메뉴
docs/architecture/harness.md の invariant を機械的に検証するスキル。引数なしで `--staged --fail-on=error` (PR 直前用)、`full` で全件スキャン、`why <RULE_ID>` で invariant の意図を harness.md から引いて表示。コミット直前・Stop hook・PR 作成前ゲート・invariant 違反の調査に使う。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Issue、ADR、設計メモ、実装計画、PR diff、指定 path に対し、書かれていない前提、producer / consumer の未接続、実運用だけで露出する failure path をコードと設定の証拠付きで探索する review-only スキル。実装前、設計レビュー、PR 前に未知や blocker を確認するときに使う。
プロジェクトを Bun + Hono（バックエンド）+ Vite + React（フロントエンド）+ Biome でスキャフォールドする初期化スキル。テンプレートを clone した直後の初回セットアップ時に、ユーザーが明示的に実行する。
新機能をヒアリング → 仕様化 → Issue 作成 → 5 役割並列実装の順で進める機能開発オーケストレーションスキル。「○○を作って」「○○機能を追加して」など新機能・機能拡張の実装依頼を受けたら、直接実装を始めずに必ず最初に使う。
PR の主目的から外れた発見・改善・技術的負債を「フォローアップ」として記録、列挙、解消管理するスキル。スコープクリープを防ぎ、scope 外の課題を別 PR で確実に処理する仕組み。引数なしで起動すると未処理一覧、`add <title>` で追加、`resolve <id> <pr-url>` で解消記録、`list-pr-body` で PR 本文に貼る markdown を出力。作業中に scope 外の改善点・技術的負債・バグを見つけたら必ず使う。
.claude 配下のスキル・フック・設定をサプライチェーン成果物として監査するスキル。harness のスキル invariant (frontmatter 検証 / 隠し指示検出 / 危険実行パターン) の全件スキャンと、機械検査で拾えない「宣言と実態の乖離」のレビューチェックリストを実行する。スキルの新規追加・更新時、サードパーティスキルの導入前、定期監査に使う。
| name | architecture-harness |
| description | docs/architecture/harness.md の invariant を機械的に検証するスキル。引数なしで `--staged --fail-on=error` (PR 直前用)、`full` で全件スキャン、`why <RULE_ID>` で invariant の意図を harness.md から引いて表示。コミット直前・Stop hook・PR 作成前ゲート・invariant 違反の調査に使う。 |
| argument-hint | [full | why <RULE_ID>] |
| allowed-tools | Read, Grep, Bash(bun scripts/architecture-harness.ts:*), Bash(bun test scripts:*), Bash(awk:*) |
docs/architecture/harness.md で定義された invariant を scripts/architecture-harness.ts で機械検証する。invariant の正本は docs/architecture/harness.md、本スキルはあくまで実行の入り口。
bun scripts/architecture-harness.ts --staged --fail-on=error
exit code 2 なら invariant 違反あり。markdown レポートが標準出力に出るので、違反箇所と invariant ID を確認してコードを修正する。設定や invariant を緩める方向の修正は ADR が必要。
full — リポジトリ全体スキャン (リファクタ後の総点検用)bun scripts/architecture-harness.ts --fail-on=warning
--fail-on=warning で warning 以上を拾う。新規 invariant を追加した直後や、大規模リファクタ後の総点検に使う。
--skills-only — スキル invariant だけを実行 (リポジトリ外の検査用)bun scripts/architecture-harness.ts --skills-only --root=<dir> --fail-on=warning
INVARIANT_SKILL_* のみ実行し、bunfig.toml 等のリポジトリ前提 (REPO_CHECKS) をスキップする。サードパーティスキルの導入前検査 (/skill-audit pre-install) から使われる。
why <RULE_ID> — invariant の意図を表示docs/architecture/harness.md から該当 invariant のセクションを抜き出して表示する。レビュー中に「この invariant は何を守ってるんだっけ?」となったときに使う。
RULE_ID="$1"
awk -v rule="$RULE_ID" '
$0 ~ "^- `" rule "`" {found=1; print; next}
found && /^- `INVARIANT_/ {found=0}
found {print}
' docs/architecture/harness.md
/architecture-harness why <RULE_ID> で意図を再読/architecture-harness で違反 0 件を確認docs/adr/NNNN-...md)。本スキルで「緩める」判断はしないADR テンプレート: docs/adr/0000-template.md
scripts/architecture-harness.tsdocs/architecture/harness.md/follow-up スキルCLAUDE.md の「ハーネスとゲート」節