mcpField
P
product-context-builder

product-context-builder

github.com/thedesignprojectエージェントワークフロー9739 回インストール9 週間前に更新
リポジトリ

product-context-builder について

Product Context Builder は、製品リポジトリで作業するコーディングエージェント向けに、簡潔で根拠に基づくコンテキスト体系を作るスキルです。既存の指針やデザイン資料を調べ、すべての文書を一律に生成せず、必要なファイルをレビュー可能な段階で作成します。

主な機能

  1. 01リポジトリの指針と構成を調査
  2. 02既存の製品・デザイン資料に基づくコンテキスト作成
  3. 03必要なコンテキストファイルのみ選択
  4. 04レビュー用にファイルを一つずつ下書き
  5. 05生成したコンテキストをリポジトリと照合

活用シーン

  1. 01コーディングエージェント用のリポジトリ指針の準備
  2. 02既存の製品とビジュアルシステムの文書化
  3. 03安定したワークフローをプロジェクトスキル化
  4. 04コンテキストファイルに根拠のない前提がないか確認

インストール

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

$npx skills add https://github.com/thedesignproject/agent-skills --skill product-context-builder

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

同梱ファイル

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

assets/templates/
AGENTS.template.md
CLAUDE.template.md
DESIGN.template.md
PRODUCT.template.md
references/
always-loaded-files.md
design.md
product.md
project-skills.md
validation.md

詳細

Product Context Builder

ユーザーの実際のプロダクトとリポジトリに根ざした、コンパクトで相互に連携するコンテキストシステムを構築します。完成したファイルは、AI エージェントがコードベース、プロダクトの判断基準、再利用すべきビジュアルシステム、必要に応じて読み込めるタスク固有のワークフローを理解するのに役立ちます。

まず既存のものを調べる

ユーザーに質問する前に、リポジトリを調査します。次のものを探します。

  • 既存の AGENTS.md、CLAUDE.md、PRODUCT.md、DESIGN.md、スキルフォルダー
  • パッケージスクリプト、ビルドおよびテストコマンド、ソースディレクトリ、コントリビューションルール
  • UI コンポーネント、Storybook のストーリー、テーマファイル、CSS 変数、Tailwind の設定、トークンパッケージ
  • プロダクトのドキュメント、PRD、調査資料、ブランドガイドライン、アクセシビリティ要件

見つかったもの、安全に推測できること、人に確認する必要があることを報告します。コマンド、コンポーネント名、プロダクトの位置付け、トークン、制約を決して作り上げないでください。

必要なファイルだけを選ぶ

すべてのファイルを自動的に生成しないでください。

  • 複数のコーディングエージェントに安定したリポジトリ向け指示が必要な場合は、AGENTS.md を作成または更新します。
  • Claude Code に、意味のある違いがあるツール固有のガイダンスが必要な場合は、CLAUDE.md を作成または更新します。共通ルールは AGENTS.md と整合させます。
  • エージェントに、対象ユーザー、目的、個性、原則、参考例、避けるべき例といった永続的なプロダクト判断基準が必要な場合は、PRODUCT.md を作成します。
  • 根拠に基づいて実際のビジュアルシステムやコンポーネントライブラリを記述できる場合は、DESIGN.md を作成します。
  • 認識しやすい実行タイミングと安定したワークフローを持つ、繰り返し可能なタスクに限り、プロジェクトスキルを作成します。

ファイルを作成する前に、該当するガイドを読みます。

assets/templates/ のテンプレートは、根拠を確認するための問いかけとして使います。機械的にすべて記入すべきフォームではありません。空のセクションや無関係なセクションは削除します。

レビューしやすい段階に分けて進める

一度に1つのファイルを下書きし、次の点を説明します。

  1. どのリポジトリの根拠がそのファイルに反映されたか
  2. どの記述がユーザーから提供されたか
  3. どの質問や矛盾が残っているか

戦略的な判断を永続的なコンテキストとして扱う前に、ユーザーに確認を求めます。プロダクトの個性、避けるべき例、例外、厳守すべき制約には明示的な確認が必要です。

各レイヤーを連携させる

常時読み込まれるファイルには、必要最小限の有用な参照ルールを記載します。たとえば次のようにします。

Before writing or changing UI, read PRODUCT.md and DESIGN.md. Reuse documented components and tokens. If the system does not cover a design need, ask before creating a new pattern.

PRODUCT.md や DESIGN.md の内容全体を AGENTS.md や CLAUDE.md にコピーしないでください。タスクスキルの中に、リポジトリ全体に適用されるルールを隠さないでください。

コンテキスト監査で仕上げる

検証 を読み、生成したすべてのファイルをリポジトリと照合し、次の点をまとめます。

  • 作成または更新したファイル
  • 使用した根拠
  • 解消した矛盾
  • 確認待ちの仮定
  • 新しいコンテキストシステムを使ってユーザーが次に試すべき、実際のタスク

コメント

Markdown 対応