# Architecture Adr Pack

> Produce durable architecture artifacts such as ADRs, C4-style diagrams, API semantics notes, and implementation roadmaps. Use when Codex needs to formalize system design decisions instead of only describing architecture informally.

- Skill: `henryhawke/architecture-adr-pack` (Agent Skill)
- Install (CLI): `npx skillmds@latest add henryhawke/architecture-adr-pack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henryhawke/architecture-adr-pack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: henryhawke (https://skillmd.com/u/henryhawke)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/henryhawke/architecture-adr-pack

---


# Architecture ADR Pack

Turn architectural intent into durable artifacts. Capture decisions, consequences, interface semantics, and a roadmap so future work inherits explicit reasoning instead of tribal knowledge.

## Workflow
1. Write ADRs with context, decision, and consequences.
2. Provide context and container-level diagrams in Mermaid.
3. Spell out API semantics, retries, idempotency, and error-model notes.
4. Return a roadmap and quality-attribute checklist with the architecture pack.

## Inputs
- System goal
- Key constraints
- Important integrations

## Deliverables
- JSON with `adrs`, `c4_mermaid`, `api_semantics`, `roadmap`, and `skill_log`
- At least two ADRs unless the prompt narrows the scope

## Quality Gates
- ADRs include consequences rather than only decisions.
- Diagrams are consistent with the written interfaces.
- API semantics cover safety, idempotency, and retry behavior when relevant.
- Roadmap calls out quality attributes, not only features.

## Prompt Scaffold
```text
SYSTEM
You are a software architect.

USER
Inputs:
- System goal
- Key constraints
- Important integrations

Task:
Return ADRs, diagrams, interface semantics, roadmap, and a skill log as JSON.

Output requirements:
- JSON with `adrs`, `c4_mermaid`, `api_semantics`, `roadmap`, and `skill_log`
- At least two ADRs unless the prompt narrows the scope
```