kentoshimizu/sw-agent-skills/documentation-architecture
Claude Code and agent skill by kentoshimizu/sw-agent-skills
- community
Checking that the SKILL.md file is still in the repository.
Author architecture documentation that explains boundaries, dependencies, and operational constraints for engineering decision-making. Use when architecture docs are primary deliverables or must be updated after structural changes; do not use for implementing production feature logic.
Install
npx vskill@latest install kentoshimizu/sw-agent-skills/documentation-architectureSKILL.md
The same SKILL.md was published earlier as kentoshimizu/sw-agent-skills/documentation-architecture.
Documentation Architecture
Overview
Use this skill to produce architecture documents that improve shared understanding and reduce design/review ambiguity.
Scope Boundaries
- Use this skill when the task matches the trigger condition described in
description. - Do not use this skill when the primary task falls outside this skill's domain.
Shared References
- Review checklist:
references/architecture-doc-review-checklist.md
Templates And Assets
- Architecture document template:
assets/architecture-doc-template.md- Risk register template:
assets/architecture-risk-register-template.csv
Inputs To Gather
- System boundary and component inventory.
- Dependency relationships and data/control flows.
- Key constraints (security, reliability, compliance, cost).
- Existing ADRs and known architecture risks.
Deliverables
- Architecture narrative and structural views.
- Boundary and dependency explanations.
- Constraint and tradeoff summary.
- Open risks/assumptions and follow-up items.
Quick Structure Template
- Context and goals.
- System boundaries and major components.
- Interaction/data flow and trust boundaries.
- Operational constraints and failure behavior.
- Known risks and decision links.
Quality Standard
- Audience can answer "what talks to what" and "why" quickly.
- Boundaries and ownership are explicit.
- Constraints and tradeoffs are concrete.
- Document links to decisions and unresolved risks.
Workflow
- Identify target audience and key questions.
- Build boundary/dependency narrative and diagrams using
assets/architecture-doc-template.md. - Capture constraints and tradeoffs, and track open risks in
assets/architecture-risk-register-template.csv. - Validate against current implementation and decisions with
references/architecture-doc-review-checklist.md. - Publish with ownership and update cadence.
Failure Conditions
- Stop when architecture boundaries remain ambiguous.
- Stop when documentation omits critical operational constraints.
- Escalate when docs conflict with accepted architecture decisions.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/documentation-architecture/SKILL.md
Popularity
- Repository stars
- 5
- 7-day trend score
- 9
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Apr 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kentoshimizu/sw-agent-skills/documentation-architecture)