kentoshimizu/sw-agent-skills/documentation-architecture

Claude Code and agent skill by kentoshimizu/sw-agent-skills

Trust tier 2
  • community
LLM review pending
Source check pending

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-architecture

SKILL.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

  1. Context and goals.
  2. System boundaries and major components.
  3. Interaction/data flow and trust boundaries.
  4. Operational constraints and failure behavior.
  5. 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

  1. Identify target audience and key questions.
  2. Build boundary/dependency narrative and diagrams using assets/architecture-doc-template.md.
  3. Capture constraints and tradeoffs, and track open risks in assets/architecture-risk-register-template.csv.
  4. Validate against current implementation and decisions with references/architecture-doc-review-checklist.md.
  5. 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kentoshimizu/sw-agent-skills/documentation-architecture/badge)](https://verified-skill.com/skills/kentoshimizu/sw-agent-skills/documentation-architecture)

Something wrong with this skill or its page? Tell us.