Community研究&データ分析github.com

pax-k/build-right

エージェント非依存のスキルセットで、曖昧なアプリのアイデアをエビデンスに基づいたAI実行計画に変換します。

build-right とは?

Build Right Executionは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、エージェント非依存の実行スキルです。事前準備が完了し、プロダクトの真実、MVPスコープ、運用ルール、実行可能なタスクキューが整った状態で使用します。このスキルは、「1つのタスクを実行し、現在の状態を証明し、狭い範囲で変更し、適切なエビデンスで検証し、トラッカーを更新してから次のタスクに進む」という厳格なループに基づいています。状態リゾルバーと実行ヘルパーという2つのスクリプトを使って、タスク選択の判断を支援し、ゲート(停止条件)をチェックします。また、実行中にスコープが拡大するのを防ぎ、必要なエビデンスを段階的に記録することで、AIによる作業の品質と再現性を高めます。このスキルは、エビデンス駆動の開発ワークフローを強制し、ユーザーへの明確な状態報告(ステータスバッジ)を要求する点が特徴です。

対応~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Build Right Execution (正しい実装を実行する)

このスキルは、事前作業によってプロダクトの真実、MVPスコープ、運用ルール、実行可能なタスクキューが生成された後に使用します。

核となるルール:

1つのタスクを実行する。
現在の状態を証明する。
狭い範囲で変更する。
適切なエビデンスで検証する。
トラッカーを更新する。
そして次のタスクに進む。

必須参照ドキュメント

  • 動作前に必ず references/workflow.md を読むこと。
  • タスク選択前、タスク受け入れ時、および別のタスクに進む前に references/gates.md を読むこと。
  • レビュートリガーが適用される場合、サブエージェントレビューが有用な場合、または広範囲のエビデンス/トラッカー変更が関係する場合にのみ references/review-and-delegation.md を読むこと。
  • タスクを完了または更新する前に references/evidence-contract.md を読むこと。
  • タスクがアーキテクチャ境界、公開API、パッケージ所有権、プロバイダアダプター、生成コード、エラーセマンティクス、テスト、観測可能性、セキュリティ、または強制可能なポリシーに触れる場合、実装またはレビューの前に ../build-right-engineering-principles/references/principles.md を読むこと。
  • 欠落しているタスクを作成する場合や、過度に広範なタスクを分割する場合は、assets/templates/task-template.md を使用すること。
  • バンドルされたヘルパースクリプトは、以下に示す完全なBunコマンド形式でのみ使用すること。PATHエイリアスに依存したり、continue-check のような短縮名をシェルコマンドとして呼び出したりしないこと。
  • タスクを選択する前、またはキューを進める前に、状態リゾルバーを使用すること。その決定を報告し、調整してから続行すること。
  • 実行ヘルパーを決定的なタスク、契約、ゲートシグナルに使用すること。スクリプトの出力は判断への入力として扱い、権威として扱わないこと。

動作モード

  1. 利用可能な場合は、読み取り専用の状態リゾルバーを実行する:

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. 作業を選択する前に、リゾルバーの結果を報告する:

    Resolver decision: <decision>
    Confidence: <confidence>
    Next action: <next action>
    Next task: <task or none>
    Blocking gates: <gates or none>
    External follow-ups: <follow-ups or none>
    
  3. リゾルバーの決定に従って作業を選択する:

    • ask-founder: 創業者所有のゲートについて質問または報告する。続行しない。
    • wait-external: 外部状態ゲートを報告する。続行しない。
    • create-blocker: 最小のAI所有ブロッカーを作成または提案する。
    • no-ready-task: 停止し、AI所有の準備済みタスクがないことを報告する。
    • invalid-state: 矛盾するトラッカー/ゲート状態を調整するために停止する。
    • continue-active-task または execute-task: そのタスクを正確に選択する。
  4. 利用可能な場合は、読み取り専用の実行ヘルパーを実行する:

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. タスク、スプリント/マイルストーントラッカー、権威ドキュメント、およびローカルエージェントの指示を読む。

  6. タスク受け入れ情報を出力する:

    Active task: <task id or path>
    Done means: <observable completion criteria>
    Non-goals: <explicit exclusions>
    Assumption basis: <founder-claimed | ai-inferred | prototype-assumption | repo-evidence-backed | public-evidence-backed | customer-evidence-backed>
    Reversibility: <easy | moderate | hard>
    Learning hook: <how this task will produce evidence>
    Source under test: <repo-local path | installed path | GitHub source | release tag | n/a>
    Baseline evidence: <artifact or command>
    Verification ladder: <focused -> broader checks>
    Evidence destination: <task file or evidence file>
    
  7. タスクパスが存在する場合は、実行ヘルパーを task-contract または all モードで実行し、編集前に不足しているフィールドを調整する。

  8. 編集前に現在のワークスペース状態を検査する。

  9. ベースラインエビデンスを取得する。

  10. タスクを満たす最小限の変更を実装する。

  11. レイヤーごとに検証する。

  12. 必要なレビュートリガーが適用され、サブエージェントツールが利用可能な場合は、サブエージェントレビューを実行する。利用不可能または禁止されている場合は、スキップされたレビューを記録し、クローズ前に代替検証を実施する。

  13. タスクを完了とマークする前にエビデンスを記録する。

  14. 関連するトラッカー/ドキュメントのみを更新する。

  15. 別のタスクを選択する前に、完全なBun状態リゾルバーコマンドと実行ヘルパーを stop-gates モードで実行する。

  16. 別のタスクを選択しても安全かどうかを判断する前に、再度リゾルバーの結果を報告する。

  17. 創業者、外部状態、検証失敗、古いタスク、ソース不一致、未解決の競合、非AI所有者、またはリリース要求のゲートで停止する。これらのゲートが解決されるか、準備済みのAI所有タスクに明示的に変換されるまで、次のタスクに進まない。

  18. プロジェクトのワークフローに従ってコミットまたは引き継ぐ。

準備未完了ルール

権威ドキュメント、MVPスコープ、実行ルール、またはタスクファイルが欠落している場合、実行準備ができているふりをしてはならない。ユーザーを /build-right-preflight に誘導するか、欠落している実行面を確立するために必要な最小のSprint 0ブロッカーを作成する。

プロトタイプタスクは、可逆性、学習フック、およびプロダクトの真実の前に必要な検証が明示されている場合にのみ、prototype-assumption から実行できる。

スキルリリース/手動トライアルの場合、テスト対象の正確なソースを記録すること。インストールまたは呼び出されたスキルが、リポジトリローカルのスキルソースよりも古い場合、トライアルを partial-needs-rerun とマークし、リリースゲートを準備完了に進めないこと。

スコープ拡大禁止ルール

暗黙的にスコープを拡大してはならない。タスクが無関係な作業を明らかにした場合は、フォローアップ課題を作成し、選択したタスクの境界内でのみ続行すること。

停止/問い合わせゲート

各タスクの後、次のステップが本当にAI所有かつ準備済みであるかを確認すること。次のステップに以下が必要な場合は、停止し、質問するかブロッカーを報告すること:

  • 創業者所有のプロダクト、ポジショニング、バイヤー/ユーザー、またはMVPの判断
  • AIではない準備済みまたはアクティブなタスクの所有権
  • docs/conflicts.md 内の未解決の競合
  • 外部調査、検索インデックス作成、公開、シークレット、有料サービス、または本番環境へのアクセス
  • 検証失敗、古いタスク状態、ソース不一致、または曖昧なエビデンス
  • 同等の代替手段なしにスキップされた必須サブエージェントレビュー

準備されたキューを進めることは、次のすべてのタスクが準備済み、AI所有、エビデンスに基づき、これらのゲートのいずれによってもブロックされていない場合にのみ許可される。

ユーザー可視ステータスバッジ

すべての最終応答を、正確に1つのステータスバッジブロックで終了すること:

✅ [DONE] Status: DONE
Decision: <decision/result>
Next action: <next action or none>
Needs user input: <none | concise ask>
Blocked by: <none | blocker>

以下のステータスマップを使用すること:

  • ✅ [DONE] Status: DONE: エビデンス、検証、トラッカー更新を伴う完了タスク用。
  • 🟢 [GREEN] Status: ALL GREEN: 実装開始前の execute-task または continue-active-task 用。
  • 🟡 [YELLOW] Status: NEEDS INPUT: ask-founder 用。
  • 🟠 [ORANGE] Status: NEEDS WORK: まだ準備済み実行タスクではないAI所有のフォローアップ作業用。
  • 🔵 [BLUE] Status: WAITING EXTERNAL: wait-external、公開、インデックス作成、認証情報、有料サービス、本番アクセス、またはサードパーティ状態用。
  • 🔴 [RED] Status: BLOCKED: create-blocker、no-ready-task、invalid-state、未解決の競合、検証失敗、古い/ソース不一致、非AI所有タスク、または代替なしの必須レビュースキップ用。

関連スキル