03-construction · git:20260408.395291c · 2026-04-08 · sha256 5d71da8740c169fd
03-construction git:20260408.395291cC
Immutable. This exact content never changes and is served at /api/v1/blob/5d71da8740c169fd.
> 🏷️ **Project:** [Project Palma](N/A (Project Palma - Notion))
**Type:** command
**Context:** AI-PLC Stage 3 — Construction。Backlogの各タスクに対して実行可能なスキル定義(Harness)を生成するステージ。既存テンプレートからのProgressive Context Loadingとタスク固有コンテキストに基づく動的生成を組み合わせる。
> 🔗 **必須コンテキスト(このスキル実行時に自動読み込み)**
1. [AI-PLC system](.claude/skills/ai-plc/README.md) — AI-PLCシステム全体
1. [RUL_plc_system](.claude/rules/ai-plc-system.md) — ルートシステムルール
1. [RUL_plc_session](.claude/rules/ai-plc-session.md) — セッション管理ルール
1. [RUL_plc_adaptive](.claude/rules/ai-plc-adaptive.md) — Adaptive Workflow + Next Action判定
1. [Templates](.claude/skills/ai-plc/templates/) — Templatesフォルダ(Roles + Agent生成テンプレート)
---
## 概要
> ⚙️ **モダン名称:** Construction Stage
**パイプライン位置:** Stage 3 of 4
**Jeff Patton対応:** Discover(実行計画の立案・検証)
**対応する旧CMD:** [Untitled](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読み込み<br>commandフィールド確認"]
READ --> SEARCH["Phase 2: Template探索<br>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<br>設計承認"]
MOB -->|"Approved"| GEN["Phase 5: Agents生成<br>Agents/フォルダに配置"]
MOB -->|"Adjusted"| PLAN
GEN --> EXIT["Phase 6: Mob Checkpoint<br>次ステージ提案"]
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](https://www.notion.so/111d456b3e1f4947b7bc1fc10fa93fb5) / [TPL_review_agent](https://www.notion.so/fd0694537b78470f9b1cbee3ef25b4f9))が選択されると、生成される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](https://www.notion.so/45c015261a2245a38a95af0eb7d03858)(SubLayer分割・統括) / [TPL_role_developer](https://www.notion.so/1442506ed7364f26b8895e22184034e5)(実装)
### 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実行指示を記載。
詳細: [Agents](.claude/skills/ai-plc/README.md)
### Phase 5.5: スコープ外タスク検出 + External Sync
> 📤 **スキル設計中に「このPJではやらないが必要な作業」を発見したら、External Syncを促す。**
Skills生成中に以下のパターンを検出:
- スキルの前提条件として「別チームの作業完了」が必要 → **その作業を外部チケット化**
- スキルのOutputが別システムでの実装を要求 → **実装チケットを外部に委譲**
- スコープ外だが価値がある改善点を発見 → **Product Backlogに蓄積**
検出時のアクション:
1. [RUL_plc_system](.claude/rules/ai-plc-system.md) §9のSelf-Describing Task構造でチケットを生成
1. 「スコープ外タスクを発見しました。外部DBに書き出しますか?」と確認
1. 承認後、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](.claude/rules/ai-plc-system.md)(ルートシステムルール)
- [RUL_plc_adaptive](.claude/rules/ai-plc-adaptive.md)(Adaptive Workflow判定)
---
**AIへの指示(このスキルが@メンションされたとき)**
### Phase 1: Backlog読み込み
1. 対象LayerのBacklog(旧tasks.yaml)を読み込む
1. 各タスクのcommandフィールドとcommand_template_refを確認
### Phase 2: Template探索(Progressive Context Loading)
1. Level 1: `.notion/Templates/`配下のAgent生成テンプレートを探索
1. Level 2: 既存Agents/配下の過去Agent定義を探索
1. Level 3: ドメイン知識テンプレート(AIPMコマンド群等)を探索
### Phase 3: スキル生成計画提案
1. 各タスクに最適な参考テンプレートを特定
1. Phase構造(Autonomous + Mob Checkpoint)を設計
1. ユーザーに提案
### Phase 4: Mob Checkpoint
1. 参考テンプレートとPhase構造を確認してもらう
1. 調整があれば反映
### Phase 5: Agents生成
1. Agents/フォルダを作成(存在しない場合)
1. 各タスクのAgent定義ページをMob Checkpoint統合型で生成
1. 各ページにGoal/Input/Output/Flow/Guardrails/Agent Instructionsを記載
### Phase 6: Mob Checkpoint
1. 生成完了を通知
1. Stage 4: SKL_plc_04_operation への遷移を案内
---
**🚨 重要ルール**
- **commandフィールドがないタスクはスキップ**
- **テンプレートがあれば必ずコピーして使用**
- **各スキルページは実行可能な詳細度で作成**
- **HITL統合型(Autonomous + Mob Checkpoint交互)** を標準構造とする
---
**📝 出力フォーマット規約(必ず遵守)**
**Phase遷移通知(セクション8):** 各Phase完了時に📍簡易通知を必ず出力すること。Autonomous Phaseでも「✅ Phase X 完了 → Phase X+1 に進みます」を表示し、ユーザーが途中で割り込めるタイミングを作る。
[RUL_plc_session](.claude/rules/ai-plc-session.md) セクション7-9に従い、**Phase 4 / Phase 6 の Mob Checkpoint** 出力には必ず以下を含める:
- **Phase 4(設計承認):** 📍現在位置 + スキル設計テーブル + 🙋承認待ちコールアウト
- **Phase 6(完了):** 📍現在位置 + 完了サマリテーブル + 📊進捗ダッシュボード + 🔜**Next Action Protocol**([RUL_plc_session](.claude/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) — テンプレート構造
- [Untitled](https://www.notion.so/4dce59e7880b4e40956510012702d18e) — 旧版コマンド(対応元)
---
**作成日:** 2026-04-07
**ステータス:** Active
**バージョン:** 1.0