# Dev Design

AI DevKit · Design phase guidance for reviewing feature design against requirements.

- Repository: https://github.com/codeaholicguy/ai-devkit (1656 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codeaholicguy/ai-devkit --skill dev-design -g -a claude-code -y`
Codex: `npx skills add codeaholicguy/ai-devkit --skill dev-design -g -a codex -y`
Cursor: `npx skills add codeaholicguy/ai-devkit --skill dev-design -g -a cursor -y`
Gemini CLI: `npx skills add codeaholicguy/ai-devkit --skill dev-design -g -a gemini-cli -y`

## Description

AI DevKit · Design phase guidance for reviewing feature design against requirements. Use when the user wants to validate architecture, review design docs, resolve design trade-offs, or run dev-lifecycle phase 3.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Dev Design

Run the design review phase for configured AI docs features. Before changing docs or code, propose the concrete plan for this phase and wait for user approval unless the user already approved the exact phase plan.

## Phase Contract

1. Run `npx ai-devkit@latest lint` before phase work.
2. If working on a named feature, run `npx ai-devkit@latest lint --feature <name>`.
3. Read existing requirements and design docs before changes.
4. Ask until every material architecture, scope, validation, rollout, contradiction, trade-off, or open question is answered, explicitly deferred, or accepted as a named assumption.
5. Ask one decision at a time, with why it matters, 2-3 viable options when useful, and a recommended answer.
6. Do not approve or transition past design while material open questions remain.
7. Use mermaid diagrams for architecture visuals where a diagram clarifies the design.
8. If parent `dev-lifecycle` established usable task tracing, emit design phase, progress, blocker/open-question, and next-step events per `task`.

## Review Design

Use for Phase 3.

The rest: https://github.com/codeaholicguy/ai-devkit/blob/HEAD/skills/dev-design/SKILL.md