クイックスタート

Intentから始めよう。それ以外はすべて選択である。

現実に合った状態を選ぶ。

seed        「アイデアはあるが、まだ具体的ではない」
exploring   「方向性はあるが、検証が必要」
clarified   「何を作るか正確にわかっている」

プロジェクトのルートに INTENT.md を置く。対応するテンプレートを記入する。

seed または exploring の場合：

# INTENT — [Project Name]

> status: seed

## Why

Problem: [Who is suffering, and how?]
Hypothesis: [What do you think will fix it? It's OK to be wrong.]
Validation: [How will you know if the hypothesis is right?]

## What

[Leave empty if seed. Write what you want to verify if exploring.]

- [ ] [Feature 1 — one line]
- [ ] [Feature 2 — one line]

## Not

[Write whatever comes to mind. Add (?) if unsure.]

- [e.g., No mobile app for now]
- [e.g., Never send user data to third parties]

## Learnings

[Empty for now. You'll fill this as you explore.]

clarified の場合：

# INTENT — [Project Name]

> status: clarified

## Why

Problem: [Who is suffering, and how?]
Goal: [What does success look like?]
Metric: [How do you measure it? Use numbers.]
Customer quote: [What would a happy user tell a friend? One sentence.]

## What

- [ ] [Feature 1 — one line]
- [ ] [Feature 2 — one line]
- [ ] [Feature 3 — one line]

User flow:
1. User does [A]
2. System does [B]
3. Result: [C]

Edge cases:
- [Case 1]
- [Case 2]

## Not

- Forbidden: [Hard security/ethical lines]
- Tech constraints: [e.g., no `any` types, TypeScript only]
- Out of scope: [What we're explicitly not building]
- Quality bar: [e.g., response time under 200ms]

## Learnings

- [Date] [What you tried] — [What you learned]

Intentは静的ではない。実験し、それから更新する。

有用な結果が出るたびにLearningsに記録する：

## Learnings

- [2026-04-01] Built prototype v1 — users ignored the dashboard, went straight to export
- [2026-04-03] Interviewed 5 SMBs — the real pain is invoice tracking, not analytics
- [2026-04-05] Found existing tool X — covers 80% of what we planned. Pivot to the 20% gap.

そしてWhy / What / Notを更新する。

証拠が裏付けたら進む。裏付けないなら終了する。

seed → exploring
  タイミング：最初の実験を開始したとき。

exploring → clarified
  タイミング：Why/What/Notがすべて確信を持って埋まったとき。(?)マークが残っていないこと。

どの状態からでも → killed
  タイミング：証拠により構築する価値がないと判明したとき、
        または既存のソリューションがカバーしているとき。
  アクション：理由をLearningsに記録する。これは貴重な知識である。

Intentが clarified になれば、INTENT.md はAIにとって十分なコンテキストとなる。

Claude Codeを使っている場合、Notの制約を CLAUDE.md に移す：

# CLAUDE.md

## Intent Constraints
- TypeScript only, no `any` types
- Never modify user data without explicit confirmation
- Response time under 200ms for all API endpoints

AIにタスクの導出、コードの作成、レビュー、デプロイを任せる。現実が変わったらIntentを更新する。