Agent-Skills.md

Agent Skills: ADR C4 Writer

Internal Moonshot Architecture stage for writing C4 model artifacts and ADRs from accepted architecture decisions.

UncategorizedID: munlucky/claude-settings/adr-c4-writer

Repository

munlucky/claude-settings
munlucky

Install this agent skill to your local

pnpm dlx add-skill https://github.com/munlucky/moonshot-relay/tree/HEAD/skills/adr-c4-writer

Skill Files

Browse the full folder contents for adr-c4-writer.

Download Skill

Loading file tree…

skills/adr-c4-writer/SKILL.md

Skill Metadata

Name
adr-c4-writer
Description
Internal Moonshot Architecture stage for writing C4 model artifacts and ADRs from accepted architecture decisions.

ADR C4 Writer

Role

Write C4 model artifacts and Architecture Decision Records from accepted architecture decisions.

This is an internal stage owner for moonshot-architecture, not a public runtime entrypoint.

Inputs

  • TRADEOFF_ANALYSIS.md
  • Selected architecture option
  • Requirement IDs, ASR IDs, and verification signals
  • Brownfield current architecture evidence when available

Flow

  1. Write C4 context, container, and component artifacts at the output paths declared by the architecture templates.
  2. Write one ADR per significant accepted decision under ADR/ADR-0001-title.md.
  3. Record context, decision, consequences, rejected alternatives, and traceability in each ADR.
  4. Link C4 elements and ADRs back to requirements, ASRs, and verification signals.
  5. Keep diagrams inspectable as markdown or mermaid source.

Hard Stops

  • Do not write ADRs without rejected alternatives.
  • Do not claim C4 coverage without a clear system boundary.
  • Do not mix source template paths with generated output paths.
  • Do not omit traceability from ADRs.

Required Evidence

  • C4 artifact paths.
  • ADR IDs and decision status.
  • Requirement and ASR links.
  • Consequences, rejected alternatives, and verification signals.