arch-docs-skill

A Claude Code skill for generating architecture documentation and Technical Assurance Board (TAB) review packs.

What it does

This skill helps you generate comprehensive documentation for technical governance reviews:

• tab-pack.md - Main TAB narrative document
• hld.md - High-Level Design (C4 Level 1-2)
• lld.md - Low-Level Design (C4 Level 3)
• risk-register.md - Risks with mitigations and phase context
• decision-log.md - Architectural decisions made and pending
• peer-review.md - Engineering review with gaps identified
• evidence-map.md - Claims mapped to code evidence
• tab-slides.md - Slide-by-slide presentation content

Installation

Via npx (recommended)

# Install to current project
npx arch-docs-skill install

# Or install globally
npx arch-docs-skill install --global

Via npm

npm install -g arch-docs-skill
arch-docs-skill install --global

Usage

Once installed, use the skill in Claude Code by asking:

• "Prepare TAB documentation for this project"
• "Create a review pack"
• "Generate architecture documentation"
• "Assess risks for TAB"

Or invoke directly with /arch-docs.

What the skill covers

The skill analyses your codebase against standard TAB lenses:

| Lens | Focus | |------|-------| | Architecture clarity | Are boundaries clear? Is the design defensible? | | Vendor portability | Is there lock-in? What's the migration path? | | Security posture | What controls exist? What evidence? | | Integration risk | External dependencies and failure modes | | Operability | Monitoring, debugging, incident recovery | | Data integrity | Consistency, lifecycle, classification | | Accessibility | Standards compliance, testing approach | | Delivery feasibility | Realistic scope, technical debt |

Output structure

Documents are generated to docs/review-pack/{DATE}/.

Uninstalling

# Remove from current project
npx arch-docs-skill uninstall

# Remove global installation
npx arch-docs-skill uninstall --global

License

MIT