mcpField
P
project-context-setup

project-context-setup

github.com/mathews-tomエージェントワークフロー33739 回インストール2 日前に更新
リポジトリ

project-context-setup について

project-context-setupは、リポジトリ内のコンテキストファイルや運用規約を整えるエージェントスキルです。既存の内容を保ちながら、セッションをまたぐエージェント作業の一貫性を支援します。

主な機能

  1. 01既存のリポジトリコンテキストを調査
  2. 02課題トラッカーとトリアージ規約を設定
  3. 03エージェント用コンテキスト文書を作成
  4. 04エージェント指示ファイルにコンテキスト節を追加
  5. 05ドメイン用語集とADR規則に対応

活用シーン

  1. 01docs/agents/がないリポジトリの初期設定
  2. 02課題ラベルとトラッカー操作の統一
  3. 03マルチエージェント作業用の永続的な課題ブリーフ作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mathews-tom/armory --skill project-context-setup

インストール後、Claude Code で/project-context-setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
cases.yaml
references/
agent-brief.md
context-format.md
out-of-scope.md

詳細

プロジェクトコンテキストのセットアップ

セッションをまたいでエージェントのワークフローに一貫性を持たせる、リポジトリ内のコンテキストファイルをひな形から作成します。 課題トラッカーのルール、トリアージラベル、ドメイン用語集の構成、ADR の構成、エージェント向けブリーフの形式、対象外事項の記録を整備します。

使用するタイミング

このスキルを使用する場合別のパッケージを使用する場合
リポジトリに docs/agents/ のコンテキストファイルがない1 つのアーキテクチャ上の決定には adr-writer
エージェント間でドメイン用語を統一する必要があるスコープがすでに定まっている機能には task-decomposer
トリアージや課題の公開にラベル規約が必要GitHub CLI を直接操作するには github
複数エージェントでの作業に永続的な課題ブリーフが必要セッション内での作業継続メモには handoff

参照ファイル

ファイル内容読み込むタイミング
references/context-format.mdCONTEXT.md と CONTEXT-MAP.md の用語集形式ドメイン文書を作成または編集するとき
references/agent-brief.md永続的な ready-for-agent 課題ブリーフの仕様課題の引き継ぎを準備するとき
references/out-of-scope.md却下した機能拡張の永続的な記録トリアージに wontfix の判断が含まれるとき

基本的なワークフロー

1. 調査

ファイルを書き込む前に、実際のリポジトリの状態を確認します。

  • git remote -v と .git/config で課題トラッカーの手掛かりを確認する
  • ルートの AGENTS.md と CLAUDE.md
  • ルートの CONTEXT.md と CONTEXT-MAP.md
  • docs/adr/ と、コンテキストごとの ADR ディレクトリ
  • 既存の docs/agents/
  • 既存の .out-of-scope/

存在するものと不足しているものを報告します。既存ファイルを確認せずに上書きしないでください。

2. セットアップ値を決める

次の値をユーザーと相談するか、リポジトリから明確に判断できる根拠に基づいて決めます。

決定事項デフォルト出力先
課題トラッカーGitHub のリモートがある場合は GitHub、ない場合はローカルの Markdowndocs/agents/issue-tracker.md
トリアージラベル正規ラベルはロール名と同じdocs/agents/triage-labels.md
ドメイン文書ルートに単一のコンテキストを置くdocs/agents/domain.md
エージェント指示ファイル既存の AGENTS.md、なければ既存の CLAUDE.md## Agent context ブロックを更新

AGENTS.md と CLAUDE.md の両方が存在する場合は、エージェント間の移植性を確保するため AGENTS.md を更新します。 どちらも存在しない場合は、作成する前に確認してください。

3. コンテキストファイルを書く

次のファイルを作成または更新します。

docs/agents/
├── issue-tracker.md
├── triage-labels.md
└── domain.md

次の規約に従います。

  • 課題トラッカーの手順は実務的なものにします。正確な CLI、ラベルの変更方針、エージェントが課題にコメントしたりクローズしたりしてよいかを明記します。
  • 正規のトリアージロールを実際のラベルに対応付けます。リポジトリに同等のラベルがある場合は、重複するラベルを作成しないでください。
  • リポジトリが単一のルート CONTEXT.md を使うか、コンテキストごとの用語集を含む CONTEXT-MAP.md を使うかを記載します。
  • ADR の参照ルールを記録します。全体に適用される決定には docs/adr/ を使い、該当する場合はコンテキストごとの docs/adr/ ディレクトリも使います。
4. エージェントコンテキストブロックを追加する

選択した指示ファイルに次のブロックを追加または更新します。

## Agent context

### Issue tracker

See `docs/agents/issue-tracker.md` for where issues live and which operations agents may perform.

### Triage labels

See `docs/agents/triage-labels.md` for canonical triage roles and their concrete label strings.

### Domain docs

See `docs/agents/domain.md` for `CONTEXT.md`, `CONTEXT-MAP.md`, and ADR lookup rules.

既存のブロックがある場合は、その場で更新します。重複して追加しないでください。

5. ドメイン用語集（任意）

ユーザーが少なくとも 1 つのドメイン用語を確定した場合に限り、CONTEXT.md を作成します。 references/context-format.md を使用してください。一般的なプログラミング概念で内容を埋めないでください。

個別の用語集が必要な複数コンテキストのリポジトリに限り、CONTEXT-MAP.md を作成します。

検証

  • docs/agents/issue-tracker.md が存在し、トラッカー、許可される操作、必要なツールを明記している。
  • docs/agents/triage-labels.md で needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix が対応付けられている。
  • docs/agents/domain.md に単一または複数のコンテキストの構成と、ADR の参照ルールが記載されている。
  • 選択した指示ファイルに ## Agent context ブロックがちょうど 1 つ含まれている。
  • そのブロック以外の、ユーザーが作成した既存の内容が保持されている。

コメント

Markdown 対応