qfai 1.0.2 → 1.0.4

package/README.md

@@ -56,7 +56,7 @@ npx qfai report
 
 ## できること
 
-- `npx qfai init` によるテンプレート生成（specs/contracts に加え、`.qfai/require/README.md`、`.qfai/rules/pnpm.md`、`.qfai/prompts/**`、`.qfai/prompts.local/README.md`、`.qfai/prompts/analyze/**`、`.qfai/samples/**`、`.qfai/promptpack/` を含む）
+- `npx qfai init` によるテンプレート生成（specs/contracts に加え、`.qfai/require/README.md`、`.qfai/prompts/**`、`.qfai/prompts.local/README.md`、`.qfai/prompts/analyze/**`、`.qfai/promptpack/` を含む）
 - `npx qfai validate` による `.qfai/` 内ドキュメントの整合性・トレーサビリティ検査
 - `npx qfai validate` による SC→Test 参照の検証（`validation.traceability.testFileGlobs` に一致するテストファイルから `QFAI:SC-xxxx` を抽出）
 - `npx qfai doctor` による設定/探索/パス/glob/validate.json の事前診断
@@ -87,7 +87,7 @@ QFAI が提供するプロンプト資産は次の 2 つに分離します。
   "summary": {
     "specs": 1,
     "scenarios": 1,
-    "contracts": { "api": 0, "ui": 1, "db": 0 },
+    "contracts": { "api": 0, "ui": 1, "db": 0, "thema": 0 },
     "counts": { "info": 0, "warning": 0, "error": 0 }
   }
 }
@@ -137,8 +137,7 @@ doctor の JSON 例:
 2. `npx qfai analyze --prompt spec_to_scenario` のようにプロンプトを出力し、AI に貼り付ける
 3. 推奨入力（Spec/Scenario/Test/Contract の抜粋 + validate/report 要約 + 差分）を揃えて検討する
 
-入力の用意に迷う場合は、`npx qfai init` が同梱する `.qfai/samples/analyze/input_bundle.md`（完成例）をコピーして編集してください。
-成果物を残す場合は `.qfai/samples/analyze/analysis.md`（テンプレ）を使う運用を推奨します。
+入力の用意に迷う場合は、PR テンプレの「検証/証跡」に validate/report の結果を貼る運用を推奨します。
 
 ### カスタマイズ（Overlay）
 
@@ -157,6 +156,8 @@ analyze も `.qfai/prompts.local/**` の overlay 運用に従います。
 Spec では `QFAI-CONTRACT-REF:` 行で参照する契約IDを宣言します（`none` 可）。Spec の先頭 H1 に `SPEC-xxxx` が必須です。
 Scenario では `# QFAI-CONTRACT-REF:` のコメント行で契約参照を宣言します（`none` 可）。
 契約ファイルは `QFAI-CONTRACT-ID: <ID>` を **1ファイル1ID** で宣言します。
+契約IDは UI/API/DB/THEMA（THEMA は 3 桁）です。UI 契約は `themaRef` / `themeOverrides` / `assets` を追加できます。
+`assets.pack` は `ui/` 配下の相対パス、`assets.use` は `assets.yaml` の `items[].id` を参照します。
 `validate.json` / `report` の file path は root 相対で出力します（absolute は出力しません）。
 
 ## Monorepo / サブディレクトリ
@@ -240,13 +241,9 @@ qfai.config.yaml
       spec.md
       delta.md
       scenario.feature
-  rules/
-    conventions.md
-    pnpm.md
   promptpack/
     constitution.md
     steering/
-      compatibility-vs-change.md
       traceability.md
       naming.md
     commands/
@@ -258,9 +255,6 @@ qfai.config.yaml
       qa.md
       spec.md
       test.md
-    modes/
-      compatibility.md
-      change.md
   prompts/
     README.md
     makeOverview.md
@@ -269,7 +263,6 @@ qfai.config.yaml
     qfai-generate-test-globs.md
     qfai-maintain-traceability.md
     qfai-maintain-contracts.md
-    qfai-classify-change.md
   prompts.local/
     README.md
   contracts/
@@ -278,6 +271,14 @@ qfai.config.yaml
       api-0001-sample.yaml
     ui/
       ui-0001-sample.yaml
+      thema-001-facebook-like.yml
+      assets/
+        ui-0001-sample/
+          assets.yaml
+          snapshots/login__desktop__light__default.png
+        thema-001-facebook-like/
+          assets.yaml
+          palette.png
     db/
       db-0001-sample.sql
   out/

package/assets/init/.qfai/README.md

@@ -24,20 +24,18 @@ npx qfai report
 - `specs/` : Spec Pack（spec.md / delta.md / scenario.feature）
 - `contracts/` : UI / API / DB 契約を置く場所
 - `require/` : 既存要件の集約（validate 対象外）
-- `rules/` : 規約・運用ルール
 - `prompts/` : QFAI 標準のプロンプト資産（自動読取はしない。更新や再 init で上書きされ得る）
-- `samples/` : analyze 等の手動運用で使う成果物テンプレ（create-only）
 - `prompts.local/` : 利用者カスタムのプロンプト資産（存在する場合は overlay でこちらを優先して読む運用）
 - `promptpack/` : PromptPack（SSOT、運用ルール/観点の正本）
 - `out/` : `validate` / `report` の出力先（gitignore 推奨）
 
 詳細は各 README を参照してください。
 
+- analyze の入力束に迷う場合は、PR テンプレの「検証/証跡」に validate/report の結果を貼る運用を推奨します。
+
 - `specs/README.md`
 - `contracts/README.md`
 - `require/README.md`
-- `rules/conventions.md`
-- `rules/pnpm.md`
 - `prompts/README.md`
 - `prompts/analyze/README.md`
 - `prompts.local/README.md`
@@ -45,9 +43,6 @@ npx qfai report
 - `prompts/qfai-generate-test-globs.md`
 - `prompts/qfai-maintain-traceability.md`
 - `prompts/qfai-maintain-contracts.md`
-- `prompts/qfai-classify-change.md`
-- `samples/analyze/analysis.md`
-- `samples/analyze/input_bundle.md`
 - `prompts/analyze/spec_to_scenario.md`
 - `prompts/analyze/spec_to_contract.md`
 - `prompts/analyze/scenario_to_test.md`

package/assets/init/.qfai/contracts/README.md

@@ -5,8 +5,10 @@
 ## 置くべきファイル
 
 - UI: `ui/ui-0001-<slug>.yaml` または `.yml`
+- THEMA: `ui/thema-001-<slug>.yml`（3桁）
 - API: `api/api-0001-<slug>.yaml` / `.yml` / `.json`（OpenAPI）
 - DB: `db/db-0001-<slug>.sql`（ID は `DB-xxxx`）
+- assets: `ui/assets/<contract-id>/assets.yaml`（参照整合のみ検証）
 
 ## 契約ID宣言（必須）
 
@@ -23,6 +25,24 @@ id: UI-0001
 name: 受注登録画面
 refs:
   - BR-0001
+themaRef: THEMA-001
+assets:
+  pack: assets/ui-0001-sample
+  use:
+    - UI-0001.desktop.light.default
+```
+
+## 最小例（THEMA）
+
+```yaml
+# QFAI-CONTRACT-ID: THEMA-001
+id: THEMA-001
+name: facebook-like
+tokens:
+  color:
+    background: "#FFFFFF"
+    textPrimary: "#111111"
+    accent: "#1877F2"
 ```
 
 ## 最小例（API）

package/assets/init/.qfai/contracts/ui/assets/thema-001-facebook-like/assets.yaml

@@ -0,0 +1,6 @@
+packId: THEMA-001
+type: thema
+items:
+  - id: THEMA-001.palette.default
+    kind: snapshot
+    path: palette.png

package/assets/init/.qfai/contracts/ui/assets/ui-0001-sample/assets.yaml

@@ -0,0 +1,6 @@
+packId: UI-0001
+type: ui
+items:
+  - id: UI-0001.desktop.light.default
+    kind: snapshot
+    path: snapshots/login__desktop__light__default.png

package/assets/init/.qfai/contracts/ui/thema-001-facebook-like.yml

@@ -0,0 +1,13 @@
+# QFAI-CONTRACT-ID: THEMA-001
+id: THEMA-001
+name: facebook-like
+tokens:
+  color:
+    background: "#FFFFFF"
+    textPrimary: "#111111"
+    accent: "#1877F2"
+components:
+  Button:
+    primary:
+      backgroundToken: "color.accent"
+      textToken: "color.background"

package/assets/init/.qfai/contracts/ui/ui-0001-sample.yaml

@@ -6,3 +6,12 @@ id: UI-0001
 name: Order Registration
 refs:
   - BR-0001
+themaRef: THEMA-001
+themeOverrides:
+  Button:
+    primary:
+      backgroundToken: "color.accent"
+assets:
+  pack: assets/ui-0001-sample
+  use:
+    - UI-0001.desktop.light.default

package/assets/init/.qfai/promptpack/commands/plan.md

@@ -8,4 +8,4 @@
 - テスト方針
 - リスクと確認点
 - testFileGlobs が未整備なら `prompts/qfai-generate-test-globs.md` を使う
-- Compatibility/Change が不明なら `prompts/qfai-classify-change.md` で整理する
+- 受入観点が曖昧なら QA 観点で整理する

package/assets/init/.qfai/promptpack/commands/review.md

@@ -1,7 +1,6 @@
 # Review
 
 - Spec/Scenario/Contracts と実装の整合
-- 互換維持/変更の区分が delta.md に記録されているか
-- 区分が曖昧なら `prompts/qfai-classify-change.md` で再整理する
+- delta.md に変更内容/受入観点が記録されているか
 - 影響範囲とテスト結果の妥当性
 - セキュリティ/運用上の懸念がないか

package/assets/init/.qfai/promptpack/constitution.md

@@ -5,7 +5,7 @@ PromptPack はプロジェクト内の SSOT（Single Source of Truth）として
 ## 基本原則
 
 - spec/scenario/delta/BR/SC を最優先で読む
-- 変更は delta.md に記録し、互換維持/変更の区分を明示する
+- 変更は delta.md に記録し、受入観点と影響範囲を明示する
 - validate を通すことを必須とする（通らないなら仕様/運用が破綻している）
 - 不確実性（仮説/未確定/TODO）は残し方針を統一する
 

package/assets/init/.qfai/prompts/README.md

@@ -8,7 +8,7 @@
 ## 目的
 
 - Spec から overview / Business Flow を生成するための素材
-- トレーサビリティ/契約/変更区分の運用支援（CIで止めない領域）
+- トレーサビリティ/契約の運用支援（CIで止めない領域）
 - 意味矛盾（解釈/前提/用語/受入条件の齟齬）のレビュー補助（analyze）
 - 将来の CLI 連携に備えた配布物（現時点では手動利用のみ）
 
@@ -27,7 +27,6 @@
 - `qfai-generate-test-globs.md`: テストファイル glob の生成支援（`qfai.config.yaml` 更新）
 - `qfai-maintain-traceability.md`: 参照切れの修復（Spec/Scenario/Test）
 - `qfai-maintain-contracts.md`: 契約 ID と参照の整合
-- `qfai-classify-change.md`: Compatibility / Change 分類支援
 - `analyze/README.md`: analyze の目的/入力/出力フォーマット
 - `analyze/spec_to_scenario.md`: Spec ↔ Scenario の意味整合
 - `analyze/spec_to_contract.md`: Spec ↔ Contract の対応漏れ/参照不整合
@@ -39,7 +38,6 @@
 | ------------------------------- | ---------------- | --------------------------------------------- | ------------------------------ | ------------------- |
 | `qfai-maintain-traceability.md` | 参照切れの修復   | spec/delta/scenario + validate/report + tests | 修正方針 + diff + 再実行手順   | ID形式崩し/SSOT無視 |
 | `qfai-maintain-contracts.md`    | 契約と参照の整合 | contracts + spec + report                     | 採番案 + 参照更新案 + diff     | ID変更の無断実施    |
-| `qfai-classify-change.md`       | 変更区分の判断   | delta.md + 変更差分                           | 分類 + 根拠 + 影響範囲         | 根拠なし分類        |
 | `qfai-generate-test-globs.md`   | テストglob生成   | package.json/設定/テスト配置                  | glob案 + 更新案 + サンプル確認 | glob過剰/不足       |
 | `makeOverview.md`               | Spec一覧生成     | spec.md                                       | 一覧テーブル/サマリ            | spec未読            |
 | `makeBusinessFlow.md`           | 業務フロー整理   | spec.md/要件                                  | フロー手順/根拠                | 要件の飛ばし        |

package/assets/init/.qfai/prompts/qfai-maintain-traceability.md

@@ -5,7 +5,7 @@
 ## 目的
 
 - Spec/Scenario/Test の ID 参照が壊れた箇所を特定し、整合させる
-- 互換維持/変更（Compatibility/Change）の区分を明確にする
+- 修正の影響と受入観点を整理する
 
 ## 必須入力
 
@@ -18,7 +18,7 @@
 
 1. validate/report の結果から、壊れている参照（Spec/BR/SC/Contract/Test）を列挙する。
 2. Spec Pack（spec/delta/scenario）を読み、ID と参照の意図を把握する。
-3. 修正が Compatibility か Change かを判断し、根拠を整理する。
+3. 修正の影響と受入観点を整理する。
 4. 参照切れを解消する最小修正案（Spec/Scenario/Test）を作る。
 5. 変更後の validate / report 手順を示す。
 
@@ -30,7 +30,7 @@
 
 ## 出力フォーマット
 
-- 変更区分（Compatibility / Change）と根拠
+- 変更内容と受入観点
 - 修正対象一覧（ファイル/ID/理由）
 - 提案 diff（またはパッチ単位）
 - 再実行コマンド（`qfai validate` / `qfai report` / テスト）

package/assets/init/.qfai/prompts/require-to-spec.md

@@ -27,8 +27,7 @@
 - 各 Scenario は `@SC-xxxx` を **ちょうど1つ**、`@BR-xxxx` を **1つ以上**持つこと。
 - 契約ファイルには `QFAI-CONTRACT-ID: <ID>` を宣言する。
 - 契約 ID（UI/API/DB）を Scenario で参照する場合はタグまたは本文に明示する。
-- `delta.md` の「変更区分」は **Compatibility / Change/Improvement のいずれか1つにチェック**する。
-  - 判断できない場合は `Compatibility` を選び、`TBD` を理由欄に記載する。
+- `delta.md` に変更内容/受入観点/影響範囲を記載する。
 
 ## Output Format
 

package/assets/init/.qfai/specs/README.md

@@ -15,7 +15,7 @@
 ```md
 # SPEC-0001: 注文登録の最小要件
 
-QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
+QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001, THEMA-001
 
 ## 背景
 
@@ -39,8 +39,7 @@ QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
 
 ## Delta（delta.md）
 
-- 互換維持 / 仕様変更の **どちらか1つ**に必ずチェックする
-- 根拠と影響範囲を明記する
+- 変更の要約・根拠・影響範囲・受入観点を明記する
 
 ## Scenario（scenario.feature）最小要件
 
@@ -54,7 +53,7 @@ QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
 ## CI でチェックされること（抜粋）
 
 - Spec: 必須セクション、SPEC/BR ID、BR Priority、ID 形式、Contract 参照の実在性、Contract 参照の必須宣言
-- Delta: 変更区分（互換/変更）のチェック状態
+- Delta: delta.md の存在
 - Scenario: Feature/Scenario の存在、タグ要件、Given/When/Then、契約参照の宣言/形式
 - Traceability: BR→SC、Spec→Contract、SC→Test の接続、BR の所属 SPEC 整合
 - IDs: 定義 ID の重複検知（Spec/Scenario/Contracts）

package/assets/init/.qfai/specs/spec-0001/delta.md

@@ -1,10 +1,5 @@
 # Delta: SPEC-0001
 
-## 変更区分
-
-- [x] Compatibility（互換維持: 既存仕様と整合）
-- [ ] Change/Improvement（改善/仕様変更: 期待値の変更を含む）
-
 ## 変更の要約（What）
 
 - ...

package/assets/init/.qfai/specs/spec-0001/scenario.feature

@@ -3,7 +3,7 @@ Feature: 注文登録
 
 Rule: 承認者が存在する
 
-    # QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
+    # QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001, THEMA-001
     @SC-0001 @BR-0001
     Scenario: 承認者が承認するまで注文は確定しない
       Given ...

package/assets/init/.qfai/specs/spec-0001/spec.md

@@ -1,6 +1,6 @@
 # SPEC-0001: 注文登録の最小仕様（サンプル）
 
-QFAI-CONTRACT-REF: API-0001, UI-0001, DB-0001
+QFAI-CONTRACT-REF: API-0001, UI-0001, DB-0001, THEMA-001
 
 > このテンプレは **最小例** です。実際の仕様に合わせて書き換えてください。
 

package/assets/init/root/qfai.config.yaml

@@ -1,7 +1,6 @@
 paths:
   specsDir: .qfai/specs
   contractsDir: .qfai/contracts
-  rulesDir: .qfai/rules
   outDir: .qfai/out
   promptsDir: .qfai/prompts
   srcDir: src