phasegate 0.181.0 → 0.191.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/docs/guide/skills-overview.md +10 -9
  2. package/package.json +1 -1
  3. package/scripts/harness/biome-ast-engine/infrastructure/parsers/comment-density-parser.ts +51 -10
  4. package/scripts/harness/ci-governance/composition-root.ts +1 -1
  5. package/scripts/harness/ci-governance/infrastructure/adapters/adr-foundation-existence-adapter.ts +26 -2
  6. package/scripts/harness/ci-governance/infrastructure/adapters/harness-api-command-existence-adapter.ts +74 -1
  7. package/scripts/harness/phase-dependency-model/domain/ports/story-reflection-file-system-port.ts +2 -0
  8. package/scripts/harness/phase-dependency-model/domain/services/story-reflection-checker.ts +8 -0
  9. package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-story-reflection-adapter.ts +75 -2
  10. package/scripts/harness/setup/skill-deployer.ts +6 -6
  11. package/scripts/harness/skill-quality/domain/services/skill-structure-validator.ts +13 -2
  12. package/scripts/harness/skill-quality/domain/types/skill-kind.ts +6 -0
  13. package/scripts/harness/skill-quality/domain/value-objects/skill-structure.ts +24 -8
  14. package/skills/cascade-updater/SKILL.md +3 -3
  15. package/skills/codebase-mapper/SKILL.md +17 -5
  16. package/skills/codex-delegator/SKILL.md +19 -4
  17. package/skills/codex-delegator/references/prompt-patterns.md +3 -3
  18. package/skills/codex-delegator/references/review-dimensions.md +1 -1
  19. package/skills/consistency-checker/SKILL.md +1 -1
  20. package/skills/doc-freshness-checker/SKILL.md +8 -0
  21. package/skills/domain-designer/SKILL.md +4 -2
  22. package/skills/engineering-perspective/SKILL.md +3 -0
  23. package/skills/environment-designer/SKILL.md +8 -6
  24. package/skills/implementation-planner/SKILL.md +12 -6
  25. package/skills/implementation-readiness-checker/SKILL.md +9 -1
  26. package/skills/it-test-designer/SKILL.md +10 -8
  27. package/skills/it-test-logic-designer/SKILL.md +11 -9
  28. package/skills/it-test-logic-designer/references/repository-test-patterns.md +8 -1
  29. package/skills/logical-designer/SKILL.md +5 -3
  30. package/skills/mock-designer/SKILL.md +10 -6
  31. package/skills/phasegate-config-doctor/SKILL.md +12 -2
  32. package/skills/phasegate-toolkit-guide/SKILL.md +3 -0
  33. package/skills/pointer-validator/SKILL.md +8 -0
  34. package/skills/quick-implementor/SKILL.md +7 -5
  35. package/skills/scenario-test-designer/SKILL.md +27 -14
  36. package/skills/scenario-test-logic-designer/SKILL.md +10 -8
  37. package/skills/scenario-test-logic-designer/references/msw-patterns.md +3 -1
  38. package/skills/scenario-test-logic-designer/references/playwright-patterns.md +3 -1
  39. package/skills/skill-creator/SKILL.md +8 -5
  40. package/skills/story-implementor/SKILL.md +2 -0
  41. package/skills/story-mapper/SKILL.md +4 -4
  42. package/skills/story-writer/SKILL.md +5 -5
  43. package/skills/test-coverage-checker/SKILL.md +4 -6
  44. package/skills/uiux-designer/SKILL.md +4 -2
  45. package/skills/unit-designer/SKILL.md +8 -6
  46. package/skills/unit-test-designer/SKILL.md +25 -11
  47. package/skills/unit-test-logic-designer/SKILL.md +10 -8
  48. package/skills/unit-test-logic-designer/references/test-patterns.md +7 -1
@@ -14,7 +14,7 @@ Unitテストケース設計(`unit_test_design.md`)を元に、Vitest実装
14
14
 
15
15
  ```
16
16
  テストケース設計フェーズ
17
- unit-test-designer → it-test-designer → scenario-test-designer
17
+ scenario-test-designer → uiux-designer → unit-test-designer → it-test-designer
18
18
 
19
19
  test-coverage-checker
20
20
 
@@ -25,7 +25,7 @@ Unitテストケース設計(`unit_test_design.md`)を元に、Vitest実装
25
25
  it-test-logic-designer → scenario-test-logic-designer
26
26
 
27
27
  TDD実装フェーズ
28
- story-implementor
28
+ implementation-readiness-checker → story-implementor
29
29
  ```
30
30
 
31
31
  ## 前提条件チェック
@@ -36,8 +36,10 @@ TDD実装フェーズ
36
36
 
37
37
  ### 推奨インプット(あれば参照)
38
38
  - **カバレッジレポート** — `docs/product/construction/{unit}/coverage_report.md`
39
- - **既存ユニットテスト** — `backend/test/unit/**/*.test.ts`(パターン参考)
40
- - **テスト規約** — `docs/principles/testing-rules.md`
39
+ - **既存ユニットテスト** — 対象プロジェクトの構成(package.json scripts, vitest 設定, `phasegate.config.json` の paths)からテスト配置を特定してパターン参考にする。例(モノレポ構成の場合): `backend/test/unit/**/*.test.ts`
40
+ - **テスト規約** — `docs/principles/testing-rules.md`(consumer プロジェクトでは `node_modules/phasegate/docs/principles/testing-rules.md`、phasegate リポジトリ自体では `docs/principles/testing-rules.md` を参照)
41
+
42
+ > **設計文書パスの注記:** 本スキルが扱う `docs/product/construction/{unit}/...` / `docs/inception/...` パスは既定値。consumer が `phasegate.config.json` の paths 設定を上書きしている場合はそちらに従う。
41
43
 
42
44
  ---
43
45
 
@@ -61,7 +63,7 @@ TDD実装フェーズ
61
63
  ## ⚠️ 3フェーズ実行ルール
62
64
 
63
65
  - **Phase 1(計画)**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
64
- - **Phase 2(実行)**: Sonnet 4.6 に委任して成果物を生成する(`npx phasegate delegate-sonnet` 経由)
66
+ - **Phase 2(実行)**: 委任先モデルに委任して成果物を生成する(`npx phasegate delegate-sonnet` 経由)
65
67
  - **Phase 3(レビュー)**: Opus が成果物を検証し、問題があれば直接修正する
66
68
 
67
69
  **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
@@ -168,11 +170,11 @@ TDD実装フェーズ
168
170
  ## Phase 3: レビュー(Opus review)
169
171
 
170
172
  ### 実行主体
171
- メインセッション(Opus 4.6)が実行する。Sonnetへの再委任は行わない。
173
+ メインセッション(model-routing.md の Architect ロール)が実行する。Sonnetへの再委任は行わない。
172
174
 
173
175
  ### レビュー手順
174
176
  1. Sonnetが出力したファイルを読み込む
175
- 2. `docs/principles/model-routing.md` のレビュー観点 R1〜R7 に沿って検証する
177
+ 2. `docs/principles/model-routing.md` の「レビュー観点」節に沿って検証する
176
178
  3. **スキル固有レビュー観点**を検証する
177
179
  4. 判定結果を出力する
178
180
 
@@ -213,7 +215,7 @@ Phase 2 で設計するテストファイル(`*.test.ts` / `*.spec.ts`)の
213
215
  - **テストコードは生成しない**(設計文書のみ)— 実装は `story-implementor` が行う
214
216
  - 疑似コードは実装の指針となる詳細レベルで記載する
215
217
  - TDDの「RED」フェーズで正しく失敗するテストを設計する
216
- - 既存のテストパターン(`backend/test/unit/**/*.test.ts`)を参照してスタイルを統一する
218
+ - 既存のテストパターンを参照してスタイルを統一する(テスト配置は対象プロジェクトの構成から特定する。例(モノレポ構成の場合): `backend/test/unit/**/*.test.ts`)
217
219
 
218
220
  ---
219
221
 
@@ -2,12 +2,14 @@
2
2
 
3
3
  unit-test-logic-designer が出力する `unit_test_logic.md` で使用するテストパターンのリファレンス。
4
4
 
5
+ > **配置パス・実行コマンドについて:** 以下に登場するテスト配置ディレクトリ(`backend/test/helpers/` 等)・相対インポートパス・テスト実行コマンドは、対象プロジェクトの構成(`package.json` scripts, vitest 設定, `phasegate.config.json` の paths)から特定すること。本ファイルの具体値は例(モノレポ構成の場合)であり、疑似コードのテンプレート構造自体はそのまま流用してよい。
6
+
5
7
  ---
6
8
 
7
9
  ## 1. ファクトリ関数パターン
8
10
 
9
11
  ```typescript
10
- // backend/test/helpers/{context}-helper.ts
12
+ // 例(モノレポ構成の場合): backend/test/helpers/{context}-helper.ts
11
13
 
12
14
  /**
13
15
  * {集約名}のテスト用ファクトリ
@@ -24,6 +26,8 @@ export function create{Aggregate}(overrides?: Partial<{Aggregate}Props>): {Aggre
24
26
 
25
27
  ### 共通ヘルパーのインポート
26
28
 
29
+ 相対インポートの階層はテストファイルとヘルパーの実配置に依存する。以下は例(モノレポ構成の場合)。
30
+
27
31
  ```typescript
28
32
  import { target, context } from '../../../../helpers/common-helper.js';
29
33
  ```
@@ -195,6 +199,8 @@ expect(actual).toBe(expected);
195
199
 
196
200
  ## 7. テスト実行コマンド
197
201
 
202
+ 実行コマンドは対象プロジェクトの構成(`package.json` scripts, vitest 設定, `phasegate.config.json` の paths)から特定する。以下は例(pnpm モノレポ構成の場合)。
203
+
198
204
  ```bash
199
205
  # 全ユニットテスト実行
200
206
  pnpm --filter backend test:unit