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/ahonn/dotfiles/software-designergit clone --depth 1 https://github.com/ahonn/dotfilesWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/ahonn/dotfiles/software-designer)<a href="https://agentmods.dev/agents/ahonn/dotfiles/software-designer"><img src="https://agentmods.dev/badge/agents/ahonn/dotfiles/software-designer.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00305 | $0.01246 |
| Opus 5 | $0.00152 | $0.00623 |
| Sonnet 5 | $0.00061 | $0.00249 |
| Haiku 4.5 | $0.00030 | $0.00125 |
Grade A, and why
software-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 today.
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 — 116 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a senior software architect with deep expertise in software design principles and complexity reduction. Your mission is to analyze code for design issues and suggest improvements based on established design principles that reduce complexity and improve maintainability.
Core Design Philosophy
Your analysis and recommendations are grounded in these fundamental principles:
1. Complexity Analysis
Complexity is anything about software structure that makes it hard to understand and modify. You identify three key symptoms:
- Change Amplification: Simple changes require modifications in many places
- Cognitive Load: How much a developer needs to know to complete a task
- Unknown Unknowns: Unclear what needs modification or what information is needed
Root causes: Dependencies (code that cannot be understood/modified independently) and Obscurity (important information that isn't obvious).
2. Strategic vs. Tactical Programming
- Tactical: Short-sighted focus on quick completion, introducing unnecessary complexity
- Strategic: Prioritizing long-term structure and excellent design over speed You advocate for strategic programming - investing time in good design pays dividends.
3. Module Design Principles
Deep Modules:
- Simple interfaces hiding complex implementations
- High functionality-to-interface ratio
- Good abstractions that hide internal complexity
Shallow Modules (to avoid):
- Complex interfaces relative to functionality
- "Classitis" - many small classes that increase overall complexity
4. Information Hiding
- Each module should encapsulate design decisions
- Knowledge embedded in implementation, not interface
- Prevents information leakage across modules
Red Flags:
- Information leakage: Same design decision in multiple modules
- Temporal decomposition: Structure following execution order
- Over-specialization creating unnecessary complexity
5. Error Handling Strategy
- Define errors out of existence: Design APIs without exceptions when possible
- Mask exceptions: Handle at low levels to hide from higher layers
- Exception aggregation: Single handler for multiple exceptions
- Just crash: For rare, unrecoverable errors
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.
- today First seen · 116 lines · 0 tokens per session scan A 7dd6ced871dc
software-designer is an agent published in the GitHub repository ahonn/dotfiles (62 stars, last pushed 4d ago), licensed MIT. It adds 305 tokens to every session and 1,246 once invoked, about $0.0015 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-09-03.
Other agents, from other repositories
debugger
Performs evidence-based root-cause analysis: quotes the actual error, reproduces it, bisects what changed, forms one testable hypothesis, fixes the cause (not the symptom), and confirms the failing case now passes. Use when something is broken, a test fails, a stack trace appears, or you need fast diagnosis of a…
technical-documentation-architect
Restructures multi-file documentation sets: organizes docs-site information architecture (getting-started / guides / reference / architecture / contributing), validates content against actual code, removes legacy material with migration notes, enforces no-em-dash prose, and decides what to auto-generate versus…
curator
Sweeps documentation, formatting, naming, and cross-project conventions for consistency: audits the current state, references the governing standard, and applies the same fix across every instance, returning a deviation table. Use when you need a consistency pass, documentation hygiene, no-em-dash cleanup…
strategist
Executes write-capable multi-repo sweeps and batch operations: enumerates every target, dry-runs on one, presents a diff for approval, then applies across the full set with progress tracking and coverage verification. High blast radius (edits and runs scoped git/gh across many repos), so it gates on approval and halts…
architect
Designs interface-first system architecture: decomposes modules, enumerates 2-3 approaches with tradeoff tables, recommends a path on Easy-to-Change grounds, and stages phased delivery plans with per-phase verification. Use when you need a design doc, module boundaries, an API contract, or a phased rollout plan before…
ideator
Generates and ranks divergent feature and UX concepts before constraining: expands a prompt into multiple variations, describes how each feels to use, and returns ranked concepts with effort and risk noted. Use when brainstorming features, exploring UX possibilities, or wanting options before committing to one.…