qfai 0.3.4 → 0.3.5

package/README.md

@@ -1,4 +1,4 @@
-# QFAI Toolkit (v0.3.4)
+# QFAI Toolkit (v0.3.5)
 
 Single-package distribution for QFAI.
 
@@ -18,7 +18,7 @@ npx qfai report
 
 ## できること
 
-- `npx qfai init` によるテンプレート生成（specs/contracts に加え、`.qfai/require/README.md`、`.qfai/rules/pnpm.md`、`.qfai/prompts/require-to-spec.md` を含む）
+- `npx qfai init` によるテンプレート生成（specs/contracts に加え、`.qfai/require/README.md`、`.qfai/rules/pnpm.md`、`.qfai/prompts/require-to-spec.md`、`.qfai/promptpack/` を含む）
 - `npx qfai validate` による `.qfai/` 内ドキュメントの整合性・トレーサビリティ検査
 - `npx qfai report` によるレポート出力
 

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

@@ -16,6 +16,7 @@ npx qfai report
 - `require/` : 既存要件の集約（validate 対象外）
 - `rules/` : 規約・運用ルール
 - `prompts/` : 生成プロンプト資産（自動読取はしない）
+- `promptpack/` : PromptPack（SSOT、運用ルール/観点の正本）
 - `out/` : `validate` / `report` の出力先（gitignore 推奨）
 
 詳細は各 README を参照してください。
@@ -27,6 +28,7 @@ npx qfai report
 - `rules/pnpm.md`
 - `prompts/README.md`
 - `prompts/require-to-spec.md`
+- `promptpack/constitution.md`
 - `out/README.md`
 
 ## 設定と CI
@@ -45,3 +47,10 @@ npx qfai report
 - Codex: `AGENTS.md` に要旨を転記
 
 詳細は `prompts/README.md` を参照してください。
+
+## PromptPack の使い方（重要）
+
+`promptpack/` は **運用ルール/観点の正本**です。自動読取は行わず、必要な章を手動で参照・転記します。
+
+- 入口: `promptpack/constitution.md`
+- 手動配置の例: Copilot/Claude/Codex 向けの指示ファイル

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

@@ -0,0 +1,6 @@
+# Implement
+
+- 既存の型/ユーティリティ/パターンを優先して再利用する
+- 入力検証と失敗パスを先に書く
+- 早期 return でネストを浅くする
+- ログ/エラーメッセージは具体的かつ最小限にする

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

@@ -0,0 +1,9 @@
+# Plan
+
+目的と完了条件を先に明確化し、以下を最小構成で整理する。
+
+- ゴール/完了条件
+- スコープ（やる/やらない）
+- 手順（小さく分割）
+- テスト方針
+- リスクと確認点

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

@@ -0,0 +1,6 @@
+# Release
+
+- CHANGELOG と version を更新する
+- `pnpm format:check && pnpm lint && pnpm check-types` を実行する
+- `pnpm -C packages/qfai test` と `pnpm verify:pack` を実行する
+- タグ付与は main の HEAD に対して行う

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

@@ -0,0 +1,6 @@
+# Review
+
+- Spec/Scenario/Contracts と実装の整合
+- 互換維持/変更の区分が delta.md に記録されているか
+- 影響範囲とテスト結果の妥当性
+- セキュリティ/運用上の懸念がないか

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

@@ -0,0 +1,15 @@
+# PromptPack Constitution
+
+PromptPack はプロジェクト内の SSOT（Single Source of Truth）として扱う。
+
+## 基本原則
+
+- spec/scenario/delta/BR/SC を最優先で読む
+- 変更は delta.md に記録し、互換維持/変更の区分を明示する
+- validate を通すことを必須とする（通らないなら仕様/運用が破綻している）
+- 不確実性（仮説/未確定/TODO）は残し方針を統一する
+
+## 運用
+
+- PromptPack は人が手動で参照する前提とする
+- 自動配置は v0.9 の emit/adapter まで行わない

package/assets/init/.qfai/promptpack/modes/change.md

@@ -0,0 +1,4 @@
+# Mode: Change
+
+- 仕様変更の根拠を delta.md に必ず記録する
+- 影響範囲を整理し、テストを増分で設計する

package/assets/init/.qfai/promptpack/modes/compatibility.md

@@ -0,0 +1,4 @@
+# Mode: Compatibility
+
+- 既存仕様との整合を最優先にする
+- 影響範囲を最小化し、回帰テストを重視する

package/assets/init/.qfai/promptpack/roles/qa.md

@@ -0,0 +1,4 @@
+# Role: QA
+
+- 例外/境界値/運用時の挙動を中心に確認する
+- 仕様とテストが一致しているかを検証する

package/assets/init/.qfai/promptpack/roles/spec.md

@@ -0,0 +1,4 @@
+# Role: Spec
+
+- 仕様書と成果物の整合を優先する
+- ID/参照/命名規約の逸脱を検出する

package/assets/init/.qfai/promptpack/roles/test.md

@@ -0,0 +1,4 @@
+# Role: Test
+
+- 振る舞い変更は再現テストを先に追加する
+- 近傍の適切な層でカバーする

package/assets/init/.qfai/promptpack/steering/compatibility-vs-change.md

@@ -0,0 +1,8 @@
+# Compatibility vs Change
+
+互換維持と仕様変更の区分は `rules/conventions.md` に従う。
+
+- 互換維持: 既存の期待値を変えない
+- 仕様変更: 期待値/挙動が変わる
+
+必ず `delta.md` に区分と根拠を記録する。

package/assets/init/.qfai/promptpack/steering/naming.md

@@ -0,0 +1,7 @@
+# Naming
+
+命名規約は `docs/rules/naming.md` を正とする。
+
+- ID は `PREFIX-0001` 形式（4桁ゼロ埋め）
+- 参照はファイル名ではなく ID を用いる
+- 同一 ID の重複定義は禁止

package/assets/init/.qfai/promptpack/steering/traceability.md

@@ -0,0 +1,9 @@
+# Traceability
+
+参照は下流→上流のみを許可する。
+
+- SC は BR を参照する
+- テスト/コードは SC を参照する
+- Spec は契約/テストを参照しない
+
+違反は CI で検出される前提で運用する。

package/assets/init/.qfai/rules/conventions.md

@@ -19,3 +19,9 @@
 - `delta.md` では **必ずどちらか1つにチェック**する
 - 両方ON/両方OFFは無効（エラー）
 - 迷った場合は「影響範囲」「受入観点」を追記して明文化する
+
+## OQ表記の扱い（対象範囲の限定）
+
+- OQ表記の排除は、現行仕様として参照される場所に限定する
+- 対象例: `packages/qfai/assets/init/.qfai/`, `.github/PULL_REQUEST_TEMPLATE.md`, `README.md`, `packages/qfai/README.md`
+- 意思決定ログ/ロードマップ（例: `docs/roadmap/`）は対象外とし、履歴の削除を誘発しない

package/dist/cli/index.cjs

@@ -716,8 +716,8 @@ var import_promises6 = require("fs/promises");
 var import_node_path7 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 async function resolveToolVersion() {
-  if ("0.3.3".length > 0) {
-    return "0.3.3";
+  if ("0.3.5".length > 0) {
+    return "0.3.5";
   }
   try {
     const packagePath = resolvePackageJsonPath();

package/dist/cli/index.mjs

@@ -693,8 +693,8 @@ import { readFile as readFile2 } from "fs/promises";
 import path7 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 async function resolveToolVersion() {
-  if ("0.3.3".length > 0) {
-    return "0.3.3";
+  if ("0.3.5".length > 0) {
+    return "0.3.5";
   }
   try {
     const packagePath = resolvePackageJsonPath();

package/dist/index.cjs

@@ -591,8 +591,8 @@ var import_promises5 = require("fs/promises");
 var import_node_path4 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 async function resolveToolVersion() {
-  if ("0.3.3".length > 0) {
-    return "0.3.3";
+  if ("0.3.5".length > 0) {
+    return "0.3.5";
   }
   try {
     const packagePath = resolvePackageJsonPath();

package/dist/index.mjs

@@ -534,8 +534,8 @@ import { readFile as readFile2 } from "fs/promises";
 import path4 from "path";
 import { fileURLToPath } from "url";
 async function resolveToolVersion() {
-  if ("0.3.3".length > 0) {
-    return "0.3.3";
+  if ("0.3.5".length > 0) {
+    return "0.3.5";
   }
   try {
     const packagePath = resolvePackageJsonPath();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qfai",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "type": "module",
   "bin": {
     "qfai": "./dist/cli/index.mjs"