mcpField
D
do

do

github.com/doodledoodエージェントワークフロー78119 回インストール1 日前に更新
リポジトリ

do について

do は、Manifest に定義された作業を実行するエージェント向けスキルです。権限と受け入れ条件を確認し、自律実行中の判断を引き継ぎ、変更と根拠を報告します。

主な機能

  1. 01実行前の権限と Manifest の確認
  2. 02Outcome と受け入れ条件の検証
  3. 03スキル間の引き継ぎで文脈を保持
  4. 04判断と根拠の報告
  5. 05権限内での Manifest 修正

活用シーン

  1. 01/do の呼び出し後にタスクを実行
  2. 02ユーザー不在時に作業を継続
  3. 03阻害要件の解決可能性を評価
  4. 04Manifest のゲートに沿って完了を報告

インストール

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

$npx skills add https://github.com/doodledood/manifest-dev --skill do

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

同梱ファイル

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

references/
EXTERNAL_REVIEW.md
HARVEST.md
LOG.md
VERIFICATION.md

詳細

実行する前に、../ticket-up/references/AUTHORITY.mdを読んでください。この割り当て、適用される権限、保持された決定を、すべてのスキルへの引き継ぎに含めてください。単独で呼び出される場合にも、役立つ意図と根拠とともに、これらを明示的に伝える必要があります。

パスがない場合は、使用方法を示して停止してください。実行を求められた場合にのみ実行してください。ユーザーが/doを呼び出した、またはビルドを依頼した場合、あるいは呼び出し元のワークフローから呼び出された場合に実行します。ユーザーが計画を承認しただけでは、実行を求めたことにはなりません。その場合は、Manifestの準備ができたことを伝え、/doコマンドを示して停止してください。それ以外の場合は、Manifestを最初から最後まで読んでから、そのOutcomeを達成し、現在のAcceptance CriterionとGlobal Invariantをすべて満たしてください。Outcomeは依頼された結果です。ハードクレームは、意図的なユーザー要件、または適用されるプロジェクト、安全性、権限上の義務を保持します。ワーキングクレームは、エージェントによる運用上の解釈です。各ゲートには、その権限と、独立した検証方法が記載されています。Outcomeまたは権限が欠けている場合は、古い要件のどれを変更してよいか推測せず、新たに定義する必要があります。Initial ApproachとProcess Guidanceは参考情報です。何を変更したか、Outcomeと各ゲートについてどのような根拠があるかを報告してください。

自律的な実行

ユーザーは実行中ずっと離席しているものとし、呼び出すすべてのスキルにもその前提を伝えてください。質問したり返答を待ったりせず、自分の権限の範囲を判断してください。ユーザーメッセージは会話の開始ではなく、方針を示すものとして受け取ってください。重大な決定とその理由、およびProcess Guidanceから逸脱した点があれば、あらゆる終了経路で報告し、実行ログを保持する場合はそこにも記録してください。

ユーザーに委ねられる判断。 同じ根拠を持つ慎重な人同士でも、合理的に異なる判断を下せて、その違いがユーザーにとって重要となる場合、その決定はユーザーに委ねられます。重大な決定ごとに、この基準で確認してください。自分の確信の強さだけで結論を決めてはいけません。ユーザーに委ねられる判断では、まず明示的に保持された決定または適用される委任に従い、次に、読み込んだメモリファイルの## Tasteセクションにある、承認済みの好みを確認してください。該当する好みは、その判断の種類に明確に関係し、従うことで選択が変わる場合に限り従ってください。労力やコストの削減など、ほぼあらゆる判断を傾ける一般的な傾向だけでは該当しません。それ以外の場合は根拠に基づいて判断してください。決定を報告する際は、まず、実行中に再検討した各決定記録について、当初の理由、それを退けた理由、覆した場合のコストを列挙してください。次に、ユーザーに委ねられた判断をそれぞれ列挙し、採用しなかった選択肢と、判断の根拠(従った好み、または該当する好みがなかったこと)を示してください。

好みの変更時。 方針を示すメッセージによって、実行中に下した判断が覆され、その理由が他のユーザーなら逆を望む可能性のある好みであり、すべてのセッションに必須の動作ではない場合は、3部構成のTaste項目を起草してください。1つ目は、まだ話題に上がっていない判断にも適用でき、対象となる判断の種類を明記した原則としての好み。2つ目は、推測した理由ではなく、ユーザーが述べた理由に基づく根拠。3つ目は、その好みが優先されない条件です。終了時の報告には、起草した内容をそのまま記載し、書き込むメモリファイルと、それが恒久的な好みか今回限りかを尋ねてください。「今回限り」は不可です。ユーザーがその文面に明示的に同意した場合に限り、そのファイルの## Tasteセクションに書き込んでください。既存の項目が覆された判断の根拠だった場合は、その相反を報告し、修正案または削除案があれば、その文面をそのまま示してユーザーの同意を求めてください。プロジェクト内の、デザインやプロンプトなど特定領域の作業だけを導く好みは、代わりに、その領域の原則スキル向けの項目として起草してください。形式と条件は../setup-project/references/PRINCIPLES_SKILLS.mdに従い、同様に報告し、同意があった場合のみ書き込んでください。それ以外のTaste提案はしないでください。報告に含める原則スキル向けの提案は、references/HARVEST.mdに記載されているものに限ります。破棄可能な下書き(以下で定義)への反応については、この実行中に下した判断を覆したかどうかにかかわらず、references/HARVEST.mdの「下書きへの反応」に記載された場合に限って項目を起草してください。 成果を持続可能にし、次の変更をより正しく行えるようにする解決策を選んでください。最初の計画は変更できます。使い捨てのドラフトは例外です。Deliverable で求められる場合がある、人がまだ言葉にできないことへの反応を得るためだけに作る、偽のデータを使った1ページのレンダリングのような、一時的なものです。プロジェクトのファイルの外に置き、その人が期待する仕上がりにし、遅くならないうちに数分で見せてください。その人に問いかけを届ける以上に完成度を高めたり、検証したりしてはいけません。問いへの選択はその人の反応を待ち、その選択に依存する作業は反応が届くまで保留します。実行によって持続可能な形で残すのは、決定と、その反応から明らかになった基準であり、ドラフトではありません。問題に見合う変更の規模であるアペタイトは、修正(Amendments)によって改められますが、すでに生じた過剰を正当化するために改めてはいけません。成果、厳格な除外事項、厳格な要件、権限は、その出所から許可を得ない限り固定されます。また、除外リストに記載がないことは、すべてのゲートで適用される事項がすべての実行に求める修正以外の、無関係なことを許可するものではありません。

信頼できる代替案を調査した後、許可された経路が一つも残っていない場合に限り、義務はブロックされます。実行に欠けている知識、アクセス権、権限が必要な場合、または成果や厳格な要件の変更が必要な場合です。失敗したアプローチは、繰り返すのではなく、自分で設計し直してください。関連する修正は、調査結果の ID やコミットをまたいで、満たそうとしている根本の約束ごとごとに追跡します。その約束ごと、承認済みの契約における出所、試みた修正とその結果を、実行ログまたはチェックポイントのメモに記録してください。その約束ごとに対する修正が2回失敗したら、3回目を試す前に、契約、アペタイト、スコープに照らして前提を検証してください。その約束ごとが本当に求められているか、もっと単純な修正で満たせるかを判断します。修正のコミットメッセージによって、受け入れ基準が強化されることはありません。成果と厳格な約束を守り、作業上の誤った主張は修正によって正してください。計画全体の承認によって、エージェントの選択が厳格な要件になるわけではありません。誤った厳格な前提には、ブロッカーのルールが適用されます。いつまでも次の試行がある状況では、ゲートに到達できないことを示すのは試行回数ではなく、証拠です。残るすべての許可された選択肢でも変わらない、測定された制約、実行ごとのばらつきを超えて結果が動かなくなった直近の試行、または一方のゲートを修正するともう一方が失敗する2つのゲートが、それに当たります。立証責任は実行側にあります。制約を推測ではなく測定し、信頼できる、実質的に異なる許可済みのアプローチを試すか、実証的な証拠で除外してください。制約によって、仮定上のバリエーションを一つずつ実装せずに選択肢の一群を除外できる場合もありますが、制約を回避できる可能性がある、妥当な再設計、置き換え、その他のアプローチが残っていれば、引き続き対応可能です。難しさ、コスト、一つのアプローチで結果が横ばいになったこと、再試行回数だけでは、実現不可能だとは言えません。信頼できる代替案の検討が終わるまでは、ゲートに到達できないとは言えず、作業を続けます。こうして根拠が得られ、成果または厳格な要件の変更が必要だと判明した場合、その義務はブロックされます。ブロッカーには、到達した最善の結果、制約、試みた内容、ブロック解除に必要な要件変更を記載し、基準は記載どおりのまま維持します。ブロッカーは証拠と必要な介入とともに速やかに提示し、そのブロックされた決定を推測せずにできる、有用で独立した作業を続けてください。有用な独立作業が残っていない場合に限り、/escalate を呼び出します(以下の 実行の終了方法)。外部プロセスがまだ実行中なら、完了ではなく待機です。

改訂

Manifest のパスを指定して define を呼び出し、権限の範囲内で、作業中の主張、証拠の方法、計画、確定した前提、Appetite を改訂するか、許可された方針変更を反映します。証拠として、以前の解釈が誤っていた点、変更しない Outcome とハード要件に照らして新しい解釈のほうが適切な理由、以前のどの結果が適用されなくなるかを提示します。チェックの失敗や困難だけでは改訂の根拠になりません。ハードな主張の根拠が欠けている、または古くなっている場合は、所有者に尋ねる理由にはなりますが、主張を弱める許可にはなりません。証拠の方法は、ハードな主張で明示的にその方法が必須とされていない限り、作業上の選択です。改訂は自動で行い、重要な変更を報告します。これは合意の実装を修正することであり、その結果を免除する許可ではありません。Appetite を改訂するのは、求められた結果に対するメリットが、追加される複雑さと保守の負担を正当化する場合に限ります。改訂ではその両方を明記し、より広範な作業の開始前に適用します。その根拠となる許可がない限り、直接改訂したり、Outcome やハード要件を変更したりしてはいけません。権限が不明確な場合は、改訂前にその根拠となる情報源で確認します。必要な判断を得られない場合は、その制約を報告し、独立して進められる作業を続けます。

改訂する前に、実行中のゲート評価がすべて完了するのを待ちます。評価中に改訂が行われた場合、その評価の判定は破棄し、改訂後のファイルを評価します。実行ログを残す場合は、references/LOG.md → A changed Manifest の説明に従い、define を呼び出す前に改訂を保留として記録し、再読み込み後に完了として記録します。 改訂した Manifest を再読み込みします。基準、対象、または解釈が変更されたすべてのゲートを再検証します。影響を受ける場合は Outcome の評価も含めます。それ以外の証拠は、有効性が保たれている間に限り引き続き使用します。ゲートの基準は、その本文と、その主張が参照するすべての Manifest セクションです。そのため、Manifest 全体を参照する上限(INV-G1)は、改訂のたびに再検証します。すべての完了経路で重要な改訂を報告し、実行ログを残す場合はそこにも記録します。

別の実行、または define を通じた人が、この実行中に同じ Manifest を変更する可能性があり、最後の書き込みが優先されます。Manifest を読み込むたびにハッシュを計算します。改訂前と完了報告前にも再度ハッシュを計算します。ハッシュが、この実行で最後に読み込んだ、または書き込んだときのものと異なる場合は、Manifest を再読み込みし、基準が変更された、または変更されていないことを確認できなくなったゲートを未検証として扱います。現在読み込めるファイルが契約です。この実行で行った改訂がそのファイルに残っていなければ、その改訂は適用されません。人による改訂の取り消しと古いコピーからの書き込みは区別できないためです。そのような各改訂とその根拠を、完了報告、および実行ログを残す場合はそこにも記載します。改訂が反映されなくなったこと自体を根拠に、そのゲートを再改訂してはいけません。変更したゲートが現在の内容で成立しない場合は、人の判断が必要なブロッカーです。反映されなくなった改訂とその根拠を明記し、再度適用するか確認してから、独立して進められる作業を続けます。

続行

実装の前に、/auto から呼び出された場合も含めて、Manifest の絶対パスを特定し、完了時のバックストップを有効にします。同じファイルを特定する有効な目標のもとで作業を続けるか、以下の目標ブロックをそのまま出力し、<manifest-path> を Manifest の絶対パスに置き換えます。要約、短縮、言い換え、句読点の変更はしないでください。ハーネスの目標設定、続行、または永続的な完了条件の機能を使って設定し、それらが使えない場合はコピーして貼り付けられる形で出力します。目標ブロックは、完了条件としてひとまとまりに出力します。ラベルのないブロックを一つだけ出力し、前には独自の文を一文置きます。フェンスとそのラベルはこのファイル内のマーカーであり、出力内容には含めません。Outcome と現在のすべてのゲートについて証拠を求める、より広範な親ワークフローのバックストップ(たとえば PR 指向の契約)がすでに確認できる場合は、そのもとで作業します。より限定された目標を別途設定または出力してはいけません。

Work under the Manifest at <manifest-path> until its Outcome and every current Acceptance Criterion and Global Invariant hold, each with fresh evidence, the workflow's bounded mandatory build work is settled, and completion has been reported. Read this file before resuming execution.

The Manifest changes only through the skill that wrote it, never by direct edit. Working claims and evidence methods may be revised on evidence while preserving the Outcome and hard requirements; those need their source's authorization to change. Overall plan approval does not harden agent choices. A changed claim or evidence method returns affected results unverified.

Record compact checkpoint notes as work proceeds: what changed, what was verified, what remains, blockers.

Assume the user is AFK; make authorized decisions without asking questions. Surface blockers promptly and continue useful independent work. Stop after reporting completion, a blocker requiring a person when no useful independent work remains, an external wait that this run's no-wait policy makes terminal, or a person settling from outside everything the work still owes, such as by merging the pull request that carries all of it. Continue while authorized, actionable work remains.

修正、負債、検証ハーネス

実行レポートを作成する前に references/HARVEST.md を読み込んでください。また、指摘事項を修復したり、不具合を修正したり、使い捨てのドラフトに対する修正や反応を受け取ったり、回避策を説明するコメントや制約を主張するコメントに触れたりした場合は、その時点ですぐに読み込んでください。修正は、チェックで維持できる場合はロックとなります。ドラフトへの反応は作業の方向性を定め、そこから先に進んだ内容だけをロックします。このようなコメントは、形を整えるか、コード化してください。また、実行で残った負債はレポートと、作成または更新するすべてのプルリクエストに記載してください。Manifest が検証レシピの適用を定めている場合、またはプロジェクトに検証ハーネスがある場合は、references/VERIFICATION.md を読み込んでください。検証ハーネスは、コンテキストファイルのプロジェクトサーフェスのセクションに記載されているもの、またはそのセクションに検証に関する箇条書きがなくてもディスク上にあるもので、後者は選択済みとみなします。また、作業に不足している部分が必要な場合、あるいはどのレシピでも対象としていないパスに触れる場合も、同様に読み込んでください。検証に関する箇条書きがないままディスク上にハーネスがある場合は、レポートでその記録を提案してください。 ハーネスはプロジェクトが選択するものです。そのセクションにプロジェクト独自の検証方法が記載されている場合は、指定された方法で検証し、ハーネスを提案しないでください。そのセクションに選択が記録されておらず、ディスク上にもハーネスがない場合は、プロジェクトに備わっている方法で検証し、レポートでハーネスを提案してください。いずれの場合も、変更に必要なチェックをプロジェクト独自の形式で追加し、ハーネスは構築しないでください。ハーネスの有無を問わず、すべてのプロジェクトで、作業が関わるチェックが壊れている、または信頼に足る状態でない場合は、「すべてのゲートに適用されること」に従い、独自の形式で修復してください。ハーネスが属するのはプロジェクトです。つまり、後のセッションで変更する作業を含む、またはこれから含む作業フォルダーやリポジトリであり、ユーザーが新しく作業を始めるフォルダーも該当します。チャットにワークスペースがない場合、ホームフォルダーやスクラッチフォルダー、完成した成果物を1つだけ含むフォルダー、またはセッションが実行されているフォルダーに関係しない質問は、いずれにも該当しません。そのようなプロジェクトがない場合は、Manifest の Outcome とゲートが検証のすべてです。ハーネスを構築せず、プロジェクトサーフェスも追加しないでください。プロジェクト内の一回限りの作業もプロジェクトの作業です。触れるパスに適用されるレシピを維持し、references/VERIFICATION.md の指示に従って実行してください。

すべてのゲートに適用されること

検証方法は自由ですが、以下の規則には従ってください。選択を制約する各ゲートについて、判断を下す前に理解してください。これには、スキルやリファレンスに委ねられた適用可能な標準も含まれます。構築と評価では、基準値、例外、トレードオフを含め、それらの標準を適用してください。これに予備レビューや決まった評価順序は必要ありません。

完成した成果物に照らして Outcome を直接評価し、ゲートとともに判断 ID OUTCOME として扱ってください。証拠と既存の判断コンテキストを再利用してください。新たなレビューレイヤーは必要ありません。チェックがすべて成功しても、Outcome の評価が欠けていてよい理由にはなりません。また、レビューで依頼された成果物が裏付けていない好みを追加してはなりません。維持されている受け入れ条件を尊重し、実際の使用によって確認できたことと、まだ確認できていないことを報告してください。

各ゲートでは、hard または working の Authority と、judgment または deterministic の kind が宣言されています。フィールドが欠けている場合は無効であり、推測して補ってはなりません。Manifest から各 claim と Evidence を ID で読み取り、コピーから読まないでください。現在のテキストを評価してください。成功を誤って記述している working claim は、免除された失敗ではなく、修正すべき指摘事項です。評価した証拠ごとに、基準と対象を追跡してください。いずれかの変更、または新たな外部証拠により、影響を受ける証拠は無効になります。引き続き適用される証拠は保持してください。対象には、コミット識別子だけでなく、関連するローカル作業と外部状態も含まれます。 判断ゲートは変更全体に一度目を通した後、その評価以降の変更によって持ち越されている、または明らかになった未解決の指摘と失敗を確認します。決定論的ゲートは毎回全体を再実行します。判断ゲートの基準が変更された場合、次の評価は新たな全体確認となります。旧基準では確認されなかった作業は、これまで一度も評価されていないためです。以下のルールで初回の全体確認に言及するものはすべて、上限も含め、そのゲートが新基準のもとで行う初回の全体確認に適用されます。 呼び出された評価者には、報告対象範囲、評価対象の状態、過去の指摘と裏付けのある処置、その根拠となる約束と受け入れ済みの情報源、検証済みの修正、それらの約束に対する失敗した試み、そしてその間の変更を伝えてください。不足しているコンテキストは、黙って再度の全体確認を求めるのではなく、補ってください。文脈を読む範囲は広くてもかまいませんが、古い行に触れただけで古い問題が新たな問題になるわけではありません。新規の独立したレビューでは、呼び出し元が指定した範囲を維持してください。評価者が基準を引き下げることはできません。正当な作業上の主張の変更は、修正に従って行います。 要約された主張は証拠ではありません。レビューの指摘と判定は、現在の主張を評価するための証拠です。指摘された失敗を、成果物、情報源上の義務、具体的な影響と照らして確認し、元の指摘、自身の処置、その根拠を記録してください。誤りである指摘、適用外の指摘、すでに解決済みの指摘、または裏付けのない指摘は、主張を修正したりレビュアーの同意を得たりせずに退けてください。確認が取れていないことだけでは、対処可能な懸念への反証になりません。重大な不確実性や、必要な証拠の不足は未解決のままです。実際の失敗は、引き続き対処が必要です。指摘によって主張の不足が明らかになった場合は、Outcomeと情報源上の義務を評価し、修正によって網羅性を補ってください。基準が存在しないことを理由に却下してはいけません。作業上の主張が成功を誤って示している場合は、確定済みとして扱う前に修正してください。 重要度は、適用されるレビュー用スキルの基準に従い、結果を基準に判断してください。Lowは、種類を問わず、仕上げや細かな指摘を指します。スタイル、命名、構成などが該当します。Manifestで選択された重要度、カテゴリ、受け入れ基準がその主張の一部である場合は、それらを適用してください。それ以外の場合、評価は実質的な判断の参考とします。Lowとされた正確性または安全性の失敗や、拘束力のある約束の不履行は、その方針を適用する前に証拠に基づいて再評価してください。意図的に求められているレビュアーの承認や外部確認は、実際に得られるまで未解決のままにしてください。あなたの処置でそれを解消することはできません。新しいID、プッシュ、セッションをまたいでも、裏付けのある処置は維持してください。新しいコード、変更された基準、議論、証拠によって、再び未解決となる場合があります。基準を下回る指摘は、その方針のもとでは主張を否定しません。以下のバッチ処理と継続レビューのルールは、それらへの対処方法を定めるものであり、Lowの定義を定めるものではありません。 すべてのプルリクエストは、リポジトリをより良い状態にします。作業が遭遇した既存の問題は、その作業に関連するかどうかを問わず、またゲートの基準を下回る指摘も、ビルド作業であり、判定ではありません。どちらも判定ゲートを失敗させず、新たな全体レビューを開始することもありません。これらの発生源は次の3つだけです。Manifest が求める変更の経路、つまり実行するチェックと、変更を行うために変更するコード、呼び出すコード、または読み取るコード。review-code に依頼したときに返される Pre-existing リスト。これは review-code を有効にする各ゲートの最初の全体レビューで依頼します。そして、プルリクエストに対するレビューのフィードバック(references/EXTERNAL_REVIEW.md)です。使い捨てのドラフトを作成しても、これらのいずれにも該当しません。これらの問題を修正する際、または指摘を修正する際に直面する事柄と、その修正または対応によってのみ触れたコードについてレビューで提起される内容は、その修正を妨げる場合、またはチェックが失敗する場合に限り対象に加わります。これにより、修正が連鎖するのを防ぎます。チェックの失敗はそのような問題の1つです。それを修正するためだけに読み取る、または編集するコードは、その修正が直面する事柄であり、変更の経路ではありません。既存の問題は修正します。最初の全体レビューで基準を下回る指摘のうち、作業を改善するものは適用し、残りは理由を添えて却下します。変更の経路から生じたものは、ビルドの一環として修正します。最初の全体レビューとレビューから生じたものは、1つずつではなくまとめて修正します。その後、そのまとめによって対象が変更された各判定ゲートは、継続レビューを1回行い、未対応の指摘と、そのまとめによって生じた、または明らかになった失敗だけを報告します。継続レビューでは既存の問題は列挙しません。また、そこで報告された基準未満の指摘は、適用も引き継ぎもせず、そのままにします。修正を再レビューすると好みの問題を再び拾うことになり、それを追いかけると終わりのないループになるためです。既存の問題はそれぞれ個別のコミットとして取り込み、プルリクエストには修正済みとして順次記載します。これらの修正は、適用されるスコープの上限がどのような表現であっても、Manifest が求める作業です。

非常に大きな問題は対象外です。つまり、独自の完了条件を必要とする独立したプロジェクトとなる修正です。これには、誰かが検討すべき設計上の決定、このリポジトリのコードを超える移行やロールアウト、またはプルリクエストが目的とする変更を埋もれさせてしまうレビューが含まれます。規模、関連性、利便性は、問題が非常に大きいかどうかの判断基準にはなりません。非常に大きな問題の例:コードベース全体でのフレームワークの置き換え、変更が通過するだけのモジュールの再設計、稼働中データの移行、他チームが所有するコード全体に及ぶロックの競合で、アーキテクチャ上の決定が必要なもの。非常に大きな問題ではない例:失敗する、または実行できないテスト、壊れたハーネススクリプト、古くなったドキュメントの記述、変更が呼び出すヘルパーのバグや型の不備、古くなったレシピ、局所的な変更で形を整えられる回避策、機械的に処理できる数十件ほどのロックの競合。非常に大きな問題は、それが独立したプロジェクトである理由とともに負債として報告します(references/HARVEST.md)。ただし、完了の前提となるチェックの失敗、つまりツリー全体に関わるもの、またはゲートが依存するものは、完了を妨げます(以下を参照)。人が保持するアクセス権、権限、または決定を必要とする問題は、たとえば先に確認を求めてから実行する必要があることなど、必要なものを明記した負債とします。ただし、ゲートが依存する場合はブロッカーとなります。プロジェクト独自のルール(コンテキストファイル、コントリビューションガイド、文書化された規約など)によって、変更と無関係な修正をプルリクエストに含めないことになっている場合は、そのルールに従います。そのような問題は修正せず、負債として報告します。ただし、完了の前提となるチェックの失敗は決してこの対象外にはならず、実行側が修正するか、ブロッカーとしてエスカレーションします(以下を参照)。 完了を報告する前に、プロジェクト全体で維持されているすべてのチェック(lint、型チェック、テスト、ビルド)に合格する必要があります。変更が失敗箇所に関係するかどうかは問いません。実行できないチェックは、製品またはそのハーネスの不具合です。修正してください。満たされていない主張を正当化するためにテストを削除、スキップ、または緩和して、グリーンにしてはいけません。正当な修正によって動作に関する主張が変わる場合は、テストを更新し、変更されていない Outcome と必須要件に対する独立したカバレッジを維持したうえで、その変更を報告してください。役に立たない、または同語反復的なテストを削除する場合は、その理由をプルリクエストの説明に記載してください。修正に膨大な作業を要するチェックの失敗は完了を妨げます。ブロッカーとしてエスカレーションし、実行が完了したと報告してはいけません。使い捨てのドラフトを作成するだけなど、プロジェクトファイルを変更しない実行には、これらの義務はありません。

外部レビューのフィードバックを直接受け取った場合も、check-pr 経由で受け取った場合も、それに対応する前に references/EXTERNAL_REVIEW.md を読み込んでください。

実行の終了方法。 実行は4つのいずれかの経路で終了します。各経路での報告には、上記の各セクションで報告を求めている判断、逸脱、修正事項、references/HARVEST.md に記載された負債、および実行ログを保持している場合はそのパスを含めます。

  • 完了 — Outcome と現在のすべてのゲートに関する最新の PASS エビデンスがあり、上記の範囲が限定された必須ビルド作業が片付いている場合は、Manifest のパス、そのエビデンス、および当該作業の処置を添えて done を呼び出します。必要なエビデンスが不足している場合、待機中の場合、または修正事項が未解決の場合は完了ではありません。これらの条件を満たしたら停止してください。さらに改善できる点があっても、追加の義務は発生しません。
  • エスカレーション — ブロッカーの解決に人の対応が必要で、独立して進められる有益な作業が残っていない場合は、Manifest のパス、未解決のブロッカー、およびそれぞれを裏付けるエビデンスを添えて escalate を呼び出します。
  • 保留 — 外部の待機だけが残っており、この実行の待機禁止ポリシーにより終了となる場合は、各未完了ゲートと、何を待っているのかを明記して自ら報告します。
  • 外部で解決済み — たとえば、Manifest が担うものがそのプルリクエストを超えておらず、それを担当するプルリクエストがマージされるなど、人が Manifest に残るすべての義務を解決した場合は、誰がいつ何を行ったか、実行で完了したこと、および保持しているエビデンスを添えて自ら報告します。人の対応を待つものはないため、これはエスカレーションではありません。Manifest がマージされたプルリクエストを超える義務(別の Deliverable、マージ後に確認されるゲート、実使用で示される Outcome など)を負っている場合、マージは実行の終了ではなく、実行中のイベントです。記録を残し、未完了のゲートを引き続き進めます。マージされたプルリクエストが担っていたプルリクエストのライフサイクルに関するゲートでは、マージがエビデンスになります。残る作業は新しいプルリクエストで進め、そのゲートが新しいプルリクエストを参照するよう、修正を通じて対応します。

実行ログ

--no-log を指定しない限り、~/.manifest-dev/logs/do-<name>-<hash>.md に追記専用ログを保持します。<name> は拡張子を除いた Manifest のファイル名、<hash> はその絶対パスの SHA-256 の先頭8桁の16進数です。これにより、この Manifest での起動時には毎回同じログを再開します。呼び出し元がジャーナルを指定した場合は、ポインター references/LOG.md → Path が示すパスに残します。再開する前にログを読み、作業しながら追記してください。goal ブロックのチェックポイントメモはそこに記録します。--no-log を指定しない限り、ログの最初の記録を行う前、および再開する前に references/LOG.md を読みます。そこには、ログの保持方法と、再開する実行で記録が必要な内容が記載されています。

コメント