03-construction · git:20260409.ec7cac7 · 2026-04-09 · sha256 324dcc2d64db9881
03-construction git:20260409.ec7cac7C

Immutable. This exact content never changes and is served at /api/v1/blob/324dcc2d64db9881.
> 🏷️ **Project:** [AI-PLC Project](https://www.notion.so/268b133701be808a81bce066ce075281)
> **Type:** command
> **Context:** AI-PLC Stage 3 — Construction。Backlogの各タスクに対して実行可能なスキル定義（Harness）を生成するステージ。既存テンプレートからのProgressive Context Loadingとタスク固有コンテキストに基づく動的生成を組み合わせる。
> 🔗 **必須コンテキスト（このスキル実行時に自動読み込み）**
> 1. [AI-PLC system](../README.md) — AI-PLCシステム全体
> 2. [RUL_plc_system](../../../rules/ai-plc-system.md) — ルートシステムルール
> 3. [RUL_plc_session](../../../rules/ai-plc-session.md) — セッション管理ルール
> 4. [RUL_plc_adaptive](../../../rules/ai-plc-adaptive.md) — Adaptive Workflow + Next Action判定
> 5. [Templates](../templates) — Templatesフォルダ（Roles + Agent生成テンプレート）
---
## 概要
> ⚙️ **モダン名称:** Construction Stage
>
> **パイプライン位置:** Stage 3 of 4
>
> **Jeff Patton対応:** Discover（実行計画の立案・検証）
>
> **対応する旧CMD:** [CMD_aipo_03_discover](https://www.notion.so/4dce59e7880b4e40956510012702d18e)
>
> **AI-DLC対応:** Construction Phase（Domain Design + Logical Design + コード生成）
Backlogの各タスクに対して、**実行可能なスキル定義**（Harness）を生成するステージ。既存のSkill Template（旧command_templates）からの**Progressive Context Loading**と、タスク固有コンテキストに基づく動的生成を組み合わせる。
> **Backlogを渡すだけで、各タスクの実行用スキルページを自動生成します**
### AI-DLC Construction対応
> ⚡ **AI-DLCのConstruction Phaseに直接対応**
>
> AI-DLCではMob Construction（チーム全員でのAI生成物検証）がConstructionの中核儀式。AI-PLCでもこのステージでスキル設計のチーム検証を組み込み可能。
>
> - **Domain Design** → タスク固有のハーネス設計（Goal/Input/Output/Flow定義）
>
> - **Code Generation** → 実行可能なスキルページの自動生成
>
> - **Coding PJ** → コーディング用テンプレート（TPL_coding_agent / TPL_review_agent）が適用されたSubLayerが再帰展開される（特別フェーズ不要）
---
## 入力インターフェース
| **入力名** | **型** | **必須** | **説明** | **旧AIPO対応** |
| --- | --- | --- | --- | --- |
| Backlog | Page | ✅ | Stage 2で生成されたタスク定義 | tasks.yaml |
| Agent Template Library | Folder | ⭕ | Agent生成テンプレート（TPL_\*）。`.notion/Templates/Agents_template/`配下 | command_templates/ |
| Existing Agents | Folder | ⭕ | 過去に生成された再利用可能なAgent定義群 | Commands/ |
---
## 処理フロー
```mermaid
flowchart TD
    START["Backlog"] --> READ["Phase 1: Backlog読み込み
commandフィールド確認"]
    READ --> SEARCH["Phase 2: Template探索
Progressive Context Loading"]
    SEARCH --> L1["Level 1: Skill Templates"]
    SEARCH --> L2["Level 2: Existing Skills"]
    SEARCH --> L3["Level 3: Domain Knowledge"]
    L1 --> PLAN["Phase 3: スキル生成計画提案"]
    L2 --> PLAN
    L3 --> PLAN
    PLAN --> MOB["Phase 4: Mob Checkpoint
設計承認"]
    MOB -->|"Approved"| GEN["Phase 5: Agents生成
Agents/フォルダに配置"]
    MOB -->|"Adjusted"| PLAN
    GEN --> EXIT["Phase 6: Mob Checkpoint
次ステージ提案"]
    
    style START fill:#fff3e0
    style MOB fill:#fff9c4
    style EXIT fill:#fff9c4
```
### Phase 1: Backlog読み込み
各タスクのcommandフィールドとcommand_template_refを確認。
### Phase 2: Template探索（Progressive Context Loading）
3段階の探索：
- **Level 1:** Agent Template Library（`.notion/Templates/Agents_template/`配下のTPL_\*）
- **Level 2:** 既存Skills（過去のハーネス定義）
- **Level 3:** ドメイン知識テンプレート（AIPMコマンド群等）
### Phase 3: スキル生成計画の提案
各タスクに対する参考テンプレートとPhase構造を提案。
### Phase 4: Mob Checkpoint — 設計承認
参考テンプレートの選択とPhase構造の確認。
### コーディングPJでのAgent生成
> 💻 **コーディングPJでも特別フェーズは不要。テンプレートの違いだけ。**
>
> コーディング用テンプレート（[TPL_coding_agent](../templates/agents/TPL_coding_agent.md) / [TPL_review_agent](../templates/agents/TPL_review_agent.md)）が選択されると、生成されるAgentのFlow内にFunctional Design → Code Gen → Build & Testが組み込まれる。
>
> 各SubLayerは通常どおり4ステージを再帰展開し、**SubLayer内のInception = 機能設計、Construction = コード生成計画、Operation = 実装+テスト** となる。
**Adaptive Skip判定（テンプレート内で制御）:**
| **深度** | **判定条件** | **SubLayer内の再帰展開** |
| --- | --- | --- |
| **Simple** | 単純バグ修正・1ファイル変更 | Collection → Construction（直接Code Gen）→ Operation |
| **Standard** | 機能追加・中規模変更 | Collection → Inception（FD設計）→ Construction（Code Gen Plan）→ Operation（実行+テスト） |
| **Complex** | 新サービス・アーキテクチャ変更 | フル4ステージ（NFR + Infrastructure Design含む） |
ロール: [TPL_role_tech_lead](../templates/roles/TPL_role_tech_lead.md)（SubLayer分割・統括） / [TPL_role_developer](../templates/roles/TPL_role_developer.md)（実装）
### Phase 5: Agents生成
Agents/フォルダを作成し、各タスクのAgent定義ページを生成。
### Agent定義の標準構造
| **セクション** | **内容** | **役割** |
| --- | --- | --- |
| Goal | このAgentが達成すること | 成功基準の定義 |
| Input | 必要な入力データ・コンテキスト | 実行前提条件 |
| Output | 生成される成果物 | 完了判定基準 |
| Execution Flow | Phase構造（Autonomous + Mob Checkpoint） | 実行手順 |
| Guardrails | 各Phaseのガードレール条件 | 品質保証 |
| Agent Instructions | Stage 4実行時のAI指示（= CCでのシステムプロンプト） | 自動実行制御 |
> 🤖 **Agent定義 = 実行手順 + 制約 + ツール権限が1つにまとまったもの。**
>
> CCの`.claude/agents/*.md`では1ファイルにシステムプロンプトとして全部入る。
>
> NotionではAgent定義ページとしてGoal/Input/Output/Flow/Guardrails/AI実行指示を記載。
>
> 詳細: [AI-PLC README](../README.md)
### Phase 5.5: スコープ外タスク検出 + External Sync
> 📤 **スキル設計中に「このPJではやらないが必要な作業」を発見したら、External Syncを促す。**
Agents生成中に以下のパターンを検出:
- スキルの前提条件として「別チームの作業完了」が必要 → **その作業を外部チケット化**
- スキルのOutputが別システムでの実装を要求 → **実装チケットを外部に委譲**
- スコープ外だが価値がある改善点を発見 → **Product Backlogに蓄積**
検出時のアクション:
1. [RUL_plc_system](../../../rules/ai-plc-system.md) §9のSelf-Describing Task構造でチケットを生成
2. 「スコープ外タスクを発見しました。外部DBに書き出しますか？」と確認
3. 承認後、sync_targetsに従ってpush
### Phase 6: Mob Checkpoint — 次ステージ提案
スキル生成完了を確認し、Stage 4: SKL_plc_04_operation への遷移を提案。
---
## 出力インターフェース
| **出力名** | **旧AIPO名** | **説明** | **生成条件** |
| --- | --- | --- | --- |
| Agents | Commands/ フォルダ | 実行可能なAgent定義群 | 常に |
---
## ガードレール・ゲート
| **ゲート名** | **タイミング** | **条件** | **旧CMD対応** |
| --- | --- | --- | --- |
| **Template Match Gate** | Phase 3 | テンプレート探索結果の人間確認 | Step 3: 生成計画提案 |
| **Skill Design Gate** | Phase 4 | 各スキルのPhase構造の承認 | Step 4: Human Approves |
| **Exit Gate** | Phase 6 | commandフィールドを持つ全タスクにスキル定義が生成されていること | Step 5: 生成完了 |
---
## 旧CMD対応表
| **SKL_plc_03_construction** | **CMD_aipo_03_discover** | **変更内容** |
| --- | --- | --- |
| Phase 1: Backlog読み込み | Step 1: tasks.yaml読み込み | Task Registry→Backlog。語彙変更 |
| Phase 2: Template探索 | Step 2: テンプレート・既存コマンド探索 | Progressive Context Loading 3段階を明文化 |
| Phase 3: スキル生成計画提案 | Step 3: コマンド生成計画の提案 | Skill Library→Skills。語彙変更 |
| Phase 4: Mob Checkpoint | Step 4: Human Approves | HITL→Mob。チーム検証を標準オプション化 |
| Phase 5: Skills生成 | Step 5: コマンド生成 | Commands/→Skills/。HITL統合型構造を維持 |
| Phase 6: Mob Checkpoint | Step 6: Next Step | 語彙変更 + SKL名での案内 |
---
## → 次ステージ接続
Agents を **Stage 4: SKL_plc_04_operation** に渡す
---
## 💬 使用例
### 例1: 基本実行
> 💡 SKL_plc_03_construction を実行してください
>
> Layer: \[対象LayerのURL\]
### 例2: テンプレート指定で追加
> 💡 SKL_plc_03_construction を実行してください
>
> Layer: \[対象LayerのURL\]
>
> T1.1もスキル化してください（テンプレート: command_templates/汎用/簡易タスク）
---
## ⚙️ AIへの実行指示
> 🤖 **重要: 事前参照**
>
> 実行前に必ず以下を参照：
> - [RUL_plc_system](../../../rules/ai-plc-system.md)（ルートシステムルール）
> - [RUL_plc_adaptive](../../../rules/ai-plc-adaptive.md)（Adaptive Workflow判定）
> ---
> **AIへの指示（このスキルが@メンションされたとき）**
> ### Phase 1: Backlog読み込み
> 1. 対象LayerのBacklog（旧tasks.yaml）を読み込む
> 2. 各タスクのcommandフィールドとcommand_template_refを確認
> ### Phase 2: Template探索（Progressive Context Loading）
> 1. Level 1: `.notion/Templates/`配下のAgent生成テンプレートを探索
> 2. Level 2: 既存Agents/配下の過去Agent定義を探索
> 3. Level 3: ドメイン知識テンプレート（AIPMコマンド群等）を探索
> ### Phase 3: スキル生成計画提案
> 1. 各タスクに最適な参考テンプレートを特定
> 2. Phase構造（Autonomous + Mob Checkpoint）を設計
> 3. ユーザーに提案
> ### Phase 4: Mob Checkpoint
> 1. 参考テンプレートとPhase構造を確認してもらう
> 2. 調整があれば反映
> ### Phase 5: Agents生成
> 1. Agents/フォルダを作成（存在しない場合）
> 2. 各タスクのAgent定義ページをMob Checkpoint統合型で生成
> 3. 各ページにGoal/Input/Output/Flow/Guardrails/Agent Instructionsを記載
> ### Phase 6: Mob Checkpoint
> 1. 生成完了を通知
> 2. Stage 4: SKL_plc_04_operation への遷移を案内
> ---
> **🚨 重要ルール**
> - **commandフィールドがないタスクはスキップ**
> - **テンプレートがあれば必ずコピーして使用**
> - **各スキルページは実行可能な詳細度で作成**
> - **HITL統合型（Autonomous + Mob Checkpoint交互）** を標準構造とする
> ---
> **📝 出力フォーマット規約（必ず遵守）**
> **Phase遷移通知（セクション8）:** 各Phase完了時に📍簡易通知を必ず出力すること。Autonomous Phaseでも「✅ Phase X 完了 → Phase X+1 に進みます」を表示し、ユーザーが途中で割り込めるタイミングを作る。
> [RUL_plc_session](../../../rules/ai-plc-session.md) セクション7-9に従い、**Phase 4 / Phase 6 の Mob Checkpoint** 出力には必ず以下を含める：
> - **Phase 4（設計承認）:** 📍現在位置 + スキル設計テーブル + 🙋承認待ちコールアウト
> - **Phase 6（完了）:** 📍現在位置 + 完了サマリテーブル + 📊進捗ダッシュボード + 🔜**Next Action Protocol**（[RUL_plc_session](../../../rules/ai-plc-session.md) 7.4: 選択肢テーブル + 推奨理由 + コピペ用プロンプト。Stage 3完了後テンプレートは7.4.4参照。即実行禁止）
> ---
> **⚠️ AI-PLC 新命名規則（必ず遵守）**
> | 旧AIPO（❌使用禁止） | AI-PLC（✅正しい名称） |
| --- | --- |
| layer.yaml | **intent.yaml** |
| tasks.yaml | **backlog.yaml** |
| Commands/ | **Agents/** |
| 「aipo管理」 | **「AI-PLC管理」** |
> 生成するAgent定義ページのフォルダ名は `Agents/` とすること（Commands/でもSkills/でもない）
---
## 参照元
- [T002_コマンド体系再定義書](https://www.notion.so/6c404df8242549df8199dadb2a187660) — Stage 3定義（本ページのベース）
- [T003_コア原理再定義書](https://www.notion.so/e81ef93779fd4a5c85d83a93791e3dd5) — Self-Describing Executable Task原理
- [T007_新コマンド体系アーキテクチャ設計書](https://www.notion.so/d39600b2da7142679bc22451089aeeae) — テンプレート構造
- [CMD_aipo_03_discover](https://www.notion.so/4dce59e7880b4e40956510012702d18e) — 旧版コマンド（対応元）
---
**作成日:** 2026-04-07
**ステータス:** Active
**バージョン:** 1.0