Planning & Design
Agents accelerate planning by exploring options, surfacing patterns, and drafting specificationsâwithout replacing stakeholder judgment.
Requirements & Planning
Section titled âRequirements & PlanningâWhere agents help
Section titled âWhere agents helpâBreaking down ambiguity
- âWhat questions should we answer before implementing [feature]?â
- âWhat edge cases should we consider for [requirement]?â
- âBreak down [epic] into implementable user storiesâ
Research and exploration
- âWhat approaches exist for [problem]? Summarize pros and cons.â
- âWhat are common pitfalls when implementing [feature type]?â
Treat this as research assistance, not authoritative answers.
Specification drafting: API contracts, data models, interface definitions, acceptance criteria. These drafts need human refinement, but they accelerate the starting point.
Estimation support: âBased on this spec, what are the major implementation tasks?â Agents decompose work; estimation remains human judgment.
Where agents struggle
Section titled âWhere agents struggleâ- Stakeholder intent â They canât replace stakeholder conversations
- Organizational context â Team ownership, historical decisions, constraints
- Prioritization â They enumerate options, but canât tell you what matters most
Prompt patterns
Section titled âPrompt patternsâUser story refinement: âGiven this requirement: [paste requirement]. Generate user stories in standard format (As a⌠I want⌠So thatâŚ). Include acceptance criteria for each.â
Risk identification: âWeâre planning to implement [feature]. What technical risks should we consider? What could go wrong?â
Architecture & Design
Section titled âArchitecture & DesignâWhat agents offer
Section titled âWhat agents offerâBroad pattern knowledge: Common approaches for your problem type, pattern variations and tradeoffs, anti-patterns to avoid. Doesnât replace experience, but accelerates exploration.
Articulation: Generate diagrams from descriptions, document decisions, create viewpoints for different audiences.
Challenge and critique: âWhat could go wrong with this design?â âWhat am I not considering?â They surface considerations you might miss.
What agents canât do
Section titled âWhat agents canât doâ- Make decisions â They lack context about your team, constraints, and what youâre optimizing for
- Understand evolution â They see a snapshot, not trajectory (why things are the way they are)
- Navigate tradeoffs â They enumerate options, not which tradeoff fits your situation
Prompt patterns
Section titled âPrompt patternsâDesign exploration: âI need to design [type of system]. What architectural patterns are commonly used? For each, what are the key tradeoffs?â
Design critique: âHereâs my proposed architecture for [system]: [description]. What potential issues should I consider? What am I missing?â
ADR drafting: âHelp me write an ADR for deciding to use [approach] instead of [alternative]. Context: [provide context].â
Diagram generation: âCreate a [type] diagram showing [components and relationships]. Use [format, e.g., Mermaid syntax].â
Resources
Section titled âResourcesâSpecifications & Planning
Section titled âSpecifications & Planningâ- Spec-Driven Development â Al Harris, Amazon Kiro - How specs enable reproducible AI delivery
- The New Code â Sean Grove, OpenAI - Why specifications are becoming the fundamental unit of programming
- Spec Kit - GitHubâs spec-driven development framework
Case studies
Section titled âCase studiesâ- AI in Product Development: Netflix, BMW, PepsiCo - Case studies of AI in product planning