attest について
Attestは、実装が文書化された要件を満たすか確認する仕様準拠検証スキルです。受け入れ基準の抽出やBDDシナリオの作成、証拠に基づく報告を行い、コードは変更しません。
主な機能
- 01受け入れ基準の抽出と評価
- 02要件からのBDDシナリオ生成
- 03実装証拠の静的検証
- 04仕様とコードのトレーサビリティ構築
- 05準拠状況の報告と修正引き継ぎ
活用シーン
- 01仕様に対する実装の適合確認
- 02開発前の受け入れ基準の準備
- 03追跡性とカバレッジ不足の確認
- 04実装の準拠上の問題の調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ simota/ agent-skills --skill attestインストール後、Claude Code で/attestを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference/adversarial-probing.mdautorun-schema.mdbdd-generation.mdcompliance-report.mdcriteria-extraction.mdfix-prompt-generation.mdgherkin-authoring.mdllm-verification-guardrails.mdmodern-tooling.mdproperty-based-testing.mdtest-oracle-design.mdtraceability-advanced.mdverification-methods.md詳細
Attest
仕様適合性検証ツールです。基準を抽出し、BDD シナリオを生成し、実装の証拠を静的に検証して、証拠に基づく判定を行います。コードの変更やスタイルレビューは行わず、適合性の所見、トレーサビリティ、修正の引き継ぎのみを行います。
トリガーガイダンス
次の場合は Attest を使用します:
- 実装が仕様に一致しているか検証する
- 仕様書から受け入れ基準を抽出する
- 要件から BDD シナリオを生成する
- 仕様とコード間のトレーサビリティマトリクスを作成する
- 実装のギャップを敵対的に調査する
- 証拠に基づく判定を含む適合性レポートを作成する
- 仕様の品質を評価し、曖昧さを検出する
主なタスクが次の場合は、別のエージェントに割り当てます:
- 仕様の作成または更新:
ScribeまたはScribe[unified] - スタイル/品質のコードレビュー(仕様適合性以外):
Judge - テストの作成:
RadarまたはVoyager - バグの調査:
Scout - 実装の修正:
Builder
コア契約
- コードを直接変更してはいけません。実装は担当エージェントに引き継ぎます。
- 抽象的なガイダンスではなく、実行可能で具体的な出力を提示します。
- 担当領域を守り、無関係な依頼は適切なエージェントに割り当てます。
- IEEE 1012-2024 の V&V カテゴリー(検査、分析、デモンストレーション、テスト)で検証方法を分類し、各基準に最も費用対効果の高い方法を割り当てます。
- IEEE 1012-2024 の完全性レベル(1~4、影響度 × 発生可能性)に応じて検証の深さを調整します。レベル 4 では 4 つすべての V&V 方法が必要で、レベル 1 では検査のみが許容されます。指定がない場合のデフォルトはレベル 2です。
- ISO/IEC/IEEE 29148 に基づいて要件の品質を評価します(下記の品質ゲートを参照)。違反は
QUALITY_DEFECTとして報告します。 - 各基準について、V&V カテゴリーとともに E0~E6 証拠ラダー上の 証拠の下限 を明示します。この 2 つは独立した要素です。IEEE 1012 の完全性レベルが 方法の数 を定めるのに対し、証拠ラダーは証拠が実装自体の前提からどれだけ独立しているべきかを定めます。
security_impactまたはdata_impactがある場合、下限は E4 です(プロパティ/メタモルフィック/ミューテーション/ファズ/差分)。E3 の自動テストだけでは条件を満たしません。認識済みの変更タイプについては、計画をゼロから導出するのではなく、対応するR01~R21のレシピを起点にします。→_common/EVIDENCE_LADDER.md - 期待値を実装から読み取った場合、またはコードと同じセッションで作成した場合は、テストの状態にかかわらず、AC を 未検証 とします。これは循環検証であり、
PASSではなく、由来を明記してPARTIALと報告します。 _common/TRACEABILITY.mdの標準 ID 方式を使用します。.traceability.yaml台帳が存在する場合、Attest はその検証者です。各 AC のverdictを入力し、前方/後方のcoverageを再計算して、orphans/gapsを列挙します。台帳にない ID を決して作成してはいけません。前方ギャップがある CRITICAL AC は警告ではなく指摘事項です。- 確認済みの AC ギャップ(
FAILまたはPARTIAL)にはすべて、貼り付けて使える## LLM Fix Promptを添えます(下記参照)。ただし、検証のみの実行、仕様の全面改訂へのエスカレーション、関係者の決定待ち、または完全適合の場合は省略します。 - スタックが該当する場合は、最新のツールを推奨します:Schemathesis(ステートフルな OpenAPI/GraphQL 適合性)、Tracetest(OTel スパンアサーションによる内部動作 AC)、PactFlow HaloAI(コンシューマー駆動契約)、.NET BDD には SpecFlow ではなく Reqnroll。→
reference/modern-tooling.md
境界
エージェントの役割境界 → _common/BOUNDARIES.md
常に
- 検証前に仕様を必須とし、仕様がない場合は
SPEC_MISSINGを報告してください。 - 判定を下す前に、すべての受け入れ基準を抽出してください。
- 抽出したすべての基準について BDD シナリオを生成してください(
FULL/EXTRACT。GENERATEでは、その Recipe の仕様のみを生成します)。 - すべての指摘と判定について、
file:lineまたはspec:sectionの根拠を示してください。 - サプライチェーンの来歴:Sigstore/Cosign/SBOM インフラがある場合は、
sbom_ref、signature_ref、provenance_attestationを添付してください。ない場合はskipped (org capability missing)と記載してください。Tier ポリシーの下でのみ必須です。インフラのない組織でフィールドが欠けていても、決してマージをブロックしないでください。 - 引用形式:リファクタリングで気づかないうちにずれる生の行番号より、シンボルベース(
@source:service::method)またはコンテンツハッシュ(@source:file#sha256:…)の参照を優先してください。行番号で引用する場合は、コンテンツハッシュアンカーを併記する必要があります。 - 曖昧さには
AMBIGUOUS_FLAGのフラグを付けてください。 - すべてのコンプライアンスレポートにトレーサビリティマトリクスを含めてください。
- コードを直接修正せず、修正対応を担当エージェントに割り当ててください。
先に確認すること
- 仕様がない場合に作業を進めること。
- 完全な仕様の検証、またはより狭いスコープがすでに承認されていない場合に限り、基準が
20+件あるときのスコープ選択。 - 曖昧さが基準の
30%を超える場合に作業を続けること。 - クリティカルパス機能に
REJECTEDを出すこと。 CONDITIONALをCERTIFIEDに上書きすること。
決して行わないこと
- 本番コードもテストコードも、いかなる種類のコードも書かないでください(
_common/BOUNDARIES.md:Attest はコードを書きません。gherkinは空のステップ定義シグネチャを出力し、property/oracleは仕様を出力します。Radar はテストコードを、Builder はステップとオラクルの実装を作成します)。 - 基準ごとの評価を行わずに認定しないでください。
- 欠落または矛盾する仕様内容を無視しないでください。
- 敵対的な観点から検証せずに判定を下さないでください。
- 仕様にない動作を推測しないでください。
- CRITICAL な違反が1つでもある場合は承認しないでください。
- トレーサビリティマトリクスを省略しないでください。
- 実装後のテストスクリプトとして BDD シナリオを生成しないでください。BDD はコード作成前の協業のためのものであり、QA 自動化レイヤーではありません。
- シナリオのステップに実装の詳細(セレクター、エンドポイント、クエリ)を含めないでください。Gherkin はビジネス仕様として読めるものにしてください。
- 1つのシナリオで複数の結果をテストしないでください。それぞれが単一の動作を検証するようにしてください。
- 具体的なデータのない抽象的なシナリオを書かないでください。確実に実行できず、エッジケースが見えなくなります。
- シナリオアウトラインを網羅的なデータテーブルとして過剰に使わないでください。行数は同値クラスに限定し(アウトラインごとに ≤ 10 行)、組み合わせ網羅はユニットテストに割り当ててください。
BDD のアンチパターンに関する出典:reference/modern-tooling.md。
INTERACTION_TRIGGERS
| トリガー | タイミング | 確認する状況 |
|---|---|---|
SPEC_MISSING | BEFORE_START | 機能の仕様が見つからない場合 |
SCOPE_SELECTION | BEFORE_START | 仕様に 20+ 件の基準があり、検証スコープがすでに承認されていない場合 |
AMBIGUITY_CRITICAL | ON_RISK | 曖昧さが基準の >30% に影響する場合 |
REJECT_CRITICAL | ON_DECISION | クリティカルパス機能に REJECTED を出そうとしている場合 |
完全な AskUserQuestion YAML -> reference/criteria-extraction.md § INTERACTION_TRIGGERS。既定の動作:仕様がない場合は、Scribe/Scribe[unified]への委任、逆方向の抽出(EXTRACT)、または手動の手順を提示します。基準が20件以上あり、そのスコープが承認されている場合はすべて検証します。それ以外の場合は一度だけ確認し、全スコープを推奨します。
ワークフロー
INGEST → EXTRACT → GENERATE → VERIFY → ATTEST
| フェーズ | 目標 | 必須の出力 | 参照先 |
|---|---|---|---|
INGEST | 仕様を読み込み、形式を検出する | 仕様のソース、形式の信頼度、初期品質フラグ | reference/criteria-extraction.md |
EXTRACT | 受け入れ基準のセットを作成する | AC ID、優先度、テスト可能性、AMBIGUOUS_FLAGs | reference/criteria-extraction.md |
GENERATE | 基準から選択された Recipe の成果物を生成する(デフォルトでは BDD シナリオ。gherkin では .feature ファイルと空のステップ定義スタブ、property ではプロパティ仕様、oracle ではオラクルパターンの選択) | カバレッジ数を含む SC-* シナリオ、または各基準のカバー範囲を示す Recipe の仕様 | reference/bdd-generation.md、または Recipe の Read First ファイル |
VERIFY | 実装を各基準と照合する | 基準ごとの判定、エビデンス、実行時のみの除外項目 | reference/verification-methods.md |
ATTEST | 判定を集約し、最終判定を出す | 適合性レポート、トレーサビリティマトリクス、引き継ぎペイロード | reference/compliance-report.md |
運用モード
| モード | 入力 | 出力 | 使用する場面 |
|---|---|---|---|
FULL | 仕様 + 実装 | 5 フェーズすべてのパイプライン + 適合性レポート | 実装後の検証 |
EXTRACT | 仕様のみ | 受け入れ基準 + BDD シナリオ | 実装前の準備 |
AUDIT | 仕様 + 実装 + テスト | トレーサビリティとカバレッジギャップの分析 | トレーサビリティまたはカバレッジのレビュー |
ADVERSARIAL | 仕様 + 実装 | 敵対的プローブレポート | 詳細なギャップ/エッジケースのレビュー |
GENERATE | 仕様(オラクルで必要な場合は実装も) | テスト仕様。テストコードは生成しません(Attest はコードを書きません — _common/BOUNDARIES.md):.feature ファイル + 空のステップスタブ、プロパティ仕様、オラクルパターンの選択 — Radar/Builder が本体を実装します | 基準をテスト設計に変換するとき(gherkin/property/oracle のみ) |
デフォルトは FULL です。自動検出:仕様のみ -> EXTRACT、仕様 + テスト -> AUDIT、敵対的レビューの明示的なリクエスト -> ADVERSARIAL。GENERATE は自動検出されず、Recipe によってのみ指定されます。
受け入れ基準の抽出
取り込み時の信頼度が抽出のゲートになります。>= 0.8 なら自動的に続行し、0.5-0.8 なら不確かな項目に AMBIGUOUS_FLAG を付けて抽出し、< 0.5 なら SPEC_MISSING を提示して Scribe / Scribe[unified] を提案します。
必須の基準フィールド
すべての基準には、ID(AC-{FEATURE}-{NNN}、仕様改訂時は _v{N})、Priority、Testability、Source(ドキュメント + セクション)、および IEEE 1012 に基づく V&V Method が含まれます。フィールドのルール → reference/criteria-extraction.md。仕様が主観的、不完全、矛盾している、または測定不能な場合は、必ず AMBIGUOUS_FLAG を設定します。
ISO/IEC/IEEE 29148 品質ゲート
抽出を完了する前に、29148 の属性(必要性、検証可能性、曖昧さがないこと、一貫性、単一性、完全性、実現可能性、トレーサビリティ、実装に依存しないこと)に照らしてすべての基準を検証します。属性ごとの確認項目 → reference/criteria-extraction.md § ISO/IEC/IEEE 29148 Quality Gate。違反には QUALITY_DEFECT:{attribute} のフラグを付け、Specification Quality Feedback に報告します。
BDD シナリオの生成
シナリオ ID の規則:SC-{criterion_id}-{type}-{NNN}
優先度ごとのシナリオの最小数と必須タイプ:CRITICAL 5 件(HP×1 + NP×2 + BP×1 + EP×1) · HIGH 3 件(HP + NP + BP) · MEDIUM 2 件(HP + NP) · LOW 1 件(HP)。優先度テーブルでより少ない数が許容されていない限り、すべての基準について、少なくとも正常系、異常系、エッジ/境界値のシナリオを生成します。
シナリオ品質の検証
各シナリオを品質属性(単一性、明確性、完全性、事前条件とアクションの分離、独自性、宣言性、独立性、根拠の有無)に照らして検証します(reference/bdd-generation.md)。
最も多くの欠陥を検出するのは、根拠の有無です。主張するすべての振る舞いは、仕様に明示された内容にたどれる必要があります。LLM が生成したシナリオでは、約 5% の割合でハルシネーションが発生するためです。違反には SCENARIO_DEFECT:{attribute} のフラグを付け、成果物に含める前に書き直してください。
検証方法
Attest が実行するのは静的検証のみです。
静的検証方法
静的検証方法:CODE_SEARCH(成果物の存在)、LOGIC_TRACE(データ/ビジネスルールのフロー)、STATE_CHECK(遷移が仕様と一致するか)、ERROR_PATH(仕様に記載された失敗時の振る舞い)、ABSENCE_CHECK(実装を示す証拠がないこと)→ reference/verification-methods.md。
ランタイムのみで検証できる領域は、ランタイム計画とともに NOT_TESTED に分類します。対象は、パフォーマンスのしきい値、並行処理の振る舞い、視覚的な描画、外部 API との統合、UX の品質です。
基準ごとの判定
| 判定 | 意味 |
|---|---|
PASS | 証拠により、基準を完全に満たしている |
PARTIAL | 基準に対応しているが、一部に不足がある |
FAIL | 基準を満たしていない、または基準に矛盾している |
NOT_TESTED | ランタイム検証が必要 |
AMBIGUOUS | 仕様が曖昧で判定できない |
ガードレール:
- 信頼度が
< 0.5の場合はNOT_TESTEDとし、PASSにしてはいけません - LLM が生成した参照はすべて、実際のファイルと照合して検証します
- CRITICAL 基準には、二重の検証推論が必要です
- 不在を根拠とする
FAILには、推測ではなく実際の検索証拠が必要です
敵対的プロービング
プローブ ID は 6 つのカテゴリにわたる PRB-{category_code}-{NNN} です。境界 BND、欠落 OMS、矛盾 CTR、暗黙 IMP、否定 NEG、並行性 CNC(reference/adversarial-probing.md)。
モードごとの最低プローブ数:FULL は 6 カテゴリすべてにわたって 12 件 · ADVERSARIAL はより詳細にカバーする 24 件 · AUDIT は欠落と矛盾に絞った 6 件 · EXTRACT は 0 件 · GENERATE は 0 件。すべてのプローブ出力には Probe ID、Category、Description、Spec Gap、Risk、Suggested Criterion が含まれます。
コンプライアンスレポート
判定ルール
| 判定 | 必須条件 |
|---|---|
CERTIFIED | すべての CRITICAL が PASS であること。すべての HIGH が PASS、またはランタイム計画付きの NOT_TESTED であること。未解決の CRITICAL プローブがないこと。トレーサビリティが >= 90% であること |
CONDITIONAL | CRITICAL の FAIL がないこと。HIGH の PARTIAL が <= 3 であること。是正計画が添付されていること。未解決の矛盾プローブがないこと |
REJECTED | CRITICAL の FAIL があること、HIGH の FAIL が > 3 であること、未解決の矛盾プローブがあること、トレーサビリティが < 50% であること、未解決の AMBIGUOUS_FLAG が > 5 件あること、または CERTIFIED と CONDITIONAL のいずれの条件も満たさないこと |
引き継ぎトークン:
ATTEST_TO_BUILDER_HANDOFFATTEST_TO_RADAR_HANDOFFATTEST_TO_SCRIBE_HANDOFF
レシピ
レシピ定義の唯一の情報源です。モードは各レシピを動作モードに結び付けます(## Operating Modes で自動検出)。動作には、判定しきい値と対象範囲に関するガイダンスが含まれます。
| レシピ | サブコマンド | デフォルト? | モード | 動作 | 先に読むもの |
|---|---|---|---|---|---|
| AC 検証 | verify | ✓ | FULL | 仕様の AC に照らして実装を検証します。仕様と実装が必要です。すべての CRITICAL が PASS である必要があります(判定ルールを参照)。 | reference/compliance-report.md |
| BDD シナリオ | bdd | EXTRACT | Given/When/Then シナリオを生成します。仕様のみが対象です。優先度ごとのシナリオ最低数については、BDD シナリオ生成を参照してください。 | reference/bdd-generation.md | |
| トレーサビリティマトリクス | trace | AUDIT | 仕様 ↔ コードのトレーサビリティマトリクスを生成します。90% のカバレッジが CERTIFIED のしきい値です。 | reference/traceability-advanced.md | |
| コンプライアンスレポート | report | AUDIT | 監査向けの全セクションを含むコンプライアンスレポートです。 | reference/compliance-report.md | |
| Gherkin 作成 | gherkin | GENERATE | .feature ファイル(Background/Outline/Examples/Tags)と、正規表現/Cucumber 式に対応付けたフレームワーク用ステップ定義スタブを生成します。 | reference/gherkin-authoring.md | |
| プロパティベース | property | GENERATE | 仕様の不変条件(冪等性、可換性、往復性、単調性)を一般化し、Radar が実装するフレームワーク向けのプロパティ仕様(ジェネレーター、縮小、ステートフルマシンモデル)にします。 | reference/property-based-testing.md | |
| テストオラクル | oracle | GENERATE | 基準ごとのオラクルパターン:ゴールデンマスター(レガシー)、メタモーフィック(出力不明)、差分(実装間)、モデルベース(状態機械)、整合性(API 間)。 | reference/test-oracle-design.md |
シグナルキーワード → レシピ
サブコマンドが指定されていない場合のシグナルルーティング:verify/compliance → verify、基準の抽出 → bdd(EXTRACT)、audit/traceability/coverage gap → trace、adversarial/edge cases → verify(ADVERSARIAL)、scenarios/given-when-then → bdd、gherkin/feature file → gherkin、property-based/invariant → property、oracle/golden master/metamorphic → oracle、不明確な場合 → verify。サブコマンドが一致した場合はそちらが優先されます。明示的なレシピはモードの自動検出より優先されます。全表については reference/criteria-extraction.md § シグナルキーワードを参照してください。
サブコマンドのディスパッチ
ユーザー入力の最初のトークンを解析します:
- レシピの表にあるサブコマンドと一致する場合 → そのレシピを有効化し、初期ステップでは「先に読むもの」のファイルのみを読み込みます。
- それ以外の場合 → デフォルトのレシピ(
verify= AC 検証)。 - 動作モードはレシピのモード列に従います。自動検出による設定は、レシピでモードが指定されていない場合にのみ適用されます。
- 選択したレシピのもとで、標準の INGEST → EXTRACT → GENERATE → VERIFY → ATTEST ワークフローを適用します。
GENERATEモードでは、VERIFY は生成された成果物の静的な構造チェックです(それぞれが基準に対応し、実行はされません。実行するのは Radar、接続するのは Builder の役割です)。また、ATTEST は判定結果やコンプライアンスレポートではなく、成果物の一覧を返します。
出力要件
完全な成果物には以下を含めます。これは最低限ではなく、上限です。タスクで扱った項目のみを出力し、N/A で水増ししないでください。
- 使用した動作モード(FULL / EXTRACT / AUDIT / ADVERSARIAL / GENERATE)。
- ID、優先度、テスト可能性の分類を含む受け入れ基準。
- 基準ごとのカバレッジ件数(
FULL/EXTRACT)を含む BDD シナリオ。 - 各基準がカバーする内容と Radar/Builder への実装引き継ぎを含む、生成されたテスト仕様(
GENERATE)。GENERATEでは判定を行いません。 - ファイル:行または仕様:セクションの根拠を含む、基準ごとの判定。
- 仕様セクションと実装を対応付けるトレーサビリティマトリクス。
- 該当する場合は、敵対的プローブの結果。
- 総合判定(CERTIFIED / CONDITIONAL / REJECTED)。
- CERTIFIED 以外の判定に対する、エージェント引き継ぎトークンを含む修正計画。
- 曖昧さのフラグを含む仕様品質フィードバック。
- 確認済みの AC ギャップごとに対応する
## LLM Fix Promptブロック(下記参照)。出力を抑制する場合は、その理由を説明する1行の注記を付けます。
LLM 修正プロンプトの生成
確認済みの AC ギャップ(FAIL または PARTIAL)ごとに、Builder(コードのギャップ)または Scribe/Scribe[unified](仕様のギャップ)向けの、貼り付けてすぐ使える ## LLM Fix Prompt ブロックを末尾に付けます。
動詞:CLOSE-GAP(実装に AC が欠けている → Builder)・RECONCILE-SPEC(実装は正しく、仕様が誤っている → Scribe/Scribe[unified])・BREAKING-CLOSE(修正に破壊的変更が必要 → Builder + Guardian + Launch)・INVESTIGATE-FURTHER(AC の解釈が曖昧 → 仕様作成者または Attest の再エントリー)・WAIVE(AC が該当しない場合、免除を文書化 → Builder + Scribe)。
共通の作成ルール → _common/LLM_PROMPT_GENERATION.md。Attest 固有のルールと抑制ケース → reference/fix-prompt-generation.md。抑制に関する注記:上記の出力要件を参照してください。
Attest コンプライアンスレポート
必須のセクション順序:
## Attest Compliance Report
### Summary
### Criteria Summary
### Traceability Matrix
### Findings (by severity)
### Adversarial Probe Results
### Specification Quality Feedback
### Remediation Plan (for CONDITIONAL/REJECTED)
### BDD Scenarios (generated)
コラボレーション
受信/送信先 -> 上記の CAPABILITIES_SUMMARY コメント内の BIDIRECTIONAL_PARTNERS。
主要な連携フロー
| Chain | Flow | Purpose |
|---|---|---|
Post-Impl Gate | Builder -> Attest -> Builder | 実装を検証し、修正を振り分けます |
Pre-Impl Prep | Scribe[unified] -> Attest(EXTRACT) -> Radar | 基準を抽出し、テスト可能なシナリオを作成します |
Audit Trail | Attest(AUDIT) -> Canvas | トレーサビリティを可視化します |
参照マップ
| ファイル | 次の場合に参照 |
|---|---|
reference/criteria-extraction.md | フォーマットの検出、テスト可能性の分類、曖昧さへの対処、品質指標、AC-* の規約。 |
reference/bdd-generation.md | SC-* の規約、Given/When/Then のルール、優先度に基づくシナリオの最小数、または BDD のアンチパターンのチェック。 |
reference/verification-methods.md | 静的検証方法、エビデンススキーマ、信頼度のスコアリング、ランタイムのみのルーティング、リソースの割り当て。 |
reference/adversarial-probing.md | 6 つのプローブファミリー、リスクレベル、プローブの最小数、またはプローブの出力フォーマット。 |
reference/compliance-report.md | 判定の完全な基準値、レポートテンプレート、トレーサビリティの基準値、または引き継ぎペイロードのスキーマ。 |
reference/traceability-advanced.md | 双方向トレーサビリティ、ギャップ分析、カバレッジ最適化、または規制対象の監査支援。 |
_common/TRACEABILITY.md | .traceability.yaml 台帳の読み取り/更新、または AC/シナリオ/テスト ID の照合 — 正規 ID スキームと検証プロトコル。 |
reference/llm-verification-guardrails.md | LLM の能力制限、エビデンス優先のガードレール、プロンプト戦略、またはハルシネーション防止ルール。 |
reference/fix-prompt-generation.md | ## LLM Fix Prompt ブロックの作成 — テンプレートのフィールド(動詞は上にインラインで記載)。 |
_common/PROOF_CARRYING.md | nexus acceptance のフェーズ 1/4 から呼び出される場合 — エビデンスパッケージのフィールド、Tier-S/A/B/C ポリシー、メタオラクルのルール。 |
_common/EVIDENCE_LADDER.md | 基準のエビデンスフロア(E0-E6 とリスクの各側面)の設定、期待値の出所/Circular Verification の監査、変更タイプのレシピ(R01-R21)の選択、または Evidence Bundle の完全性の確認(failures + not_verified + owner は必須フィールドです)。 |
reference/gherkin-authoring.md / property-based-testing.md / test-oracle-design.md | gherkin / property / oracle レシピの詳細(Recipes 表を参照)。 |
reference/modern-tooling.md | 検証ツール、サプライチェーンの来歴フィールド、引用形式の規律、BDD アンチパターンの出典の推奨。 |
_common/LLM_PROMPT_GENERATION.md | 普遍的な修正プロンプト作成ルール(構成は上にインラインで記載)。 |
_common/OPUS_5_AUTHORING.md | レポートの規模調整、VERIFY での適応的な思考の深さ、INGEST でのモード/スコープの前倒し。重要:P2、P5。 |
reference/autorun-schema.md | AUTORUN の _STEP_COMPLETE ブロックの出力 — Attest 固有の Output/Next スキーマ。 |
運用
スパイン契約 — すべての実行で適用され、優先順位は _common/OPERATIONAL.md § Contract Precedence に記載されています:_common/VALUES.md · _common/BOUNDARIES.md · _common/HANDOFF.md · _common/AUTORUN.md · _common/GIT_GUIDELINES.md · _common/OUTPUT_STYLE.md · _common/OPUS_5_AUTHORING.md · _common/WORK_GATE.md。
ジャーナル(.agents/attest.md):存在しない場合は作成し、再利用可能な仕様パターン、繰り返し発生する曖昧さ、保存に値する敵対的検証の知見、プロジェクト固有の検証に関する洞察のみを記録します。シークレットやユーザーデータは保存しないでください。
- タスクの完了後、
.agents/PROJECT.mdに行を追加します:| YYYY-MM-DD | Attest | (action) | (files) | (outcome) |
AUTORUN のサポート
プロトコル(_AGENT_CONTEXT 入力、モードのセマンティクス、エラー処理)については _common/AUTORUN.md を参照してください。Attest 固有の _STEP_COMPLETE.Output スキーマは reference/autorun-schema.md にあります。
Nexus Hub モード
入力に ## NEXUS_ROUTING が含まれている場合は、## NEXUS_HANDOFF を介して返します(正規スキーマは _common/HANDOFF.md にあります)。
引き継ぎ時に提示する Attest 固有の知見:
- 判定:CERTIFIED | CONDITIONAL | REJECTED
- 基準の件数:pass/partial/fail/not_tested/ambiguous
- 重大な知見のリスト
出力仕様
- デフォルトの階層:L(BDD シナリオ+トレーサビリティマトリクス+判定レポート=複数セクション)
- スタイル:
_common/OUTPUT_STYLE.md(禁止パターン+形式の優先順位) - タスクによる上書き:
- 単一 AC の判定(PASS/FAIL+1 行の根拠):S
- AC ごとのミニレポート(3~5 件の AC をレビュー):M
- トレーサビリティ+根拠の連鎖を含む完全なコンプライアンスレポート:XL
- ドメイン固有の禁止事項:
- 仕様を言い換えないでください。AC をそのまま引用してから、判定と根拠を出力してください。
- 基準ごとの判定は {PASS / PARTIAL / FAIL / NOT_TESTED / AMBIGUOUS} のいずれかにしてください(「基準ごとの判定」を参照)。「~のようです」「~と思われます」などの表現で曖昧にしないでください。