ワークスペース構成の最適化 — 現在と今後 (v3)

全数調査（エージェント11体・リポジトリ17個・コマンド17個・過去の不満52件）に基づく比較提案。v3 反映: 個別監修カテゴリ新設 / 全エージェントに日本語別名・略称 / ギルドマスターの /gm コマンド化。

11 → 15
エージェント（維持8・起動3・新設4）
7分類
品質 / 事実 / 設計 / デザイン / 個別監修 / 対話 / 統括
8 / 6 / 3
リポジトリ: 稼働 / 休眠 / 要整理
A/B/C
ドキュメント3カテゴリの命名規約を新設

1エージェント構成 — カテゴリ別レビュー（現在11体 → 今後15体）

評価: S/A=稼働・B=休眠（定義のみ）・紫=新設。全員に日本語別名・略称を付与（この名前で呼び出せるよう定義に登録する）。

カテゴリエージェント別名／略称役割（ひとこと）評価今後
品質ゲート
実装の正しさ		 verifier検証員テスト・型・ビルドの実行検証A維持 /post-impl 組込済
code-reviewer査読官セキュリティ・設計レビュー（OWASP/SOLID）A+維持 強化済
visual-verifier ★目視官スクショを「見て」述語判定する視覚検証専任・複数状態全回し新設新設 不満最多「見た目未確認」13件対策
test-env-reviewer環境診断士テスト環境自体の信頼性診断（見せかけPASS検出）B 休眠起動 「PASS なのに実バグ」時の必須相談化
事実・規律
嘘と近道を止める		 discipline-keeper風紀委員ルール遵守の門番（3回fix・verify省略・完了宣言）S維持 最重要・変更なし
fact-auditor ★監査役／ファクトAI の虚偽・数値矛盾・根拠なき成功宣言を証拠と突き合わせて検出新設新設 報告内の全数値・SHA・「済み」を再検証
設計・計画
作る前に考える		 analystアナリスト実装前の要件・スコープ・エッジケース整理A強化 新機能・3ステップ超で必須化
test-planner ★試験設計士／テスプラアプリの設計・コンセプト・ターゲット理解に基づく「何を検証すべきか」の設計（受け入れ基準の述語化）新設新設 verifier（実行）との分業。testing-standard の運用者
claude-code-strategy-consultant軍師エージェント構成のコスト・リスク監査B 休眠起動 構成変更時の必須相談化
デザイン
見せ方の正しさ		 information-designer情報設計士UI 情報設計レビュー（階層・グルーピング・認知負荷）— 全アプリ共通B 休眠起動 デザイン承認ゲート役を明文化
個別監修
特定プロジェクト
専属の専門家		 jazz-arranger譜面監修譜面記譜の正しさレビュー — PJ_RSO / HexaScorix 専属A維持 汎用ではないため本カテゴリへ
prototype-librarianプロト司書プロトタイプの最新版管理 — PJ_RSO / YAWEB / PEDAL 専属A維持 同上（3PJ 限定のため）
対話
ユーザーへの声		 secretary秘書ユーザー向け発話の文体・要否ゲートA維持 REVISED 率計測継続
統括・運営
全体を回す		 workspace-auditor巡回監査ドキュメント間矛盾の毎日監査 + ドキュメント命名規約の監視（兼任追加）A拡張 §4 の命名規約チェックを兼任
guild-master ★ギルドマスター／ギルマス依頼内容から必要エージェントの編成を返す司令塔。/gm コマンドで即呼び出し新設新設 エージェント増加時代の入口
個別監修カテゴリの意図: 全アプリで使える汎用エージェントと、特定プロジェクト専属の専門家を分けた。プロジェクトが増えて専属監修者が必要になったら（例: 会計監修 for FREEE）、このカテゴリに追加していく。
別名の使い方: 「風紀委員に聞いて」「ギルマス呼んで」のように日本語名でも呼び出せるよう、各エージェント定義の説明文に別名を登録する（Phase 1 で実装）。

2新設4体の設計（役割の境界と呼ばれ方）

visual-verifier — 視覚検証専任 UI 変更の verify で、スクリーンショットを画像として読み「行 A に B が重なっていないか」を Yes/No 述語で判定。初期表示 / モーダル開 / モバイル幅 / ダーク等の複数状態を全回しし、判定ログを discipline-keeper の citation に渡す。
根拠: 不満最多13件（PJ_RSO #015 の60ラウンド手戻り・L-015「最後に1枚を目で見る」の機械化）。数値 PASS と見た目 OK は別物。
test-planner — テスト観点の設計者 実装前・機能追加時に、アプリの設計思想・コンセプト・ターゲットユーザーを HANDOFF/spec から読み込み、「このアプリにとって壊れたら致命的な動線は何か」の観点で受け入れ基準を述語化する。verifier（実行）・test-env-reviewer（環境の信頼性）とは分業:
planner=何を検証すべきか / verifier=実行 / env-reviewer=検証環境自体の健全性
根拠: testing-standard.md（期待値の述語化・user-action contract chain）は存在するが運用する主体が不在。fixture が実ユースと乖離（PJ_RSO #015 #020）の再発防止。
fact-auditor — 事実監査役 ユーザー向け報告の直前に、報告内の事実主張を証拠と突き合わせて検証: 数値（「テスト127件パス」→ 実行ログ確認）・commit SHA（実在するか）・「push 済み」「deploy 済み」（実際の状態確認）・数値同士の矛盾（合計が合わない等）。虚偽・確認不能・矛盾を BLOCK/WARN で返す。
根拠: 「audit 4/4 PASS でも本番バグ」（#016）・false fix 宣言 10 連続（saga #017）。secretary は文体を見るが事実は見ない — その空白を埋める。
guild-master（ギルマス）— 編成の司令塔 依頼を投げると「このタスクに必須のゲート / 推奨の相談先 / 並列可否」の編成表を返す。SSOT は .claude/agents/ の定義集で、CLAUDE.md の必須相談表が肥大するのを止める受け皿にもなる。
/gm <依頼内容> のカスタムコマンドで即呼び出し可能にする（例: /gm PJ_RSO の印刷レイアウトを直したい → 編成表が返る）。
呼ぶ場面: 複数エージェントが絡みそうな非自明タスクの冒頭 / 編成に迷ったとき / 新メンバー追加後の見直し。軽いタスクでは主エージェントが直接判断（毎回の強制経由点にはしない）。
根拠: エージェント15体・今後も増加見込みで、割り当て知識が CLAUDE.md の表と主エージェントの記憶に依存している。

報告が届くまでの品質パイプライン（今後）

実装・検証→ fact-auditor（事実の検証）→ secretary（文体・要否）→ ユーザー ※ fact-auditor は数値・成功宣言を含む完了報告のみ（全発話ではない — コスト管理）

3過去の不満・修正指示 52件 → 対応マップ

全リポジトリの lessons.md・bug-log・USER_PROFILE から採掘。棒の長さ＝出現件数。

① 検証不足（見た目を見ない・全件回さない）
13件
→ visual-verifier + test-planner
④ 手戻り（想像実装・spec無視・表面修正）
11件
→ analyst 必須化 + discipline-keeper
⑤ 運用（過剰確認・audit盲信・虚偽の成功宣言）
10件
→ fact-auditor + test-env-reviewer 起動
③ デザイン/記譜（承認スキップ・細部詰め不足）
7件
→ information-designer 起動
② 報告文体（冗長・専門用語・URL形式）
6件
→ secretary 対応済み・計測継続
⑥ その他（fail-open・state同期）
5件
→ テスト機械化 + test-planner

4ドキュメント管理ルール（新設）— 番号管理の立て直し

現状: 00〜18 の番号付きガイドの横に wrap-typography-guide 等の無番号ファイルが直置きされ始め、規約が事実上崩壊。マスタ番号管理は維持し、3カテゴリで再定義する。SSOT は 05_DOCUMENT_ARCHITECTURE.md。

カテゴリ命名対象例ルール
A: 番号付きガイドNN_UPPER_SNAKE.md恒久的な参照ガイド・ポリシー（ワークスペースの「法律」）15_USER_PROFILE / 17_WORKTREE_PLAYBOOK新規は次の空き番号を採番。欠番は再利用しない。番号は登録順（読み順ではない）
B: 生きた記録無番号・固定名常時更新されるログ・台帳HANDOFF / engineering-lessons / security-audit-log / CONFIRMATION_RULES例外リストを 05 に明記して管理（リスト外の無番号直置きは違反）
C: 派生・成果物サブフォルダ + トピック名（日付可）説明資料・調査・プロジェクト付随物docs/explain/*.html / research/ / projects/00.aimd 直下に置かない。置き場所は用途別サブフォルダ
監視は workspace-auditor が兼任（ユーザー案どおり・新エージェント不要）: Layer 2 に「00.aimd 直下の .md は A の命名規則 or B の例外リストに合致すること」の機械チェックを追加。違反は毎日の /spj-full 監査で WARN。既存の逸脱（wrap-typography-guide.md）は初回適用時に番号化 or docs/ へ移動を提案。

5リポジトリ構成

現在

  • 17 ディレクトリが区別なく並ぶ（git 15 + 非git 2）
  • 活動は PJ_RSO + wmap に集中（直近90日 commit の 78%）
  • 60日以上 commit のない休眠 6 個も毎回同列に表示
  • SEF / TANGO は git 未管理のまま素性が不明瞭
  • YASNS はトークン失効で同期も止まっている
→

6スキル / コマンド構成

現在

  • 中核 5: spj / spj-full / save-project / save-all / post-impl
  • 条件付き現役 4: promote-lessons / proto-index / audit-workspace / userflow
  • 使用形跡が薄い 8: audit-stats / secretary-stats / analyze-permissions / audit-rules / update-ga4 / update-confirmation-rules-notion / review-user-profile / comfyui
  • プラグイン10個は使用率が測れない
→

7全体の Before / After

観点現在今後効果
エージェント11体（3体休眠・分類なし・英名のみ）15体・7分類・日本語別名付き（起動3 + 新設4: 目視官 / 試験設計士 / 監査役 / ギルマス）不満上位パターン全てに担当ゲートが付く
検証数値中心・「何をテストすべきか」の設計者不在test-planner が観点設計 → verifier 実行 → visual-verifier が見た目判定「数値PASSだが壊れてる」「fixture が実ユースと乖離」を遮断
報告の信頼性文体は secretary が見るが、事実は自己申告fact-auditor が数値・SHA・成功宣言を証拠と突き合わせてから secretary へAI の虚偽・数値矛盾を構造的に検出
編成どのエージェントを呼ぶかは CLAUDE.md の表と記憶頼みguild-master が依頼から編成表を返すエージェント増加に耐える入口ができる
ドキュメント番号管理が事実上崩壊（無番号直置きが増加）A/B/C 3カテゴリ規約 + workspace-auditor が毎日機械監視マスタ番号管理の復旧と維持
リポジトリ17個が同列・休眠が埋もれる稼働8 / 休眠6 / 整理3・自動判定毎セッションの認知負荷減
コマンド17個・使用率不明のまま堆積中核9 + 計測に基づく統合/廃止迷わない一覧に

8実施ロードマップ（3段階）

Phase 1 — 今週（エージェント整備）

  • 新設4体の定義作成（visual-verifier / test-planner / fact-auditor / guild-master）
  • /gm コマンド新設（ギルマス即時呼び出し）+ 全15体に日本語別名を定義登録
  • 休眠3体のトリガを CLAUDE.md に追記（B → A 化）
  • analyst の実装前必須条件を明文化
  • 軍師（strategy-consultant）で新構成のコストレビュー（15体体制の検収）

Phase 2 — 2週間以内（ルールと計測）

  • ドキュメント A/B/C 規約を 05_DOCUMENT_ARCHITECTURE.md に制定 + workspace-auditor に機械チェック追加
  • 既存逸脱ファイルの番号化 or 移動
  • コマンド使用率の集計 → 12個の keep/merge/retire 確定・comfyui 判定
  • fact-auditor / visual-verifier の効果測定開始

Phase 3 — 1ヶ月以内（構成整理）

  • 休眠 6 リポジトリのステータス明記 + /spj 折りたたみ
  • SEF アーカイブ / TANGO 管理方針決定
  • 90日無活動の自動休眠判定を監査に追加
  • guild-master の編成精度レビュー（実運用1ヶ月分）

出典: .claude/agents/ 全11定義・audit-log.jsonl・全リポジトリの docs/bug-log.md / tasks/lessons.md・00.aimd/15_USER_PROFILE.md・engineering-lessons.md・git log 実測（2026-07-03 調査）。v2 反映: ユーザーフィードバック 2026-07-03（カテゴリ分類・test-planner・ドキュメント規約・guild-master・fact-auditor）。