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

$3

``bash


Install to current project

npx arch-docs-skill install

Or install globally

npx arch-docs-skill install --global
`

$3

`bash
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

`bash


Remove from current project

npx arch-docs-skill uninstall

Remove global installation

npx arch-docs-skill uninstall --global
``

License

MIT