ref-domain-rubric-template

Purpose & Output Contract

設計書29 §3 の3層階層モデル (L0 共通 / L1 ドメイン / L2 プロジェクト) における L1 (ドメイン特化) rubric の抽象テンプレート。{{domain_name}} 変数を実ドメインに置換するだけで新ドメインの L1 rubric が派生できる。

入力: domain_name (kebab-case、例: task-spec, meeting-minutes, design-doc) 出力: plugins/harness-creator/skills/ref-domain-<domain_name>-rubric/references/rubric.json (L1 rubric 実体) 完了条件: 派生 rubric が schema (version/layer/upstream/rules) を満たし、plugins/skill-governance-config/config/rubric-registry.json に登録されること。

Key Rules

1. L0 を upstream に固定: 派生 rubric は必ず upstream: ["plugins/harness-creator/skills/ref-skill-design-rubric/references/rubric.json"] を含む。
2. layer は L1 固定: L0 / L2 への混在禁止 (設計書29 §10 アンチパターン)。
3. rules は最低1件、ドメイン固有のものに限る: L0 と重複する rule (FM-001 等) を再記述しない。重複は deep-merge で自動継承される。
4. registry 登録必須: plugins/skill-governance-config/config/rubric-registry.json の rubrics[] に新エントリを追加する。

Steps

Step 1: domain_name の決定

kebab-case で命名する。既存 rubric-registry.json の rubrics[].domain と衝突しないことを確認。

Step 2: 雛形コピー

python3 - <<'PY'
from pathlib import Path
import shutil

domain = "task-spec"  # 例
src = Path("plugins/harness-creator/skills/ref-domain-rubric-template")
dst = Path(f"plugins/harness-creator/skills/ref-domain-{domain}-rubric")
shutil.copytree(src, dst)
PY

Step 3: 変数置換

references/rubric.json 内の {{domain_name}} をすべて $DOMAIN に置換し、rules の TODO(human) を実ルールで埋める。

Step 4: registry 登録

plugins/skill-governance-config/config/rubric-registry.json の rubrics[] に以下エントリを追加:

{
  "domain": "<domain_name>",
  "layer": "L1",
  "rubric": "plugins/harness-creator/skills/ref-domain-<domain_name>-rubric/references/rubric.json",
  "description": "<one-line description>",
  "upstream": ["plugins/harness-creator/skills/ref-skill-design-rubric/references/rubric.json"]
}

Step 5: 整合性検証

python3 plugins/skill-governance-lint/scripts/lint-rubric-refs-exist.py
python3 plugins/skill-governance-automation/scripts/compute-rubric-hash.py plugins/harness-creator/skills/ref-domain-${DOMAIN}-rubric/references/rubric.json

Gotchas

• L0 ルールの再記述禁止: deep-merge が L0 から自動継承するため、L1 で書くと二重採点となる。
• threshold_override は慎重に: L0 の threshold=80 を緩める変更は governance 承認が必要 (設計書29 §10)。
• conflict_policy は most-specific-wins 固定推奨: error にすると L0 と key 衝突しただけで起動失敗する。

Additional Resources

• references/rubric.json — L1 抽象テンプレート (変数化済み)
• 設計書29: doc/ClaudeCodeスキルの設計書/29-multi-project-rubric-composition.md
• 具体例: plugins/harness-creator/skills/ref-domain-task-spec-rubric/references/rubric.json