phasegate 0.181.0 → 0.183.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.181.0",
+  "version": "0.183.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/skills/codebase-mapper/SKILL.md

@@ -8,9 +8,21 @@ languages: [typescript]
 
 # Codebase Mapper
 
+## 目的
+
 全ソースファイルの `@unit`/`@layer` アノテーションとimportグラフを解析し、
 コードベースの構造マップを生成するスキル。
 
+## 入力
+
+- 解析対象ソース: `phasegate.config.json` の `sourceDir` 配下の `**/*.ts`（`__tests__/`・`*.test.ts` は除外）
+- 各ソースファイルの `@unit` / `@layer` アノテーションと `import` 文（Unit間依存グラフの構築に使用）
+
+## 前提条件
+
+- `phasegate.config.json` に `sourceDir` が設定されていること
+- 解析対象ソースに `@unit` / `@layer` アノテーションが付与されていること（欠落ファイルは後述「アノテーション欠落の対処」で報告される）
+
 ## 出力物
 
 `{constructionDir}/codebase-map.md` — Unit・レイヤー分布・依存関係の可視化文書（パスは `phasegate.config.json` で設定）

package/skills/codex-delegator/SKILL.md

@@ -11,9 +11,16 @@ languages: [typescript]
 
 # Codex Delegator
 
+## 目的
+
 codex CLI（gpt-5.4）にタスクをLocal実行で並列委任し、2段階レビューで品質管理するスキル。Claude Codeは**マネージャー**、codexは**実行者**、Sonnetは**レビュワー**として振る舞う。
 
-## 前提
+## 入力
+
+- 委任するタスク（ユーザー指示）: 設計計画・設計文書・テスト設計・コード実装など全タスクタイプ
+- 突合対象の設計文書（ドメインモデル・論理設計・テストケース設計等、後述「前提条件」参照）
+
+## 前提条件
 
 - codex CLI v0.111.0+（`codex exec "<prompt>" --full-auto`）
 - モデル: `gpt-5.4`（ChatGPTアカウントでは派生モデル不可）
@@ -62,6 +69,13 @@ Local実行では1委任単位の粒度を小さく保つことがコスト効
 
 ---
 
+## ⚠️ 2フェーズ実行ルール
+
+- **Phase 1（計画）**: タスクを委任単位に分解し、プロンプトを設計して人間の承認を得る
+- **Phase 2（実行）**: `codex exec` に委任し、2段階レビュー（Tier 1 → Tier 2）で品質管理する
+
+**Phase 1/2を同時に実行してはならない。**
+
 ## Phase 1: 計画（Plan）
 
 ### Step 1.1: タスク分解

package/skills/doc-freshness-checker/SKILL.md

@@ -8,6 +8,8 @@ languages: [typescript]
 
 # Doc Freshness Checker
 
+## 目的
+
 設計文書の鮮度（freshness）を検証し、古くなった文書や対応コードとの乖離を検出するスキル。
 `phasegate check-freshness` CLIをラップし、結果を解釈・対処する。
 
@@ -16,6 +18,12 @@ languages: [typescript]
 - `phasegate.config.json` に `docFreshnessThresholds` が設定されていること（未設定時はデフォルト値使用）
 - git リポジトリ内で実行すること（最終更新日は `git log` で判定）
 
+## 入力
+
+- 対象ディレクトリ: `--dir <path>` または `phasegate.config.json` の `constructionDir`（デフォルト `docs/`）
+- 閾値: `--threshold <days>` または `docFreshnessThresholds`（未設定時はデフォルト30日）
+- git 履歴（最終更新日の判定に使用）
+
 ---
 
 ## ⚠️ 2フェーズ実行ルール

package/skills/engineering-perspective/SKILL.md

@@ -14,6 +14,8 @@ languages: [typescript]
 
 # Engineering Perspective
 
+## 目的
+
 4人の巨匠の視点を統合し、実用性・シンプルさ・説明責任の観点でレビュー・設計・議論を行う。
 
 ## 視点一覧

package/skills/implementation-planner/SKILL.md

@@ -8,6 +8,8 @@ languages: [typescript]
 
 # Implementation Planner
 
+## 目的
+
 UnitドキュメントとConstructionのドメインモデル設計を元に、**設計フェーズの実装計画**を体系的に立案する。
 
 ## ⚠️ `story-implementor` との役割分担
@@ -36,7 +38,7 @@ UnitドキュメントとConstructionのドメインモデル設計を元に、*
 
 ## ワークフロー
 
-## Pre-flight check (BLOCKING)
+## 前提条件チェック（Pre-flight, BLOCKING）
 
 Before generating any plan, verify `docs/inception/{unit}/WI-XXX/description.md` exists.
 If not, halt and ask the user to create the WI first, or offer to run `phasegate scaffold-wi <unit> <story|issue|chore>`.
@@ -86,6 +88,8 @@ If not, halt and ask the user to create the WI first, or offer to run `phasegate
 3. 実装ステップ分解
 4. 影響範囲特定
 
+## 出力ファイル
+
 ### Step 6: 出力
 
 計画をmdファイルとして出力。パスの推奨:
@@ -98,7 +102,7 @@ docs/inception/{unit}/WI-XXX/tdd_implementation_plan.md
 
 ---
 
-## 参照ドキュメント
+## 入力（参照ドキュメント）
 
 | ファイル | 用途 |
 |----------|------|

package/skills/implementation-readiness-checker/SKILL.md

@@ -8,8 +8,15 @@ languages: [typescript]
 
 # Implementation Readiness Checker
 
+## 目的
+
 実装開始前に呼び出し、全ての前提条件（設計文書、テスト設計、カバレッジ検証）を**自動検証**するスキル。不足があれば具体的に何が必要かを報告し、対応するスキルを提案する。
 
+## 入力
+
+- 検証対象の Unit / ストーリー (`{unit}` / `{story_id}`)
+- 存在確認する設計文書群（`{constructionDir}` / `{inceptionDir}` 配下の論理設計・テスト設計・カバレッジレポート等、後述「検証ワークフロー Step 1」の一覧参照）
+
 ## 使用タイミング
 
 - `story-implementor` の前に実行（推奨）

package/skills/phasegate-config-doctor/SKILL.md

@@ -6,8 +6,17 @@ languages: [typescript]
 
 # Phasegate Config Doctor
 
+## 目的
+
 現在の `phasegate.config.json` を診断し、改善案を **diff 形式** でユーザーに提示する skill。
 
+## 入力
+
+診断対象として以下を Read する（詳細は「診断プロセス Step 1」の一覧参照）:
+
+- `phasegate.config.json`（診断対象）、`package.json` / `pnpm-workspace.yaml` / `lerna.json`（workspace・formatter 検出）
+- `.claude/scripts/hook-config.json`、`.phasegate/manifest.json`、doctor report、`.claude/settings.json` / `.codex/hooks.json`、`.husky/*`、`.github/workflows/*`、`AGENTS.md` / `CLAUDE.md`
+
 ## このスキルが解決する問題
 
 phasegate を導入した直後の config は単純な default で、実プロジェクトの構造 (monorepo / formatter 選定 / architecture style / Quick Mode の運用方針) に最適化されていない。さらに setup lifecycle は `phasegate.config.json` だけでは完結せず、manifest、hook JSON、Husky、CI、skill link、doctor finding を合わせて読む必要がある。AI が schema や setup contract を知らずに勘で書き換えると壊れるため、**schema + 検出結果に基づいた決定的提案** が必要。<!-- @work-item-id WI-153 -->

package/skills/phasegate-toolkit-guide/SKILL.md

@@ -6,6 +6,8 @@ languages: [typescript]
 
 # Phasegate Toolkit Guide
 
+## 目的
+
 phasegate ツールキット自体の概念・仕様・設定について、ユーザーの質問に正確に答えるための skill。
 
 ## このスキルが解決する問題

package/skills/pointer-validator/SKILL.md

@@ -8,9 +8,16 @@ languages: [typescript]
 
 # Pointer Validator
 
+## 目的
+
 設計文書内のファイルパス参照（ポインタ）の有効性を検証するスキル。
 `phasegate validate-pointers` CLIをラップし、broken pointer を検出・修正案を提示する。
 
+## 入力
+
+- 対象ディレクトリ: `--dir <path>`（デフォルト `docs/`）配下の設計文書
+- 検証対象ポインタ: Markdown `[text](path)` リンク / `@file:` `@ref:` / `filePath:` フィールドのパス参照（`http(s)://` URL は対象外）
+
 ## CLIの動作
 
 `p2:validate-pointers` は以下を検出する:

package/skills/quick-implementor/SKILL.md

@@ -6,11 +6,13 @@ languages: [typescript]
 
 # Quick Implementor
 
+## 目的
+
 Quick Mode下での軽微変更実装スキル。story-implementorの緩和版として、フルハーネスが過剰な変更に対して最低限の品質を維持しつつ高速に実装を行う。
 
 ## 適用条件チェック（必須）
 
-### 適用可能な変更カテゴリ
+### 入力（適用可能な変更カテゴリ）
 
 | カテゴリ | 例 |
 |---------|---|
@@ -33,7 +35,7 @@ Quick Mode下での軽微変更実装スキル。story-implementorの緩和版
 
 `type: fix | chore` でも、API契約変更・新ドメインモデル追加・レイヤー構造変更・複数Unitにまたがる実装変更が見えた場合は、通常の除外ルールを優先して `story-implementor` に切り替える。
 
-### 適用除外（フルハーネス必須 → story-implementor を使用）
+### 前提条件（適用除外・フルハーネス必須 → story-implementor を使用）
 
 - 新機能追加
 - API契約変更（Port/Adapter インターフェース変更）
@@ -55,7 +57,7 @@ Quick Mode下での軽微変更実装スキル。story-implementorの緩和版
 
 ---
 
-## ワークフロー
+## 実行フロー
 
 ### Step 1: 適用条件の判定
 
@@ -95,7 +97,7 @@ Quick Mode下での軽微変更実装スキル。story-implementorの緩和版
 pnpm test  # 全テスト グリーンを確認
 ```
 
-### Step 5: コミット
+### 出力（Step 5: コミット）
 
 Atomic commit で変更をコミットする。コミットメッセージに `[quick]` プレフィックスを付与。作業対象WIがある場合は `Work-Item: WI-XXX` trailer を必ず含める。
 

package/skills/skill-creator/SKILL.md

@@ -7,6 +7,8 @@ languages: [typescript]
 
 # Skill Creator
 
+## Purpose
+
 This skill provides guidance for creating effective skills.
 
 ## About Skills