review-harness-spec

Review Harness Spec

ディスク上の hedera-harness レシピを、2 つの軸で監査します。ジェネレーターの試行が始まってから初めてハーネスに検出されるようなミスを見つけます。

最初に共有語彙を読み込みます。../harness-spec-anatomy/SKILL.md と GLOSSARY.md を読んでください。

対象は hedera-harness schemaVersion 3 です。

作成専用スキルです。レシピにスキルを列挙することはありません。

ステップ 1：レシピを見つける

レシピはプロジェクトルートの .harness/spec.yaml にあります。解決先となるすべてのファイルを読みます。v3 ではほとんどのパスがデフォルトで設定されるため、キーがないことはファイルが欠けていることを意味しない点に注意してください。

キー	省略時のデフォルト
prd	.harness/prd.md（リストの場合はインクリメント）
eval	なし（EVALUATE はオフ）。リストの場合は prd: と 1 対 1 に対応する必要があります
validators.static	.harness/validators/static.json
validators.commands	.harness/validators/yarn.json

レシピファイルがない場合は、作業を中止して確認を求めます。schemaVersion が省略されている場合、1、または 2 の場合は、v3 への書き換え（contract: → eval:、skills: を削除し、schemaVersion: 3 を設定）を推奨して中止します。または hedera-harness init で再生成します。migrate は廃止されています。古い元のレシピではなく、書き換え後のレシピをレビューしてください。

ステップ 2：配線軸

bash <path-to>/harness-spec-anatomy/scripts/check-spec.sh <project-root>

<project-root> は .harness/ を含むディレクトリです。このスクリプトはスキーマの妥当性を確認するために hedera-harness doctor --recipe-only を実行し、その後、ファイル間の整合性チェックを追加します。

検出事項を そのまま ## Wiring の下に報告してください。

スキーマが検証されなかったと報告された場合（ハーネス CLI がない、または古すぎる場合）は、その旨をレポートで明示してください。その場合、配線軸は合格ではなく、一部のみの確認となります。

ステップ 3：評価軸

判断のみを行います。スクリプトでは確認できない項目です。 references/review-checklist.md に沿って確認してください。少なくとも次の点を確認します。

• すべての PRD ジャーニーが、対応する evaluate チェックリスト内の 1 つ以上のアサーションに対応している
• すべてのアサーションが PRD ジャーニーに紐づいている（孤立項目／スコープの逸脱がない）
• 重大度の上限が妥当（critical は 2 以下を推奨）
• Needle が壊れやすい実装文字列ではなく、実際のスクリプトを指定している
• Playwright ステージは薄く保ち、詳細な UX はチェックリストで扱っている
• skills: キーがない（プロダクトプラグインは検出され、ジェネレーターが選択します）
• デフォルト値を単に言い換えただけの値でレシピを水増ししていない
• インクリメントの場合：各インクリメントでアプリが正常な状態を保ち、依存関係に沿った順序になっており、eval: が prd: と 1 対 1 に対応している

## Eval の下に報告してください。Wiring と統合したり、順位を付け直したりしないでください。レシピは配線が完璧でも、誤った内容を評価することがあります。

ステップ 4：レポートを出力する

# Harness Recipe Review — <slug>

## Summary
- **Schema**: v3 | stale (rewrite first)
- **Stage ambition**: ASSERT | +SMOKE | +EVALUATE | +CHAIN
- **Increments**: single PRD | N ordered (eval paired: yes / no / scalar)
- **Ready to run ASSERT?**: yes / no
- **Wiring findings**: N  (schema validated: yes / no)
- **Eval findings**: N

## Wiring
- [script output or hand-checked findings]

## Eval
### Blocker
- [id] <what> — <where> — <fix>
### Warning
- [id] <what> — <where> — <fix>
### OK
- [id] <what>

ステップ 5：引き継ぎ

ASSERT の準備ができている場合：

hedera-harness run .harness/spec.yaml --max-attempts 3
# or: yarn harness:run

追加リソース

• references/review-checklist.md
• 関連項目：/create-harness-spec
• 用語集：/harness-spec-anatomy