메뉴
docs/architecture/harness.md の invariant を機械的に検証するスキル。引数なしで `--staged --fail-on=error` (PR 直前用)、`full` で全件スキャン、`why <RULE_ID>` で invariant の意図を harness.md から引いて表示。コミット直前 / Stop hook から呼ばれる前提。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
新機能をヒアリング → 仕様化 → Issue 作成 → 5 役割並列実装の順で進める機能開発オーケストレーションスキル。
PR の主目的から外れた発見・改善・技術的負債を「フォローアップ」として記録、列挙、解消管理するスキル。スコープクリープを防ぎ、scope 外の課題を別 PR で確実に処理する仕組み。引数なしで起動すると未処理一覧、`add <title>` で追加、`resolve <id> <pr-url>` で解消記録、`list-pr-body` で PR 本文に貼る markdown を出力。
| name | architecture-harness |
| description | docs/architecture/harness.md の invariant を機械的に検証するスキル。引数なしで `--staged --fail-on=error` (PR 直前用)、`full` で全件スキャン、`why <RULE_ID>` で invariant の意図を harness.md から引いて表示。コミット直前 / Stop hook から呼ばれる前提。 |
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 を追加した直後や、大規模リファクタ後の総点検に使う。
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 の「ハーネスとゲート」節