docs(specs): guardrails ADR — agent-spanning anti-patterns as OpenCode mechanism

[terisuke]

概要

5 リポジトリ横断調査(Grift / ai-cluster / phone-training-system / persona-village-forecast / persona-village-v2)で、エージェント(Claude Code / Codex / Cursor / Grok / OpenCode)を問わず反復する実装問題を抽象化し、ドキュメントではなく OpenCode の仕組み(plugin / permission / command / skill)で止めるための ADR。

8 パターン(抽象化)

#	パターン	実例
A	変更の影響範囲分析の欠如	Grift anomalyco#1741/anomalyco#1750(削除で結線破壊)
B	並列実行の権限不足	Grift team/subagent の git deny
C	パイプラインの両極端	重層レビュー vs レビュー 0 往復 vs PR +4753 行
D	環境の過剰構築	cloudia-grift-uat(1 日+リソース→削除)
E	Issue/ブランチ/worktree 放置	persona-village-v2 86 ブランチ・24 worktree
F	反証なし修正	anomalyco#1741(バグより悪化)
G	余計なパイプラインを作らない	重量級基盤が学習を遅らせる
H	外部エージェント非依存ダブルチェック	客観性証明を他エージェントに依存

決定

• ガードは「ドキュメントではなく仕組み」で実装(CI 結線テスト → plugin → permission → command/skill の 4 レイヤー)
• 各パターンを にマッピング
• 実装は反証付き(ガードを無効化すると落ちる)

配置

• specs/ai-guardrails-anti-patterns.md(本 ADR)
• 実装は packages/guardrails/profile/(plugin 3 本 + command 3 本 + skill 4 本 + permission 変更)

Refs: #1(epic: internal AI guardrails)

[github-actions]

This PR doesn't fully meet our contributing guidelines and PR template.

What needs to be fixed:

• PR description is missing required template sections. Please use the PR template.

Please edit this PR description to address the above within 2 hours, or it will be automatically closed.

If you believe this was flagged incorrectly, please let a maintainer know.

[github-actions]

The following comment was made by an LLM, it may be inaccurate: