single-file-wbs: Instructions file for Codex

計画・課題管理ツール（WBS Viewer） - AGENTS.md

AI エージェント共通の説明書（Claude Code 2.1.277+・Codex ほか AGENTS.md を読む AI が対象）。旧 CLAUDE.md は 2026-09-24 にこの名前へ統一した（内容は同じ・symlink は置かない）。

English: AGENTS.en.md（本ファイルが正。仕様を変更したら ja/en を同じコミットで更新すること）

テキスト（JSON）駆動の管理ツール。計画（WBS）と課題（Issue）を 1枚の HTML・1つの JSON で回す。 データは「案件（projects[]）の中に 計画（tasks）と課題（issues）が並ぶ」1つの JSON。 つながりは課題側の links[] にだけ書き、画面が逆引きして両方向へ1クリックで飛ぶ。

ファイル	位置づけ
wbs_viewer.html	製品の入口。これを開く。「計画｜課題」の2択スイッチで切り替える（単一HTML・依存ゼロ）
wbs.json	データの single source of truth。計画も課題もここに入る（ファイル名は自由。慣用名が wbs.json）

このファイル1本で、計画（tasks）も課題（issues）も完結する。 工数の式・ガント・イナズマ線・進捗の査定・課題の起票とクローズまで、すべてここに書く（説明書を別ファイルに分けない＝AI が1本読めば済む）。 計画だけの従来の wbs.json（issues が無いファイル）もそのまま開ける（→「後方互換の約束」）。

読む順の目安：共通（ビジョン・原則・環境・画面・編集・データ）→ 計画（計算ロジック・追加と更新）→ 課題（導出値・4つの動き・依頼例）→ 異常系と制限 → 開発運用。

---

製品ビジョン・設計指針

AI時代の管理者（PL／テックリード）が、AIを含む少数精鋭チームを率いるためのローカルな計画表＋課題表。人間はGUIで、AIは素のJSONと AGENTS.md で、同じ1枚を編集する。

• 対象ユーザー：巨大プロジェクトのエンタープライズPMではなく、AIを含む10人規模の少数精鋭を率いる管理者（PL／テックリード）。作者自身がこのペルソナ＝ドッグフーディング。
• ビジョン（賭けと自覚）：AI台頭で少数精鋭がAIを使いこなすのが主流になり、全員がPL/TL化する。そのリード（人間 and PL/TLエージェント）が計画と課題を管理する道具。未来への賭けだが、外れても今日のリードに刺さる＝ヘッジ済み。
• 核の差別化＝2つの第一級インターフェース：人間＝GUI／AI＝素のJSON＋AI可読な AGENTS.md。両方が第一級。全機能が GUI経路 と AI/JSON経路 の両方で動く（カスタムキー保持・round-trip）。
• AGENTS.md は"ドキュメント"でなく"AIのAPI仕様"：AIがフォーマットに依存するため、スキーマはほぼ動かさないを厳守。変える時は読む側の後方互換を保ち、AGENTS.md／AGENTS.en.md を同時に更新する。
• 1つの入口で完結させる：AI は別リポの説明書を読めない。計画も課題も本ファイル1本に書き、参照は文書内で完結させる。
• 正本ルール＝リポ単位で宣言・1リポ1正本：課題の置き場をリポジトリごとに1つだけ決めて宣言する。GitHub Issue と課題表を混ぜない（どちらが本当か分からなくなる）。宣言は各リポの AGENTS.md に書く（本リポの宣言は末尾の「このリポの正本」節）。
• 作る：事実だけを持つデータ（状態は導出）／載せる規律を支える欄（二つの問い・完了条件）／止まっている理由が必ず添う「待ち」と「凍結」／AIネイティブ（進捗査定・依存推定）／担当別の負荷（人間 vs AI の内訳）／コスト（_ai トークン・_money）／誠実なview（見栄えでなく真実の状態）。
• 作らない：エンタープライズなチケット管理／エンタープライズPM（ポートフォリオ・複雑権限）／ワークフロー・承認フロー／大規模リアルタイム協業／通知・外部送信／自動集計レポート。
• 意味論の出典 → 課題管理とはなにか？
• 計画側の背景の論考 → WBSという至高ツールで、このAI時代をサバイブする