# Core Rule Maintenance

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

- Skill: `matsuni-kk-mini-app-agent/core-rule-maintenance` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add matsuni-kk-mini-app-agent/core-rule-maintenance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/matsuni-kk-mini-app-agent/core-rule-maintenance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: matsuni-kk (https://skillmd.com/u/matsuni-kk-mini-app-agent)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/matsuni-kk-mini-app-agent/core-rule-maintenance

---


# 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を自動実行する。