Skip to content

docs: TVFプロトコル4層設計反映 (cmd_510 v2 / cmd_517)#157

Closed
ysaitogrander wants to merge 1 commit into
yohey-w:mainfrom
ysaitogrander:docs/cmd_517_tvf_protocol
Closed

docs: TVFプロトコル4層設計反映 (cmd_510 v2 / cmd_517)#157
ysaitogrander wants to merge 1 commit into
yohey-w:mainfrom
ysaitogrander:docs/cmd_517_tvf_protocol

Conversation

@ysaitogrander

Copy link
Copy Markdown
Contributor

概要

軍師 cmd_510 v2 で策定された TVF (Task Verification First / 事実検証ファースト) プロトコル 4 層設計を CLAUDE.md および instructions/roles/* に反映する文書追記。

Lord の前提主張と外部実態(Figma / 仕様書 / 外部API 等)の乖離による誤実装を未然に防ぐ仕組みとして全エージェントに義務化する。

  • cmd_517 (足軽7号 5/25 18:46): 文書追記実装(commit禁止状態で家老/殿レビュー待ち)
  • cmd_529-D (殿の発令OK 5/26 13:25): 本PRで commit/push/PR作成

TVF プロトコル 4 層設計

役割 担当 反映先
A 指示テンプレ4ブロック必須化 Karo instructions/roles/karo_role.md
B self-check(実装前の事実確認) Ashigaru instructions/roles/ashigaru_role.md
C report テンプレに purpose_gap 必須化 Ashigaru → Gunshi → Karo CLAUDE.md + ashigaru_role.md
D サブエージェント種別整合性チェック Ashigaru instructions/roles/ashigaru_role.md

変更ファイル

Source templates (3 ファイル)

  • CLAUDE.md — TVF Protocol 横断ルール節(4層構造 + purpose_gap 必須化 + skill 連携)
  • instructions/roles/karo_role.md — 家老指示テンプレ 4ブロック (tvf_protocol YAML)
  • instructions/roles/ashigaru_role.md
    • Report Format に purpose_gap フィールド必須化(TVF Protocol C)
    • TVF(事実検証ファースト)プロトコル節(Self-check + サブエージェント自動チェック)

Generated files (11 ファイル、build_instructions.sh で自動展開)

  • instructions/generated/{ashigaru,karo}.md
  • instructions/generated/{codex,copilot,kimi}-{ashigaru,karo}.md
  • AGENTS.md (Codex auto-load)
  • .github/copilot-instructions.md (Copilot auto-load)
  • agents/default/system.md (Kimi auto-load)

検証

  • bash scripts/build_instructions.sh 成功
  • ✅ 冪等性確認: 2 回連続実行で git diff 差分なし
  • git diff --exit-code instructions/generated/ 相当のドリフトなし(コミット時点)
  • ✅ TVF / purpose_gap キーワードが全 generated ファイルへ展開済

関連 skill 候補(軍師 cmd_510 v2 提案・採用判断は殿)

  • 🥇 figma-fresh-fetch-guard — Pre-PR hook で 48h 以内取得証跡を必須化(High推奨
  • 🥈 figma-component-type-checker — Figma 種別と実装 UI の差分自動検知(Med-High)
  • 🥉 lord-assumption-verifier — Lord 指示の事実主張を自動検証(Med → High 昇格推奨

関連

  • 軍師 cmd_510 v2: TVF プロトコル設計(2026-05-25 16:41)
  • cmd_517: ソース文書追記(足軽7号 2026-05-25 18:46、commit禁止で待機)
  • cmd_529-D: 本 PR で commit/push/PR 作成(殿の発令 OK 2026-05-26 13:25 受領後)

Test plan

  • PR レビューで TVF プロトコルの文言が殿の意図と一致するか確認
  • generated/ ファイルがソーステンプレと一致していることを確認(CI「Build Instructions Check」相当)
  • マージ後、次回 Figma 準拠タスク発令時に家老テンプレが守られるかを確認

🤖 Generated with Claude Code

…517)

軍師 cmd_510 v2 で策定された TVF (Task Verification First / 事実検証ファースト)
プロトコル 4 層設計を、Lord の前提主張と外部実態(Figma / 仕様書 / 外部API 等)の
乖離による誤実装を未然に防ぐ仕組みとして全エージェントに義務化。

■ 反映先 (source templates)
- CLAUDE.md: TVF Protocol 横断ルール節(4層構造 + purpose_gap 必須化 + skill 連携)
- instructions/roles/karo_role.md: 家老指示テンプレ 4ブロック (tvf_protocol YAML)
- instructions/roles/ashigaru_role.md:
    - Report Format に purpose_gap フィールド必須化 (TVF Protocol C)
    - TVF (事実検証ファースト) プロトコル節 (Self-check + サブエージェント自動チェック)

■ 自動展開 (generated files)
- scripts/build_instructions.sh により以下が自動再生成
- instructions/generated/{ashigaru,karo}.md
- instructions/generated/{codex,copilot,kimi}-{ashigaru,karo}.md
- AGENTS.md (Codex auto-load)
- .github/copilot-instructions.md (Copilot auto-load)
- agents/default/system.md (Kimi auto-load)
- 冪等性確認済 (build_instructions.sh 2回連続実行で diff なし)

■ 関連 skill 候補(軍師 cmd_510 v2 提案・採用判断は殿)
- figma-fresh-fetch-guard (High)
- figma-component-type-checker (Med-High)
- lord-assumption-verifier (High推奨へ昇格)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ysaitogrander

Copy link
Copy Markdown
Contributor Author

誤って upstream リポジトリ (yohey-w) を base にしてしまったため close。origin (ysaitogrander) に再作成。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant