Spec Design — Testing skill for Claude Code
Refine design.md for an active change.
How to install Spec Design
Installs to ~/.claude/skills/srg-kostyrko-ai-sdlc-spec-design/SKILL.md
mkdir -p ~/.claude/skills/srg-kostyrko-ai-sdlc-spec-design && curl -fsSL https://raw.githubusercontent.com/srg-kostyrko/ai-sdlc/HEAD/commands/spec-design.md -o ~/.claude/skills/srg-kostyrko-ai-sdlc-spec-design/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Spec Design does
description: Refine design.md for an active change. Surfaces missing constraints, writes the initial draft to disk, then refines on-disk through self-check and grill-me. Optionally dispatches a subagent to survey existing code. argument-hint: []
You are refining the design for an active change.
The flow is **resolve → gate → read context → constraints interview (skip-when-covered) → draft and write to disk → self-check → grill-me → report**. The initial draft writes to disk early
Alternatives in Testing
- Loki Grill — Interrogate a spec with Loki's Devil's-Advocate grill before building, and summarize the hardest questions it 1.1k ★
- Adversarial Spec — A Claude Code plugin that iteratively refines product specifications by debating between multiple LLMs until a 514 ★
- Spec Draft PR — Turn a feature idea or GitHub issue into a one-page spec saved to Documentation/specs/ and opened as a draft P 324 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Spec Requirements
Refine proposal.md and capability deltas for an active change. Interviews the user, writes the initial draft t
Spec Tasks
Refine tasks.md for an active change. Writes the initial draft to disk, then refines on-disk through self-chec
Unity Refine
Refines a raw GitHub issue into an implementation-ready spec — problem, acceptance criteria, scope, affected s
Parallel Fix
Use when facing 3+ independent test failures or broken subsystems with different root causes. Dispatches one a
Devs Team
Parallel multi-lens critique of a solution design (the active spec if present, else the decision brief). Dispa
Diff Spec
Diff a product's built UI against its DESIGN_SPEC.md — catches drift (tokens missing from CSS, surfaces named
Related Agents
Gantry Critic
Attacks a plan before it is implemented. Use to grill plan.md against task.md — unstated assumptions, unfalsif
Survey Code
Investigate the codebase to understand existing patterns, constraints, and relevant files. Writes a session-sc
Tend
Tend the Allium garden. Use when the user wants to write, edit, update, add to, improve, clarify, refine, rest