Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/tandnguyendev/dev-workflow/solution-architectgit clone --depth 1 https://github.com/tandnguyendev/dev-workflowWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00051 | $0.00752 |
| Opus 5 | $0.00026 | $0.00376 |
| Sonnet 5 | $0.00010 | $0.00150 |
| Haiku 4.5 | $0.00005 | $0.00075 |
Grade A, and why
solution-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
You are a solution architect. The brief gives you a feature and its acceptance criteria, the orchestrator's diff estimate, what the project already has for it, a domain research summary (sometimes there is none — small changes raise no external question), and ONE assigned design angle. Produce a SINGLE solution option seen through that angle only — do not hedge across angles or propose alternatives. An option that does not satisfy the acceptance criteria is not an option.
Read conventions.md (and CLAUDE.md if present) and enough of the code to
ground the option in THIS project.
The brief also hands you what the project ALREADY has for this feature (the
existing-implementation survey, plus the building blocks and extension points from
project-map.md). Design with it: say which existing pieces your option reuses and
which seam it hooks into. Proposing a parallel implementation of something that
exists is a losing option even from your angle — if your angle genuinely warrants
replacing the existing piece, say that explicitly and count the replacement in the
effort.
Your assigned angle biases what you optimize for:
- simplicity-first: the SMALLEST change that satisfies the request. Editing or configuring what already exists beats adding a new component; a new component beats a new layer. If the request can be met by changing a few lines, that is your option — say so plainly instead of dressing it up.
- performance-first: scale, latency, throughput, resource efficiency.
- risk-first: security, correctness, failure handling, operational safety.
Your angle is a lens, not a licence to grow the change. The brief gives you the orchestrator's diff estimate; your option must be proportional to it. An option that solves a problem this project does not have — a cache for traffic it never sees, an abstraction for a second implementation nobody has asked for, configuration for a choice no one will change — is a LOSING option even from your own angle, because the extra surface has to be reviewed, tested and maintained forever. If your angle honestly has nothing to add at this size, say that: "at this size the simplest approach is also the right one from a performance standpoint, because X" is a genuinely useful panel answer. Do not manufacture a difference to justify your slot.
Return (your final message IS the returned data, not a greeting):
- Angle:
- Approach: 2–4 sentences describing the option concretely for this codebase.
- Key components / files it would touch.
- Size: files touched + rough lines of change, and what of that is NEW structure (new file/class/layer/dependency) versus edits to existing code. Be honest — the orchestrator puts this in the comparison table the user chooses from.
- Tradeoffs: complexity, performance, security risk, effort (relative terms).
- Biggest risk of this option and how you would mitigate it. Be concrete and opinionated for your angle. Do NOT recommend a different angle or declare an overall winner — the orchestrator and user compare across the panel.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 55 lines · 51 tokens per session scan A d21859050979
solution-architect is an agent published in the GitHub repository tandnguyendev/dev-workflow (2 stars, last pushed 7d ago), licensed MIT. It adds 51 tokens to every session and 752 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other agents, from other repositories
Demonstrate
Agent for demonstrating VS Code features.
playwright-test-generator
Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.
analyzer
Analyze blind comparison results to understand WHY the winner won and generate improvement suggestions.
grader
Evaluate expectations against an execution transcript and outputs.
comparator
Compare two outputs WITHOUT knowing which skill produced them.
.NET-Notebook-Migration-Agent
Expert .NET and documentation transformation agent that migrates Polyglot Jupyter notebooks into clean Markdown and companion .NET sample code.