仕様駆動開発(Spec-Driven Development: SDD)環境の比較: SpecKit vs Kiro

# Specify CLIのインストール
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# プロジェクトの初期化
specify init my-project --ai copilot

# または既存プロジェクトで
specify init . --ai copilot

/speckit.constitution Create principles focused on code quality, 
testing standards, user experience consistency, and performance requirements

/speckit.specify Build an application that can help me organize my photos 
in separate photo albums. Albums are grouped by date and can be re-organized 
by dragging and dropping on the main page.

/speckit.plan The application uses Vite with minimal number of libraries. 
Use vanilla HTML, CSS, and JavaScript as much as possible.

/speckit.tasks

/speckit.implement

---
description: Create or update project governing principles
---

# Project Constitution

Create a comprehensive constitution document that includes:

1. **Code Quality Standards**
   - Naming conventions
   - Documentation requirements
   - Code review processes

2. **Testing Standards**
   - Unit test coverage requirements
   - Integration test strategies
   - Test documentation

3. **Architecture Principles**
   - Design patterns to follow
   - Technology stack constraints
   - Performance requirements

4. **User Experience Guidelines**
   - Accessibility standards
   - Responsive design requirements
   - Internationalization considerations

---
description: Define requirements and user stories
---

# Specification Template

## User Stories

**As a** [user type]
**I want** [goal]
**So that** [benefit]

### Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2

## Functional Requirements

### FR-001: [Requirement Name]
**Priority**: High/Medium/Low
**Description**: Detailed requirement description
**Dependencies**: [Other requirements]

---
description: Create technical implementation plans
---

# Implementation Plan

## Technology Stack
- Frontend: [Framework/Library]
- Backend: [Framework]
- Database: [Type]
- Deployment: [Platform]

## Architecture Overview
[システム構成図、コンポーネント図]

## Data Model
[エンティティ関係図、テーブル定義]

## API Specifications
[エンドポイント定義、リクエスト/レスポンス形式]

## Implementation Phases
1. Phase 1: [Core features]
2. Phase 2: [Advanced features]

## Technical Considerations
- Security requirements
- Performance optimization
- Scalability concerns

---
description: Generate actionable task lists
---

# Task Breakdown

## User Story: [Story ID]

### Task 1: [Task Name]
**File**: `src/components/Feature.tsx`
**Type**: Implementation
**Dependencies**: None
**Parallel**: [P] (if parallelizable)
**Description**: Detailed task description
**Acceptance**: How to verify completion

### Task 2: [Task Name]
**File**: `tests/Feature.test.tsx`
**Type**: Testing
**Dependencies**: Task 1

---
description: Execute implementation plan
---

# Implementation Execution

1. **Validate Prerequisites**
   - Constitution exists
   - Spec is complete
   - Plan is approved
   - Tasks are defined

2. **Parse Tasks**
   - Read tasks.md
   - Build dependency graph
   - Identify parallel tasks

3. **Execute Tasks**
   For each task in order:
   - Create/modify specified files
   - Run tests (if TDD)
   - Validate against acceptance criteria
   - Update task status

4. **Progress Reporting**
   - Mark tasks as In Progress/Done
   - Report errors with context
   - Suggest next steps

---
description: Clarify underspecified areas
---

# Clarification Questions

## Coverage Analysis
[仕様で言及されていない領域を特定]

## Sequential Questions
1. **Question**: [Specific question]
   **Context**: [Why this is important]
   **Options**: [Possible answers]

[回答が記録されるとClarificationsセクションに追加]

my-project/
├── .specify/
│   ├── memory/
│   │   └── constitution.md          # プロジェクト原則
│   ├── specs/
│   │   └── 001-photo-albums/
│   │       ├── spec.md               # 機能仕様
│   │       ├── plan.md               # 実装計画
│   │       ├── tasks.md              # タスクリスト
│   │       ├── data-model.md         # データモデル
│   │       ├── contracts/
│   │       │   └── api-spec.json    # API仕様
│   │       └── research.md           # 技術調査
│   ├── scripts/
│   │   ├── create-new-feature.sh
│   │   └── setup-plan.sh
│   └── templates/
│       ├── spec-template.md
│       ├── plan-template.md
│       └── tasks-template.md
├── .github/
│   └── prompts/
│       ├── speckit.constitution.prompt.md
│       ├── speckit.specify.prompt.md
│       ├── speckit.plan.prompt.md
│       ├── speckit.tasks.prompt.md
│       ├── speckit.implement.prompt.md
│       ├── speckit.clarify.prompt.md
│       └── speckit.analyze.prompt.md
└── src/
    └── [実装ファイル]

WHEN [条件/イベント]
THE SYSTEM SHALL [期待される動作]

{
  "hooks": [
    {
      "trigger": "onFileSave",
      "pattern": "**/*.tsx",
      "action": "generateTests"
    }
  ]
}

my-project/
├── .kiro/
│   ├── steering/
│   │   ├── tech-stack.md
│   │   ├── coding-standards.md
│   │   └── workflows.md
│   └── specs/
│       └── photo-albums/
│           ├── requirements.md    # EARS形式の要件
│           ├── design.md          # アーキテクチャ設計
│           └── tasks.md           # 実装タスク
└── src/
    └── [実装ファイル]

# spec.md

## User Stories
As a user, I want to...

## Functional Requirements
FR-001: Feature description

## Review Checklist
- [ ] Requirements are clear
- [ ] Acceptance criteria defined

# requirements.md (EARS形式)

WHEN user clicks upload button
THE SYSTEM SHALL display file selection dialog

WHEN file size exceeds 10MB
THE SYSTEM SHALL display error message

# plan.md

## Architecture
- Frontend: React
- Backend: Node.js

## Implementation Details
[詳細な実装ガイド]

# data-model.md
[データベーススキーマ]

# contracts/api-spec.json
{OpenAPI仕様}

# design.md

## Component Architecture
[システム構成図]

## Sequence Diagrams
[フロー図]

## Technical Considerations
[パフォーマンス、セキュリティ等]

# tasks.md

## User Story: US-001

### Task 1: Setup database schema
File: src/db/schema.sql
Dependencies: None
[P] Parallel: Yes

### Task 2: Create API endpoint
File: src/api/upload.ts
Dependencies: Task 1

# tasks.md

## Phase 1: Core Implementation

- [ ] Task 1: Database setup
  Status: Not Started
  Assignee: [Auto]
  
- [ ] Task 2: API development
  Status: Not Started
  Dependencies: Task 1

---
description: Custom quality checklist generator
---

# /speckit.custom-checklist

Generate a quality checklist for:

1. **Security Review**
   - Authentication check
   - Authorization verification
   - Input validation

2. **Performance Review**
   - Database query optimization
   - Caching strategy
   - Load testing results

[Output format: Markdown checklist in spec directory]

# Feature 1
specify init . --ai copilot
/speckit.specify Build user authentication system

# Feature 2 (新しいブランチで)
git checkout -b feature/002-payment
/speckit.specify Integrate payment gateway

graph TD
    A[Product Manager] -->|要件定義| B["speckit.specify"]
    B --> C["spec.md生成"]
    C --> D[Tech Lead]
    D -->|技術選定| E["speckit.plan"]
    E --> F["plan.md, data-model.md生成"]
    F --> G[Developer]
    G -->|タスク確認| H["speckit.tasks"]
    H --> I["tasks.md生成"]
    I --> J["speckit.implement"]
    J --> K["コード生成"]
    K --> L[Pull Request]
    L --> M[Code Review]
    M -->|承認| N[Merge]

graph TD
    A[アイデア] --> B[Spec Chat]
    B --> C[Requirements生成]
    C --> D[Design生成]
    D --> E[Tasks生成]
    E --> F[#spec参照してコーディング]
    F --> G[ファイル保存]
    G --> H[Hooks起動]
    H --> I[自動テスト生成]
    I --> J[バックグラウンドで実行]