jasonkneen avatar

Spec Driven Development

This is a structured three-phase methodology for breaking down features into Requirements (using EARS format for acceptance criteria), Design (architecture and technical decisions), and Tasks (sequenced implementation steps). It shines when you're building complex features where rework is expensive or when working with AI assistants that need clear structure to generate quality code. The checklists and traceability between phases help catch gaps early. Skip it for simple bug fixes or quick prototypes, but for anything involving multiple components or team collaboration, the upfront investment pays off in reduced ambiguity and fewer surprises during implementation. Essentially turns "build a user authentication system" into a spec you can actually execute against.

skills.sh installs
452
GitHub stars
757
last updated
Aug 21, 2026

Install

$ npx -y skills add jasonkneen/kiro --skill spec-driven-development --agent claude-code

Installs into .claude/skills of the current project.

Files

Spec-Driven Development

A comprehensive methodology for systematic software feature development that ensures quality, maintainability, and successful delivery through structured planning.

When to Use This Skill

Ideal scenarios:

  • Complex features with multiple components, integrations, or user interactions
  • High-stakes projects where rework costs are significant
  • Team collaboration requiring shared understanding
  • AI-assisted development where clear structure improves output quality
  • Knowledge preservation for future maintainers

Less suitable:

  • Simple bug fixes with obvious solutions
  • Experimental prototypes for rapid iteration
  • Time-critical hotfixes requiring immediate action
  • Well-established patterns with minimal ambiguity

The Three-Phase Workflow

Phase 1: Requirements Gathering

Purpose: Transform vague feature ideas into clear, testable requirements

Process:

  1. Capture user stories expressing value and purpose
  2. Define acceptance criteria using EARS format (Easy Approach to Requirements Syntax)
  3. Identify edge cases and constraints
  4. Validate completeness and feasibility

Sponsors

Details

Repository
github.com/jasonkneen/kiro
Categories
Code Review & Quality, Design & UI/UX
First seen
Jun 3, 2026

More from jasonkneen/kiro

All 2
1aj-geddes avatarcloud-migration-planningaj-geddes/useful-ai-promptsPlan and execute cloud migrations with assessment, database migration, application refactoring, and cutover strategies across AWS, Azure, and GCP.450skills.sh installs
2aj-geddes avatardesign-handoffaj-geddes/useful-ai-promptsPrepare designs for development handoff. Document specifications, interactions, and assets to enable efficient development and maintain design quality.450skills.sh installs
3alchaincyf avatarhuashu-weread-advisoralchaincyf/huashu-weread微信读书高阶顾问。在底层 weread skill 的原子 API 之上,提供四类工作流:基于已读做个性化进阶推荐(advisor)、给方向规划入门到前沿的阶梯书单(path)、把零散划线想法提炼成读书笔记总结(alchemy)、做季度/年度阅读复盘并生成可发朋友圈/公众号的文章(review)。核心方法是「书架 + 447skills.sh installs
4feiskyer avatarkiro-skillfeiskyer/claude-code-settingsInteractive feature development workflow from idea to implementation. Creates requirements (EARS format), design documents, and task lists. Triggers: "kiro", ".442skills.sh installs
5vercel-labs avatarweb-design-guidelinesvercel-labs/agent-evalReview UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site 440skills.sh installs
6secondsky avatardatabase-schema-designsecondsky/claude-skillsDatabase schema design for PostgreSQL/MySQL with normalization, relationships, constraints. Use for new databases, schema reviews, migrations, or encountering m437skills.sh installs