Skill1.4k repo starsupdated yesterday

dev-design

The dev-design Claude Code skill guides users through the design review phase of AI DevKit's development lifecycle. Use it to validate feature architecture against requirements, review design documentation for completeness, resolve design trade-offs, and ensure all material decisions are explicitly answered before proceeding to implementation. The skill systematically checks alignment between requirements and design docs, identifies gaps, proposes architecture alternatives, and documents decisions before transitioning to the next phase.

View source Repository: ai-devkit

Install in Claude Code

Copy

git clone --depth 1 https://github.com/codeaholicguy/ai-devkit /tmp/dev-design && cp -r /tmp/dev-design/skills/dev-design ~/.claude/skills/dev-design

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

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

## Review Design

Use for Phase 3.

1. Run `npx ai-devkit@latest lint --feature <name>` and review the design doc path it validates. If manual path resolution is unavoidable, first resolve `.ai-devkit.json` `paths.docs`, falling back to `docs/ai`.
2. Search memory for relevant architecture patterns or past decisions.
3. Cross-check against the latest matching requirements doc. Verify every goal, user story, and constraint has corresponding design coverage. Flag uncovered requirements.
4. Review completeness: architecture, components, technology choices, data models, API contracts, design trade-offs, and non-functional requirements.
5. Resolve every gap, misalignment, open question, hidden assumption, or unresolved trade-off between requirements and design.
6. Brainstorm alternatives for key architecture decisions and trade-offs before accepting the first approach.
7. Update the design doc with clarified decisions and chosen options.
8. Store reusable architecture decisions in memory.
9. Summarize requirements coverage, completeness assessment, updates made, and remaining gaps.

Next: `dev-implementation`. If requirements gaps are found, return to `dev-requirements`. If design is fundamentally wrong, revise design and re-review.