AGENTS.md - AI 協定プロトコル
「あなたがこのドキュメントを読んでいるなら、あなたこそがインテリジェンスです。」
このファイルはあなたのアンカーです。プロジェクトの法則、領土の地図、記憶プロトコルを定義します。 起動時（新しいセッションを開始したとき）は、まずこのファイルを読んでください。
🧠 30秒復帰プロトコル (Quick Recovery)
新しいセッションを開始したとき、または「迷子」になったと感じたときは、すぐに実行:
- ルートの AGENTS.md を読む → プロジェクトの地図を取得
- 下の「現在の状態」を確認 → 最新のアーキテクチャバージョンを見つける
.anws/v{N}/05_TASKS.mdを読む → 現在のタスクを把握- 作業を開始する
🗺️ 地図 (領域認識)
このプロジェクトの構成は次の通りです：
| パス | 説明 | アクセスプロトコル |
|---|---|---|
src/ | 実装層。実際のコードベース。 | Task で読み書き。 |
.anws/ | 統一アーキテクチャルート。バージョン管理されたアーキテクチャ状態とアップグレード記録を含む。 | 読み取り専用(旧版) / 1回書き込み(新版) / changelog は CLI が管理。 |
.anws/v{N}/ | 現在の真理。最新のアーキテクチャ定義。 | 常に最大の v{N} を探す。 |
.anws/changelog/ | アップグレード記録。anws update で生成される変更記録。 | CLI が自動管理、削除禁止。 |
target-specific workflow projection | ワークフロー。/genesis, /blueprint など。 | 現在のターゲットに対応するネイティブ投影ファイルを読む。 |
target-specific skill projection | スキルライブラリ。アトミックな能力。 | 現在のターゲットに対応するネイティブ投影ファイルを呼び出す。 |
.nexus-map/ | ナレッジベース。コードベース構造マッピング。 | nexus-mapper によって生成される。 |
🛠️ ワークフローレジストリ
[!IMPORTANT] ワークフロー優先の原則: タスクがいずれかのワークフローに一致する場合、またはタスクがワークフローの適用シーンに明らかに、基本的に、あるいは該当する可能性があると判断した場合、必ず最初に対応ファイルを読み込み、その手順に厳密に従って実行してください。ワークフローは慎重に設計されたプロトコルであり、オプションの参考資料ではありません。
トリガーフロー:
- ユーザーがワークフロー名に言及した場合、またはタスクがワークフローの適用シーンに明らかに、基本的に、あるいは該当する可能性があると判断した場合、必ず最初に対応ファイルを読み込む
- 直ちに対応するワークフローファイルを読み込む
- ワークフローの手順に厳密に従って実行する
- チェックポイントで一時停止し、ユーザーの確認を待つ
| ワークフロー | トリガー条件 | 成果物 |
|---|---|---|
/quickstart | 新規ユーザーのエントリポイント / どこから始めればよいかわからない | 他のワークフローのオーケストレーション |
/genesis | 新規プロジェクト / 大規模リファクタリング | PRD, Architecture, ADRs |
/probe | 変更前 / プロジェクト引き継ぎ | .anws/v{N}/00_PROBE_REPORT.md |
/design-system | genesis の後 | 04_SYSTEM_DESIGN/*.md |
/blueprint | genesis の後 | 05_TASKS.md + AGENTS.md 初期 Wave |
/change | 既存タスクの微調整 | TASKS + SYSTEM_DESIGN (変更のみ) + CHANGELOG の更新 |
/explore | 調査時 | 調査レポート |
/challenge | 決定前の疑問提起 | 07_CHALLENGE_REPORT.md (質問一覧目次を含む) |
/forge | コーディング実行 | コード + AGENTS.md Wave ブロックの更新 |
/craft | ワークフロー/スキル/プロンプトの作成 | Workflow / Skill / Prompt ドキュメント |
/upgrade | anws update 後のアップグレードオーケストレーション | Minor / Major を判断し、/change または /genesis にルーティング |
📜 憲法 (The Constitution)
- バージョンが法律: アーキテクチャ文書は「修正」せず、「進化」させる。変更は新しいバージョンを作成しなければならない。
- 明示的なコンテキスト: 決定は ADR に書き、チャットの記憶に残さない。
- 相互検証: コーディング前に
05_TASKS.mdを確認する。自分が計画されたことをやっているか？ - 美学: ドキュメントは美しくあるべき。Markdown と絵文字を活用せよ。
🔄 プロジェクト状態保持ゾーン
📍 現在の状態 (ワークフローにより自動更新)
注意: これはプロジェクトファイルの保持部分であり、
/genesis、/blueprint、/forgeによって自動維持されます。
- 最新アーキテクチャバージョン:
.anws/v1 - アクティブタスクリスト:
.anws/v1/05_TASKS.md - 未完了タスク数: 0件のブロッキング実装タスク；現在は最終的な人手によるレビューフェーズ
- 最終更新:
2026-03-16
🌊 Wave 1 — Guided Core + Replay メインチェーン完了
start / step / replayCLI メインパス完了- 自動保存、
final.md、replay.md、カレントディレクトリへのエクスポート完了 verifyワンクリック検証チェーン完了.windsurf/skills/sequential-thinking/SKILL.mdとskills/sequential-thinking-skills/SKILL.mdへの CLI プロトコル書き戻し完了- 現在の状態：最終人手レビューと提出準備の可否を待機中
🌳 プロジェクト構造 (Project Tree)
注意: この部分は
/genesisによって維持されます。
src/
└── anws/
├── bin/cli.js
├── lib/ (init, update, diff, changelog, copy, manifest, ...)
└── templates/
├── .agents/ (内部正規テンプレートソース、projection により各ターゲットに配信)
└── AGENTS.md
.anws/
├── changelog/ (アップグレード記録)
└── v{N}/ (現在のアーキテクチャ文書)
🧭 ナビゲーションガイド (Navigation Guide)
注意: この部分は
/genesisによって維持されます。
- 新しいアーキテクチャが準備できるまで: 大規模なコード変更は行わないでください。
- アーキテクチャ概要:
.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md - ADR:
.anws/v{N}/03_ADR/(システム横断的な決定の唯一の記録源) - アーキテクチャに関する問題:
.anws/v{N}/03_ADR/を参照してください。
技術スタック決定
- [.anws/tech-evaluator または /genesis により自動入力]
システム境界
- [.anws/system-architect または /genesis により自動入力]
アクティブ ADR
- [.anws により ADR サマリーを自動入力]
現在のタスク状態
T4.3.1完了T1.3.1完了pnpm typecheck / test / build / verify全て合格- 現在は自動 Git コミットを行わず、人手による確認を待機中
状態セルフチェック: 準備はできましたか？ユーザーに
/quickstartを実行して開始するよう促してください。