@mmerterden/multi-agent-pipeline 12.6.0 → 12.7.0

package/pipeline/multi-agent-refs/component-generation.md

@@ -0,0 +1,121 @@
+# Component Generation Guide (generic)
+
+> Lifted out of `core/multi-agent/SKILL.md`, where it was loaded on every
+> run of every mode. It applies only to a task that generates a UI
+> component from a design, so it now loads when that path is taken.
+> Component dispatch itself is in `component-dispatch.md`.
+
+When the task involves creating a SwiftUI component (any project, not just figma), follow this architecture:
+
+### Component Architecture: Configuration / View / Modifiers
+
+Every component produces up to 5 files:
+
+| File | When | Content |
+|------|------|---------|
+| `{Name}Configuration.swift` | Complex (>3 props) | Pure value type, all declarative properties |
+| `{Name}View.swift` | Always | SwiftUI view, renders Configuration |
+| `{Name}+Modifiers.swift` | Complex | Fluent modifier API chain |
+| `{Name}Preview.swift` | Always | All meaningful variant previews |
+| `{Name}Tests.swift` | Always | ViewInspector + Unit tests |
+
+### Configuration Purity Rule
+
+Configuration structs hold ONLY declarative, value-type properties:
+
+```swift
+// ✅ CORRECT  -  pure value type
+struct ButtonConfiguration {
+    var title: String = ""
+    var style: ButtonStyle = .primary
+    var isEnabled: Bool = true
+    var icon: Image? = nil
+}
+
+// ❌ WRONG  -  these do NOT belong in Configuration
+// Closures → View property
+// @Binding → View property
+// @State → View property
+// AnyView / @ViewBuilder → View generic parameter
+```
+
+### View Implementation
+
+```swift
+struct ButtonView: View {
+    let configuration: ButtonConfiguration
+    private var action: (() -> Void)?  // closure lives in View, not Config
+
+    var body: some View {
+        Button(action: { action?() }) {
+            HStack(spacing: .Spacing.spacing8) {
+                if let icon = configuration.icon { icon }
+                Text(configuration.title)
+                    .typographyStyle(.body1)
+            }
+        }
+        .disabled(!configuration.isEnabled)
+    }
+}
+```
+
+### Modifier Pattern
+
+```swift
+extension ButtonView {
+    func title(_ value: String) -> ButtonView {
+        var config = configuration
+        config.title = value
+        return ButtonView(configuration: config)
+    }
+    func style(_ value: ButtonStyle) -> ButtonView {
+        var config = configuration
+        config.style = value
+        return ButtonView(configuration: config)
+    }
+    func onTap(_ action: @escaping () -> Void) -> ButtonView {
+        var view = self
+        view.action = action
+        return view
+    }
+}
+```
+
+### Simple vs Complex Decision
+
+| Criteria | Simple | Complex |
+|----------|--------|---------|
+| Properties | ≤3 | >3 |
+| Configuration file | No  -  props in View directly | Yes  -  separate struct |
+| +Modifiers file | No | Yes |
+| View file | All-in-one | Renders Configuration |
+
+### 3-Layer Test Strategy
+
+| Layer | Tool | What It Validates |
+|-------|------|-------------------|
+| Structural | ViewInspector | Hierarchy, subview existence, applied modifiers |
+| Visual | Snapshot Tests | Pixel-correct render: light/dark, RTL/LTR |
+| Behavioral | Unit Tests | State changes, closures, configuration mutations |
+
+### Component Checklist (Before Commit)
+
+1. No magic numbers  -  all values are design tokens or named constants
+2. Configuration purity  -  no side-effects or view logic in Config
+3. Modifier correctness  -  fluent API valid, paired modifiers live in the View
+4. Accessibility  -  accessibility label/trait on every interactive element
+5. Preview  -  all meaningful variants in the preview
+6. Test  -  structural + unit tests written
+7. Dark mode  -  renders correctly in both color schemes
+8. Dynamic Type  -  text scales at large sizes without breaking the layout
+
+### When a Figma URL Is Provided
+
+If the user provides a Figma URL:
+1. Fetch the design data with Figma MCP tools (get_design_context, get_screenshot)
+2. Map the design's colors, spacing, and typography onto the project's token system
+3. Apply the Configuration/View/Modifiers pattern above
+4. Use the screenshot as a reference, do not copy it  -  adapt to the project's existing components
+
+---
+

package/pipeline/multi-agent-refs/cross-cli-contract.md

@@ -50,7 +50,7 @@ Both skills are wired to 4 consumers: `/multi-agent:test "store-ready"` (primary
 
 ### 1.3 Figma-skill routing from multi-agent (superseded)
 
-Superseded by §1.1: Claude Code resolves component dispatch to the marketplace plugin (dual-name `create-component`/`create-ui-component`; full contract in `$HOME/.claude/multi-agent-refs/component-dispatch.md`); Copilot CLI uses its local `~/.copilot/skills/figma-*` copies. No shared filesystem-path routing table or figma-skill frontmatter/inventory parity remains under enforcement.
+Superseded by section 1.1: Claude Code resolves component dispatch to the marketplace plugin (dual-name `create-component`/`create-ui-component`; full contract in `$HOME/.claude/multi-agent-refs/component-dispatch.md`); Copilot CLI uses its local `~/.copilot/skills/figma-*` copies. No shared filesystem-path routing table or figma-skill frontmatter/inventory parity remains under enforcement.
 
 ---
 

package/pipeline/multi-agent-refs/features/model-fallback.md

@@ -9,7 +9,7 @@ without ever editing persona files at runtime.
 
 > **Fable 5 available again (2026-07).** `claude-fable-5` is the top tier once
 > more. Architect (`ios/android/backend-architect`), Reviewer-1 (`code-reviewer`),
-> and triage personas declare `preferredModel: fable` — the deepest-reasoning
+> and triage personas declare `preferredModel: fable` - the deepest-reasoning
 > roles. **If Fable 5 is unavailable, the first fallback is opus (`claude-opus-4-8`).**
 > Security and other `preferredModel: opus` personas keep opus as their top tier.
 > The `premiumTierUntil` date gate stays in the contract as a generic mechanism
@@ -98,6 +98,6 @@ per-phase `model` field already carries the override).
 - No edits to `pipeline/agents/*.md` at runtime; frontmatter is install-time
   configuration only.
 - Copilot CLI reviewer set is out of scope: Copilot CLI pins its own three
-  reviewer models (GPT-5.4 + Opus + Sonnet — Fable 5 is not offered there) and
+  reviewer models (GPT-5.4 + Opus + Sonnet - Fable 5 is not offered there) and
   does not use this persona ladder. Only Claude Code dispatches Reviewer-1 on
   Fable.

package/pipeline/multi-agent-refs/phases/phase-4-review.md

@@ -1,6 +1,6 @@
 ### Phase 4: Review (deterministic gates + parallel + triage)
 
-> **TLDR**  -  Three-stage review. Stage 1: deterministic gates (build + lint + test + secret scan) that MUST pass. Stage 2: AI models in parallel  -  reviewer set is **CLI-aware**: Claude Code dispatches 2 reviewers (Fable + Sonnet); Copilot CLI dispatches 3 reviewers (GPT-5.4 + Opus + Sonnet — Fable 5 is not offered on Copilot CLI). Stage 3: Fable triage (Opus on Copilot CLI)  -  evaluates raw findings, filters false-positives/out-of-scope, keeps only actionable items. Only triage-accepted blocking items loop back to Phase 3.
+> **TLDR**  -  Three-stage review. Stage 1: deterministic gates (build + lint + test + secret scan) that MUST pass. Stage 2: AI models in parallel  -  reviewer set is **CLI-aware**: Claude Code dispatches 2 reviewers (Fable + Sonnet); Copilot CLI dispatches 3 reviewers (GPT-5.4 + Opus + Sonnet - Fable 5 is not offered on Copilot CLI). Stage 3: Fable triage (Opus on Copilot CLI)  -  evaluates raw findings, filters false-positives/out-of-scope, keeps only actionable items. Only triage-accepted blocking items loop back to Phase 3.
 
 <!-- progress-contract: applied -->
 Progress emission per `$HOME/.claude/multi-agent-refs/progress-contract.md`  -  lines for each gate, each reviewer dispatch + finish, triage start, triage verdict, fix dispatch.

package/pipeline/preferences-template.json

@@ -45,12 +45,7 @@
       "autoDiff": false,
       "manualNote": false
     },
-    "wikiScope": [
-      "main",
-      "ios",
-      "screenshots",
-      "index"
-    ],
+    "wikiScope": ["main", "ios", "screenshots", "index"],
     "autopilotReportTimeoutSeconds": 1800,
     "promptLanguage": "en",
     "outputLanguage": "en",
@@ -162,17 +157,16 @@
     }
   },
   "_derivedSkillSourcesTemplate": {
-    "_comment": "Optional. Populate global.derivedSkillSources[] to let /multi-agent:refactor check whether skills you derived from an upstream marketplace plugin have been updated. Kept in your LOCAL prefs only (never synced), so it may reference private sources. Copy an entry like the one below.",
+    "_comment": "Optional. Populate global.derivedSkillSources[] to let /multi-agent:refactor check whether skills you derived from an upstream marketplace plugin have been updated. Kept in your LOCAL prefs only (never synced), so it may reference private sources. Copy an entry like the one below. Set upstreamLocalClone when you have a working copy: the installed plugin cache is only as fresh as your last marketplace update, and a stale cache makes the drift check answer 'up to date' when it is four releases behind.",
     "_example": {
       "label": "Component toolkit skills",
       "localPath": "plugins/<my-plugin>/skills/workflow",
       "upstreamMarketplace": "<installed-marketplace-name>",
       "upstreamPlugin": "<upstream-plugin-name>",
-      "upstreamSkills": [
-        "<skill-a>",
-        "<skill-b>"
-      ],
+      "upstreamSkills": ["<skill-a>", "<skill-b>"],
       "derivedFromVersion": "0.0.0",
+      "upstreamVersionSource": "marketplace.json",
+      "upstreamLocalClone": "$HOME/<upstream-repo-working-copy>",
       "upstreamRepoUrl": "https://github.com/<org>/<repo>"
     }
   },

package/pipeline/schemas/agent-state.schema.json

@@ -97,8 +97,16 @@
             "type": "object",
             "required": ["tool", "phase"],
             "properties": {
-              "tool": { "type": "string", "description": "MCP tool name, e.g. mcp__claude_ai_Figma__get_design_context." },
-              "phase": { "type": "integer", "minimum": 0, "maximum": 7, "description": "Pipeline phase the call ran in. Only 0 (init) and 1 (analysis) are permitted." },
+              "tool": {
+                "type": "string",
+                "description": "MCP tool name, e.g. mcp__claude_ai_Figma__get_design_context."
+              },
+              "phase": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 7,
+                "description": "Pipeline phase the call ran in. Only 0 (init) and 1 (analysis) are permitted."
+              },
               "timestamp": { "type": "string", "description": "ISO-8601 time of the call." }
             }
           }
@@ -154,7 +162,10 @@
               "items": { "type": "object", "additionalProperties": true },
               "description": "{ id, kind, label, screen, driver, evidence } per state driver (launch-arg / scenario-case / code-scenario / fixture / deep-link)."
             },
-            "groups": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+            "groups": {
+              "type": "array",
+              "items": { "type": "object", "additionalProperties": true }
+            },
             "byKind": { "type": "object", "additionalProperties": true },
             "truncated": { "type": "boolean" }
           }
@@ -164,9 +175,15 @@
           "additionalProperties": true,
           "description": "Resolved run scope: the inventory targets this run must audit. The coverage gate applies to this set, not to the whole inventory  -  a scoped run is not penalised for out-of-scope targets.",
           "properties": {
-            "argument": { "type": ["string", "null"], "description": "Raw $ARGUMENTS as given (empty = whole module, '--resume' = remainder of the last run)." },
+            "argument": {
+              "type": ["string", "null"],
+              "description": "Raw $ARGUMENTS as given (empty = whole module, '--resume' = remainder of the last run)."
+            },
             "targetIds": { "type": "array", "items": { "type": "string" } },
-            "resumedFrom": { "type": ["string", "null"], "description": "Report dir of the run this scope resumes, when --resume was used." }
+            "resumedFrom": {
+              "type": ["string", "null"],
+              "description": "Report dir of the run this scope resumes, when --resume was used."
+            }
           }
         },
         "figmaUrl": { "type": ["string", "null"] },
@@ -208,7 +225,10 @@
             "unaccountedIds": { "type": "array", "items": { "type": "string" } }
           }
         },
-        "reportDir": { "type": ["string", "null"], "description": "Output dir under ~/DesignChecks." }
+        "reportDir": {
+          "type": ["string", "null"],
+          "description": "Output dir under ~/DesignChecks."
+        }
       }
     },
     "identity": {
@@ -218,7 +238,10 @@
       "properties": {
         "name": { "type": "string" },
         "email": { "type": "string", "format": "email" },
-        "username": { "type": "string", "description": "SCM username (GitHub/Bitbucket). Used to filter out PR author from reviewer list." }
+        "username": {
+          "type": "string",
+          "description": "SCM username (GitHub/Bitbucket). Used to filter out PR author from reviewer list."
+        }
       }
     },
     "phases": {
@@ -229,7 +252,10 @@
           "type": "object",
           "additionalProperties": false,
           "properties": {
-            "status": { "type": "string", "enum": ["pending", "in_progress", "done", "skipped", "failed"] },
+            "status": {
+              "type": "string",
+              "enum": ["pending", "in_progress", "done", "skipped", "failed"]
+            },
             "startedAt": { "type": "string", "format": "date-time" },
             "finishedAt": { "type": "string", "format": "date-time" },
             "model": { "type": "string" },
@@ -312,7 +338,11 @@
       "properties": {
         "number": { "type": "integer", "minimum": 1 },
         "url": { "type": "string", "format": "uri" },
-        "version": { "type": "integer", "minimum": 0, "description": "Bitbucket PR version  -  must increment by 1 per PUT." },
+        "version": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Bitbucket PR version  -  must increment by 1 per PUT."
+        },
         "draft": { "type": "boolean" },
         "reviewers": {
           "type": "array",

package/pipeline/schemas/analysis-output.schema.json

@@ -18,8 +18,14 @@
           "enum": ["ios", "android", "backend", "frontend", "mobile", "unknown"],
           "description": "Dominant stack inferred from project markers (.xcodeproj, build.gradle, package.json, etc.)."
         },
-        "language": { "type": "string", "description": "E.g. 'Swift 6', 'Kotlin 2.1', 'Python 3.13', 'TypeScript 5'." },
-        "framework": { "type": "string", "description": "E.g. 'SwiftUI', 'Jetpack Compose', 'FastAPI', 'Next.js 16'." }
+        "language": {
+          "type": "string",
+          "description": "E.g. 'Swift 6', 'Kotlin 2.1', 'Python 3.13', 'TypeScript 5'."
+        },
+        "framework": {
+          "type": "string",
+          "description": "E.g. 'SwiftUI', 'Jetpack Compose', 'FastAPI', 'Next.js 16'."
+        }
       }
     },
     "touchedAreas": {
@@ -30,8 +36,16 @@
         "additionalProperties": false,
         "required": ["path", "why"],
         "properties": {
-          "path": { "type": "string", "minLength": 1, "description": "File or directory relative to repo root." },
-          "why": { "type": "string", "minLength": 4, "description": "Why the task likely affects this area." }
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "description": "File or directory relative to repo root."
+          },
+          "why": {
+            "type": "string",
+            "minLength": 4,
+            "description": "Why the task likely affects this area."
+          }
         }
       },
       "description": "Files / modules the task is most likely to modify. Phase 2 uses this to scope tasks."

package/pipeline/schemas/analysis-spec.schema.json

@@ -128,8 +128,15 @@
               "url": { "type": "string", "format": "uri" },
               "fileKey": { "type": ["string", "null"] },
               "nodeId": { "type": ["string", "null"] },
-              "screenshotUrl": { "type": ["string", "null"], "description": "Local PNG path or signed render URL for this node." },
-              "tier": { "type": ["integer", "null"], "enum": [1, 2, 3, null], "description": "Figma access tier used to capture this record (mirrors state.figmaAccess.tier)." },
+              "screenshotUrl": {
+                "type": ["string", "null"],
+                "description": "Local PNG path or signed render URL for this node."
+              },
+              "tier": {
+                "type": ["integer", "null"],
+                "enum": [1, 2, 3, null],
+                "description": "Figma access tier used to capture this record (mirrors state.figmaAccess.tier)."
+              },
               "frames": {
                 "type": "array",
                 "items": {
@@ -202,14 +209,23 @@
                   "properties": {
                     "nodeId": { "type": "string" },
                     "name": { "type": ["string", "null"] },
-                    "designText": { "type": ["string", "null"], "description": "The visible-layer text at this node (often a placeholder)." },
-                    "raw": { "type": ["string", "null"], "description": "The raw annotation label/labelMarkdown before parsing." },
+                    "designText": {
+                      "type": ["string", "null"],
+                      "description": "The visible-layer text at this node (often a placeholder)."
+                    },
+                    "raw": {
+                      "type": ["string", "null"],
+                      "description": "The raw annotation label/labelMarkdown before parsing."
+                    },
                     "parsed": {
                       "type": "object",
                       "description": "Parsed copy keyed by language code (lowercased), e.g. { tr, en }.",
                       "additionalProperties": { "type": "string" }
                     },
-                    "mode": { "type": "string", "enum": ["prefixed", "two-line", "single", "empty"] }
+                    "mode": {
+                      "type": "string",
+                      "enum": ["prefixed", "two-line", "single", "empty"]
+                    }
                   }
                 }
               }
@@ -231,7 +247,10 @@
                   "additionalProperties": false,
                   "required": ["method", "path"],
                   "properties": {
-                    "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+                    "method": {
+                      "type": "string",
+                      "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]
+                    },
                     "path": { "type": "string" },
                     "summary": { "type": ["string", "null"] },
                     "auth": { "type": ["string", "null"] },
@@ -363,7 +382,10 @@
                 "enum": ["names", "schema", "console"],
                 "description": "Sub-type: names (comma list), schema (local JSON), console (reference-only URL)."
               },
-              "source": { "type": ["string", "null"], "description": "Original input string (path, URL, or comma list)." },
+              "source": {
+                "type": ["string", "null"],
+                "description": "Original input string (path, URL, or comma list)."
+              },
               "events": {
                 "type": "array",
                 "items": {
@@ -387,7 +409,10 @@
                     },
                     "platformsEmitting": {
                       "type": "array",
-                      "items": { "type": "string", "enum": ["ios", "android", "backend", "frontend"] }
+                      "items": {
+                        "type": "string",
+                        "enum": ["ios", "android", "backend", "frontend"]
+                      }
                     },
                     "citation": { "type": ["string", "null"] }
                   }
@@ -415,7 +440,10 @@
                       "name": { "type": "string" },
                       "file": { "type": "string" },
                       "line": { "type": ["integer", "null"] },
-                      "tag": { "type": "string", "enum": ["direct-match", "same-domain", "cross-cutting"] }
+                      "tag": {
+                        "type": "string",
+                        "enum": ["direct-match", "same-domain", "cross-cutting"]
+                      }
                     }
                   }
                 }
@@ -493,29 +521,89 @@
       "additionalProperties": false,
       "description": "v3 template - 23 main sections + 3 footer. Each section is either filled (object) or omitted (null). Omitted sections do not appear in the output document. Sections 1, 2, 4, 9, 13, 14, 20, 21 are never omitted (Locked 2).",
       "properties": {
-        "summary":              { "type": ["object", "null"], "description": "Section 1 - Geliştirme Özeti / Summary. Never null." },
-        "goalsAndNonGoals":     { "type": ["object", "null"], "description": "Section 2 - Hedefler ve Karşı Hedefler. Never null. Both columns mandatory (Locked 13)." },
-        "flowChart":            { "type": ["object", "null"], "description": "Section 3 - Akış Diyagramı. Mermaid blocks." },
-        "userStories":          { "type": ["object", "null"], "description": "Section 4 - Kullanıcı Hikayeleri. Gherkin format (Locked 12). Never null." },
-        "designReference":      { "type": ["object", "null"], "description": "Section 5 - Tasarım Referansı. All Figma variants drilled (Locked 18). Screenshots embedded (Locked 17)." },
-        "componentInventory":   { "type": ["object", "null"], "description": "Section 6 - Bileşen Envanteri." },
-        "designTokens":         { "type": ["object", "null"], "description": "Section 7 - Tasarım Token'ları." },
-        "assetInventory":       { "type": ["object", "null"], "description": "Section 8 - Asset Envanteri. SVG default for new assets (Locked 15)." },
-        "apiContracts":         { "type": ["object", "null"], "description": "Section 9 - API Kontratları. All response variants enumerated (Locked 17)." },
-        "localization":         { "type": ["object", "null"], "description": "Section 10 - Lokalizasyon. 8-locale full coverage for new keys (Locked 20)." },
-        "analytics":            { "type": ["object", "null"], "description": "Section 11 - Analytics." },
-        "deeplinkPush":         { "type": ["object", "null"], "description": "Section 12 - Deeplink ve Push Notification. Conditional." },
-        "architecturePlan":     { "type": ["object", "null"], "description": "Section 13 - Mimari Plan. Never null. Concept table filled by Pass B (Locked 22 + 24)." },
-        "filesToAdd":           { "type": ["object", "null"], "description": "Section 14 - Eklenecek Dosyalar. Never null. Every row carries Reuse / Add new / Modify tag (Locked 16)." },
-        "testPlan":             { "type": ["object", "null"], "description": "Section 15 - Test Planı." },
-        "accessibility":        { "type": ["object", "null"], "description": "Section 16 - Erişilebilirlik." },
-        "securityAndPrivacy":   { "type": ["object", "null"], "description": "Section 17 - Güvenlik ve Gizlilik." },
-        "rolloutPlan":          { "type": ["object", "null"], "description": "Section 18 - Yayılım Planı." },
-        "alternativesConsidered":{ "type": ["object", "null"], "description": "Section 19 - Değerlendirilen Alternatifler. ADR format." },
-        "risksAndOpenQuestions":{ "type": ["object", "null"], "description": "Section 20 - Riskler ve Açık Sorular. Never null. Auto-populated from conventionRisks + reuse competitors." },
-        "references":           { "type": ["object", "null"], "description": "Section 21 - Referanslar. Never null. User-supplied input table at the bottom (Locked 21)." },
-        "glossary":             { "type": ["object", "null"], "description": "Section 22 - Sözlük (footer). Optional in Lite mode." },
-        "changelog":            { "type": ["object", "null"], "description": "Section 23 - Değişiklik Geçmişi (footer)." }
+        "summary": {
+          "type": ["object", "null"],
+          "description": "Section 1 - Geliştirme Özeti / Summary. Never null."
+        },
+        "goalsAndNonGoals": {
+          "type": ["object", "null"],
+          "description": "Section 2 - Hedefler ve Karşı Hedefler. Never null. Both columns mandatory (Locked 13)."
+        },
+        "flowChart": {
+          "type": ["object", "null"],
+          "description": "Section 3 - Akış Diyagramı. Mermaid blocks."
+        },
+        "userStories": {
+          "type": ["object", "null"],
+          "description": "Section 4 - Kullanıcı Hikayeleri. Gherkin format (Locked 12). Never null."
+        },
+        "designReference": {
+          "type": ["object", "null"],
+          "description": "Section 5 - Tasarım Referansı. All Figma variants drilled (Locked 18). Screenshots embedded (Locked 17)."
+        },
+        "componentInventory": {
+          "type": ["object", "null"],
+          "description": "Section 6 - Bileşen Envanteri."
+        },
+        "designTokens": {
+          "type": ["object", "null"],
+          "description": "Section 7 - Tasarım Token'ları."
+        },
+        "assetInventory": {
+          "type": ["object", "null"],
+          "description": "Section 8 - Asset Envanteri. SVG default for new assets (Locked 15)."
+        },
+        "apiContracts": {
+          "type": ["object", "null"],
+          "description": "Section 9 - API Kontratları. All response variants enumerated (Locked 17)."
+        },
+        "localization": {
+          "type": ["object", "null"],
+          "description": "Section 10 - Lokalizasyon. 8-locale full coverage for new keys (Locked 20)."
+        },
+        "analytics": { "type": ["object", "null"], "description": "Section 11 - Analytics." },
+        "deeplinkPush": {
+          "type": ["object", "null"],
+          "description": "Section 12 - Deeplink ve Push Notification. Conditional."
+        },
+        "architecturePlan": {
+          "type": ["object", "null"],
+          "description": "Section 13 - Mimari Plan. Never null. Concept table filled by Pass B (Locked 22 + 24)."
+        },
+        "filesToAdd": {
+          "type": ["object", "null"],
+          "description": "Section 14 - Eklenecek Dosyalar. Never null. Every row carries Reuse / Add new / Modify tag (Locked 16)."
+        },
+        "testPlan": { "type": ["object", "null"], "description": "Section 15 - Test Planı." },
+        "accessibility": {
+          "type": ["object", "null"],
+          "description": "Section 16 - Erişilebilirlik."
+        },
+        "securityAndPrivacy": {
+          "type": ["object", "null"],
+          "description": "Section 17 - Güvenlik ve Gizlilik."
+        },
+        "rolloutPlan": { "type": ["object", "null"], "description": "Section 18 - Yayılım Planı." },
+        "alternativesConsidered": {
+          "type": ["object", "null"],
+          "description": "Section 19 - Değerlendirilen Alternatifler. ADR format."
+        },
+        "risksAndOpenQuestions": {
+          "type": ["object", "null"],
+          "description": "Section 20 - Riskler ve Açık Sorular. Never null. Auto-populated from conventionRisks + reuse competitors."
+        },
+        "references": {
+          "type": ["object", "null"],
+          "description": "Section 21 - Referanslar. Never null. User-supplied input table at the bottom (Locked 21)."
+        },
+        "glossary": {
+          "type": ["object", "null"],
+          "description": "Section 22 - Sözlük (footer). Optional in Lite mode."
+        },
+        "changelog": {
+          "type": ["object", "null"],
+          "description": "Section 23 - Değişiklik Geçmişi (footer)."
+        }
       },
       "required": [
         "summary",

package/pipeline/schemas/clarify-output.schema.json

@@ -49,9 +49,19 @@
               "additionalProperties": false,
               "required": ["label"],
               "properties": {
-                "label":       { "type": "string", "description": "The choice text (≤ 60 chars; longer wraps awkwardly in AskUserQuestion)." },
-                "recommended": { "type": "boolean", "default": false, "description": "True for the conventional default. At most one option per question carries this flag." },
-                "reason":      { "type": "string", "description": "One-line tradeoff hint  -  why this choice would or would not be the right pick." }
+                "label": {
+                  "type": "string",
+                  "description": "The choice text (≤ 60 chars; longer wraps awkwardly in AskUserQuestion)."
+                },
+                "recommended": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True for the conventional default. At most one option per question carries this flag."
+                },
+                "reason": {
+                  "type": "string",
+                  "description": "One-line tradeoff hint  -  why this choice would or would not be the right pick."
+                }
               }
             }
           },
@@ -67,8 +77,8 @@
       "description": "Filled in AFTER the orchestrator runs AskUserQuestion. Keys are question IDs (q1, q2, ...) and values are the selected label or free-text response. Empty during the agent's own emission.",
       "additionalProperties": { "type": "string" }
     },
-    "tokens_in":   { "type": "integer", "minimum": 0 },
-    "tokens_out":  { "type": "integer", "minimum": 0 },
+    "tokens_in": { "type": "integer", "minimum": 0 },
+    "tokens_out": { "type": "integer", "minimum": 0 },
     "duration_ms": { "type": "integer", "minimum": 0 }
   }
 }