# Design

> Design a feature or change into a reviewed ADR. Outputs an accepted decision record ready for /scope.

- Skill: `majiayu000/design-16` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/design-16`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/design-16/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/design-16

---


# Design

Produce an Architecture Decision Record (ADR) for a feature or change. Read AGENTS.md if not in context.

## Inputs

Design question or topic. Timebox if relevant.

## Review-aware

Before starting: check if `<artifact>.findings.md` exists for this topic. If it does, read it and incorporate findings before proceeding.

## Workflow

1. **GitHub state check** — Run `gh issue list` and `gh pr list` to avoid proposing already-built or conflicting work.

2. **Shape options** — Produce 1 recommended option (+ 1 alternative max). Include: pros/cons, risks, dependencies, success validation.

3. **Draft ADR** — Write to `.aide/docs/decisions/YYYY-MM-DD-<slug>.md` (AIDE framework decisions) or `docs/decisions/YYYY-MM-DD-<slug>.md` (game/project decisions). Status: `Draft`.

4. **Cross-review** — Use `/findings` to exchange findings before accepting. Do not accept unreviewed ADRs.

5. **Accept** — Set status to `Accepted`. Hand off to `/scope` to decompose into GitHub issues.

## ADR format

```
# Title
Status: Draft | Accepted | Superseded
## Context
## Decision
## Rationale
## Consequences
```

## Reference

- Design pillars: `design/` directory
- Quick reference: `docs/DESIGN_QUICK_REFERENCE.md`