// Detail or invent
Missing context — or plausible fabrication.
Spec-Driven DevelopmentMissing context — or plausible fabrication.
Spec-Driven DevelopmentCode that ignores your standards.
Rules over ToolsSilent drift until fixes are expensive.
Human in the LoopSet up new projects and understand brownfield legacy codebases.
Architect skillsA guided path from requirement to verified solution delivery.
Builder skillsReview, repair, and release maintainable code with confidence.
Craftsman skillsWhen agents invent context or miss critical details, specs and verification keep output trustworthy.
Projects where consistency, conventions, and verifiability are non-negotiable.
AI-powered IDEs that load project context from your repo.
Agent harnesses that invoke markdown skills from `.agents/skills/`.
When requirements live only in chat history, models interpolate and invent. AIDD treats the spec as the contract: scope, constraints, and acceptance criteria stay in-repo so every change traces back to written intent.
Specs are not only for new features. Capture current behavior, risks, and migration steps so refactors and legacy work stay grounded instead of drifting into silent rewrites.
AGENTS.md, skills, and conventions give the same guardrails in Cursor, Claude Code, Copilot, or the next editor. Tools change; the rules your team cares about stay versioned with the code.
Without shared rules, every developer gets a different “voice” from the model. Central patterns for naming, architecture, and review keep output predictable enough to trust in production.
Agents can propose diffs quickly — the bottleneck is knowing they are right. Build habits around tests, static checks, and targeted review so acceleration does not become silent debt.
Small mistakes compound when no one reconciles output against the spec. Short feedback loops (local runs, CI, and explicit sign-off) keep fixes cheap and intent aligned with what shipped.