ADR-0029 — X5-γ Phase F agent セット確定 (temporal build / structure cut / explorer・architect・stakeholder defer) + §7.2 完成形 anchor 改訂

Status: accepted · Date: 2026-05-26 · folio v0.5.0-draft · forward (X5-γ、 user 承認済 (AskUq 方向性 γ)、 実 amend は WS2)

§1. Context

ADR-0027 (X4-D)§7.2 完成形 8 specialist agents のうち 3 個 (spec-review-ears / spec-review-vocabulary / spec-review-ssot) を実装し、 残 5 個 (spec-explorer / spec-architect / spec-review-{structure,temporal,stakeholder}) を X5+ 据置、 §7.2 完成形 8 agents は「未来 anchor として保持」とした。

X5 方向性 AskUq で user は γ (選択的完成) を選択 (目標「長期的に安定する folio plugin」)。 γ は完成形を額面通り全 build せず、 価値が重複しない要素のみ実装する。 ここで残 5 agent には性質差がある: (a) spec-review-structurefolio validate の link-integrity (REQ-CI-010) + readme-index + naming で機械被覆と重複 (ADR-0027 §4 が既に自認)、 (b) spec-review-temporal は P-4 declarative の意味的判定で LLM-distinctive (ADR-0028 §2.3 が 011 を agent ceiling に委ねた対の軸)、 (c) spec-explorer / spec-architect は folio-architect が inline で機能中、 (d) spec-review-stakeholder (ISO 42010) は niche

本 ADR は ADR-0028 (gate enforcement の二層モデル) の companion として、 Phase F の agent セットを v1.0 向けに確定し、 ADR-0027 が保持した §7.2 完成形 anchor を γ 方針で剪定改訂する。

§2. Decision

§2.1 Phase F v1.0 agent セット = 4 review agent

Phase F (Quality Review) の review agent を 4 個に確定する: spec-review-ears / spec-review-vocabulary / spec-review-ssot (実装済) + spec-review-temporal (新規)。

§2.2 spec-review-temporal を build

P-4 declarative form + wave-specific narrative 検出 (§7.2 F軸4) を担う review agent を実装する。 ADR-0028 §2.3 で REQ-CI-011 (declarative-form) を hard gate 化せず agent ceiling に委ねたが、 その ceiling 実体が本 agent である。 contract は他 review agent と同型: agents/spec-review-temporal.md (plugin root)、 scoped name folio:spec-review-temporaltools: Read, Grep, Glob (read-only)、 model = review_model (opus) または inherit。

§2.3 spec-review-structure を CUT

§7.2 F軸2 (directory structure / file naming / cross-ref / heading hierarchy) は folio validate の link-integrity (REQ-CI-010 = cross-ref) + readme-index hook (cluster 掲載) + naming convention で機械的に被覆されるため、 専用 LLM review agent を実装しない (ADR-0027 §4 の「structure は validate が cover」自認を確定)。 deterministic floor が担い、 LLM ceiling を別立てしない。

§2.4 post-1.0 opt-in に defer

これらは削除でなく defer であり、 §7.2 に post-1.0 anchor として残す。

§2.5 §7.2 完成形 anchor 改訂 (実 amend は WS2)

folio-self-spec §7.2 を「8 agents 完成形 (未来 anchor 保持)」から 「v1.0 確定セット + post-1.0 deferred」へ改訂する: v1.0 = Phase F 4 review agent (ears/vocabulary/ssot/temporal) + structure は folio validate 被覆 + Phase B/D は folio-architect inline、 post-1.0 deferred = explorer / architect / stakeholder。 §7.1 の Phase F 「6 並列固定」 を 「4 並列 (v1.0)」 に、 §7.6 growth pathverification §4.2 完成形列 も整合させる。 ADR-0027 の「§7.2 不変・未来 anchor 保持」 guidance は本 ADR が refine する (supersede ではなく、 完成形定義を γ で確定)。

§2.6 verification

spec-review-temporal の structural 妥当性 (frontmatter + scoped name folio:<name> resolvable + SKILL の agent 参照整合) を tests/scenarios/agent-structure.yaml に追加し決定的に検証 (REQ-VER-016 (a))。 検出能力は REQ-VER-016 (b) の e2e detection (既知 P-4 violation を seed → flag 観察) で被覆。

§2.7 適用範囲 (WS2)

実装物: agents/spec-review-temporal.md 新規 + folio-architect SKILL Phase F の review agent を 3 → 4 + §7.2 / §7.1 / §7.6 + verification §4.2 amend (spec edit = caller marker 要) + agent-structure.yaml 拡張 + e2e detection。 実装方式 (PARENT / SPAWN) は本 ADR 承認後に決定

§3. Consequences

Positive

Negative

Neutral

§4. Alternatives Considered

採用可否
4 review agent (temporal 追加) + structure cut + 3 defer (採用)価値が重複しない軸のみ build。 二層モデル (ADR-0028) と整合し P-4 を ceiling 被覆 (AskUq γ)
§7.2 の 6 review + explorer + architect を全 build不採用 — structure は validate 重複、 stakeholder は niche、 explorer/architect は inline で足りる。 ADR-0027 §4 の over-build 判断と矛盾
3 agent 維持 (temporal も defer)不採用 — P-4 declarative は folio core principle。 ADR-0028 が 011 を hard gate 化しない以上、 temporal ceiling を欠くと P-4 の品質保証が空く
spec-review-structure を build不採用 — folio validate link-integrity + readme-index + naming と重複。 deterministic floor で足りる軸に LLM agent を重ねない
§7.2 を改訂せず deferred を未来 anchor のまま放置不採用 — 完成形 (8 agents) と実装 (4 agent) の乖離が永続化し、 spec が実態を語らない rot を招く。 v1.0 で完成形定義を確定すべき

§5. Trace