Context Cartographer
将来のエージェントが必要なコンテキストのみを読み込めるようにする、小さなドキュメントシステムを構築します。
スコープ境界
- このスキルは、ドキュメントシステムのセットアップ、監査、移行、クリーンアップ、再構築、または所有権が不明確な場合に使用します。
- ターゲットとなるオーナーファイルが既に判明しているルーチン編集には使用しないでください。
AGENTS.md、CLAUDE.md、Cursorルール、docs/architecture.md、docs/code_rules.mdで既に要求されている自動的な永続メンテナンスには使用しないでください。それらのローカル指示を直接適用してください。- ユーザーが明示的に
context-cartographerを呼び出した場合、常に使用します。
コアルール
- プロジェクトルートを特定し、実パスを把握してからプロジェクトファイルを読み込んでください。カレントディレクトリや別のプロジェクトからパスを推測しないでください。
- タスク中に既に読み込んだファイルは再利用してください。変更されたファイル、出力が切り詰められた場合、または特定の未読範囲を読み込む場合にのみ再読み込みします。
- ルートエージェント指示ファイルは短く保ってください。詳細なトピック情報は
docs/配下のオーナーファイルに格納します。 - Codex には
AGENTS.md、Claude Code にはCLAUDE.md、Cursor には.cursor/rules/context-cartographer.mdcを使用するか、選択したマルチエージェントターゲット向けの薄いアダプターを使用してください。 - 変更を提案する前に、読み取り専用で検査してください。
- 既存のプロジェクト固有ルールを維持し、外科的に編集してください。
- 承認なしに既存の指示ファイルやドキュメントファイルを上書き、移動、マージ、削除しないでください。
- プロジェクトの証拠と現在のニーズに基づいたファイルのみを作成してください。
- 不明な事実は
TODO: clarifyとマークし、プロジェクトの事実を捏造しないでください。 - プロジェクトメモリドキュメントはデフォルトでローカルのみとし、ユーザーが明示的に追跡または公開を要求しない限り、リポジトリの無視ファイルに追加してください。
- 編集後、リンク、オーナールーティング、無視ルール、古い参照を検証してください。
必要な決定事項
ルートエージェント指示を作成または置き換える前に、以下を解決してください：
- エージェントターゲット；
- コードルールモード：
docs/code_rules.mdを使用するか、使用しないか； - ドキュメントメンテナンスモード：
自動永続メンテナンスまたは要求時のみメンテナンス； - 既存ドキュメントの扱い：現状維持、監査のみ、承認後の移行、またはエージェントに任せる；
- プロジェクトメモリドキュメントをローカルのみにするか、追跡するか。
コードルールモードやドキュメントメンテナンスモードを推測しないでください。2つ以上の決定が欠落している場合は、バンドルされた質問票を使用してください。
生成されたルート指示は、ルーチンメンテナンスをこのスキルから独立させる必要があります：
自動永続メンテナンスでは、完了した作業が永続的な動作、アーキテクチャ、セットアップ、デプロイ、ステージング、テストデータ、アクセス、インポート/エクスポート、公開URL、オペレーターワークフロー、データモデル、公開インターフェース、エージェントワークフロー、またはドキュメント所有権を変更するたびに、同じタスク内で対応するオーナードキュメントを更新してください。要求時のみメンテナンスでは、明示的に要求された場合のみドキュメントを更新し、古くなっている可能性があるドキュメントにフラグを立ててください。- ルーチンメンテナンスはルート指示と既存のオーナードキュメントを直接使用し、
context-cartographerを呼び出さないことを明記してください。 - 該当する既存のオーナーファイルがない場合は、このスキルを呼び出し、オーナー不足プロトコルに従ってください。自動永続メンテナンスでは、マークダウンファイルを作成する許可を求めるだけで、最小限の正当なオーナーを自動的に分類して作成します。
- このスキルは、セットアップ、監査、移行、クリーンアップ、再構築、明示的な使用、または所有権が真に不明確な場合にのみ後で呼び出します。
参照ルーティング
- 初回セットアップ時は、常に
references/setup-workflow.mdを読み込んでください。他の必要な参照をルーティングします。 - 監査、移行、クリーンアップ、再構築、または所有権不明確な場合は、常に
references/existing-docs-workflow.mdを読み込んでください。他の必要な参照をルーティングします。 - ファイルや所有権を選択する前に
references/doc-map.mdを読み込んでください。 - ルート指示または
docs/*.mdを作成する前にreferences/file-templates.mdを読み込んでください。 - 既存のリポジトリを監査する前に
references/audit-checklist.mdを読み込んでください。 - ドキュメントを分割、マージ、削除、または名前変更する前に
references/cleanup-rules.mdを読み込んでください。 - 質問票JSONを作成する前に
references/question_schema.mdを読み込んでください。 - 質問票フローを適応する場合のみ
references/questionnaire_usage_examples.mdを読み込んでください。
ワークフロー
rg --filesを使用してプロジェクトルートとインベントリパスを解決します。- プロジェクトプロファイル、選択されたエージェントターゲット、既存ドキュメント、所有権、コードルールモード、メンテナンスモードを分類します。
- 既存ドキュメントについては、編集前に現在のファイル、トピックオーナー、計画された作成/更新/削除アクションのコンパクトなマップを表示します。
- ユーザーの許可範囲内で、最小限の正当なドキュメントシステム変更を適用します。
- リンク、古いファイル名、オーナーカバレッジ、ローカルのみの無視ルール、および独立したルーチンメンテナンス指示を検証します。
新しいシステムの場合は、references/setup-workflow.md に従ってください。
監査、クリーンアップ、移行、再構築、または所有権不明確な場合は、references/existing-docs-workflow.md に従ってください。
質問票
2つ以上の決定が欠落している幅広いセットアップ作業の場合：
references/question_schema.mdから.project-questionnaire/questions.jsonを作成します。languageをユーザーまたはプロジェクトの言語に設定します。python3 <this-skill>/scripts/questionnaire_server.py --input .project-questionnaire/questions.json --validate-onlyで検証します。- 自動ポートで
127.0.0.1上でサーバーを実行します。 - ユーザーが保存して完了したと言った後、続行する前に両方の回答ファイルを読み込んでください。
コードルールモードとドキュメントメンテナンスモードは、デフォルトや推奨オプションなしの必須選択でなければなりません。
更新確認
python3 <this-skill>/scripts/check_update.py --json を1日1回まで実行します。利用可能な更新をインストールする前に許可を求めてください。インストール済みユーザーが受け取るべき変更を公開する際に VERSION を上げてください。
終了条件
以下を報告します：
- 作成または変更したファイル；
- リンク、ルーティング、古い参照のチェック；
- ローカルのみの無視ポリシーのチェック；
- 独立した自動メンテナンスルーティングのチェック；
- 実行した検証と実行しなかったチェック。