# App Genesis Forge · AI バーチャル従業員チーム

> **Code the Origin, Forge the App.**
> 14 人の AI 同僚 · Agile + Scrum + TDD の骨格 · 一晩で feature をリリース · ブラウザの 1 タブで全工程を観察。

[![GitHub Template](https://img.shields.io/badge/GitHub-Template-2ea44f?logo=github)](https://github.com/pcliangx/AppGenesisForge/generate)
[![Release](https://img.shields.io/github/v/release/pcliangx/AppGenesisForge)](https://github.com/pcliangx/AppGenesisForge/releases)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-%E2%89%A5%20v2.1.130-orange?logo=anthropic)](https://claude.com/claude-code)
[![Methodology](https://img.shields.io/badge/methodology-Agile%20Scrum%20%2B%20TDD-9b59b6)](#-中核思想agile--scrum--tdd)
[![Agents](https://img.shields.io/badge/agents-14-9b59b6?logo=robotframework&logoColor=white)](.claude/agents/)
[![Commands](https://img.shields.io/badge/commands-4-3498db)](.claude/commands/)
[![Skills](https://img.shields.io/badge/skills-6-1abc9c)](.claude/skills/)
[![LLM](https://img.shields.io/badge/LLM-DeepSeek%20%7C%20Doubao%20%7C%20Qwen%20%7C%20MiniMax-ff6b6b)](.claude/skills/agf-wiring-multi-llm-sdk/)
[![WeChat](https://img.shields.io/badge/WeChat-MiniProgram-07c160?logo=wechat&logoColor=white)](.claude/standards/miniapp.md)
[![Hooks](https://img.shields.io/badge/hooks-4%20layers-2c3e50?logo=shieldsdotio&logoColor=white)](.claude/standards/security.md)
[![Stars](https://img.shields.io/github/stars/pcliangx/AppGenesisForge?style=social)](https://github.com/pcliangx/AppGenesisForge/stargazers)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/pcliangx/AppGenesisForge/pulls)

[简体中文](README.md) · [English](README.en.md) · **日本語**

> 📖 **読み進め方（結論-詳細-まとめ）**：
> - **結論先行** ── [💡 結論](#-これは何か結論から) → [🧠 中核思想](#-中核思想agile--scrum--tdd)
> - **詳細（3 つの柱 + 入門 + ツール）** ── [🏢 組織](#-組織--who) → [🔄 プロセス](#-プロセス--how) → [⚙️ メカニズム](#-メカニズム--enforcement) → [⏱ Day 1](#-day-1初日) → [🛠️ ツール](#-セルフサービス)
> - **まとめ** ── [🔍 比較](#-他との比較) → [✨ まとめ](#-まとめ)

---

## 💡 これは何か（結論から）

**AppGenesisForge** は [Claude Code Agent Teams](https://code.claude.com/docs/en/agent-teams) を基盤にした **AI チームスキャフォールド**です。プロンプト集でもなく、エージェントペルソナのカタログでもなく、**Agile + Scrum + TDD を骨格とし、ワークフロー・規範・受け入れループを備えたバーチャル AI チーム**です。

### 中核の結論（一文）

> **Agile + Scrum + TDD の原則を skill / hook / DoD の 3 層 enforcement に組み込み、エージェントの自律性に依存しない。**

### 5 つの事実

- **🧠 方法論の骨格は妥協なし** —— Agile + Scrum + TDD（[§中核思想](#-中核思想agile--scrum--tdd) 参照）
- **🏢 明確な組織** —— 14 人の AI 同僚それぞれに役割契約（[§組織](#-組織--who) 参照）
- **🔄 閉じたプロセス** —— PRD → UAT の 6 段階ゲート、失敗時はスキップ不可（[§プロセス](#-プロセス--how) 参照）
- **⚙️ メカニズムによる安全網** —— skill 強制 / hook ブロック / DoD チェックリストの 3 層（[§メカニズム](#-メカニズム--enforcement) 参照）
- **🇨🇳 中国系エコシステム** —— DeepSeek / Doubao / Qwen / MiniMax + WeChat ミニプログラム（[§ツール](#-セルフサービス) 参照）

### 適用範囲

✅ **適合**：React + FastAPI + Postgres · AI Agent / RAG / マルチモーダル · WeChat ミニプログラム（ネイティブ + Taro フォールバック）· PRD → UAT 完全ループ

❌ **非適合**：iOS / Android ネイティブ · デスクトップ GUI · 大規模モデル学習

> 📝 **デフォルトのバックエンドは Python（FastAPI + SQLAlchemy + Alembic）**、フロントエンドは React + Vite。**Java / Go / Rust 等への拡張可能** —— OpenAI 互換 LLM 接続 / Agile + Scrum + TDD 原則 / 4 層 hook 防御 / 14 同僚の役割契約はすべて言語に依存しません。バックエンド差し替え時は `tech-lead` が [`ADR-000`](.claude/skills/agf-writing-adr/SKILL.md) を書き直し、[`backend-dev`](.claude/agents/backend-dev.md) / [`testing.md`](.claude/standards/testing.md) / `agf-wiring-multi-llm-sdk` 内の Python コード例を置き換えます。

---

## 🧠 中核思想：Agile + Scrum + TDD

AI エージェント協業には 2 つの本質的弱点があります：**コンテキスト喪失と過信**。Scrum のステージゲート + Agile の反復フィードバック + TDD の red-green-refactor は、いずれもこれに対する成熟した規律です。本プロジェクトはこれらの規律を **組織 + プロセス + メカニズムの 3 層に落とし込み**ます。本セクションは WHAT/WHY、続く 3 セクションが HOW です。

完全な意思決定ログ：[`product-workflow.md §4.4`](./docs/product-workflow.md#44-agile--scrum-心法采用清单--词汇替代) + [`team-capability-map.md §1.6`](./docs/team-capability-map.md#16-scrum-词汇--本项目载体feature-流变体)。

### 原則チェックリスト（すべて必須 / 3 層着地）

| Agile / Scrum 概念 | 本プロジェクトの実体 | 着地レイヤー |
|---|---|---|
| **TDD red-green-refactor** | `superpowers:test-driven-development` + DoD 順序ルール | ⚙️ メカニズム |
| **AC（受け入れ基準）** | PRD §4 表（P0/P1）+ 派出時に AC 原文必須引用 | 🔄 プロセス + ⚙️ メカニズム |
| **DoD（完了の定義）** | [`ac-lifecycle.md`](.claude/standards/ac-lifecycle.md) の 9 項目チェックリスト | ⚙️ メカニズム |
| **DoR（着手準備の定義）** | `brainstorming` 完了 + AC が 30 秒以内に検証可能 + Open Q に Owner | 🔄 プロセス |
| **User Story（INVEST）** | PRD §3 表 + US↔AC ID 相互参照 | 🔄 プロセス |
| **Product Owner + Scrum Master** | `product-lead`（PO+SM 統合）| 🏢 組織 |
| **Dev Team（cross-functional）** | 5 dev + 1 Designer + 2 Reviewer + 2 QA + 2 Post-launch = 12 + PL/TL = 14 | 🏢 組織 |
| **Sprint** | 1 feature = PRD → UAT 署名ループ | 🔄 プロセス |
| **Sprint Planning** | `superpowers:writing-plans`（非同期）| 🔄 プロセス |
| **Daily Standup** | `progress/<role>.md` + SendMessage（非同期）| ⚙️ メカニズム |
| **Sprint Review** | UAT ビジネス署名 | 🔄 プロセス |
| **Sprint Retrospective** | `/agf-release-retro vX.Y.Z`（MAJOR/MINOR で必須）| 🔄 プロセス |

### Scrum 用語 → プロジェクト実体（代替マッピング）

| Scrum 用語 | 本プロジェクトの代替 | 理由 |
|---|---|---|
| **Sprint**（定時イテレーション）| Feature ストリーム | Agent Team は連続非同期、同期サイクルなし |
| **Product Backlog** | Status=Draft/Review の `docs/prd/` ファイル | ファイル化、git 追跡可能 |
| **Sprint Backlog** | `~/.claude/tasks/<team>/*.json` | PL が `TaskCreate/Update` で維持、`/agf-tasks` で閲覧 |
| **Story Points** | PRD の `Estimated effort tier: S/M/L` | トークン予算ティアと連動、抽象的なポイントより精密 |
| **Velocity / Burndown** | 計測しない | 定時イテレーションなし → velocity 無意味；retro 3 回後にサイクルタイム傾向を評価（暗黙形式）|
| **Daily Standup** | `progress/<role>.md` + SendMessage | 非同期スタンドアップ + hook 兜底 |

---

## 🏢 組織 / WHO

> Scrum 3 役割マッピング + 14 人の AI 同僚。**セルフマネージド、cross-functional** —— dev が Unit + SIT を自走、Reviewer はソースに触れず、QA はビジネス署名をしない。

### Scrum 3 役割マッピング

| Scrum 役割 | 本プロジェクトの実体 | 備考 |
|---|---|---|
| **Product Owner** | [`product-lead`](.claude/agents/product-lead.md) | PRD / 優先度 P0/P1 / UAT ビジネス署名 |
| **Scrum Master** | `product-lead`（PO+SM 統合）| プロセス指揮 / skill 強制 / retro 司会。エージェントには人間的な利害対立がないため統合は合理的。 |
| **Development Team** | 12 名の execution / review / QA / post-launch（下表参照）| セルフマネージド；dev が Unit + SIT を自走 |
| **技術アドバイザー**（Scrum 役割ではない）| [`tech-lead`](.claude/agents/tech-lead.md) | ベースライン欠如 / 新規技術選定 / 設計リスク昇格時のみ介入 |

### 14 人の AI 同僚

| # | 同僚 | 性格 + 役割 |
|---|---|---|
| 🟠 001 | [`product-lead`](.claude/agents/product-lead.md) | **PO + SM** —— コード書かず署名のみ。PRD / タスク派出 / UAT 署名 / retro 司会 |
| 🔵 002 | [`tech-lead`](.claude/agents/tech-lead.md) | 歴戦のベテラン —— 代替案なしの ADR は決定ではない。ベースライン欠如 / 新規選定 / 設計リスク時のみ介入 |
| 🟢 003 | [`frontend-dev`](.claude/agents/frontend-dev.md) | コンポーネントは契約 —— React+Vite + Unit + SIT 自走 |
| 🟢 004 | [`backend-dev`](.claude/agents/backend-dev.md) | スキーマ移行で PTSD —— FastAPI / SQLAlchemy + Unit + SIT 自走 |
| 🟢 005 | [`ai-agent-dev`](.claude/agents/ai-agent-dev.md) | Prompt はコード —— LLM / RAG / Agent + Unit + SIT 自走 |
| 🟢 006 | [`ml-engineer`](.claude/agents/ml-engineer.md) | 品質-レイテンシ-コスト三角 —— マルチモーダル推論 + Unit + SIT 自走 |
| 🟢 007 | [`uiux-designer`](.claude/agents/uiux-designer.md) | spec.md + index.html 二重納品 + AC カバレッジ表 |
| 🟢 008 | [`miniapp-dev`](.claude/agents/miniapp-dev.md) | ネイティブ優先 Taro フォールバック —— setData 256KB は越えられない壁 |
| 🟡 009 | [`code-reviewer`](.claude/agents/code-reviewer.md) | docs/reviews/ にしか書かない —— コード review + SIT Audit（4 項目 + 3 段階 verdict）|
| 🟡 010 | [`miniapp-code-reviewer`](.claude/agents/miniapp-code-reviewer.md) | 審査レッドラインゼロ容認 —— wx.* + パッケージサイズ + プライバシー + SIT Audit |
| 🔴 011 | [`qa-engineer`](.claude/agents/qa-engineer.md) | デフォルト verdict ❌ —— curl/スクショ/DB diff なしでは Pass 不可。E2E + UAT |
| 🔴 012 | [`miniapp-qa-engineer`](.claude/agents/miniapp-qa-engineer.md) | E2E で実機 QR スキャンなしは署名しない |
| 🟪 013 | [`content-writer`](.claude/agents/content-writer.md) | 形容詞より数字、フックは一文目に —— リリースノート / ブログ |
| 🟪 014 | [`growth-analyst`](.claude/agents/growth-analyst.md) | 指標は直感に勝る —— North Star / OMTM / A/B 実験 |

能力ベースライン（model / tools / プリロード skills）：[`team-roles.md`](.claude/standards/team-roles.md)；エンドツーエンドのメッセージフロー：[`team-capability-map.md §2`](./docs/team-capability-map.md)。

---

## 🔄 プロセス / HOW

> feature が要件から納品までを通る完全な連鎖。**6 段階ゲートが順番に進み、失敗時はスキップ不可**。

### エンドツーエンド全景

```mermaid
flowchart LR
    U([👤 ユーザー]) --> S1["S1 要件明確化<br/>brainstorming → PRD"]
    S1 --> S2["S2 派出<br/>6 段スキーマ + AC 引用"]
    S2 --> S3["S3 TDD 実装<br/>red→green→refactor<br/>+ Unit + SIT 自走"]
    S3 --> S4["S4 Code Review<br/>+ SIT Audit"]
    S4 --> S5["S5 E2E<br/>chrome-devtools-mcp"]
    S5 --> S6["S6 UAT<br/>PL ビジネス署名"]
    S6 --> D([🎁 納品])
    S6 -.->|オプション| POST["Post-Launch<br/>content + growth"]

    S4 -.失敗.-> S3
    S5 -.失敗.-> S3
    S6 -.失敗.-> S3

    style U fill:#3b82f6,color:#fff
    style S6 fill:#f97316,color:#fff
    style D fill:#22c55e,color:#fff
```

完全図（サブグラフ + ミニプログラム派生 + リリース後リンク + ステージ × Hook + ステージ × Skill）：[`team-capability-map.md §1.1-§1.6`](./docs/team-capability-map.md)。

### 1 feature = 1 Sprint

| Sprint ステージ | 担当 + 内容 | 成果物 |
|---|---|---|
| **Planning** | #001 が `brainstorming` で明確化 → PRD → `writing-plans` で計画 | `docs/prd/<feature>-<date>.md`（10 セクション / AC P0/P1）|
| **Design** | #007 が spec.md + 自己完結 HTML プロトタイプ + **AC カバレッジ表** | `docs/design/<feature>/{spec.md,index.html}` |
| **TDD 実装** | #003 + #004 が並行（独立 worktree）→ red → green → refactor | コード + `tests/sit/` |
| **非同期スタンドアップ** | 各 Task 完了後 → `progress/<role>.md` に追記（コマンド + 実出力 + AC 自己検証）| `progress/*.md` |
| **Code Review + SIT Audit** | #009 のダブル verdict（コード approve/changes/block + Audit ✅/⚠️/❌）| `docs/reviews/<feature>-<date>.md` |
| **Sprint Review（E2E + UAT）** | #011 が E2E 実施 → UAT（ビジネス側が PRD AC を逐条署名）| `docs/qa/<feature>-{e2e,uat}-<date>.md` |
| **署名 + アーカイブ** | #001 のビジネス署名 → `archive-progress.sh` で progress をアーカイブ | `docs/qa/<feature>-process-log.md` |
| **Retrospective**（MAJOR/MINOR）| #001 が `/agf-release-retro vX.Y.Z`（7 ステップ + §5 Owner+Due 必須）| `docs/reviews/retro-vX.Y.Z-<date>.md` |

### PRD → Task 分解ルール

詳細は [`product-workflow.md §3.3`](./docs/product-workflow.md#33-拆分规则硬性条款)：

- 1 User Story = 1〜N Task、**役割境界で切る**（FE/BE/AI/ML）、AC で切らない；各 Task に最低 1 AC、SendMessage 内で原文引用
- Task 粒度 = 1 セッション内でクローズ可能（実装 + Unit + AC 自己検証）
- AC はリーフ、再分割不可 —— 大きすぎる場合は「観察可能な結果」を分割

### 失敗ループ（任意ステージ失敗 → スキップ不可、S3 に戻る）

| ステージゲート | 失敗時の動作 | 戻り先 |
|---|---|---|
| code review = `request changes` | PL が execution layer に再派出 | S3 |
| SIT Audit = `❌ Redo SIT` | PL が再派出を統合（コード修正 + SIT redo）| S3（E2E に進まない）|
| E2E fail | qa が報告 → PL が再派出 | S3（UAT に進まない）|
| UAT = `request changes` | PL が再派出 | S3 |

**code-reviewer / qa-engineer は決してソースを直接編集しない**。

---

## ⚙️ メカニズム / ENFORCEMENT

> Agile + Scrum + TDD の原則を **skill / hook / DoD の 3 層 enforcement** に組み込み、エージェントの自律性に依存しない。

### TDD 強制チェーン

```mermaid
flowchart LR
    PL([🟠 PL 派出<br/>新機能 / bugfix]) --> HOOK["validate-task-schema<br/>6 セクション完備"]
    HOOK --> SKILL["skill 呼び出し<br/>test-driven-development"]
    SKILL --> RED["🔴 red<br/>失敗 test を書く<br/>commit: test:"]
    RED --> GREEN["🟢 green<br/>最小実装で test を緑に<br/>commit: feat: / fix:"]
    GREEN --> REFACTOR["🔵 refactor<br/>緑を保ちつつ整理<br/>commit: refactor:"]
    REFACTOR --> PR["PR commit history<br/>first test が first impl より前"]
    PR --> CR["code-reviewer<br/>順序チェック"]
    CR --> PASS([✅ code review<br/>+ SIT Audit へ])

    REFACTOR -.反復可能.-> RED
    CR -.違反 = block.-> RED

    style PL fill:#f97316,color:#fff
    style PASS fill:#22c55e,color:#fff
```

**スキップ条件**：純粋なリファクタ / ドキュメント / 設定タスクは TDD 順序をスキップ可能（[`ac-lifecycle.md` DoD line 81–85](.claude/standards/ac-lifecycle.md)）。

### 4 層 Hook 防御（レッドライン + リマインダー）

| レイヤー | トリガー | 動作 |
|---|---|---|
| 🚫 | 危険コマンド：`rm -rf` / `DROP TABLE` / `git push --force` / `git reset --hard` | 強制ブロック |
| 🚫 | シークレット漏洩：10 ベンダーのトークン + PEM/SSH/PuTTY/BIP39 ニーモニック | 強制ブロック |
| 🚫 | 外部コンテンツ内の prompt-injection | ソフト警告 |
| 🚫 | commit 前の staged diff secret スキャン | 強制ブロック（Edit/Write バイパスの兜底）|
| 💡 | teammate が idle したいが pending タスクが残る | 残って完了の促し |
| 💡 | execution layer が `progress/<role>.md` 未記載で退出 | ブロック（**Daily Standup 兜底**）|
| 💡 | `TaskCreate` の 6 段スキーマ欠落 | ブロック（**AC 引用強制**）|
| 💡 | 着手前の skill チェック | リマインダー（未使用なら促し）|

### ステージ × Hook × Skill トリガー（統合ビュー）

| ステージ | Hook（🛑 強制ブロック / ⚠️ ソフト警告）| Skill（必須 / 推奨）|
|---|---|---|
| **prompt 送信** | 🛑 `scan-secrets`（10+ ベンダーシークレット + PEM/SSH/BIP39）<br/>⚠️ `skill-suggester` | — |
| **S1 要件明確化 + PRD** | — | `brainstorming`（曖昧/複数選択時に必須）<br/>`agf-writing-prd` |
| **S2 派出** | 🛑 `validate-task-schema`（6 セクション + AC 引用）| `writing-plans`（≥3 AC / 跨役割）<br/>`using-git-worktrees`（≥2 dev 並行で必須）|
| **S3 実装期ツール呼び出し** | 🛑 `block-dangerous-bash`<br/>　Bash：`rm -rf` / `DROP TABLE` / `push --force` / `reset --hard`<br/>⚠️ `sanitize-tool-output`<br/>　WebFetch/WebSearch/Read/Bash 出力の prompt-injection 警告 | `test-driven-development` 必須（新機能/bugfix）<br/>`agf-running-sit-tests`（Unit 完了後）<br/>`systematic-debugging`（バグ発生時）<br/>`verification-before-completion`（報告前）|
| **S3 退出/idle** | 🛑 `check-progress-file`（progress 項目なしでブロック）<br/>🛑 `teammate-keepalive`（pending あり idle 阻止）| — |
| **git commit** | 🛑 `scan-commit`（staged diff 同じ secret 正規表現）| — |
| **S4 review** | — | `requesting-code-review`（トリガー前）<br/>`receiving-code-review`（差し戻し受領時）|
| **S5/S6 テスト** | — | `agf-writing-qa-report`（E2E/UAT レポート）|
| **リリース後**<br/>（MAJOR/MINOR）| — | `agf-running-release-retro`（PATCH 自動 abort）|

### Release 規律 + No Equivalent Bypass

**Release 規律**：MAJOR/MINOR は同一セッション内で tag + tag annotation に tagged-along commits を列挙 + **必ず** `/agf-release-retro` を実行。詳細：[`versioning.md`](.claude/standards/versioning.md)。

**強制ブロックに遭遇** → **No Equivalent Bypass**（等価な迂回路を探さず、SendMessage で PL に授権を仰ぐ）。詳細：[`security.md`](.claude/standards/security.md)。

### 📖 用語クイックリファレンス

**協業アクション**（実行時頻出、詳細：[`product-workflow.md §4.5`](./docs/product-workflow.md#45-协作动作collaboration-actions)）：

| 用語 | 意味 |
|---|---|
| **dispatch / 派出** | PL が SendMessage で Task を execution layer に割当（6 段 + AC 引用）|
| **escalate** | 上位に判断を要請（execution→PL→user；reviewer→tech-lead で設計リスク昇格）|
| **halt / STOP ⛔** | hook ブロック / テスト fail / spec drift がトリガー；停止して SendMessage 報告、勝手にバイパスしない |
| **verify-before-assert** | 「完了」と報告する前に必ず実行検証、空言厳禁 |
| **push back** | review フィードバック受領後、実測根拠で反論 |
| **ghost mailbox** | 存在しないか破壊済みの mailbox に派出 |
| **spec drift** | ドキュメント/PRD/spec の契約と実コード/DB が乖離 |
| **sweep** | PL が能動的に git log + task list + mailbox を一括確認 |
| **mock-first** | フロントは mock データで UI 実装、backend 準備後に実エンドポイントへ切替 |

**ステータス記号**（チーム合意、自作禁止）：

| 記号 | 意味 | 典型的な出現箇所 |
|---|---|---|
| ✅ | 完了 / 通過 | AC 自己検証、Code Review verdict、UAT 署名 |
| ⚠️ | 警告 / 偏差 | AC 自己検証に偏差、Code Review Warning |
| ❌ | 失敗 / 不通過 | テスト失敗、Code Review request changes |
| 🔄 | 進行中 | Task ステータス、長時間タスク進行 |
| ⏸ | 一時停止 / pending | 外部依存待ち / 明確化待ち |
| 💤 | idle / standby | teammate 待機中 |
| ⛔ | STOP / halt | 緊急停止（hook ブロック / spec drift / テスト fail）|

---

## ⏱ Day 1（初日）

**前提**：Claude Code ≥ v2.1.130 + Agent Teams 有効化（`init-team.sh` が自動チェック）。

```bash
# 新規プロジェクトとしてスキャフォールド
gh repo create my-app --template pcliangx/AppGenesisForge --private
cd my-app && bash init-team.sh

# 既存リポジトリへ埋め込み（一発移行；既存の CLAUDE.md / ADR-000 / settings.json は上書きしない）
bash install-to-existing.sh ~/path/to/your-existing-repo

# 試走
/agf-team-start <最初の feature>
```

完全な Day-1 チェックリスト + 前提知識 + よくある落とし穴：[`docs/FIRST_RUN.md`](./docs/FIRST_RUN.md)。⚠️ 本リポジトリの `CLAUDE.md` を直接コピーしないでください —— スキャフォールドは `CLAUDE.example.md` を提供します。

---

## 🛠️ セルフサービス

### Slash Commands（4 個、Scrum セレモニーの入口）

| コマンド | Scrum セレモニー |
|---|---|
| [`/agf-team-start`](.claude/commands/agf-team-start.md) | Sprint キックオフ |
| [`/agf-uat`](.claude/commands/agf-uat.md) | Sprint Review（ビジネス署名）|
| [`/agf-release-retro`](.claude/commands/agf-release-retro.md) | Sprint Retrospective（PATCH 自動 abort）|
| [`/agf-tasks`](.claude/commands/agf-tasks.md) | Sprint Backlog 表示 |

### Skills（プロジェクト固有 6 個 + superpowers スイート）

| Skill | 誰が / いつ |
|---|---|
| [`agf-writing-prd`](.claude/skills/agf-writing-prd/) | #001 が PRD 執筆時（10 セクション + AC 5 ルール + 完了チェック）|
| [`agf-writing-adr`](.claude/skills/agf-writing-adr/) | #002 が設計決定記録時（代替案必須 + バージョン検証）|
| [`agf-wiring-multi-llm-sdk`](.claude/skills/agf-wiring-multi-llm-sdk/) | #005 が DeepSeek/Doubao/Qwen/MiniMax 接続時 |
| [`agf-running-sit-tests`](.claude/skills/agf-running-sit-tests/) | execution layer の dev が SIT 自走時 |
| [`agf-writing-qa-report`](.claude/skills/agf-writing-qa-report/) | #011 が E2E/UAT レポート執筆時 |
| [`agf-running-release-retro`](.claude/skills/agf-running-release-retro/) | #001 が MAJOR/MINOR retro 実行時 |

**Superpowers スイート**（全員呼び出し可）：`brainstorming` / `writing-plans` / `test-driven-development` / `systematic-debugging` / `verification-before-completion` / `requesting-code-review` / `receiving-code-review` / `using-git-worktrees` —— 強制ポイントは [`superpowers.md`](.claude/standards/superpowers.md) 参照。

### 📊 ライブダッシュボード

`agf-team-start` 実行中に別ターミナルで：`cd tools/team-dashboard && ./start.sh` → `http://localhost:5173/`。3 ペイン UI：**Tasks** リアルタイム状態 · **Timeline** transcript メッセージストリーム · **Artifacts** docs/ 変更。ゼロ侵入の読み取り専用 SSE。詳細：[`tools/team-dashboard/README.md`](tools/team-dashboard/README.md)。

---

## 🔍 他との比較

|  | **AppGenesisForge** | 汎用 prompt ライブラリ | ロールペルソナライブラリ | 単一 agent ツールチェーン |
|---|---|---|---|---|
| **方法論の骨格** | ✅ Agile + Scrum + TDD（組織 / プロセス / メカニズム 3 層）| ❌ | ❌ | ❌ |
| **組織** | ✅ 14 同僚 + Scrum 役割マッピング | ❌ | ⚠️ 役割リストのみ | ❌ |
| **プロセス** | ✅ PL + 6 ステージゲート | ❌ | ⚠️ サンプルのみ | ❌ |
| **メカニズム（TDD 強制）** | ✅ commit 順序 + skill + DoD | ❌ | ❌ | ❌ |
| **メカニズム（Hook 防御）** | ✅ 4 層 | ❌ | ❌ | ❌ |
| **Retrospective** | ✅ 7 ステップ + Owner+Due 必須 | ❌ | ❌ | ❌ |
| **ライブ観察** | ✅ team-dashboard ゼロ侵入 | ❌ | ❌ | ❌ |
| **下流への移行** | ✅ install-to-existing | ✅ コピペ | ⚠️ fork | ⚠️ |
| **中国系 LLM** | ✅ DeepSeek/Doubao/Qwen/MiniMax | ❌ | ❌ | 依存 |

---

## ✨ まとめ

振り返り：

- **何か**：14 人の AI 同僚 + Agile + Scrum + TDD ワークフロー + 4 層 hook 防御のスキャフォールド
- **なぜユニークか**：Agile + Scrum + TDD の原則を **組織 + プロセス + メカニズムの 3 層着地** に組み込み、エージェントの自律性に依存しない
- **使い方**：`/agf-team-start <feature>` → 14 同僚が Sprint フローを実行 → 1 タブで観察
- **あなたへの価値**：一晩で feature をリリース；成果物は追跡可能；ステージゲートのスキップ = 職務違反

> **コアトレードオフ**：*Agile + Scrum + TDD を wiki ではなく enforcement パスに組み込む* —— これがこのシステム最重要の設計選択。一線チームが繰り返し試行錯誤して固めた規律：初期は PL がコードを書き始め、Reviewer が Dev より過激、QA が証拠を出せない —— 各 hook、各規範、各 skill はすべて実際の躓きから生まれました。

### 🚀 次のステップ

| あなたがしたいこと | やり方 |
|---|---|
| **新規プロジェクトで試す** | `gh repo create --template pcliangx/AppGenesisForge` → [⏱ Day 1](#-day-1初日) |
| **既存リポジトリに埋め込む** | `bash install-to-existing.sh ~/your-repo`（既存の `CLAUDE.md`/`ADR-000`/`settings.json` は上書きしない）|
| **本物の feature の完全成果物を見る** | `ls examples/login-feature/` —— PRD → Design → Review → UAT → Release notes → Experiment 一式 |
| **フィードバック / PR を出す** | [🐛 Issue](https://github.com/pcliangx/AppGenesisForge/issues) · [🍴 PR](https://github.com/pcliangx/AppGenesisForge/pulls) |
| **各リリースの変更を見る** | [📒 CHANGELOG](CHANGELOG.md) |

### 📂 内部資料

```text
.claude/                14 agents · 14 standards · 6 skills · 8 hooks · 4 commands · 2 scripts · 2 rules
docs/                   product-workflow / team-capability-map / PRD·QA·ADR·Review·Retro テンプレート
examples/ · evals/      エンドツーエンド worked example + 役割別 baseline JSONL
progress/               execution layer の Self-Reporting 下書き（非同期 Daily Standup）
tools/team-dashboard/   単タスク読み取り専用 web ダッシュボード（ゼロ侵入）
init-team.sh            Day-1 ヘルスチェック（10 項目チェック + pre-commit hook 自動インストール）
install-to-existing.sh  既存リポジトリへの一発移行
CLAUDE.example.md       プロジェクト級 CLAUDE.md テンプレート（本リポジトリの CLAUDE.md と混同しないこと）
```

### 🗺️ Roadmap

**実装済み**：

| Release | 内容 |
|---|---|
| Foundation | 中国系 LLM 4 種 · WeChat ミニプログラム 3 点セット · 4 層 hook 防御 · Self-Reporting Pattern · agent 名前空間定常化 |
| **v1.6.0** | team-dashboard ゼロ侵入観察台 + `install-to-existing.sh` 一発移行 |
| **v1.7.0** | code-reviewer が `/simplify` Phase 1+2 review を採用 |
| **v2.0.0** | H3 後期ワークフロー：SIT 責任を dev 自走 → code-reviewer audit へ |
| **v3.0.0** | cost audit feature 削除（連続 2 回空転 = 誤規律）|
| **v3.1.0** | **Agile + Scrum + TDD enforcement 完成**（skill / hook / DoD 3 層兜底）+ README rewrite + ドキュメント traceability |

**進行中**：

- [ ] 追加 skill：テストケース / commit message / リリースノート
- [ ] 追加 eval baseline：残り役割の JSONL カバレッジ
- [ ] CI/CD：`init-team.sh` を GitHub Actions に接続
- [ ] feature サイクルタイム傾向の可視化（retro 3 回後に有効化）

---

## 📜 ライセンス & 謝辞

MIT —— 商用利用自由。構成のインスピレーション：[The Agency](https://github.com/msitarzewski/agency-agents)。

---

<div align="center">

**14 人の AI 同僚 · Agile + Scrum + TDD（組織 / プロセス / メカニズム 3 層着地）· 一晩で feature をリリース**

[⭐ Star](https://github.com/pcliangx/AppGenesisForge) · [🍴 Fork](https://github.com/pcliangx/AppGenesisForge/fork) · [🐛 Issue](https://github.com/pcliangx/AppGenesisForge/issues) · [📒 CHANGELOG](CHANGELOG.md) · [🇨🇳 简体中文](README.md) · [🇬🇧 English](README.en.md)

</div>
