qfai 1.1.2 → 1.1.4

package/README.md

@@ -39,7 +39,7 @@ npx qfai report
 - `npx qfai doctor`
   - Diagnoses configuration discovery, path resolution, glob scanning, and `validate.json` inputs before running validate/report; use `--fail-on` to enforce failures in CI.
 - `npx qfai guardrails`
-  - Lists, extracts, or checks Decision Guardrails in `delta.md` (`list` / `extract` / `check`); use `--path` to point at samples or custom locations.
+  - Lists, extracts, or checks Decision Guardrails in `delta.md` (`list` / `extract` / `check`); use `--path` to point at target files/directories or custom locations.
 
 ## Operating model (prompt-driven workflow)
 
@@ -354,9 +354,6 @@ Typical customizations.
 │   │   └── require.md
 │   ├── specs
 │   │   └── README.md
-│   ├── samples
-│   │   ├── guardrails
-│   │   │   └── delta_with_guardrails.md
 │   └── README.md
 └── qfai.config.yaml
 ```

package/assets/init/.qfai/assistant/prompts/qfai-implement.md

@@ -162,6 +162,18 @@ QFAI expects `assistant/steering/` to contain **project‑specific facts** so al
 
 ## Step 1 — Confirm prerequisites
 
+### 1.1 Read delta decision log (mandatory)
+
+Before implementing, read `.qfai/specs/spec-XXXX/delta.md` and treat it as authoritative for:
+
+- what options were considered (Decision Table)
+- what options were rejected or deferred (Decision Guardrails)
+
+Hard rule:
+
+- Do not implement rejected/deferred options unless the spec/delta is explicitly updated.
+- If you need an exception, raise an Open Question and propose a spec change first.
+
 Must exist:
 
 - `.qfai/specs/spec-XXXX/spec.md`

package/assets/init/.qfai/assistant/prompts/qfai-spec.md

@@ -258,12 +258,50 @@ Tie each acceptance criterion to scenarios and/or tests.
 
 ### 2.2 `delta.md` template (Planner + QA)
 
+`delta.md` is not only a change log. It is also a **decision log** that prevents accidental implementation of rejected options.
+
 Use this structure:
 
 # Delta
 
 ## Summary
 
+## Decision Table (検討テーブル)
+
+Record the options that were considered during spec discussion.
+
+Rules:
+
+- For each important design decision, list at least:
+  - the chosen option (Adopt)
+  - one plausible alternative (Reject or Defer)
+- If ambiguity remains, explicitly mark it as `Defer` and raise an Open Question.
+- For any rejected option that an implementer could accidentally pick, add a corresponding Decision Guardrail entry below.
+
+Template:
+
+| ID      | Topic   | Options     | Decision                            | Rationale | Implementation note         |
+| ------- | ------- | ----------- | ----------------------------------- | --------- | --------------------------- |
+| DT-0001 | <topic> | <A / B / C> | Adopt: <X>, Reject: <Y>, Defer: <Z> | <why>     | <do / do not / constraints> |
+
+## Decision Guardrails
+
+Convert critical `Reject` / `Defer` items into short, machine-extractable guardrails.
+
+Format (one entry per `### DG-` heading):
+
+```md
+### DG-0001: <title>
+
+- Type: non-goal | not-now | trade-off
+- Scope: <optional>
+- Guardrail: <1 sentence. What must NOT be done / must be deferred>
+- Reason: <1-3 sentences>
+- Reconsider: <never or explicit condition>
+- Related: <optional links/IDs>
+- Keywords: <comma or space separated>
+```
+
 ## User-visible changes
 
 ## Backward compatibility / migration notes

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

@@ -3,12 +3,46 @@
 A **spec pack** lives under `specs/spec-XXXX/` and contains:
 
 - `spec.md` : SDD spec (source of truth for behavior)
-- `delta.md` : impact / migration / verification plan
+- `delta.md` : change log / impact / migration / verification plan (and decision records)
 - `scenario.feature` : Gherkin scenarios (ATDD skeleton)
 
 Create/update spec packs with `/qfai-spec`.
 
-Decision Guardrails can be stored under `delta.md` as `## Decision Guardrails`. See `.qfai/samples/guardrails/delta_with_guardrails.md` for an opt-in example.
+## Decision records in `delta.md`
+
+`delta.md` is not only "what changed", but also "what we decided".
+This is critical for AI-assisted implementation: when `spec.md` is ambiguous, the implementer must avoid accidentally choosing a previously rejected option.
+
+### Decision Table (recommended)
+
+Record candidate options and outcomes in a compact table:
+
+```md
+## Decision Table
+
+| ID      | Topic         | Candidates | Decision              | Rationale | Implementation note  |
+| ------- | ------------- | ---------- | --------------------- | --------- | -------------------- |
+| DT-0001 | Example topic | A / B / C  | Adopt: B, Reject: A,C | Why B     | Do NOT implement A,C |
+```
+
+### Decision Guardrails (DG)
+
+Decision Guardrails can be stored under `delta.md` as `## Decision Guardrails`.
+Keep each guardrail short and machine-extractable so `qfai guardrails extract` can pull the relevant constraints when needed.
+
+```md
+## Decision Guardrails
+
+### DG-0001: Do not implement option A for <topic>
+
+- Type: trade-off
+- Scope: specs/spec-\*/
+- Guardrail: Option A MUST NOT be implemented; prefer option B.
+- Reason: Option A breaks compatibility.
+- Reconsider: only if compatibility policy changes.
+- Related: DT-0001
+- Keywords: option-a, compatibility
+```
 
 Before writing a spec pack, read `.qfai/assistant/steering/manifest.md` to align on product-level decisions.
 

package/assets/init/root/.claude/agents/README.md

@@ -0,0 +1,13 @@
+# Claude Code Project Sub-agents (QFAI wrappers)
+
+## これは何？
+
+このディレクトリの `*.md` は、Claude Code の **Project Sub-agents** をリポジトリに同梱するための設定です。
+
+ただし、本プロジェクトではサブエージェント定義の正本を `.qfai/assistant/agents/` に置きます。
+ここにある各 `*.md` は、Claude Code から呼び出された際に **.qfai の role card を参照して従う**ことだけを強制する「薄いラッパー」です。
+
+## 重要
+
+- 役割の中身を変えるときは、まず `.qfai/assistant/agents/*.md` を更新してください。
+- ここ（`.claude/agents`）は **参照先を示すだけ**に留め、重複実装を避けてください。

package/assets/init/root/.claude/agents/architect.md

@@ -0,0 +1,29 @@
+---
+name: architect
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/architect.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/architect.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/backend-engineer.md

@@ -0,0 +1,29 @@
+---
+name: backend-engineer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/backend-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/backend-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/code-reviewer.md

@@ -0,0 +1,29 @@
+---
+name: code-reviewer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/code-reviewer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/code-reviewer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/contract-designer.md

@@ -0,0 +1,29 @@
+---
+name: contract-designer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/contract-designer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/contract-designer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/devops-ci-engineer.md

@@ -0,0 +1,29 @@
+---
+name: devops-ci-engineer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/devops-ci-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/devops-ci-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/facilitator.md

@@ -0,0 +1,29 @@
+---
+name: facilitator
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/facilitator.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/facilitator.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/frontend-engineer.md

@@ -0,0 +1,29 @@
+---
+name: frontend-engineer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/frontend-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/frontend-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/interviewer.md

@@ -0,0 +1,29 @@
+---
+name: interviewer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/interviewer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/interviewer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/planner.md

@@ -0,0 +1,29 @@
+---
+name: planner
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/planner.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/planner.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/qa-engineer.md

@@ -0,0 +1,29 @@
+---
+name: qa-engineer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/qa-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/qa-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/requirements-analyst.md

@@ -0,0 +1,29 @@
+---
+name: requirements-analyst
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/requirements-analyst.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/requirements-analyst.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.claude/agents/test-engineer.md

@@ -0,0 +1,29 @@
+---
+name: test-engineer
+description: "QFAI sub-agent wrapper (project-level). Canonical role card lives under .qfai/assistant/agents/."
+model: inherit
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **Claude Code Project Sub-agent**（`.claude/agents/`）向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このサブエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/test-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/test-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.github/agents/README.md

@@ -0,0 +1,13 @@
+# GitHub Copilot Custom Agents (QFAI wrappers)
+
+## これは何？
+
+このディレクトリの `*.agent.md` は、GitHub Copilot の **Custom Agents** をリポジトリに同梱するための設定です。
+
+ただし、本プロジェクトではサブエージェント定義の正本を `.qfai/assistant/agents/` に置きます。
+ここにある各 `*.agent.md` は、Copilot から呼び出された際に **.qfai の role card を参照して従う**ことだけを強制する「薄いラッパー」です。
+
+## 重要
+
+- 役割の中身を変えるときは、まず `.qfai/assistant/agents/*.md` を更新してください。
+- ここ（`.github/agents`）は **参照先を示すだけ**に留め、重複実装を避けてください。

package/assets/init/root/.github/agents/architect.agent.md

@@ -0,0 +1,29 @@
+---
+description: "QFAI sub-agent wrapper. Canonical role card lives under .qfai/assistant/agents/."
+target: github-copilot
+infer: false
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **GitHub Copilot Custom Agents** 向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/architect.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/architect.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.github/agents/backend-engineer.agent.md

@@ -0,0 +1,29 @@
+---
+description: "QFAI sub-agent wrapper. Canonical role card lives under .qfai/assistant/agents/."
+target: github-copilot
+infer: false
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **GitHub Copilot Custom Agents** 向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/backend-engineer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/backend-engineer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.github/agents/code-reviewer.agent.md

@@ -0,0 +1,29 @@
+---
+description: "QFAI sub-agent wrapper. Canonical role card lives under .qfai/assistant/agents/."
+target: github-copilot
+infer: false
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **GitHub Copilot Custom Agents** 向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/code-reviewer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/code-reviewer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない

package/assets/init/root/.github/agents/contract-designer.agent.md

@@ -0,0 +1,29 @@
+---
+description: "QFAI sub-agent wrapper. Canonical role card lives under .qfai/assistant/agents/."
+target: github-copilot
+infer: false
+---
+
+# QFAI Sub-agent (Wrapper)
+
+## 目的
+
+このファイルは **GitHub Copilot Custom Agents** 向けの「薄いラッパー」です。
+
+本リポジトリでは、サブエージェントの正本（Single Source of Truth）は `.qfai/assistant/agents/*.md` にあります。
+このエージェントが呼び出されたら、**必ず最初に**以下を読んで、その指示に従ってください。
+
+- `.qfai/assistant/agents/README.md`
+- `.qfai/assistant/agents/contract-designer.md`
+
+## 運用ルール（最重要）
+
+- 役割定義・応答フォーマット・禁止事項は、上記の `.qfai` 配下の role card を **優先**します。
+- このファイルに書かれた内容と `.qfai` の内容が矛盾する場合、**`.qfai` を正**とします。
+- `.qfai` を読まずに推測で進めないでください。
+
+## 実行指示（最小）
+
+1. `.qfai/assistant/agents/contract-designer.md` を読み、期待されるアウトプット形式で回答する
+2. `.qfai/assistant/steering/*.md` と `.qfai/assistant/instructions/*.md` を前提として扱う
+3. 不明点は Open Questions として列挙し、確定事項と混ぜない