phasegate 0.91.0 → 0.107.0

package/docs/guide/preset-selection.md

@@ -0,0 +1,170 @@
+# Architecture Preset Selection Guide
+
+phasegate の `phasegate.config.json` には `architecture.preset` を通じて「そのプロジェクトが採用しているアーキテクチャスタイル」を明示する。L1-003 (`no-layer-violation`) / L1-004 (`enforce-folder-structure`) はこの preset を参照して層名と依存方向を判定する。
+
+preset の選択が正しくないと、本来合法な import が violation として検出される / 本来検出されるべき違反が通過する等の誤判定が発生する。本ガイドは preset 選択の判断基準と実例を示す。
+
+---
+
+## 用語の整理（呼称の混同を避ける）
+
+phasegate には 2 系統の「プリセット」概念があり、役割が異なる:
+
+| 系統 | 概念 | 設定キー | 例 |
+|------|------|---------|----|
+| **防御プリセット** | L3 CI で検査強度を選ぶ | `ci.preset` | `strict` / `lenient` |
+| **アーキプリセット** | L1 の層構造と依存方向を定義 | `architecture.preset` | `clean` / `onion` / `hexagonal` / `layered` / `flat` / `strict-ddd` / `custom` |
+
+本ガイドの対象は **アーキプリセット**。CI 強度の選定は `docs/guide/configuration.md` を参照。
+
+---
+
+## 7 preset の早見表
+
+| preset | 層構成 | 典型的な採用対象 |
+|--------|--------|------------------|
+| `clean` (default) | `domain / application / infrastructure / presentation` | Clean Architecture / AIDLC フルハーネス構成 |
+| `strict-ddd` | `clean` + 循環依存禁止を厳格化 | DDD 重視の新規 PJ |
+| `onion` | `domain / application / interface` | Onion Architecture |
+| `hexagonal` | `core / ports / adapters` | Hexagonal / Ports-and-Adapters |
+| `layered` | `presentation / business / data` | 古典的 3 層レイヤード |
+| `flat` | 層分割なし | 小規模スクリプト・CLI ツール / retrofit 導入初期 |
+| `custom` | `layers` + `allowedDependencies` を明示指定 | どの既成プリセットにも当てはまらない PJ |
+
+各 preset の詳細な層行列は `docs/inception/issues/ISSUE-014/wave1_schema_proposal.md §1.2` を参照。
+
+---
+
+## 選択フロー
+
+```
+1. 既存 PJ か新規 PJ か？
+   ├─ 新規 → Q2 へ
+   └─ 既存 → retrofit-adoption.md を先に参照 / 初期は `flat` でも可
+
+2. DDD / Clean Architecture を明示採用している？
+   ├─ はい → Q3 へ
+   └─ いいえ → Q4 へ
+
+3. 4 層分離（domain / application / infrastructure / presentation）を守っている？
+   ├─ はい → `clean`（循環依存も潰したい場合は `strict-ddd`）
+   └─ いいえ → カスタム Q5 へ
+
+4. フレームワーク構造に寄せている？
+   ├─ Onion (3 層 domain/application/interface) → `onion`
+   ├─ Hexagonal (core/ports/adapters) → `hexagonal`
+   ├─ MVC / 古典 3 層 (presentation/business/data) → `layered`
+   ├─ 小規模スクリプト / 層概念なし → `flat`
+   └─ それ以外 → `custom`
+
+5. `custom` を選ぶ場合、`layers` と `allowedDependencies` を明示指定する（例は後述）。
+```
+
+---
+
+## 設定例
+
+### `clean`（default、省略可）
+
+```json
+{
+  "$schema": "./node_modules/phasegate/schemas/harness-config-v3.schema.json",
+  "architecture": { "preset": "clean" },
+  "l1": { "enabled": true, "rules": {} }
+}
+```
+
+### `onion`
+
+```json
+{
+  "architecture": { "preset": "onion" },
+  "l1": { "enabled": true, "rules": {} }
+}
+```
+
+ソースファイルの `@layer` タグは `domain` / `application` / `interface` のいずれかを使用する。
+
+### `hexagonal`
+
+```json
+{
+  "architecture": { "preset": "hexagonal" },
+  "l1": { "enabled": true, "rules": {} }
+}
+```
+
+`@layer core` / `@layer ports` / `@layer adapters`。
+
+### `flat`（層分割なし）
+
+```json
+{
+  "architecture": { "preset": "flat" },
+  "l1": { "enabled": true, "rules": {} }
+}
+```
+
+`flat` を指定すると L1-001 (`require-unit-comment`) / L1-002 (`require-layer-comment`) / L1-003 / L1-004 が user 明示なき限り auto-disable される。
+
+### `custom`（明示指定）
+
+```json
+{
+  "architecture": {
+    "preset": "custom",
+    "layers": ["model", "service", "controller", "view"],
+    "allowedDependencies": {
+      "model":      ["model"],
+      "service":    ["service", "model"],
+      "controller": ["controller", "service", "model"],
+      "view":       ["view", "controller"]
+    }
+  }
+}
+```
+
+`custom` では `layers` と `allowedDependencies` の両方が必須（片方欠けると config 検証で error）。
+
+---
+
+## override（preset に部分的な上書きを掛ける）
+
+preset を base にして一部の `allowedDependencies` のみ書き換えたい場合:
+
+```json
+{
+  "architecture": {
+    "preset": "clean",
+    "allowedDependencies": {
+      "presentation": ["presentation", "application"]
+    }
+  }
+}
+```
+
+上書きしなかった層（`domain` / `application` / `infrastructure`）は preset 既定のまま。
+
+詳細な semantic validation ルール（C1 自己参照 auto-fill / C2 キー不整合 error / C3 値不整合 error / C4 layer 欠落 auto-fill / C5 循環依存 warn）は `docs/inception/issues/ISSUE-014/wave1_schema_proposal.md §1.3` を参照。
+
+---
+
+## 既存 v2 config からの移行
+
+v0.86.0 より前の `phasegate.config.json` には `architecture` キーが無い。phasegate は後方互換で v2 も読めるが、**v3 への明示アップグレードを推奨**する:
+
+```bash
+npx phasegate migrate --schema v3
+```
+
+このコマンドは `phasegate.config.json` に `architecture: { preset: "clean" }` を追記して v3 化する（既に `architecture` がある場合は no-op）。
+
+---
+
+## 参照
+
+- `docs/inception/issues/ISSUE-014/wave1_schema_proposal.md` — 設計提案とプリセット詳細
+- `docs/inception/issues/ISSUE-014/issue_description.md` — issue 背景
+- `docs/ADR/ADR-015-architecture-preset.md` — アーキ設計決定
+- `docs/guide/retrofit-adoption.md` — 既存 PJ への後付け導入
+- `docs/guide/configuration.md` — 他の config 項目

package/docs/guide/quick-vs-full-mode.md

@@ -130,7 +130,7 @@ Running every change through Full AIDLC is genuinely heavy for one-person projec
 | Core | `docs/product/construction/<unit>/*.md` (contract docs) | Full |
 | Periphery | Internal helpers in `application/` that don't change ports | Quick-first, Full if contract impact emerges |
 | Periphery | `scripts/harness/presentation/` formatting / wording | Quick |
-| Periphery | `docs/guide/*`, `README.md`, `.claude/skills/*` tweaks | Quick |
+| Periphery | `docs/guide/*`, `README.md`, `skills/*` tweaks | Quick |
 | Periphery | Version bumps, `phasegate.config.json` value edits | Quick |
 
 Codify the split in your head (or in a project CLAUDE.md note) — "`domain/**` is core, everything else starts Quick" is a healthy default for a single-maintainer project.
@@ -168,5 +168,5 @@ No. `allowedCategories` is a fixed enum (`bugfix`, `docs`, `test`, `config`). If
 - [Skills Overview](skills-overview.md) — full catalogue of 28 skills
 - [Layer Model](layer-model.md) — L0 through L4 defence layers
 - [Configuration](configuration.md) — `quickMode` configuration reference
-- `.claude/skills/quick-implementor/SKILL.md` — the Quick Mode skill definition
-- `.claude/skills/story-implementor/SKILL.md` — the Full Mode skill definition
+- `skills/quick-implementor/SKILL.md` — the Quick Mode skill definition
+- `skills/story-implementor/SKILL.md` — the Full Mode skill definition

package/docs/guide/retrofit-adoption.md

@@ -44,7 +44,7 @@ Step 4: 新規 Unit / 構造変更は scaffold-design で設計文書を起こ
 npx phasegate init --name <project-name>
 ```
 
-- `.claude/skills/` に 28 スキルを配置
+- `skills/` に 28 スキルを配置し、有効な agent 用に `.claude/skills` / `.codex/skills` を作成
 - `phasegate.config.json` を生成
 - `phasegate.config.json` に `baseline` セクションが未記載でも、v0.71.0 以降は
   **`baseline.enabled` の default が `true`** のため grandfather は既定で有効
@@ -97,7 +97,24 @@ monorepo など複数ディレクトリを持つ場合は配列で列挙:
 この設定を忘れると、phase-gate は `scripts/harness/` 配下しか見ないため、
 retrofit 対象の新規コード作成が block されず、結果として **phasegate が
 無効化された運用** になってしまう（ISSUE-007 Wave 8 で schema 上 overridable
-になるまで、この設定は config validator で拒否されていた）。
+になるまで、この設定は config validator for 拒否されていた）。
+
+### architecture preset の選定（v0.86.0 以降）
+
+retrofit 対象 PJ のアーキテクチャスタイルに合わせて `architecture.preset` を
+選ぶと、L1-003 / L1-004 が preset の層構造に従って判定される。既存コードが
+Clean 4 層でない場合（オニオン / ヘキサゴナル / 古典レイヤード / 層分離なし）、
+preset を合わせないと合法な import が violation として検出される。
+
+初期は層分離無しで運用したい場合は `flat` を選ぶと L1-001〜004 が auto-disable
+される。選定ガイドと設定例は [Preset Selection Guide](./preset-selection.md) 参照。
+
+既存の v2 config（v0.86.0 未満相当、`architecture` キー無し）は下記で自動
+アップグレードできる:
+
+```bash
+npx phasegate migrate --schema v3
+```
 
 ---
 

package/docs/guide/skills-overview.md

@@ -1,6 +1,6 @@
 # Skills Overview
 
-Phasegate provides 28 skills covering the full AIDLC (AI-Driven Development Life Cycle). Skills are deployed to `.claude/skills/` by `npx phasegate init` and invoked as slash commands in AI agent sessions.
+Phasegate provides 28 skills covering the full AIDLC (AI-Driven Development Life Cycle). `npx phasegate init` deploys the skill bodies to `skills/` and exposes them to enabled agents through `.claude/skills/` / `.codex/skills/` links.
 
 ## AIDLC Process — Skill Execution Order
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.91.0",
+  "version": "0.107.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "Apache-2.0",
@@ -51,6 +51,12 @@
     "phasegate:disable": "npx tsx scripts/harness/main.ts disable-feature",
     "phasegate:check-phase": "npx tsx scripts/harness/main.ts phasegate:check-phase",
     "phasegate:check-ready": "npx tsx scripts/harness/main.ts phasegate:check-ready",
+    "harness:status": "pnpm phasegate:status",
+    "harness:init": "npx tsx scripts/harness/main.ts init",
+    "harness:enable": "pnpm phasegate:enable",
+    "harness:disable": "pnpm phasegate:disable",
+    "harness:check-phase": "pnpm phasegate:check-phase",
+    "harness:check-ready": "pnpm phasegate:check-ready",
     "test": "vitest run --config scripts/harness/__tests__/vitest.config.forks.ts && vitest run --config scripts/harness/__tests__/vitest.config.ts"
   },
   "dependencies": {