AI Project Pack

これは何か

AI Project Pack は、AI を使った開発のための public な単一リポジトリ型 operating pack です。新しい AI セッションが始まるたびに「何が真実で、何が未決で、次に何をすべきか」を再構築するのではなく、同じ repo から始められるようにします。

主役はリポジトリそのもので、このページはそのリポジトリを先に理解するための説明ページです。

メモリサービスでも、自律的なマネージャーでも、ホスト型プラットフォームでもありません。あくまで reviewable な text-first operating repo です。

なぜ作られたか

開発プロジェクトは、決定事項がチャットに埋もれ、未決事項が勝手に確定扱いされ、source が見えなくなり、新しいモデルや新しいセッションのたびに文脈を作り直すことで劣化します。

AI Project Pack は、それを防ぐために以下を分離して持たせます。

• current truth
• decisions
• pending items
• next actions
• sources
• append-only update logs

誰向けか

AI セッションのたびに文脈がリセットされ、プロジェクト品質が落ちる人向けです。

• AI を併用した product / technical planning
• 根拠の質が重要な research-heavy implementation
• OSS の公開準備や handoff を伴う作業
• 人間 + AI の混成で、変更履歴を監査可能にしたいチーム

逆に、自動で全部進める project manager や SaaS を探している場合は向きません。

リポジトリの中身

このリポジトリは、AI が毎回読んで判断し、必要なら小さく更新できる operating surface として整理されています。

Core operating files

current-truth.md、decisions.md、pending.md、next-actions.md、sources.md、updates/。

Operational guidance

examples/、playbooks/、adapters/、docs/、templates/、そして scripts/validate_repo.py による validation。

どう動くか

設計は単純です。読み、まずは編集せずに把握し、小さく更新し、その結果を残します。

初回の使い方

初めて使うときは、次の流れだけで十分です。

1. リポジトリを開く
2. README.md と AGENTS.md を読む
3. current-truth.md、decisions.md、pending.md、next-actions.md、sources.md を読む
4. report-only を実行する
5. bounded safe-update を1回だけ承認する
6. dated update log を追記する
7. 次回はその repo から再開する

examples には、report-only 出力、safe-update 範囲、touched-files、handoff まで具体的に入っています。

何が違うのか

これは単なる prompt pack ではありません。read order、bounded update rules、source-aware claims、append-only history、session restart quality まで含めた operating surface です。

将来の簡易版について

将来的に browser 上で軽く試せる lightweight builder が追加される可能性はあります。ただし主役は今後も repo のままです。

もし簡易版が追加されるなら、project snapshot、decisions、pending、next actions、sources、AI prompts を軽く組み立てて repo 導線につなぐ導入版になる想定です。

FAQ

関連リンク