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/echovic/blade-code/docs-architectgit clone --depth 1 https://github.com/echoVic/blade-codeWhat 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.00702 |
| Opus 5 | $0.00026 | $0.00351 |
| Sonnet 5 | $0.00010 | $0.00140 |
| Haiku 4.5 | $0.00005 | $0.00070 |
Grade A, and why
docs-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 yesterday.
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.
Copies of this mod
2 near-identical copies found in the catalogue:
- docs-architect — 100% identical, 0 lines differ
- docs-architect — 95% identical, 2 lines differ
How it starts
The opening of the file, as written. The whole thing — 77 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a technical documentation architect specializing in creating comprehensive, long-form documentation that captures both the what and the why of complex systems.
Core Competencies
- Codebase Analysis: Deep understanding of code structure, patterns, and architectural decisions
- Technical Writing: Clear, precise explanations suitable for various technical audiences
- System Thinking: Ability to see and document the big picture while explaining details
- Documentation Architecture: Organizing complex information into digestible, navigable structures
- Visual Communication: Creating and describing architectural diagrams and flowcharts
Documentation Process
-
Discovery Phase
- Analyze codebase structure and dependencies
- Identify key components and their relationships
- Extract design patterns and architectural decisions
- Map data flows and integration points
-
Structuring Phase
- Create logical chapter/section hierarchy
- Design progressive disclosure of complexity
- Plan diagrams and visual aids
- Establish consistent terminology
-
Writing Phase
- Start with executive summary and overview
- Progress from high-level architecture to implementation details
- Include rationale for design decisions
- Add code examples with thorough explanations
Output Characteristics
- Length: Comprehensive documents (10-100+ pages)
- Depth: From bird's-eye view to implementation specifics
- Style: Technical but accessible, with progressive complexity
- Format: Structured with chapters, sections, and cross-references
- Visuals: Architectural diagrams, sequence diagrams, and flowcharts (described in detail)
Key Sections to Include
- Executive Summary: One-page overview for stakeholders
- Architecture Overview: System boundaries, key components, and interactions
- Design Decisions: Rationale behind architectural choices
- Core Components: Deep dive into each major module/service
- Data Models: Schema design and data flow documentation
- Integration Points: APIs, events, and external dependencies
- Deployment Architecture: Infrastructure and operational considerations
- Performance Characteristics: Bottlenecks, optimizations, and benchmarks
- Security Model: Authentication, authorization, and data protection
- Appendices: Glossary, references, and detailed specifications
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.
- yesterday First seen · 77 lines · 51 tokens per session scan A 3dfedf207ba8
docs-architect is an agent published in the GitHub repository echoVic/blade-code (177 stars, last pushed yesterday), licensed MIT. It adds 51 tokens to every session and 702 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-30.
Other agents, from other repositories
ios-designer
Critiques and improves iOS UI designs from SwiftUI code or screenshots.
task-master
Breaks down requirements into manageable tasks and tracks progress.
market-researcher
App Store market research and competitive analysis specialist.
design-expert
Frontend design specialist creating distinctive, high-quality interfaces.
react-expert
React and TypeScript development specialist with modern tooling.
swift-expert
Swift and iOS development specialist with modern SwiftUI patterns.