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 commands/data-wise/craft/archgit clone --depth 1 https://github.com/Data-Wise/craftWhat 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.00000 | $0.02684 |
| Opus 5 | $0.00000 | $0.01342 |
| Sonnet 5 | $0.00000 | $0.00537 |
| Haiku 4.5 | $0.00000 | $0.00268 |
Grade A, and why
arch 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.
This is a copy
91% identical to arch — 13 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 357 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Architecture Commands
⏱️ 5 minutes • 🟡 Intermediate • ✓ System design and analysis
TL;DR (30 seconds)
- What: 4 commands for analyzing, planning, reviewing, and diagramming software architecture
- Why: Understand your codebase structure, identify patterns, and plan improvements with AI assistance
- How: Use
/craft:arch:analyzefor analysis,/craft:arch:diagramfor visual diagrams- Next: Try
/craft:arch:analyze debugto see your project's architecture patterns
Craft's architecture commands help you understand, document, and improve your codebase structure with AI-powered analysis and visualization.
Commands Overview
| Command | Purpose | Time (default) |
|---|---|---|
/craft:arch:analyze |
Analyze architecture patterns | < 15s |
/craft:arch:diagram |
Generate architecture diagrams | < 30s |
/craft:arch:plan |
Plan architectural changes | < 60s |
/craft:arch:review |
Review architecture decisions | < 120s |
All commands support execution modes for different levels of detail.
/craft:arch:analyze - Architecture Analysis
Analyze codebase architecture, patterns, dependencies, and structure.
Quick Start
/craft:arch:analyze # Quick overview
/craft:arch:analyze debug # Deep pattern analysis
/craft:arch:analyze optimize # Performance architecture
/craft:arch:analyze release # Full audit
Modes
| Mode | Time | Focus |
|---|---|---|
| default | < 15s | Quick overview, basic structure |
| debug | < 120s | Deep dive, all patterns, anti-patterns |
| optimize | < 180s | Performance hotspots, import analysis |
| release | < 300s | Full architectural audit with metrics |
Analysis Areas
The command examines:
- Structure: Directory layout, module organization, separation of concerns
- Dependencies: Import graphs, coupling metrics, circular dependencies
- Patterns: MVC, microservices, layered architecture, design patterns
- Data Flow: How data moves through the system
- Complexity: Cyclomatic complexity, nesting depth, function sizes
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 · 357 lines · 0 tokens per session scan A c5aa0d0b4b9a
arch is a command published in the GitHub repository Data-Wise/craft (4 stars, last pushed 15d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,684 tokens. A static security scan graded it A with 0 findings. It is 91% identical to arch, differing in 13 lines, and is treated as a copy.
Other commands, from other repositories
readme-audit
Audit a README's reading flow by treating it as a conversion funnel. Every section is evaluated against a target reader and a terminal action. Produces a structured audit blueprint that feeds directly into /readme-restructure.
readme-restructure
Execute a /readme-audit blueprint. Rewrites the README to the evaluator → conversion → links structure and creates linked docs by extracting and reorganising existing content.
build-fix
Fix build and type failures with minimal diffs.
checkpoint
Record a verified checkpoint before the next phase.
doctor
Check the install surface for missing files and invalid manifests.
feature-dev
Drive a feature from plan to implementation to review.