v0.3.4

Release Notes — v0.3.4

リリース日: 2026-07-15

ハイライト

• decision-council の手段・目的すり替え防止 (Issue #55): owner 承認付き Outcome version、source-namespaced Proposal ID、Proposal→Outcome の因果・trade-off・disposition・verification 台帳、Challenge の link-change 履歴、4種の fail-closed guard、低 stakes compact record を追加し、5つの要求シナリオを決定論的 validator で検証できるようにした。
• decision-council Skill の追加 (second-opinion v0.3.0 相当): Outcome Alignment、証拠 readiness gate、Fable/Codex 等の独立 first round、匿名 challenge、全提案の disposition、議長・役割別モデル/effort 選定、劣化時の confidence 上限、Outcome Review を含む意思決定記録の枠組みを定義した。
• Codex ホスト対応の拡充 (second-opinion v0.2.0 相当): Codex rollout JSONL の機械抽出、Codex SessionStart hook の transcript_path 引き継ぎに対応した。

Added

• second-opinion / decision-council: Issue #55 の手段・目的すり替え防止を追加。owner 承認付き Outcome version、source-namespaced Proposal ID、Proposal→Outcome 因果・trade-off・disposition・verification の台帳、Challenge の link-change 履歴、4種の fail-closed guard、低 stakes compact record を定義し、5つの要求シナリオを決定論的 validator で検証する。
• second-opinion (v0.3.0): ツール非依存の decision-council Skill を追加。Outcome Alignment、証拠 readiness gate、Fable/Codex 等の独立 first round、匿名 challenge、全提案の disposition、議長・役割別モデル/effort 選定、劣化時の confidence 上限、Outcome Review を含む意思決定記録を定義した。再現可能な safeguard failure をサニタイズして GitHub Issue 化するテンプレートと手順も追加。AWS sample Collaborative AI-DLC の Inception/traceability/role separation/human gate/refinement loop を一次資料付きで取り込み、Orca/orchestration は任意 transport に限定した。
• second-opinion (v0.2.0): Codex rollout JSONL の機械抽出、Codex SessionStart hook の transcript_path 引き継ぎ、codex exec による read-only / ephemeral reviewer 起動を追加。.codex-plugin/plugin.json と Codex marketplace エントリを追加し、Claude Code / Codex の両ホストから同じ Skill を利用可能にした。Claude Code JSONL と CLAUDE_ENV_FILE の既存経路は維持する。

Compatibility / Migration

• 破壊的変更なし。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.3.3...v0.3.4

v0.3.3

Release Notes — v0.3.3

リリース日: 2026-07-10

このファイルは雛形です。## ハイライト を手で書き加え、必要に応じて節の説明を膨らませてください。

ハイライト

• second-opinion: アドバイザーの Codex バックエンドが上位モデル gpt-5.6-sol を明示的にピン留めするよう修正。app-server の既定に委ねて意図せず下位モデルへ落ちる問題を解消し、モデルが失敗した場合は codex 既定へフォールバックしてレビュー自体は落とさない。実効モデルは結果ヘッダに表示される。

Fixed

• second-opinion: advisor の Codex バックエンドがモデルをピン留めせず app-server の既定に委ねていたため、意図した上位モデル (gpt-5.6-sol) が使われないことがあった。runCodex が --model を常に明示的に渡すよう変更（既定 CODEX_MODEL = gpt-5.6-sol、環境変数 SECOND_OPINION_CODEX_MODEL で上書き可）。ピン留めモデルが失敗した場合は --model なしで一度だけ再試行して codex 既定へ退避し、レビュー自体は落とさない。結果ヘッダに実効モデルを表示するようにした。

Compatibility / Migration

• 破壊的変更なし。Codex モデルを変更したい場合は scripts/second-opinion.mjs の CODEX_MODEL 定数、または環境変数 SECOND_OPINION_CODEX_MODEL を設定する。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.3.2...v0.3.3

v0.3.2

Release Notes — v0.3.2

リリース日: 2026-07-10

このファイルは雛形です。## ハイライト を手で書き加え、必要に応じて節の説明を膨らませてください。

ハイライト

• 新プラグイン second-opinion (v0.1.1) を追加。Claude Code ビルトイン advisor 相当の第二意見レビューを、backend を Codex / Fable から選択（両方＝和集合も可）して得られる。現在のセッションを要約せず機械抽出し、固定 5 セクション（盲点／収束判定／ship-noship／決定的制約／最強の反論）で返す。model・effort は実行時選択。
• リリース整合性ゲート (verify-versions.sh) に Claude 専用プラグインの許容機構 を追加。second-opinion のようにホスト依存で Codex に載せないプラグインを正式にサポートしつつ、登録漏れの検出能力は維持する。

Added

• プラグイン second-opinion (v0.1.1) を収録 — Claude Code ビルトイン advisor 相当の第二意見レビュープラグイン。現在のセッションを機械抽出（要約なし。origin.kind で本物の人間発言のみ抽出し、全ツールエラーを verbatim、コンパクション要約は合成として明示退避）し、Codex (codex-companion task) と Fable (claude -p --model claude-fable-5) へ無編集で渡して固定 5 セクション（盲点／収束判定／ship-noship／決定的制約／最強の反論）の判定を得る。backend (codex / fable / both)・model・effort を実行時選択（無指定は AskUserQuestion）。SessionStart hook で現在の transcript を特定し、/second-opinion:setup で依存 (codex / claude CLI) を点検する。Claude Code 専用プラグイン。
• scripts/verify-versions.sh に Claude 専用プラグインの許容機構 (CLAUDE_ONLY_PLUGINS allowlist) を追加 — 意図的に .codex-plugin マニフェストと Codex マーケットプレイス登録を持たないプラグインを dual-registration 必須チェックから除外し、逆に Claude 専用なのに Codex マーケットプレイスへ登録された誤りも検出する。write_plugin_version とリリーススクリプトの staging も Claude 専用プラグインでは Codex マニフェストを触らないようガードした。

Compatibility / Migration

• 破壊的変更なし。second-opinion は新規追加で既存プラグインに影響しない。
• second-opinion は Claude Code 専用。Codex ホストでは動作せず、Codex マーケットプレイスにも登録しない（Codex 側では既存 codex プラグインのレビュー機能を利用する想定）。利用には claude CLI（Fable backend）と、Codex backend を使う場合は openai-codex プラグインの codex-companion.mjs が必要。詳細は plugins/second-opinion/README.md を参照。
• scripts/ と CI (verify-versions) の変更は内部のみで、プラグイン利用者への影響はない。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.3.1...v0.3.2

v0.3.1

Release Notes — v0.3.1

リリース日: 2026-07-07

ハイライト

• 新プラグイン compact-plus を収録（v0.1.0）: Claude Code の /compact 前後でセッション状態を保存・復元する。u-ichi/compact-plus (MIT License) の移植。
• 圧縮前後を hook で自動化: PreCompact で transcript をバックアップし LLM で 10 見出しの state file を生成、PostCompact/次プロンプトで復旧誘導を additionalContext に注入。閾値超過時には /compact 実行を促すリマインダーも出す。
• 移植にあたり自己完結化: upstream が前提としていた作者 dotfiles 依存（session id 取得・warn マーカー生成）を解消するため、scripts/get-session-id.sh と scripts/compact-warn-statusline.sh を同梱した。

Added

• プラグイン compact-plus (v0.1.0) を収録 — Claude Code の /compact 前後でセッション状態を保存・復元するプラグイン。transcript backup、LLM 生成の 10 見出し state file、閾値超過時の /compact 推奨通知、圧縮後の復旧誘導を hook で提供。u-ichi/compact-plus (MIT License) の移植で、session id 取得スクリプトと warn 通知用 statusline スクリプトを同梱して自己完結化した。

Fixed

• ルート README の収録プラグイン表に、v0.3.0 で収録済みの agent-ops の行を追加 (記載漏れの修正)。

Compatibility / Migration

• 破壊的変更なし。既存プラグイン（tech-docs / quality-architect / model-strategy / agent-ops）には変更ありません。
• compact-plus は新規追加のため、利用には /plugin install compact-plus@9uile-plugins でのインストールが必要です。
• state 生成のバックエンドは既定で claude -p --model claude-sonnet-5（フォールバックに codex exec）を使います。コストを抑えたい場合は COMPACT_PLUS_PRIMARY_BACKEND を Haiku 等に差し替えられます（詳細は plugins/compact-plus/README.md）。
• warn 通知リマインダーを使う場合は、同梱の scripts/compact-warn-statusline.sh を settings.json の statusLine に絶対パスで配線する必要があります（${CLAUDE_PLUGIN_ROOT} は statusLine では展開されません）。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.3.0...v0.3.1

v0.3.0

Release Notes — v0.3.0

リリース日: 2026-07-04

ハイライト

• agent-ops のスキル名を agent-handoff に変更 (breaking): 旧名 codex-handoff はエイリアスなしで廃止し、呼び出し・トリガーは新名に読み替える。
• Codex 配布経路の整備: agent-ops を Codex マーケットプレイスマニフェストに登録し、verify-versions.sh に掲載チェックを追加。
• 委譲先の一般化: agent-ops の運用を Claude Code / Codex 両対応として整理。

Changed

• agent-ops スキル名を codex-handoff から agent-handoff にリネーム。旧名でのスキル呼び出しは新名 agent-handoff に変わる。

Fixed

• agent-ops を Codex マーケットプレイスマニフェスト (.agents/plugins/marketplace.json) に登録 — v0.1.8 収録時からの登録漏れにより、codex plugin add agent-ops@9uile-plugins がプラグイン未検出で失敗していた。

Added

• scripts/verify-versions.sh に Codex マニフェスト掲載チェックを追加 — Claude 側 marketplace.json に載る全プラグインが .agents/plugins/marketplace.json にも掲載されていることを検査し、登録漏れを CI で検出する。
• agent-ops codex-handoff の委譲先を Claude Code / Codex 両対応に一般化 — Claude Code 用実行経路 (references/02-execution-claude.md) を追加し、運用プロトコル・参照表・マニフェスト説明を委譲先選択後の運用規律として整理した。

Compatibility / Migration

• 破壊的変更あり: 旧名 codex-handoff でのスキル呼び出し・トリガーは、新名 agent-handoff への読み替えが必要 (エイリアスなし)。
• その他の変更に移行作業はありません。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.2.0...v0.3.0

v0.2.0

Release Notes — v0.2.0

リリース日: 2026-07-04

ハイライト

• codex-handoff を状態駆動の委譲フローへ拡張（agent-ops v0.1.0 → v0.2.0）: 指示書の穴を着手前に露呈させるゲート、委譲ごとの計測台帳、Fable 非依存化プログラム（DR 目標）、監督役の自動進行プロトコルを追加。
• 着手前ゲート（M0）: 実行モデルのフレッシュセッションに調査・作戦フェーズを実施させ、未確定事項を「確認が必要 / 仮定して進められる」に二分して着手前に回収する。高リスク時は 2 モデル独立のアンサンブル批評を追加。
• Fable 非依存化プログラム: Fable が利用できなくなっても自分の指示 + Opus/Codex で同等の委譲品質を維持することを目標に、ベースライン記録・批評採掘・Fable-off 訓練・フェーズ移行判定を定義。
• 運用プロトコル: フェーズや Fable-off 周期の記憶を台帳先頭の状態ヘッダに移し、監督役セッションが発火直後に運用モードを宣言して各ステップの次の行動を提示する。ユーザーが覚えるのはトリガーフレーズ 1 つ。

Added

• agent-ops codex-handoff に着手前ゲート・振り返り台帳・Fable 非依存化プログラムを追加 — 指示書テンプレートへ「非目標」「未確定事項と仮定」「事前調査」セクションと M0（調査・作戦フェーズ）を追加し、未確定事項を二分類で着手前に回収するゲート（references/03）、委譲ごとの振り返り 4 行 + 4 指標の台帳（references/04）、Fable 非依存化プログラム（references/05）を新設。監査チェックリストに「指示書起因」タグを追加。(#38)
• agent-ops 運用プロトコルを追加 — 手順の記憶を台帳の状態ヘッダへ移し、監督役セッションが自動進行する（references/06）。(#39)

Changed

• agent-ops プラグイン版を v0.1.0 → v0.2.0 に更新。

Compatibility / Migration

• 破壊的変更なし。既存プラグイン（tech-docs / quality-architect / model-strategy）には変更ありません。
• codex-handoff のフローがステップ 0〜7 の 8 段階になります。既存の指示書テンプレート利用分には「非目標」「未確定事項と仮定」「事前調査」「M0」の追記を推奨します。
• 委譲先プロジェクトの台帳 docs/handoff-ledger.md は初回発火時に監督役が状態ヘッダ付きで自動作成します。事前準備は不要です。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.1.8...v0.2.0

v0.1.8

Release Notes — v0.1.8

リリース日: 2026-07-03

ハイライト

• 新プラグイン agent-ops を収録（v0.1.0）: Fable 導入後 7 プロジェクト・21 セッションの実利用履歴から「再利用可能 / 高コスパ / 繰り返し」の 3 基準で抽出したエージェント運用規律を 3 Skill 化。
• codex-handoff: 指示書（正典・禁止事項・停止点・受け入れ条件）を固定してから外部エージェントへ委譲し、監査チェックリスト 7 項目（自己報告の独立検証・否定的証明の対照群など）で証拠ベースに受け入れる。
• first-touch-review / crystallize: 固定 6 観点ルーブリックの初見ユーザー評価を実機で反復するレビューループと、セッション知見を lint / script / skill / ADR へ資産化するルーティングを提供。

Added

• プラグイン agent-ops (v0.1.0) を収録 — Fable 実行履歴から抽出したエージェント運用規律プラグイン。指示書駆動の外部エージェント委譲と懐疑的監査を行う Skill codex-handoff、固定ルーブリックの初見ユーザー評価を実機で反復する Skill first-touch-review、セッション知見を lint / script / skill / ADR に資産化する Skill crystallize、リファレンス 8 編を提供。

Compatibility / Migration

• 破壊的変更なし。既存プラグイン（tech-docs / quality-architect / model-strategy）には変更ありません。
• agent-ops は新規追加のため、利用には /plugin install agent-ops@9uile-plugins でのインストールが必要です。
• codex-handoff の実行経路リファレンスは headroom CLI（headroom wrap codex）の利用を前提とします。未導入環境ではスキルの指示書・監査部分のみ利用できます。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.1.7...v0.1.8

v0.1.7

Release Notes — v0.1.7

リリース日: 2026-07-03

ハイライト

• quality-review スキルの全面改訂（quality-architect v0.1.5）: 資産インベントリの言語非依存化と profile: none フォールバックにより、Swift 以外のリポジトリでも決定論パートが機能するように。
• レビュー精度の強化: 差分帰属ラベル（既存負債を PR の回帰と誤認しない）、CI artifact の整合検証（commit_sha / target 照合）、trivial diff fast-path を追加。
• 本文のスリム化: 既定オフの 07a merge contract を references/07a-review-integration.md へ分離し、SKILL 本文を 215 → 160 行に削減。

Added

• quality-architect (v0.1.5): quality-review に差分帰属ラベル（diff-caused / pre-existing / unknown）、CI artifact の整合検証（mtime / commit_sha / target の照合）、trivial diff fast-path（§2.1）、非対話環境フォールバック、成功基準セルフチェック（§4）を追加。quality-gate-swift.sh の出力 JSON に generated_at / commit_sha / git_root / target / source メタデータを追加し、artifact 検証を裏付け。
• quality-architect (v0.1.5): 07a 結合シグナルの merge contract を references/07a-review-integration.md へ分離。既定オフの実験層を SKILL 本文から切り出し、coupling シグナル採用時のみ Read する構造に。

Changed

• quality-architect (v0.1.5): quality-review SKILL.md を全面改訂（215 → 160 行）。資産インベントリを言語非依存の manifest 駆動に変更し、profile 未定義言語は profile: none + 言語横断ツールの measured-only フォールバックで対応（Swift 固有ファイルのハードコードを解消）。設計妥当性トリアージを step 2.5 → step 2 に改番し、関連参照 10 箇所（00-overview / README / 07 / 07a / static-evaluation / architecture SKILL / coupling-gate-swift.sh）を同期。

Fixed

• quality-architect (v0.1.5): quality-gate-swift.sh / coupling-gate-swift.sh の shellcheck SC2086（未クォート変数）を修正。

Compatibility / Migration

• 破壊的変更なし。既存の quality-gates.yml・CI ワークフローはそのまま動作します。
• quality-review の内部セクション番号が変わりました（設計妥当性トリアージ: step 2.5 → step 2、merge contract: SKILL §2.1 → references/07a-review-integration.md）。同梱ドキュメントの参照は同期済みですが、外部から旧番号で参照している場合は更新してください。
• quality-gate-swift.sh の出力 JSON にメタデータフィールド（generated_at / commit_sha / git_root / target / source）が追加されます。既存フィールドは変更されないため、旧 JSON を読む処理への影響はありません。旧形式の artifact は artifact-integrity: unknown として扱われます。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.1.6...v0.1.7

v0.1.6

Release Notes — v0.1.6

リリース日: 2026-07-02

ハイライト

• Codex plugin support: 全プラグインに .codex-plugin/plugin.json を追加し、Codex からも配布・利用できる形にしました。
• quality-architect: quality-review に設計妥当性評価ルートを統合し、結合・凝集・複雑度・モジュール境界の指摘には具体的な削減アクションを必ず添えるようにしました。
• model-strategy: Codex CLI での利用手順、Fable 5 の提供条件、価格・effort・コスト削減判断の参照情報を更新しました。

Added

• tech-docs / quality-architect / model-strategy: Codex plugin manifest (.codex-plugin/plugin.json) を追加。
• quality-architect (v0.1.4): references/07a-coupling-deep-dive.md に削減アクション・カタログを追加し、BALANCE FALSE の結合・複雑性検出時に Strength / Distance / Volatility の観点で削減手順を提示するように変更。
• model-strategy (v0.1.1): Codex CLI 向けの実行環境判定、委譲代替手順、references/07-codex.md を追加。

Changed

• quality-architect (v0.1.4): quality-review のスキルルーティングを更新し、既存コードや既存設計の妥当性評価は quality-review 側で扱う規律を明確化。
• model-strategy (v0.1.1): pricing / effort / decision matrix / cost lever の参照情報を更新。
• release automation: marketplace、version verification、README、CONTRIBUTING、RELEASING を Codex manifest 対応に更新。

Compatibility / Migration

• 破壊的変更はありません。
• Claude plugin manifest と Codex plugin manifest の両方が verify-versions.sh の検証対象になります。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.1.5...v0.1.6

v0.1.5

Release Notes — v0.1.5

リリース日: 2026-06-15

ハイライト

• quality-review のコンテキスト消費を削減: quality-review スキルが「特性ごとのチェック」(step 4) で 9 特性すべての参照ファイル references/0N-*.md（合計 約 44,500 トークン相当）を無条件に Read していた挙動を、Read の前に「関連度トリアージ」を挟み、精査対象と判定した特性のみ遅延ロードする方式へ変更しました。
• スコアカードには従来どおり 9 特性すべてを掲載して網羅性を維持しつつ、典型的な差分（精査 3 特性程度）で 1 レビューあたり概算 30,000 トークンのコンテキスト消費を削減します。差分が広範・判断に迷う特性は精査対象に寄せるため、取りこぼしは起きません。

Changed

• quality-architect: quality-review スキルの「特性ごとのチェック」(step 4) に関連度トリアージを追加し、リファレンス references/0N-*.md を 9 特性すべて無条件に Read していた挙動を、精査対象と判定した特性のみ遅延ロードする方式へ変更。スコアカードには従来どおり 9 特性すべてを載せ網羅性を維持しつつ、典型的な差分で 1 レビューあたり概算 30,000 トークンのコンテキスト消費を削減。quality-architecture は既に重点 2〜4 特性に絞る設計のため変更なし。

Compatibility / Migration

• 破壊的変更はありません。既存ユーザの追加対応は不要です。
• スキルの出力フォーマット（スコアカードの 9 特性網羅）・参照ライブラリの内容に変更はなく、参照ファイルの読み込みタイミングを最適化したものです。

References

• CHANGELOG: CHANGELOG.md
• Compare: v0.1.4...v0.1.5