Skip to content

Commit cc03aa4

Browse files
authored
Merge pull request #314 from Cor-Incorporated/chore/phase22-opencode-profile
docs(guardrails): OpenCode実効profileへ委任payloadを同期
2 parents 2a2fe21 + cd13387 commit cc03aa4

1 file changed

Lines changed: 86 additions & 45 deletions

File tree

‎packages/guardrails/profile/AGENTS.md‎

Lines changed: 86 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -50,50 +50,73 @@ Defaults: read-only workers `600000` (10m); write workers and deepseek `1200000`
5050
- Bug fixes: grep all instances → fix all → re-grep to confirm zero remaining
5151
- Fact-check: back every claim with CLI output, git diff, or API response; mark estimates as "(unverified)"
5252

53-
## Route B/C 委任受領契約
54-
55-
handover を受領したら、次の 10 欄が一字一句一致で存在し、内容が埋まっていることを着手前に確認する。不足欄を推測で補わない。
56-
57-
1. 停止条件と最大反復
58-
2. 報告間隔 / 無進捗タイムアウト
59-
3. 課金上限
60-
4. 発射前の実現可能性チェック
61-
5. 人間ゲート列挙(「リマインドのみ」セクションに分離)+ 待ち中の可否
62-
6. 反証可能な完了条件
63-
7. 事前スパイク回答欄
64-
8. 完了条件の検査
65-
9. 追加を提案しない
66-
10. 強制点の実測表
67-
68-
H8 の補助欄は次の 7 欄を一字一句一致で記載し、各欄を 20 文字以上の実質内容で埋める。
69-
70-
### 一次資料
71-
72-
推測ではなく、判定に用いる Issue・正本・実装・実測証跡を列挙する。
73-
74-
### 要求インベントリ
75-
76-
要求を原子単位で列挙し、実装・検証・人間ゲートの境界を分ける。
77-
78-
### 突合表
79-
80-
要求と実装、実装と配備、配備と実測を対応づけて漏れを示す。
81-
82-
### 標準質問
83-
84-
過大主張、未検証境界、権限越境、既存装置の破壊がないかを問う。
85-
86-
### 北極星
87-
88-
活動量ではなく、今回の変更で到達させる利用者価値または事故削減を示す。
89-
90-
### 反証軸
91-
92-
実装前に、F1 の軸列挙、F2 の事故入力、F3 の片側変異のいずれかを 20 文字以上で書く。「テスト green」だけは不可。
93-
94-
### 撤収
95-
96-
worktree の回収先として commit / PR 番号または retire 判定を書き、`active` / `recover` / `preserve` / `retire` のいずれかを含める。
53+
## 完了報告の証跡トレーラー(不可逆・課金・完了宣言に限定)
54+
「完了」「verified」「根因確定」を含む報告の末尾に必須:
55+
`Evidence: <実行コマンド> | <生出力の要点 or ログパス> | <実行時刻>`
56+
- 宣言ファイルを変えたら「誰がそれを読んで強制しているか」の grep 結果を同報告に貼る
57+
- 監督(Claude/人間)の記載に事実誤りを見つけたら実測付きで反証してよい
58+
59+
## 委任受領プロトコル(経路 B/C)
60+
- 受領した handover に次の 10 欄が無ければ、着手前に不足欄を指摘して返す。
61+
`停止条件と最大反復` / `報告間隔 / 無進捗タイムアウト` / `課金上限` /
62+
`発射前の実現可能性チェック` /
63+
`人間ゲート列挙(「リマインドのみ」セクションに分離)+ 待ち中の可否` /
64+
`反証可能な完了条件` / `事前スパイク回答欄` / `完了条件の検査` /
65+
`追加を提案しない` / `強制点の実測表`。
66+
- H8 補助欄として `一次資料` / `要求インベントリ` / `突合表` / `標準質問` /
67+
`北極星` / `反証軸` / `撤収` も空欄不可。Route B/C の 10 欄とは別に検査する。
68+
- 「詰まっています」は義務発信: 同一エラーで 3 回失敗 / 30 分無進捗 / 判断待ちで
69+
次の手が無い、のいずれかで作業を止めて報告する(無言のリトライ継続は禁止)
70+
- 人間ゲート待ち中: 準備・別タスクは可。本番系の迂回経路新設は不可
71+
72+
## 新規依存の実物照合(着手前に回答。空欄不可・「確認せず採用」は明記すれば可)
73+
- 新規フレームワーク / 外部 API: インストール済みソース・公式 docs・実レジストリで確認したか
74+
- 性能仮説(速くなるはず): 数ターンの最小実測をしたか
75+
- 組織ポリシー: org allowlist / quota / 環境変数の実在を確認したか
76+
77+
## リポ個別の禁止事項枠
78+
handover の「禁止事項」節は本ブロックと同格の絶対遵守として読む。
79+
違反しかけた場合はその場で停止して報告する。
80+
81+
## 並列作業の撤収(完了条件)
82+
- 完了報告 3 欄: 回収コミット SHA / 削除した worktree・ブランチ / 残す判断待ち在庫(理由つき)
83+
- worker 成果の回収は定型コミット `chore(team): apply worker changes` を完了条件に含める
84+
85+
## AI作成PR本文のH5マーカー書式
86+
87+
PRを作る前に変更パスを確認し、初版本文へ次の機械可読マーカーを証跡から記入する。最初のCI失敗を待って書式を学ばない。これは既存 `h5-admission` の入力契約を可視化する節であり、強制点そのものは変更しない。
88+
89+
実行環境を持たない変更は次の1行を使う。
90+
91+
```text
92+
H5-E2E: none
93+
```
94+
95+
実行環境を持つ変更はコマンドと20文字以上の生出力要約または安定ログパスを対にする。
96+
97+
```text
98+
H5-E2E: <実際に実行したコマンド>
99+
H5-E2E-OUT: <生出力要約または安定ログパス、20文字以上>
100+
```
101+
102+
`hooks/**/*.sh`、`scripts/**/*.sh`、`settings.json`、`.github/workflows/**` の変更はguard/verifier PRとして、実測した内容を次の形で全て書く。
103+
104+
```text
105+
H5-guard: yes
106+
H5-NEGATIVE: <既知の事故入力と修正前red/exit結果>
107+
H5-LEDGER: <発火がaidd_ledger_appendまたはguard-ledger.jsonlへ届く経路>
108+
H5-RETIRE: <測定可能な撤収条件>
109+
H5-SUBTRACTION: N/A
110+
```
111+
112+
既存装置を廃止する場合だけ `H5-SUBTRACTION: N/A` の代わりに `H5-RETIRE-PR: <merge済みPR番号>` を使う。宣言と強制のpairを変更する場合は両側と片側変異を記録し、変更しない場合は該当なしを明示する。
113+
114+
```text
115+
H5-PAIR: <宣言側> ↔ <強制側>; mutation=<片側変異のred結果>
116+
H5-PAIR: N/A
117+
```
118+
119+
「該当なし」を使えるのは `H5-E2E: none`(実行環境なし)、`H5-SUBTRACTION: N/A`(装置純増・廃止なし)、`H5-PAIR: N/A`(pair変更なし)だけである。構造パス変更の `H5-NEGATIVE` / `H5-LEDGER` / `H5-RETIRE` をN/Aで埋めてはならない。非構造PRでは不要なguardマーカーを省略する。`H5-PAIR` は可視化欄であり、現行h5の合否入力ではない。
97120

98121
## 診断プロトコル(可視化のみ)
99122

@@ -114,7 +137,6 @@ AI が作成する非 merge commit の末尾に、次の trailer を 1 行記録
114137

115138
これは可視化であり強制ではない。Claude Code の Co-Authored-By は削除せず併記する。
116139
trailer が無い、値が不正、または複数値が競合する commit は H10 で unknown として数える。
117-
118140
## Git Workflow
119141

120142
- Protected branches: dev, develop, main, master — no direct push (hard-blocked by the guardrail plugin; force-push is also hard-blocked), PR only by convention
@@ -124,6 +146,25 @@ trailer が無い、値が不正、または複数値が競合する commit は
124146
- Merge: default `--merge`, `--squash` only when explicitly requested
125147
- Check CI status before merging (`gh pr checks`); GitHub branch protection and repo CI are the authoritative merge gates, not this profile
126148

149+
## OpenCode runtime H8 compatibility
150+
151+
The local wrapper smoke reads the seven H8 fields as Markdown headings. The
152+
authoritative wording remains the payload-managed contract above.
153+
154+
### 一次資料
155+
156+
### 要求インベントリ
157+
158+
### 突合表
159+
160+
### 標準質問
161+
162+
### 北極星
163+
164+
### 反証軸
165+
166+
### 撤収
167+
127168
## Delegation
128169

129170
- Dialog, judgment, design → main agent

0 commit comments

Comments
 (0)