core-rule-maintenance

name	core-rule-maintenance
description	CLAUDE.md/AGENTS.md等のコアルールファイルの保守・更新を対話で行い、3環境同期と整合性を維持したまま反映する。CLAUDE.md更新、コアルール変更、ルール追加、パス辞書更新、ワークフロー索引更新を依頼されたときに使用する。

Core Rule Maintenance Workflow

対象ファイル

ファイル	役割	同期先
CLAUDE.md	コア原則、成果物タイプ、品質ゴール、Skill選択ポリシー、WF索引、パス辞書	.cursor/.claude/.codex
AGENTS.md	エージェント定義（Cursor専用、非同期）	.cursor のみ

Instructions

1. Preflight:

   • ドキュメント精査原則（Preflight必須）：変更前に必ず以下を実施すること。
     • 現在のCLAUDE.md/AGENTS.mdを全て読み込む。
     • 変更依頼の背景・理由・期待される効果を確認する。
     • 影響を受けるSkills/Subagentsを特定する。
     • これらを完了するまで変更を開始しない。
   • 変更対象（section=コア原則/成果物タイプ/品質ゴール/WF索引/パス辞書等）、変更範囲、理由を確認する（推測しない）。
   • ./assets/claude_md_structure.md を参照し、CLAUDE.mdの構造を把握する（テンプレートファースト）。

2. 変更種別の判断:

   • 以下の変更種別を特定し、それぞれの手順に従う:
     • Section 1-5 変更: コア原則/成果物タイプ/品質ゴール/Skill選択ポリシー/成果物分類
     • Section 6 変更: ワークフロー索引（WF連携マップ）
     • Section 7 変更: パス辞書（root/dirs/patterns/meta）
     • 複合変更: 複数セクションにまたがる変更

3. 生成（変更実施）:

   • ./questions/core_rule_maintenance_questions.md に従い入力を確定する。
   • 既存の構造・フォーマットを崩さない（最小差分で修正）。
   • CLAUDE.mdの必須セクション区切りを維持する。
   • 変更内容:
     • WF索引変更時: 該当フェーズに追記/修正、矢印（→）で連携を表現
     • パス辞書変更時: dirs/patterns/metaの適切な箇所に追記、変数参照の整合性を確認
     • コア原則変更時: 全Skillsへの影響を確認し、必要なら各SKILL.mdとtriggersも更新する
     • Skill運用ルール変更時: 「Skillは原則必須」「どうしてもskillsに該当がない場合のみ省略可」「Skill完了後はtriggersで次へ必ず進む」などの運用原則は、必ずCLAUDE.mdの ## 1. コア原則 に記載する（Section 4だけに置かない）

4. 整合性チェック:

   • パス辞書変更時:
     • 変数参照（{{patterns.xxx}}等）が正しく解決されることを確認
     • 循環参照がないことを確認
     • 実際のファイルパスとして有効であることを確認
   • WF索引変更時:
     • 参照先Skillが存在することを確認
     • 連携フロー（→）の整合性を確認
     • 各SkillのNext Action triggersと整合していることを確認

5. 3環境同期（Skills/Assets統一）:

   • CLAUDE.md変更後は python3 scripts/update_agent_master.py --source claude --force で同期を実施する（Claude起点）。
   • 同期内容: CLAUDE.mdからAGENTS.md等の派生ルールを再生成し、.claude/skills / .claude/commands を各環境へ同期する（SKILL.md だけでなく assets/ questions/ evaluation/ triggers/ scripts/ も含めて統一する）。
   • 備考: .cursor/.codex/.opencode/.github 側のskillsを直接編集しない（起点で変更→同期で統一）。AGENTS.mdは生成対象だが、Cursor専用の運用ファイルとして扱う（手動で直接編集しない）。

6. QC（必須）:

   • ./evaluation/evaluation_criteria.md を参照し、以下を自己評価する:
     • 必須セクション維持
     • パス辞書の変数参照整合性
     • WF索引とSkillsのNext Action triggers整合性
     • 3環境同期の実施
   • 評価結果を成果物末尾に追記する（修正有無/理由）。
   • 重大な問題がある場合は修正し、再評価する（最大3回）。

7. バックログ反映:

   • 次アクション（影響Skillsの更新、レビュー依頼等）を抽出しバックログへ反映する。
   • 反映先・編集制約・差分提示は AGENTS.md / CLAUDE.md の全体ルールに従う。

subagent_policy:

• 単なる評価目的のqa-xxxサブエージェントはAgents/に作成しない
• 評価は ./evaluation/evaluation_criteria.md を参照したインライン評価を基本とする
• ただし変更が広範/高リスク、またはユーザー要望がある場合は qa-skill-qc / red-team-feedback-loop 等の既存Subagentを並列実行してレビュー強度を上げてもよい（新規Agent作成はしない）

Resources

• questions: ./questions/core_rule_maintenance_questions.md
• assets: ./assets/claude_md_structure.md
• assets: ./assets/path_dictionary_guide.md
• assets: ./assets/workflow_index_guide.md
• evaluation: ./evaluation/evaluation_criteria.md
• triggers: ./triggers/next_action_triggers.md
• scripts: scripts/update_agent_master.py

Next Action

• triggers: ./triggers/next_action_triggers.md

起動条件に従い、条件を満たすSkillを自動実行する。