現状の folio-architect SKILL (skills/folio-architect/SKILL.md) は §7.1 7-Phase PR Cycle の Phase E (Implementation) のみを実装した最小版 (caller marker set → 編集 → unset、 disable-model-invocation: true)。 完成形の 7-Phase (A Discovery 〜 G Summary) + §7.2 8 specialist agents は未実装。
§7.6 growth path は 1 skill (X3) → 2-3 skill (X4) → 8 agents 完成形 (X5+) と段階を規定する (試作駆動: 巨大計画を一括せず増分検証)。 X4-D はこの path に沿って folio-architect を完成形へ前進させる。 8 agents 一括 build は X5+ scope ゆえ不採用とし、 orchestration pattern (SKILL → specialist subagent) を 2-3 agent で早期 validate する。
user 承認 (AskUq): (1) agent 起点 = 2-3 review agent を X4 で実装 (skills-only 不採用、 §7.6 を amend)、 (2) specialist = ears + vocabulary + ssot (folio validate CLI が機械検査できない folio 固有 3 軸)。
Claude Code 公式 docs (plugins / sub-agents) で機構を確認: plugin agent は agents/<name>.md (plugin root)、 scoped name folio:<name>、 SKILL は Agent tool で subagent を並列 spawn 可。 ただし subagent は subagent を spawn できない (nesting 不可) ため、 specialist を spawn する orchestrator は main-session で動く SKILL でなければならない (folio-architect を SKILL のまま保つ根拠)。
folio-architect SKILL を 7-Phase orchestration (A〜G) に昇格し、 Phase F に review agent を 3 個 (spec-review-ears / spec-review-vocabulary / spec-review-ssot) 実装する。 以下は X5+ に据置: spec-explorer (Phase B)、 spec-architect (Phase D)、 spec-review-{structure,temporal,stakeholder} (Phase F 残 3 軸)。 Phase B/D は X4 では folio-architect が inline 実行する (agent spawn は X5+)。
agents/<name>.md (plugin root 直下、 .claude-plugin/ ではない)。 scoped name = folio:spec-review-ears 等。name / description (auto-delegation を抑制する具体記述) / model (folio.config.yaml の review_model = opus、 または inherit) / tools: Read, Grep, Glob (read-only、 review のみで Edit/Write を持たない)。 plugin agent は hooks/mcpServers/permissionMode 非対応。| Phase | X4-D での挙動 |
|---|---|
| A Discovery | todo list + folio.config.yaml load (folio-architect 直接) |
| B Exploration | inline (folio-architect が関連 spec/ADR を Grep/Read。 spec-explorer agent 化は X5+) |
| C Clarifying | MUST NOT SKIP。 AskUserQuestion で曖昧点を user に確認 |
| D Design | structural change 時のみ inline で設計 (spec-architect agent 化は X5+、 optional) |
| E Implementation | 既存最小 SKILL を内包: marker set (.folio/architect-active) → Edit → folio validate 機械検証 → marker unset (MUST、 エラー時も優先) |
| F Quality Review | MUST NOT SKIP。 3 review agent (ears/vocabulary/ssot) を 並列 spawn → findings を集約 → 高 severity を folio-architect が修正適用 (再 Phase E) |
| G Summary | delta marker (rules §5) check + 変更要約 (folio-architect 直接) |
各 review agent は変更された spec file 群を受け取り、 担当軸を review し、 構造化 findings (severity / location / 違反 rule / 修正提案) を返す。 read-only (自ら Edit せず、 folio-architect が Phase F 後に修正を適用)。 軸:
spec-review-ears: EARS 5-pattern 網羅 + REQ-ID uniqueness + traceability (rules §6)spec-review-vocabulary: P-5 canonical name 違反 + forbidden synonym detectionspec-review-ssot: P-7 content domain exclusivity + ADR / research 境界folio-self-spec §7.6 の growth path を 「1 skill (X3) → 7-Phase SKILL + 2-3 review agent (X4) → 8 agents 完成形 (X5+)」に amend する (従来「2-3 skill (X4)」を agent 込みに精緻化)。 §7.1 table は Phase B/D を「X4 inline、 agent 化 X5+」、 Phase F を「X4 = 3 agent (ears/vocab/ssot)、 残 3 軸 X5+」と現状局所化する (§7.2 完成形 8 agents は未来 anchor として保持)。
verification.html §3.6 に REQ-VER-016 を追加: (a) structural — 各 agent .md の frontmatter 妥当性 + scoped name folio:<name> resolvable + SKILL の agent 参照整合 (決定的、 sandbox 可)。 (b) e2e — /folio-architect を既知 violation (EARS 欠落 / forbidden synonym / domain 越境) を seed した spec に invoke → 3 review agent が該当 violation を flag することを観察 (REQ-VER-009 型 agent-driven runbook)。 LLM agent は非決定的ゆえ golden 比較でなく 「検出有無」 を一次 assertion とする。
実装物: folio-architect SKILL.md の 7-Phase 化 + agents/spec-review-{ears,vocabulary,ssot}.md 3 個 + folio-self-spec §7.6/§7.1 amend + verification.html REQ-VER-016 + e2e runbook (tests/e2e/) + structural 検証。 実装方式 (PARENT 一括 / SPAWN feature-dev) は本 ADR 承認後に決定。
folio validate (機械: link/jsonld/broken-reverse) を補完する LLM 3 軸 (EARS 網羅 / P-5 vocabulary / P-7 SSoT)。 mechanical check 不能な folio 固有品質を Phase F で enforce| 案 | 採用可否 |
|---|---|
| 7-Phase SKILL + 3 review agent (ears/vocab/ssot) (採用) | orchestration pattern を早期 validate + folio 固有の非機械的 3 軸を品質ゲート化 (AskUq) |
| skills-only (厳密 §7.6、 review inline、 agent は X5+ 全送り) | 不採用 — SKILL → subagent orchestration pattern が未検証のまま X5+ full build に突入し risk 大 (AskUq で agent 起点を選択) |
| full 8 agents 一括 (ADR-0027 で X5+ を前倒し) | 不採用 — 6 LLM review agent + explorer + architect の一括 build は over-build かつ未検証。 §7.6 試作駆動に反する |
| 1 統合 spec-reviewer (6 軸を 1 agent) | 不採用 — 並列 specialist の focus (1 軸 = fresh context) を失い、 context-window 圧迫。 完成形 §7.2 の 6 並列固定と乖離 |
| explorer + ears + structure | 不採用 — structure の cross-ref は folio validate link-integrity が既に cover。 ears/vocabulary/ssot が最も LLM-distinctive かつ folio core principle 直結 |
agents/spec-review-{ears,vocabulary,ssot}.md + folio-self-spec §7.6/§7.1 amend + verification.html REQ-VER-016 + e2e runbook + structural 検証。folio validate と Phase F の役割分担)。