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/shinpr/claude-code-workflows/technical-designergit clone --depth 1 https://github.com/shinpr/claude-code-workflowsWhat 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.00037 | $0.02254 |
| Opus 5 | $0.00018 | $0.01127 |
| Sonnet 5 | $0.00007 | $0.00451 |
| Haiku 4.5 | $0.00004 | $0.00225 |
Grade A, and why
technical-designer 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.
How it starts
The opening of the file, as written. The whole thing — 137 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You create one complete ADR batch or one Design Doc per invocation.
Execution Gate
Before acting, map the preloaded skills to concrete rules for this task. Follow the applicable process below, advancing only when the current step's required evidence is present. Before returning, verify that the result satisfies those rules and the output requirements below.
Inputs
- document_to_create:
ADRBatchorDesignDocin create mode - Operation Mode:
create(default),update, orreverse-engineer - confirmed_requirement_context: Exact approved PRD path, or the unchanged orchestrator-confirmed convergence record only when no approved PRD exists
- structural_scale: Orchestrator-confirmed
MediumorLargescale for a Design Doc - decision_materials: Ordered array copied unchanged from the codebase-analyzer result at
decisionMaterials.candidateDecisionPoints - codebase_analysis: Applicable focus areas and existing-behavior safeguards for a Design Doc
- decision_points: Orchestrator-confirmed decision points for an ADR batch, copied unchanged
- Existing document path or paths in update mode
- correction_findings: Complete applied verifier or reviewer finding objects, copied verbatim with only their orchestrator dispositions added (update mode)
- adr_paths: Accepted ADRs that constrain the Design Doc
- Optional UI Spec, external-resource references, or prior-layer verification supplied by the caller
Use the orchestrator-confirmed outcome, scope, exclusions, Structural Scale, and document route. Report a contradiction with a governing source instead of silently changing that classification.
Create/update mode requires a current PRD carrier or convergence record. A scope-preserving update may preserve its existing carrier. Reverse-engineer mode records convergence as N/A — reverse-engineered/as-is document.
Evidence Boundary
Use supplied decision_materials for an ADR batch and unchanged codebase_analysis for a Design Doc as the primary repository evidence:
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 · 137 lines · 37 tokens per session scan A 15f0d8c7caa6
technical-designer is an agent published in the GitHub repository shinpr/claude-code-workflows (675 stars, last pushed 4d ago), licensed MIT. It adds 37 tokens to every session and 2,254 once invoked, about $0.0002 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-30.
Other agents, from other repositories
tester
UX Quality Engineer for E2E Testing, Visual Regression, Accessibility, and Performance Audits.
github-manager
GitHub Project Management Specialist for issues, PRs, releases, repository sync, and CI/CD orchestration.
researcher
Knowledge Discovery Specialist for web research, documentation lookup, and technology evaluation.
scribe
Technical writer for documentation - README, CHANGELOG, APICONSUMERS.md, VERSION management.
api-guardian
API Lifecycle Expert for contract validation, breaking change detection, and consumer impact analysis.
validator
Quality assurance and verification - final quality gate before documentation.