
Coding Agentを「使う」から、再現可能に運用するへ。Best Practices Kit
Coding Agentは、短い修正ならかなり任せられるようになりました。
ところが、仕事が少し長くなると別の問題が出てきます。
Issueを丸ごと渡すと、変更範囲が広がる
repoを何度も読み直し、Contextが膨らむ
大きなTaskの途中で要件が混ざる
testが落ちたとき、今回の変更か既存問題か分からない
Agentの「完了しました」を、どのEvidenceで信じるか決まっていない
これは、モデル性能だけでは解決しません。
必要なのは、Coding Agentへ仕事を渡す前後の運用設計です。
この「Coding Agent Best Practices Kit」は、Work Contractだけでなく、Context、Task分解、Validation、STOP、Recoveryまでを一つの流れにした実務向けPremium Kitです。
先に結論:4つのCoreで運用を組み立てる
本Kitの中心は、次の4つです。
Work Contract
Context & Source of Truth
Task Decomposition & Bounded Execution
Validation / STOP / Completion
流れはシンプルです。
依頼
↓
Work Contract
↓
正本とContext Boundary
↓
必要な場合だけTask分解
↓
boundedな実装
↓
final revisionに紐づくValidation
↓
validated / STOP
長いプロンプトを書くことが目的ではありません。
何を任せるか、どこまで読ませるか、どこで分けるか、何をもって完了とするかを、再利用できる形にします。
Starter Kitとの違い
現在販売中の「Coding Agent / Work Contract Starter Kit」は、AIへの雑な依頼をGoal、Scope、Done、Human Gate、STOP付きのWork Contractへ変える入口商品です。価格は980円です。
Starterで解決したいのは、「まず安全に任せる」ことです。
Premiumが扱うのは、その次に起こる問題です。
Contextが増え続ける
Source of Truthが古くなる
Issueが大きすぎて一度に検証できない
mainや成果物が変わり、過去のPASSが使えない
failure時に全面再実行してしまう
ReviewやRecoveryが人によってばらつく
Work Contractだけで十分な人は、Starterのままで問題ありません。
すでにCoding Agentを使っており、運用全体を再現可能にしたい人向けがPremiumです。Starterの上書きや無償差し替えではなく、別SKUとして提供します。
3件の実作業でDogfoodした
このKitは、架空のBest Practiceを先に並べたものではありません。
通常のsingle-agent Coding Agent作業3件で4 Coreを使い、Before / After、friction、STOP、Validationを記録しました。
運用指示とschemaの整合
長期停滞PRのlatest-base追従
公開前validatorの実装修正
3件ともrepo再探索は0、scope driftと実装reworkは観測されませんでした。
ただし、比較対照がないため、「Kitによって何%速くなった」「tokenを何%削減した」とは言いません。task固有のtoken、cost、速度改善率は未計測です。
一方、3件で繰り返した問題は明確でした。
PASSは、どのrevisionのPASSか
実作業では、testが一度通っても終わりません。
その後に文書を追記する。mainが進む。別の回帰修正が入る。PR headが変わる。
このとき、古いPASSを新しいheadへコピーすると、「検証済み」の意味が崩れます。
PremiumではValidation Evidenceに、revision、base revision、実行command、結果、scopeを固定します。成果物やbaseが変われば、必要なValidationを取り直します。
また、failureを次の4つへ分けます。
今回の変更による回帰
baselineまたはintegration debt
revision変化によるstale Evidence
environmentまたはsetup不足
これにより、関連しないFAILを黙って今回のIssueへ取り込み、Taskを無限に広げることを防ぎます。
入っているもの
購入者向けZIPには、次を収録します。
4つのCoreガイド
Work Contract Template
Issue / Bounded Task Template
Handoff Template
Validation Evidence Template
通常のCoding Agent運用Playbook
Context最小化Playbook
Review / Human Gate Playbook
Recovery / STOP Playbook
3件の匿名化Dogfood Before / After
Failure / Anti-pattern Catalog
Coding Agentへ導入できる薄いSkill wrapper
15分で始めるBuyer README
Codex、Claude Code、GitHub Copilotなど、特定のCoding Agentだけに閉じないCoreです。Skillに対応しない環境でも、templatesとplaybooksはそのまま使えます。
こんな人に向いています
Coding Agentをすでに実務・個人開発で使っている
小さな修正は任せられるが、長いIssueになると不安定になる
毎回repoを広く読ませている
test failureの原因切り分けに時間がかかる
Agent間、session間のHandoffで抜けが出る
ReviewとDone判定を人依存にしたくない
まだ不要な人
まず1件だけ安全に任せたい
Work Contractの型だけあれば十分
Coding Agentをほとんど使っていない
templateやplaybookを自分の仕事へ適用する予定がない
その場合は、980円のStarter Kitから始める方が軽量です。
価格
初回の販売検証価格は2,980円です。
高額な講座ではなく、実際のIssueへ導入できるSkill、templates、playbooks、実例、anti-patternを一つの運用Kitとして提供します。
速度やtoken削減率を保証する商品ではありません。価値の中心は、依頼からvalidatedまでの判断を再利用可能にすることです。