feat(guardrails): implement 8 anti-pattern guards in profile (plugin/command/permission/skill) #284

背景

ADR specs/ai-guardrails-anti-patterns.md(PR #283)で、5 リポジトリ横断調査から抽象化した 8 つの実装アンチパターンを OpenCode の仕組みで止める。epic #1 の「plugin- and command-based guardrails」workstream の具体化。

ゴール

packages/guardrails/profile/ に以下のガードを実装し、「ドキュメントではなく仕組み」で 8 パターンを防ぐ。全ガードは反証付き(無効化すると落ちる)で実装すること。

実装内容(Phase 1: 即効)

1. Plugin: 変更の影響範囲ガード(パターン A)

• ファイル: packages/guardrails/profile/plugins/removal-guard.ts
• tool.execute.before フック:
  • git rm / git add -A(削除含む)を検知 → 削除対象ファイルを抽出
  • リポジトリ全体で逆被参照 grep → 参照があれば警告ログ + エージェントに確認を強制
• 反証: ガードを無効化すると、削除時に参照が検出されないことをテストで示す

2. Permission: 並列実行の権限整備(パターン B)

• ファイル: packages/guardrails/profile/opencode.json の permission
• 読み取り系 git を allow: git worktree list / git merge-base * / git status* / git log*
• 破壊系を ask/deny: git worktree add *(ask)/ git branch -D *(ask)/ git push --force*(deny)
• 反証: subagent が git worktree list を実行でき、git push --force を実行できないことをテストで示す

3. Plugin: セッション開始時の衛生警告(パターン E)

• ファイル: packages/guardrails/profile/plugins/hygiene-warning.ts
• event フックでセッション開始時に worktree 数・マージ済み放置ブランチ数をカウント
• 閾値(worktree > 8 / 放置ブランチ > 10)超えで警告
• 反証: 閾値以下のリポジトリでは警告が出ないことをテストで示す

4. Command: /plan-light(パターン C / G)

• ファイル: packages/guardrails/profile/commands/plan-light.md
• 実装前に「最小の検証パス」(fake テスト → CI → PR)を 1 行で宣言させる
• 重厚なパイプライン(複数環境・重層レビュー)を提案したら「まず最小パスで」と誘導
• 反証: 重厚な計画を提示したときに /plan-light が最小パスに誘導することをテストで示す

5. Command: /env-check(パターン D)

• ファイル: packages/guardrails/profile/commands/env-check.md
• 新環境を作る前に「既存環境(dev 等)で足りるか」を確認させる
• 新環境構築は最後の手段であることを明示
• 反証: 既存で足りるケースで新環境構築をブロックすることをテストで示す

6. Command: /repo-hygiene(パターン E)

• ファイル: packages/guardrails/profile/commands/repo-hygiene.md
• 放置ブランチ/worktree/マージ済み残骸を列挙し、削除候補をドライラン提示
• 実際の削除は実行せず、エージェントの判断を求める

7. Skill: 4 本(パターン F / G / H / A)

• packages/guardrails/profile/skills/falsifiable-change/SKILL.md(F): 修正は「外すと落ちる」を実測してから報告
• packages/guardrails/profile/skills/lean-pipeline/SKILL.md(C / G): 最小検証パスをデフォルトに
• packages/guardrails/profile/skills/self-check/SKILL.md(H): 外部エージェント非依存の客観性証明(結線テスト)
• packages/guardrails/profile/skills/impact-analysis/SKILL.md(A): 変更前に逆被参照を列挙

受入条件

• 全 8 パターン(A〜H)に対応するガードが packages/guardrails/profile/ に存在する
• 各ガードが反証付き(無効化すると落ちるテストが同 PR にある)
• 既存の guardrail plugin / team plugin と競合しない(新規ファイル)
• 既存テスト(bun run local:check 等)が green
• PR は小さく分割可(1 PR = 1 ガード)

参照

• ADR: specs/ai-guardrails-anti-patterns.md(PR docs(specs): guardrails ADR — agent-spanning anti-patterns as OpenCode mechanism #283)
• epic: epic: internal AI guardrails thin distribution for Cor-Incorporated #1
• 実例: Grift Bug: primary agent stop working if provided an image path anomalyco/opencode#1741 / Setting baseURL requires provider.anthropic.models anomalyco/opencode#1750(パターン A/F)/ Feature request: support claude opus 4 and 4.1 agent in github copilot anomalyco/opencode#1753(経路B ハンドオーバー)