人間のIntent。AIの実行。

Intentを届けよ、
コードではなく。

Why、What、Notを定義する。スタック、アーキテクチャ、スケジュール、実装はAIが選ぶ。

クイックスタートコンセプト

01 — 問題

AIが生成を安価にした。Intentがなければ、そのスピードはノイズになる。Intentがあれば、明確さになる。

Intentなし

AIが頼んでもいないスタックを選ぶ
AIが誰も必要としないスケジュールを作る
AIが仕様、ストーリー、プロセスを肥大化させる
8ファイル、3,740行、132KBのノイズ
何を作るべきかまだわからない

Intentあり

Why：なぜこれが存在しなければならないか
What：何が真でなければならないか
Not：AIが踏み込めない領域
1ファイル、47行、シグナル
AIが推測ではなく実行する

02 — フレームワーク

Intent Documentには4つのセクションがある。それ以上はない。

Why

なぜこれが存在するのか？

問題、目標、成功基準を述べる。これが変われば、Intentが変わったということ。

What

何を作るのか？

機能、フロー、エッジケースを述べる。具体的に、しかしスタック、アーキテクチャ、スケジュールは決して指定しない。

Not

絶対にやらないことは何か？

AIが越えてはならない線を述べる。スコープの制限、セキュリティルール、品質基準、禁止事項。

Learnings

何を発見したか？

試したこと、学んだこと、変わったことを記録する。これがIntentをより鋭くする方法。

03 — ライフサイクル

Intentは静的ではない。学びを通じて鋭くなるか、証拠に基づいて消滅する。

seed

→

exploring

→

clarified

→

build

killed

← どの状態からでもここに到達できる。それでいい。

# INTENT.md
# INTENT — Legacy Converter

> status: exploring

## Why
Problem: Legacy projects can't leverage vibe coding.
Hypothesis: An automated converter can bridge the gap.
Validation: Convert one small project, measure dev speed.

## What
- [ ] Scan legacy codebase structure
- [ ] Generate vibe-coding-ready CLAUDE.md
- [ ] Suggest refactoring candidates

## Not
Forbidden: Never modify source files without explicit confirmation
Scope: Node.js/TS only for now

## Learnings
[2026-04-01] Prototype v1 — type coverage was the key signal
[2026-04-05] User interview — they want CLAUDE.md generation most
    

04 — パイプライン

人間がIntentを定義し、結果を判断する。残りはAIが行う。

✍

Intentを書く

Why / What / Not を記述する

Human

⚙

仕様を生成

AIがIntentをタスクに変換する

💻

実装

AIエージェントがコードを書く

🔍

検証

AIがレビュー、テスト、リントチェックを行う

🚀

デプロイ

CI/CDが本番環境にプッシュする

💡

学習と判断

結果をレビューし、Intentを更新するか終了する

Human

05 — 原則

4つのルール。破ればAIが推測を始める。

Howを書かない

Intentは制約を設定するもので、実装を指定するものではない。「Redisを使え」ではなく「外部キャッシュレイヤーは使わない」と書く。

不確実性を認める

不明な点は(?)でマークする。正直な不確実性は偽りの精密さに勝る。

素早く終了する

アイデアが死んだなら、そう言って理由を記録する。killedされたIntentは将来の時間を節約する。

Intentの精度 = アウトプットの品質

「良いアプリを作れ」はノイズ。「新規ユーザーが30秒で価値に到達する」がIntentである。

Intentを届けよ、コードではなく。