cross-project-group.v1 Schema

Phase 65.3 (Cross-Project Group + 3-Layer Redaction) で導入。 .claude/rules/cross-project-groups.yaml のスキーマ仕様。

目的

Plan Brief / Acceptance Demo / Progress Tracker などの client 側 skill が、 横断プロジェクト検索を opt-in で有効化するためのグループ定義 SSOT。

横断検索は default 無効。--cross-project-group <name> flag で 明示的に group 名を指定した場合のみ、その group の member projects に 対して mcp__harness__harness_mem_search を発行する。

スキーマ

schema_version: cross-project-group.v1

groups:
  - name: <string>            # group 識別子
    description: <string?>    # 任意 (group の用途説明)
    members:                  # 配列、要素 unique、空 OK
      - <string>              # member project 名
      - <string>

制約

フィールド	型	必須	制約
schema_version	string	✓	cross-project-group.v1 固定
groups	array	✓	空配列 [] 可
groups[].name	string	✓	groups 内で unique、空文字不可
groups[].description	string	optional	任意
groups[].members	array	✓	配列、要素 unique、空 OK
groups[].members[]	string	-	空文字不可、重複不可

バリデーション

scripts/load-cross-project-groups.sh が yaml をパースし、 不正な schema を検出した場合は exit 1 で停止する。

検出する不正:

1. schema_version 不一致 (cross-project-group.v1 以外)
2. groups が array でない
3. groups[].name 欠損 / 空文字 / 重複
4. groups[].members が array でない / 要素重複 / 空文字
5. groups[].members[] が string でない

利用例

CLI (loader script 直接呼び出し)

# 全 groups を JSON で出力
bash scripts/load-cross-project-groups.sh

# 特定 group の members を JSON array で出力
bash scripts/load-cross-project-groups.sh --group "Personal Tools"
# → ["my-cli","my-dotfiles","my-scripts"]

# 存在しない group は exit 1
bash scripts/load-cross-project-groups.sh --group "Unknown"
# → stderr: "group not found: Unknown" / exit 1

Skill 経由 (Phase 65.3.5 で実装予定)

# 横断検索なし (default、現プロジェクトのみ)
/harness-plan-brief "新しい CI を導入したい"

# 横断検索 opt-in (Personal Tools group の全 members を検索)
/harness-plan-brief "新しい CI を導入したい" --cross-project-group "Personal Tools"

Cross-Project Search の実装 (D43 Option α)

client skill (Plan Brief / Accept / Progress)
   │
   │ --cross-project-group <name>
   ▼
load-cross-project-groups.sh --group <name>
   │
   │ JSON array of member projects
   ▼
For each member in members:
   mcp__harness__harness_mem_search(project=member, ...)
   │
   ▼
client 側でマージ・dedupe (relevance_score 順)
   │
   ▼
Layer 2 (dict + NER) で固有名詞 redact
   │
   ▼
Layer 3 (final scan) で残骸検出 → 0 件なら HTML 生成、検出なら exit 1

詳細な責任境界は .claude/rules/cross-repo-handoff.md の 「3 層 Redaction の責任境界」と「Phase 65.3 実装決定事項 (D43)」を参照。

関連

• .claude/rules/cross-project-groups.yaml — 本 schema の SSOT (default groups: [])
• scripts/load-cross-project-groups.sh — yaml → JSON parser + validator
• tests/test-cross-project-groups-schema.sh — 4 ケース機械検証
• .claude/rules/cross-repo-handoff.md — Phase 65.3 実装決定事項 (D43)
• .claude/rules/client-redaction.yaml — Layer 2a 辞書 (Phase 65.3.2 で導入予定)
• Plans.md §65.3.1-65.3.7 — Phase C 全タスク