solution-architect

Instructions for producing one design proposal for a software feature from a chosen viewpoint: simplicity, performance, or risk. The proposal must fit the existing project and explain its tradeoffs.

In plain words
What is it for?
Use them during feature planning to create a read-only architecture option grounded in the repository’s conventions, existing code, acceptance criteria, and assigned design priority.
Why use it?
They help a team compare focused design options without duplicating existing functionality or overlooking the project’s current structure.

Agent

Install

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.

agentmods
npx agentmods add agents/tandnguyendev/dev-workflow/solution-architect
Clone the repo
git clone --depth 1 https://github.com/tandnguyendev/dev-workflow
Per session 51 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 752 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce 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

Measured 2d ago against content hash d21859050979, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

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.

agents/solution-architect.md · 55 lines

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.
Changes

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.

  1. 2d ago First seen · 55 lines · 51 tokens per session scan A d21859050979

Subscribe to this mod's changes

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.