single-file-wbs: Instructions file for Claude Code

WBS ツール - CLAUDE.md

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

テキスト（JSON）駆動の WBS／ガント＋イナズマ線ツール。 wbs.json（データ）を single source of truth とし、JS内蔵の単一HTML wbs_viewer.html が描画する。

---

製品ビジョン・設計指針（#67）

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

• 対象ユーザー：巨大プロジェクトのエンタープライズPMではなく、AIを含む10人規模の少数精鋭を率いる管理者（PL／テックリード）。作者自身がこのペルソナ＝ドッグフーディング。
• ビジョン（賭けと自覚）：AI台頭で少数精鋭がAIを使いこなすのが主流になり、全員がPL/TL化する。そのリード（人間 and PL/TLエージェント）が計画を管理する道具。未来への賭けだが、外れても今日のリードに刺さる＝ヘッジ済み。
• 核の差別化＝2つの第一級インターフェース：人間＝GUI／AI＝素のJSON＋AI可読な CLAUDE.md。両方が第一級。全機能が GUI経路 と AI/JSON経路 の両方で動く（カスタムキー保持・round-trip）。
• CLAUDE.md は"ドキュメント"でなく"AIのAPI仕様"：AIがフォーマットに依存するため、スキーマはほぼ動かさないを厳守。
• 作る：AIネイティブ（進捗査定・依存推定）／誠実なview（見栄えでなく真実の状態）／担当別の負荷（人間 vs AI の内訳）／コスト（_aiトークン・_money）。
• 作らない：エンタープライズPM（ポートフォリオ・複雑権限）／大規模リアルタイム協業／重いワークフローエンジン／承認フロー。
• 背景の論考 → WBSという至高ツールで、このAI時代をサバイブする

---

取り扱いの原則（重要）

• wbs_viewer.html（ビューア）は原則さわらない。 表示ロジックは完成済み。
• 変更は wbs.json（データ）の編集のみ。 AI に作業を頼むときも、原則 JSON を直す。
  • 表示仕様そのものを変えたい場合に限り HTML を触る（その時は明示的に依頼）。

アーカイブ運用（過去タスクの整理）

項目が増えすぎないよう、古い完了タスクは current から退避する：

• トリガー：ガントの表示が進み、過去の月（例：2026年5月以前）の完了タスクが 「過去日付以前」になったら実施。
• 手順：
  1. 同じフォルダ内にバックアップを作成（例：wbs-archive-2026-05.json に退避分をまとめる）。
  2. wbs.json から該当の実施済み（完了）タスクを削除する。
• → current の wbs.json は「今と未来」に集中。履歴はアーカイブ JSON に保全。
• 大量項目対策は 折りたたみ（表示）＋このアーカイブ運用（データ） の二段で行う。

---

動作環境

• Google Chrome（最新版）推奨。Edge 等の Chromium 系でも動作（検証は Chrome で実施）。Firefox/Safari は不可（File System Access API 未対応）。
• 会社管理ブラウザはポリシーで File System Access が無効だと編集不可（閲覧は可）。
• HTTPサーバー不要・外部ライブラリ/CDN不要。wbs_viewer.html を file:// でそのまま開く。

開き方・更新

1. Chrome で wbs_viewer.html を開く。
2. 「ファイルを開く」 で wbs.json を選ぶ（同じボタンへのドラッグ&ドロップでも読み込める）。
3. wbs.json を編集して保存 → 「更新」ボタンで再読込・再描画（再選択不要 / File System Access API）。
4. 折りたたみ：◆プロジェクト・1L・2L の ▼/▶〜名前をクリック。 作業項目ヘッダの ▼/▶ で全展開/全たたみ（▼=全部開いている→押すと全たたみ／▶=どこか閉じている→押すと全展開）。 ヘッダ操作の誤りは Ctrl+Z で直前の表示状態に復元（入力フォーカス中は無効）。
5. スクロール位置は折りたたみ・更新では保持、新規ファイル読込時のみ本日へセンタリング＋折りたたみリセット。