@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/pipeline/commands/multi-agent/refs/analysis-template.md

@@ -0,0 +1,1062 @@
+---
+description: "v3 canonical template for /multi-agent:analysis. 23 main sections + 3 footer sections. Platform-agnostic concept layer (Pass A) projected per-platform with repo-driven naming (Pass B). Includes Lite mode for small features."
+---
+
+# Analysis Template v3 - 23 Main Sections + 3 Footer
+
+`/multi-agent:analysis` renders every output against this template. Document language follows `prefs.global.outputLanguage` (`tr` or `en`). Tables use pipe-syntax markdown; the Confluence channel (`md2confluence-v3.py`) converts them to storage XML at emit time, embeds attachment images, and runs the humanizer punctuation gate before write.
+
+> **Heading style**: plain Arabic numeral numbering: `## 1. Geliştirme Özeti`, `## 2. Hedefler ve Karşı Hedefler`. No special section characters. The section sign codepoint (U+00A7) is banned by `feedback_no-section-sign`.
+
+> **Language**: This file is read as a system prompt. Prose stays English. Example tables and headings carry bilingual TR / EN scaffolds; the runtime renderer picks the right column per `outputLanguage`.
+
+> **Locked decisions that govern this template**: 1 (one feature per run), 2 (omission rule), 3 (citation discipline), 4 (forward-looking spec), 7 (humanizer punctuation policy), 8 (standards binding), 9 (per-platform output split), 11 (repo-evidence reuse-first), 12 (Gherkin), 13 (Goals + Non-Goals), 14 (SVG default), 15 (Files-to-Add tag), 16 (API response variants), 17 (screenshots embedded), 18 (all Figma variants), 19 (8-locale full coverage), 20 (References at bottom), 21 (platform-agnostic + Pass B), 22 (convention extraction), 23 (fallback risk), 24 (Pass B footnote mandatory), 28 (SwiftUI Preview block iOS), 29 (variant usage explicit), 30 (analysis self-contained pipeline-wide MCP forbidden outside analysis phase).
+
+## Mode selection - Full vs Lite
+
+The renderer picks Full or Lite mode automatically based on signals captured in Phase 1, or honours an explicit `--lite` flag from the user.
+
+| Mode | Sections | When |
+|---|---|---|
+| Full | 23 main + 3 footer | Default. Used when feature has multi-screen flow, external service contracts, or complex business rules. |
+| Lite | 7 main + 1 footer: 1, 2, 4, 9, 13, 14, 21, 23 | Used when (a) Confluence spec < 100 lines AND (b) Figma frames <= 1 AND (c) repo evidence direct-match >= 8. Manual override: user passes `--lite`. |
+
+Lite mode sections retain the same scaffold as Full mode; only the section set is reduced.
+
+## Section duplication mode per platform (A3 hybrid)
+
+Locked 9 - one file per selected platform under `analysis/<feature>-<platform>.md`. Sections fall into three duplication categories:
+
+| Category | Sections | Behaviour |
+|---|---|---|
+| Shared verbatim | 1, 2, 3, 4, 9, 21 | Identical content in every per-platform file. Pass A renders once, Pass B copies verbatim. |
+| Per-platform projection | 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 | Logical content shared; expressions (class names, paths, code snippets, test framework, identifier patterns) projected per platform from Phase 1c conventions. |
+| Footer | 22, 23 | Optional in Lite mode. In Full mode, identical across platforms. |
+
+Backend-only run drops Sections 5 (Design), 6 (Components), 7 (Tokens), 8 (Assets), 10 (Localization keys can omit if no server-rendered text), 11 (Analytics if no backend telemetry), 12 (Deeplink/Push if no outgoing contracts), 16 (Accessibility N/A), 17 (subset: server-side input validation only).
+
+## Front-matter header (per-platform file)
+
+Every per-platform file starts with this YAML block:
+
+```yaml
+---
+feature: <FeatureName>
+platform: ios | android | backend | frontend
+language: tr | en
+mode: full | lite
+generated: <ISO 8601 UTC timestamp>
+jira: <JIRA_KEY>-<id>
+branch: <branch-name>
+base_branch: <base-branch>
+siblings:
+  - analysis/<FeatureName>-<other-platform>.md
+standards:
+  - <absolute path or confluence:title or github-wiki:slug>
+evidence_digest: sha256:<digest>
+template_version: v3
+---
+```
+
+The dev pipeline (`/multi-agent:dev`) reads `platform` to verify file match, `evidence_digest` to detect stale specs, and `mode` to know which section set to expect.
+
+## Omission rules
+
+Locked 2 - no `TBD` / `Not applicable` placeholder. Sections with zero evidence are omitted entirely. Numbering remains sequential `1..N` over the rendered set; numbers re-flow when sections drop. The dispatch report logs the omission list.
+
+| Section | Omission condition |
+|---|---|
+| 3 Flow Chart | Single screen AND single service AND simple business rule (no state transitions) |
+| 5 Design Reference | No Figma URL AND no Code Connect mapping in any selected repo |
+| 6 Component Inventory | No Figma URL AND no UI primitive evidence in repo |
+| 7 Design Tokens | Sections 5 and 6 both omitted |
+| 8 Asset Inventory | No new visual asset planned AND no existing asset modified |
+| 10 Localization | No Figma text layer AND no localization key file in repo |
+| 11 Analytics | No Firebase input AND no analytics call site in repo |
+| 12 Deeplink/Push | No deeplink handler in repo AND no push payload binding AND spec silent |
+| 15 Test Plan | Backend-only run with no contract testing planned (rare) |
+| 16 Accessibility | Backend-only (no UI surface) |
+| 17 Security | No PII / auth / health data touched (rare, document explicit decision) |
+| 18 Rollout | Lite mode |
+| 19 Alternatives | Lite mode AND zero significant architectural decision points |
+| 22 Glossary | Lite mode |
+| 23 Changelog | Lite mode (optional even in Full for small revisions) |
+
+Sections 1, 2, 4, 9, 13, 14, 20, 21 are never omitted.
+
+## Pass B footnote format (Locked 24)
+
+Every Pass B-rendered cell carries a footnote pointing to its evidence source:
+
+```
+| Cell label | Cell value ^[<convention-key> <confidence>: <evidence-source>] |
+```
+
+Examples:
+
+```
+| State holder | `PassengerFlightViewModel` ^[C2 high: 8 örnek; en yakın StandaloneLoginViewModel.swift] |
+| Test naming | `@Test func fetch_validInput_returnsIdle()` ^[C4 medium: 4 mevcut örnek, çoğunluk Swift Testing] |
+| Identifier | `passengerFlight.continueButton` ^[C5 high: ui-testing-identifiers.json dot notation] |
+| State model | sealed enum `PassengerFlightUIState` ^[C3 fallback: conventions-defaults.md:C3-iOS, repo evidence none] |
+```
+
+Footnote-less cells fail the dispatch gate.
+
+---
+
+# Section scaffolds
+
+## 1. Geliştirme Özeti / Summary
+
+Never omitted. 2-3 paragraphs. Reader-friendly explanation of what the feature does and why it exists.
+
+```markdown
+## 1. Geliştirme Özeti   <!-- TR -->
+## 1. Summary            <!-- EN -->
+
+<one-sentence definition citing the primary spec source>
+
+<paragraph: what the user gains from the feature>
+
+<paragraph: which platforms and which app versions ship this>
+```
+
+Citation: feature definition cites the primary Confluence spec page (`[Confluence:<pageId>:<heading>]`).
+
+## 2. Hedefler ve Karşı Hedefler / Goals and Non-Goals
+
+Never omitted. Locked 13 - both columns mandatory. A row in only one column is not accepted.
+
+```markdown
+## 2. Hedefler ve Karşı Hedefler   <!-- TR -->
+## 2. Goals and Non-Goals          <!-- EN -->
+
+| Hedef / Goal | Karşı Hedef / Non-Goal |
+|---|---|
+| <goal 1 citing source> | <non-goal 1 citing source> |
+| <goal 2> | <non-goal 2> |
+```
+
+Each non-goal must say what it does NOT cover, not a vague "out of scope".
+
+## 3. Akış Diyagramı / Flow Chart
+
+Mermaid diagram(s). At least one is mandatory unless omission conditions hold (single screen + single service + simple rule).
+
+```markdown
+## 3. Akış Diyagramı   <!-- TR -->
+## 3. Flow Chart       <!-- EN -->
+
+### 3.1 Navigasyon Akışı / Navigation Flow
+
+\`\`\`mermaid
+flowchart TD
+    A[Entry] --> B{Validation}
+    B -->|valid| C[POST endpoint]
+    B -->|invalid| A
+    C --> D{Server response}
+    D -->|case A| E[Next screen]
+    D -->|case B| F[Modal]
+\`\`\`
+
+### 3.2 Servis Sırası / Sequence Diagram
+
+\`\`\`mermaid
+sequenceDiagram
+    actor U as User
+    participant A as App
+    participant B as BFF
+    participant S as Service
+
+    U->>A: action
+    A->>B: request
+    B->>S: downstream
+    S-->>B: response
+    B-->>A: aggregated
+    A->>U: rendered
+\`\`\`
+
+### 3.3 Durum Makinesi / State Machine (optional)
+
+\`\`\`mermaid
+stateDiagram-v2
+    [*] --> Loading
+    Loading --> Idle: success
+    Loading --> Error: failure
+    Idle --> Submitting: action
+    Submitting --> [*]: success
+    Submitting --> Error: validation
+    Error --> Idle: retry
+\`\`\`
+```
+
+Confluence dispatch wraps each mermaid block in `<ac:structured-macro ac:name="mermaid">`. If the macro is unavailable, `md2confluence-v3.py --mermaid-fallback` converts to a numbered list. The dispatch report carries `mermaid_macro_fallback_used: true/false`.
+
+## 4. Kullanıcı Hikayeleri / User Stories
+
+Never omitted. Locked 12 - Gherkin format mandatory. **Source-story completeness gate**: Gherkin scenarios cover the key happy/error/edge paths, but a `### 4.0 Kaynak Hikaye Izlenebilirligi / Source Story Traceability` table MUST list EVERY source-spec user-story ID (US-1..US-N) verbatim, each mapped to where it is covered (a Gherkin scenario or another section). Condensing into a few Gherkin scenarios is allowed ONLY if this table preserves the full source ID set; no source user story may be silently dropped. A missing source ID is a blocker and emits a Section 20 Risk row.
+
+```markdown
+## 4. Kullanıcı Hikayeleri   <!-- TR -->
+## 4. User Stories           <!-- EN -->
+
+### 4.1 Mutlu yol / Happy path
+
+\`\`\`gherkin
+Given <precondition>
+And <additional context>
+When <action>
+Then <expected outcome>
+And <secondary outcome>
+\`\`\`
+
+### 4.2 <Hata adı> / <Error name>
+
+\`\`\`gherkin
+Given <precondition>
+But <conflicting state>
+When <action>
+Then <prevention code shown, e.g. PP-211>
+And <user guidance>
+\`\`\`
+
+### 4.3 <Edge case>
+
+\`\`\`gherkin
+Given <precondition>
+When <action>
+Then <expected outcome>
+\`\`\`
+```
+
+Each scenario cites the matching prevention code (Section 9) when applicable. Plain-prose user stories without Given/When/Then are rejected by the renderer.
+
+## 5. Tasarım Referansı / Design Reference
+
+Per-platform projection. Omitted if no Figma URL AND no Code Connect mapping. Locked 17 + 18.
+
+```markdown
+## 5. Tasarım Referansı   <!-- TR -->
+## 5. Design Reference    <!-- EN -->
+
+### 5.1 Frame galerisi / Frame gallery
+
+Drill into every Figma variant (Locked 18). When a section URL is given, list all of its child frames.
+
+| Frame ID | Varyant / Variant | Boyut / Dimensions | Görüntü / Screenshot | Ayırt edici / Distinctive | Code Connect |
+|---|---|---|---|---|---|
+| <nodeId 1> | <name> (canonical) | <w>x<h> | ![](frame-<prefix>-<id>.png) | <list> | <component name> ^[Figma <nodeId>] |
+| <nodeId 2> | <name> | <w>x<h> | ![](...) | <list> | <component name> |
+| <nodeId 3> | Error state | <w>x<h> | ![](...) | <list> | <component name> |
+
+The `Code Connect` column is filled from `evidence.codeConnect[]` (Phase 1b.1): the component bound to that frame's `nodeId` (matched by `fileKey` + `nodeId`), or blank when the frame has no existing binding.
+
+### 5.2 Padding ve hizalama / Padding and alignment
+
+Token references for each variant (no raw numbers).
+
+| Varyant | Outer padding | Card gap | Section top | CTA stack |
+|---|---|---|---|---|
+| Canonical | Spacing.spacing16 | Spacing.spacing12 | Spacing.spacing24 | Spacing.spacing16 / 20 |
+| Error | same | same | Spacing.spacing48 | same |
+
+### 5.3 Tier durumu / Tier status
+
+Tier in use: <1 (MCP) | 2 (REST) | 3 (user screenshot)>
+Screenshots attached: <count>
+Auth retries used: <count>
+```
+
+Frame gallery images are uploaded to Confluence as multipart attachments and referenced via `<ac:image><ri:attachment ri:filename="..." /></ac:image>` (Locked 17). Section URL drilling enumerates all child frames automatically via `mcp__claude_ai_Figma__get_metadata` or `figma-screenshot.sh --section`.
+
+## 6. Bileşen Envanteri / Component Inventory
+
+Per-platform projection.
+
+```markdown
+## 6. Bileşen Envanteri   <!-- TR -->
+## 6. Component Inventory <!-- EN -->
+
+| Bileşen / Component | Mevcut / Existing | Konum / Location | Kullanım / Usage | Notlar / Notes |
+|---|---|---|---|---|
+| <Name> | yes | <path> | <where used> | reuse ^[direct-match] |
+| <Name> | yes | <path> | <where used> | modify: <variant property to add> |
+| <Name> | no | new | <where used> | added to Section 14 ^[Figma <nodeId>] |
+```
+
+Locked 11 - existence is resolved against `evidence.codeConnect[]` (the Code Connect index from Phase 1b.1) first: a design `nodeId` (or its `fileKey`) that matches an index entry emits a `reuse` row (`Mevcut/Existing = yes`, pointing at the bound component + path), because figma-to-swiftui already built and bound it. A `nodeId` with no Code Connect match falls back to the Phase 1b `uiComponents` heuristic; only when neither finds a candidate does the row become a new component (`Existing = no`, added to Section 14).
+
+## 7. Tasarım Token'ları / Design Tokens
+
+Per-platform projection. No magic numbers, no raw hex, no raw `.font()`.
+
+```markdown
+## 7. Tasarım Token'ları   <!-- TR -->
+## 7. Design Tokens        <!-- EN -->
+
+### 7.1 Spacing
+
+| Token | Değer / Value | Kullanım / Usage |
+|---|---|---|
+| Spacing.spacing12 | 12 pt | <where> |
+| Spacing.spacing16 | 16 pt | <where> |
+
+### 7.2 Renkler / Colors
+
+| Token | Hex (reference) | Kullanım / Usage |
+|---|---|---|
+| Color.Primary.primary | #E31837 | <where> |
+| Color.Status.error | #D32F2F | <where> |
+
+### 7.3 Tipografi / Typography
+
+| Token | Kullanım / Usage |
+|---|---|
+| .h6 | <where> |
+| .body1 | <where> |
+```
+
+Per-platform projection translates token names: iOS uses `.Spacing.spacingN` enum; Android uses `MaterialTheme.spacing.medium` or design system equivalent; Frontend uses CSS variables `--spacing-md` or Tailwind classes; Backend section omitted.
+
+## 8. Asset Envanteri / Asset Inventory
+
+```markdown
+## 8. Asset Envanteri   <!-- TR -->
+## 8. Asset Inventory   <!-- EN -->
+
+| Asset adı / Name | Format | Mevcut / Existing | Kaynak / Source | Notlar / Notes |
+|---|---|---|---|---|
+| <name> | SVG | yes | xcassets | reuse |
+| <name> | SVG | no | Figma frame <nodeId> | new ^[Figma <nodeId>] |
+| <name> | Lottie | no | Figma + motion spec | new, istisna gerekçesi / exception rationale: <reason> |
+```
+
+Locked 14 - SVG default for new assets. Lottie or optimized PNG accepted with explicit rationale in the Notes column.
+
+## 9. API Kontratları / API Contracts
+
+Never omitted (if any service is consumed). Locked 16 - response variants exhaustive. **Service-completeness gate**: do NOT rely solely on the supplied Swagger/Confluence inputs - reconcile against the canonical Api Contract page(s) for this screen. Every endpoint listed on the screen's Api Contract page MUST appear in 9.1 (or be explicitly tagged out-of-scope with a reason). An uncovered contract endpoint is a blocker and emits a Section 20 Risk row.
+
+```markdown
+## 9. API Kontratları   <!-- TR -->
+## 9. API Contracts     <!-- EN -->
+
+**Swagger / OpenAPI**: <url-or-omit>
+**Confluence kontrat sayfası / Confluence contract page**: <url-or-omit>
+
+### 9.1 Endpoint
+
+\`\`\`
+POST /v1/<endpoint>
+Content-Type: application/json
+Authorization: Bearer <token>
+\`\`\`
+
+### 9.2 Request body
+
+\`\`\`json
+{
+  "field1": "value",
+  "field2": 0
+}
+\`\`\`
+
+| Alan / Field | Tip / Type | Zorunlu / Required | Validation |
+|---|---|---|---|
+| field1 | string | yes | <rule> |
+| field2 | integer | no | <rule> |
+
+### 9.3 Response varyantları / Response variants
+
+List every HTTP status code one by one.
+
+| HTTP | Senaryo / Scenario | Body | UI sonucu / UI outcome |
+|---|---|---|---|
+| 200 | success | <body> | <UI> |
+| 200 | redirect type A | <body> | <UI> |
+| 400 | invalid input | `{"code":"FP-011"}` | <UI> |
+| 422 | business rule violated | `{"code":"FP-031"}` | <UI> |
+| 500 | server error | `{"code":"GEN-500"}` | <UI> |
+
+### 9.4 Prevention catalog (when applicable)
+
+| Kod / Code | Anlam / Meaning | UI konumu / UI location |
+|---|---|---|
+| FP-011 | Invalid format | <screen> |
+| PP-211 | Empty result set | <screen> |
+```
+
+## 10. Lokalizasyon Anahtarları / Localization Keys
+
+Per-platform projection. Locked 19 - 8-locale full coverage mandatory for new keys.
+
+```markdown
+## 10. Lokalizasyon Anahtarları   <!-- TR -->
+## 10. Localization Keys          <!-- EN -->
+
+Desteklenen diller: TR, EN, AR, DE, ES, FR, RU, ZH
+
+| Key | TR | EN | AR | DE | ES | FR | RU | ZH | Source | Status |
+|---|---|---|---|---|---|---|---|---|---|---|
+| <key 1> | <tr> | <en> | <ar> | <de> | <es> | <fr> | <ru> | <zh> | Figma <nodeId> | new |
+| <key 2> | <tr> | <en> | <ar> | <de> | <es> | <fr> | <ru> | <zh> | repo:Localizable.xcstrings | reuse |
+| <key 3> | <tr> | <en> | [bekleniyor: çeviri ekibi] | [bekleniyor: çeviri ekibi] | ... | ... | ... | ... | Figma | partial |
+```
+
+Status values:
+
+| Status | Meaning |
+|---|---|
+| reuse | Existing namespace, no new translation needed |
+| new | New key, all 8 locales must be filled |
+| partial | TR + EN filled, remaining 6 locales pending translation team. Dispatch report flags `i18n_pending: <count>` as blocker. |
+
+Per-platform projection:
+
+| Platform | File format | Key convention | Example |
+|---|---|---|---|
+| iOS | `Localizable.xcstrings` | hierarchical dot PascalCase | `Feature.Element` ^[C6 high] |
+| Android | `strings.xml` | flat snake_case | `feature_element` ^[C6 high] |
+| Backend | error code table | per server convention | uppercase enum |
+| Frontend | `i18n/*.json` | hierarchical dot camelCase | `feature.element` ^[C6 high] |
+
+## 11. Analytics
+
+```markdown
+## 11. Analytics
+
+| Event | Parametreler / Params | Tetiklenme / Trigger | Source | Status |
+|---|---|---|---|---|
+| <event_name> | <param1, param2> | <when> | <Firebase schema / repo / Confluence> | new |
+| <event_name> | <params> | <when> | <source> | reuse |
+
+PII redaction: <list of fields hashed before telemetry>
+```
+
+Locked 11 - direct-match events emit reuse rows. Locked 17 - PII fields (PNR, surname, ffp number) hashed before emit.
+
+## 12. Deeplink ve Push Notification / Deeplink and Push
+
+Conditional. Included when: repo grep hits deeplink/push handler, OR Confluence spec mentions deeplink/push routing, OR feature has push payload binding.
+
+```markdown
+## 12. Deeplink ve Push Notification   <!-- TR -->
+## 12. Deeplink and Push Notification  <!-- EN -->
+
+### 12.1 Deeplink tablosu / Deeplink table
+
+| URL Pattern | Parametreler / Params | Hedef route / Target route | Handler | autoSubmit |
+|---|---|---|---|---|
+| `<scheme>://<feature>?<params>` | <params> | <screen> | <handler:line> | yes/no |
+| `https://<domain>/<feature>?<params>` | <params> | <screen> | <handler:line> | yes/no |
+
+### 12.2 Push payload
+
+| Event | Payload | Hedef route / Target route | Handler | Foreground davranışı / Foreground behaviour |
+|---|---|---|---|---|
+| <event> | `{...}` | <screen> | <handler> | banner + tap or full screen |
+
+### 12.3 Universal Links / Associated domains
+
+apple-app-site-association: `<path>`
+Android intent-filter: `<host>` / `<scheme>`
+
+### 12.4 Routing sequence
+
+\`\`\`mermaid
+sequenceDiagram
+    participant N as Notification
+    participant AD as AppDelegate / FirebaseMessagingService
+    participant DR as DeeplinkRouter
+    participant C as Coordinator / Navigator
+    participant V as View
+
+    N->>AD: payload
+    AD->>DR: resolve
+    DR->>C: start(route, params)
+    C->>V: attach
+\`\`\`
+```
+
+## 13. Mimari Plan / Architecture Plan
+
+Never omitted. Per-platform projection from Phase 1c conventions.
+
+```markdown
+## 13. Mimari Plan        <!-- TR -->
+## 13. Architecture Plan  <!-- EN -->
+
+### 13.1 Kavram tablosu / Concept table
+
+Locked 21 - platform-agnostic concept layer rendered with repo conventions.
+
+| Kavram / Concept | Karşılığı / Realization | Confidence | Evidence |
+|---|---|---|---|
+| Module folder | <repo path> | high | C1 |
+| State holder | `<class name>` | high | C2 |
+| View / Screen | `<class name>` | high | C2 |
+| Navigator | `<class name>` | high | C2 |
+| Use case | `<class names>` | high | C2 |
+| Repository | `<class name>` | high | C2 |
+| DTO | `<class names>` | high | C2 |
+| UI state model | <sealed enum / data class / discriminated union> | high | C3 |
+| DI registration | <configurator / module / Depends / hook factory> | high | C7 |
+| Localization key | `<example>` | high | C6 |
+| Accessibility id | `<example>` | high | C5 |
+| Test method | `<example>` | high | C4 |
+
+### 13.2 State holder snippet
+
+\`\`\`<lang>
+<rendered class skeleton per Pass B>
+\`\`\`
+
+### 13.3 State model
+
+\`\`\`<lang>
+<rendered state type per Pass B>
+\`\`\`
+
+### 13.4 Validation kuralları / Validation rules
+
+| Kural / Rule | Konum / Location | Davranış / Behaviour |
+|---|---|---|
+| <rule> | <use case class> | <effect> |
+
+### 13.5 Navigator / Coordinator
+
+\`\`\`<lang>
+<rendered navigator interface per Pass B>
+\`\`\`
+
+### 13.6 DI registration
+
+\`\`\`<lang>
+<rendered DI register line per Pass B>
+\`\`\`
+
+### 13.6 SwiftUI Preview block (iOS projection, SwiftUI views only)
+
+Per Locked 29 - SwiftUI views ship with `#Preview` macro (Swift 5.9+) or `PreviewProvider` (legacy). UIKit view controllers are exempt from this section. Pass B detects the view kind via `import SwiftUI` + `: View` protocol conformance against `evidence.repoEvidence[<repo>].buckets.uiComponents`; if a feature has only UIKit `UIViewController` artefacts, this subsection is omitted with note `(N/A: UIKit-only feature)`.
+
+One preview entry per variant matters for Xcode Canvas and snapshot test alignment. Preview macro convention is read from `conventions[<repo>].previewMacro` (Phase 1c) - the renderer picks `#Preview` for Swift 5.9+ repos and `PreviewProvider` for legacy ones.
+
+| Varyant / Variant | Mode / Trait | Notes |
+|---|---|---|
+| Default (canonical) | LTR Light | basic happy path |
+| Default | LTR Dark | dark mode regression check |
+| Default | RTL Light | RTL layout regression |
+| Default | Dynamic Type accessibilityLarge | scaling regression |
+| Error state | LTR Light | empty state, prevention message |
+| Loading state | LTR Light | skeleton or spinner |
+| Edge case (e.g. long copy, single passenger) | LTR Light | optional, when distinct from canonical |
+
+Preview snippet (Pass B fills variant list per Phase 1c convention):
+
+\`\`\`swift
+#Preview("Default") {
+    PassengerFlightView(viewModel: .preview(.idle))
+}
+
+#Preview("Error - PP-211") {
+    PassengerFlightView(viewModel: .preview(.error(.PP_211)))
+}
+
+#Preview("Dark") {
+    PassengerFlightView(viewModel: .preview(.idle))
+        .preferredColorScheme(.dark)
+}
+
+#Preview("RTL") {
+    PassengerFlightView(viewModel: .preview(.idle))
+        .environment(\.layoutDirection, .rightToLeft)
+}
+\`\`\`
+
+Reuse rule (Locked 11 + 24): if `evidence.repoEvidence[<repo>].buckets.uiComponents` shows that the view already has a `#Preview` block, the table cell carries `Reuse existing block at <file:line>` instead of `Add new preview`. Conventions footnote example: `^[C8 high: 6 örnek, #Preview macro convention, en yakın StandaloneLoginView.swift:120]`.
+
+Snapshot test linkage: Section 15.2 Snapshot Tests must enumerate each preview variant listed here so Canvas previews and CI snapshots stay aligned. A preview without a matching snapshot row triggers a Section 20 Risk.
+
+### 13.7 Standards binding
+
+Decisions cite their binding source (Locked 8):
+
+| Decision | Source |
+|---|---|
+| <decision> | <standards file or wiki page> |
+```
+
+## 14. Eklenecek Dosyalar / Files to Add
+
+Never omitted. Locked 15 - every row carries Reuse / Add new / Modify tag.
+
+```markdown
+## 14. Eklenecek Dosyalar   <!-- TR -->
+## 14. Files to Add         <!-- EN -->
+
+| Dosya / File | Etiket / Tag | Notlar / Notes |
+|---|---|---|
+| <path> | Add new | <purpose> |
+| <path> | Reuse | <where it lives, why no change> ^[direct-match] |
+| <path> | Modify | <what changes> |
+```
+
+## 15. Test Planı / Test Plan
+
+Per-platform projection.
+
+```markdown
+## 15. Test Planı   <!-- TR -->
+## 15. Test Plan    <!-- EN -->
+
+### 15.1 Birim testleri / Unit tests
+
+| Test | Hedef / Target |
+|---|---|
+| <test name per C4 convention> | <what it verifies> |
+
+### 15.2 Görsel regresyon / Snapshot tests
+
+| Senaryo / Scenario | Mod / Mode |
+|---|---|
+| Canonical | LTR Light |
+| Canonical | LTR Dark |
+| Canonical | RTL Light |
+| Error state | LTR Light |
+| Empty state | LTR Light |
+
+Cihaz boyutları / Device sizes: <list>
+
+### 15.3 Sahte servisler / Mock services
+
+| Service | Mock class / file | Use case |
+|---|---|---|
+| <service> | <mock> | <UC> |
+
+### 15.4 Kabul senaryoları / Acceptance scenarios
+
+Gherkin scenarios from Section 4 mapped to UI test names.
+
+| Senaryo | UI test |
+|---|---|
+| 4.1 happy path | <XCUITest / Espresso / Playwright name> |
+
+### 15.5 Performans bütçesi / Performance budget
+
+| Metrik / Metric | Hedef / Target |
+|---|---|
+| Cold start to ready | <ms> |
+| Scroll FPS | 60 |
+| Memory peak | <MB> |
+```
+
+## 16. Erişilebilirlik / Accessibility
+
+Per-platform projection. WCAG 2.2 AA + Apple HIG + Material A11y.
+
+```markdown
+## 16. Erişilebilirlik   <!-- TR -->
+## 16. Accessibility     <!-- EN -->
+
+| Madde / Item | Durum / Status | Notlar / Notes |
+|---|---|---|
+| Unique identifier on every interactive element | required | <per C5 convention> |
+| Minimum tap target (iOS 44x44 pt / Android 48x48 dp / Web 44x44 px) | required | |
+| Screen reader label (accessibilityLabel / contentDescription / aria-label) | required | |
+| Hint text (accessibilityHint / stateDescription / aria-description) | optional | |
+| Dynamic Type / font scaling support | required | |
+| Contrast ratio >= 4.5:1 | required | |
+| State expressed beyond colour | required | |
+| Keyboard navigation (web only) | required | tabindex + focus order |
+| Voice Over / TalkBack reading order | required | |
+```
+
+## 17. Güvenlik ve Gizlilik / Security and Privacy
+
+Per-platform projection. Locked decisions: no PII in logs, HTTPS only, Keychain for secrets, hashing for telemetry, ATT before tracking, KVKK/GDPR compliance.
+
+```markdown
+## 17. Güvenlik ve Gizlilik   <!-- TR -->
+## 17. Security and Privacy   <!-- EN -->
+
+| Kural / Rule | Uygulama / Implementation |
+|---|---|
+| Secrets in secure storage (Keychain / KeyStore / encrypted env) | required |
+| Sensitive fields hashed before telemetry | required, SHA-256 |
+| HTTPS only, no ATS exception | required |
+| Certificate pinning (where applicable) | required |
+| ATT consent before tracking (iOS) | required if tracking enabled |
+| KVKK / GDPR data lifecycle disclosed | required |
+
+OWASP MASVS quick check:
+
+| MSTG | Status |
+|---|---|
+| AUTH-1 | <status> |
+| NETWORK-1 | <status> |
+| STORAGE-1 | <status> |
+```
+
+## 18. Yayılım Planı / Rollout Plan
+
+```markdown
+## 18. Yayılım Planı   <!-- TR -->
+## 18. Rollout Plan    <!-- EN -->
+
+| Aşama / Stage | Aksiyon / Action |
+|---|---|
+| Development | feature branch <name> |
+| Code review | <number of approvals, who> |
+| QA test | <devices and versions> |
+| Staged rollout | <internal -> beta -> production %> |
+| Rollback | <remote flag name> |
+```
+
+## 19. Değerlendirilen Alternatifler / Alternatives Considered
+
+ADR format.
+
+```markdown
+## 19. Değerlendirilen Alternatifler   <!-- TR -->
+## 19. Alternatives Considered         <!-- EN -->
+
+### Alternatif <n> / Alternative <n>
+
+| Seçenek / Option | Artı / Pro | Eksi / Con |
+|---|---|---|
+| <chosen> | <pro list> | <con list> |
+| <alternative> | <pro list> | <con list> |
+
+Karar / Decision: <chosen>. Gerekçe / Rationale: <reason>.
+```
+
+## 20. Riskler ve Açık Sorular / Risks and Open Questions
+
+Never omitted.
+
+```markdown
+## 20. Riskler ve Açık Sorular   <!-- TR -->
+## 20. Risks and Open Questions  <!-- EN -->
+
+| Risk / Soru / Risk / Question | Sahibi / Owner | Durum / Status |
+|---|---|---|
+| <risk or question> | <name or role> | Açık / Open |
+| <convention fallback applied> | Pass B (auto) | Açık / Open |
+| <existing X candidate found; reuse or document why a new one is needed> | <name> | Açık / Open |
+```
+
+Auto-populated rows (Locked 11, 23): repo-evidence direct-match candidates that conflict with planned new-write; convention fallbacks where Phase 1c confidence was none.
+
+## 21. Referanslar / References
+
+Never omitted. Locked 20 - at the bottom, not at the top.
+
+```markdown
+## 21. Referanslar   <!-- TR -->
+## 21. References    <!-- EN -->
+
+| Tür / Type | Kaynak / Source | URL or Path | Rol / Role | Notlar / Notes |
+|---|---|---|---|---|
+| Standards | <name> | <url or path> | binding | <version> |
+| Wiki | <name> | <url> | binding | <pattern referenced> |
+| Figma | <design name> | <url> | UI design | <n variants, all screenshots embedded> |
+| Confluence | <spec name> | <url> | feature spec | <v<n>> |
+| Confluence | <api contract> | <url> | API contract | <endpoint summary> |
+| Jira | <ticket id> | <url> | ticket | <description> |
+| Firebase | events | <console url> | reference only | auth-gated |
+| OpenAPI | generated | <repo path> | DTO source | <regen plugin name> |
+| Repo | <module> | <repo path> | existing implementation | <reuse summary> |
+```
+
+## 22. Sözlük / Glossary
+
+Footer. Optional in Lite mode. Alphabetical.
+
+```markdown
+## 22. Sözlük   <!-- TR -->
+## 22. Glossary <!-- EN -->
+
+| Kısaltma / Abbreviation | Açıklama / Description |
+|---|---|
+| APIS | Advance Passenger Information System |
+| ATS | App Transport Security |
+| BFF | Backend For Frontend |
+| CTA | Call To Action |
+| FFP | Frequent Flyer Programme |
+| KVKK | Kişisel Verilerin Korunması Kanunu |
+| PNR | Passenger Name Record |
+| WCAG | Web Content Accessibility Guidelines |
+```
+
+Only terms used in this document are listed. Generic IT terms (HTTP, JSON, REST) are excluded.
+
+## 23. Değişiklik Geçmişi / Changelog
+
+Footer.
+
+```markdown
+## 23. Değişiklik Geçmişi   <!-- TR -->
+## 23. Changelog            <!-- EN -->
+
+| Sürüm / Version | Tarih / Date | Yazar / Author | Değişiklik / Change |
+|---|---|---|---|
+| v1 | <date> | <author> | İlk taslak / Initial draft |
+| v2 | <date> | <author> | <change summary> |
+```
+
+---
+
+# Pass B render examples (per platform)
+
+The following examples show how Pass B fills the same Pass A concept layer (state holder + use case + view + state model) for each platform when repo conventions are extracted with `high` confidence.
+
+## iOS render example
+
+Conventions extracted: feature-first + clean arch, `<Feature>ViewModel`, sealed enum state, Swift Testing, dot-notation accessibility identifiers, hierarchical dot PascalCase localization, manual configurator DI.
+
+```swift
+@MainActor
+final class PassengerFlightViewModel: ObservableObject {
+    @Published private(set) var state: PassengerFlightUIState = .loading
+    private let fetchUseCase: FetchPassengerFlightUseCaseProtocol
+
+    init(fetchUseCase: FetchPassengerFlightUseCaseProtocol) {
+        self.fetchUseCase = fetchUseCase
+    }
+
+    func onAppear() async {
+        do {
+            let result = try await fetchUseCase.execute()
+            state = .idle(passengers: result.passengers, flights: result.flights)
+        } catch let error as PreventionError {
+            state = .error(error.code)
+        } catch {
+            state = .error(.generic)
+        }
+    }
+}
+
+enum PassengerFlightUIState {
+    case loading
+    case idle(passengers: [PassengerEntity], flights: [FlightEntity])
+    case error(PreventionCode)
+}
+```
+
+Folder: `Domains/Checkin/Sources/Checkin/Screens/PassengerAndFlightSelection/Presentation/ViewModel/`
+Test name: `@Test func fetch_validInput_returnsIdle()`
+Identifier: `passengerFlight.continueButton`
+Localization key: `PassengerFlight.ContinueButton`
+
+## Android render example
+
+Conventions extracted: feature module + clean arch, `<Feature>ViewModel`, sealed interface state, JUnit5 + Turbine, camelCase testTag, snake_case strings.xml, Hilt module DI.
+
+```kotlin
+@HiltViewModel
+class PassengerFlightViewModel @Inject constructor(
+    private val fetchUseCase: FetchPassengerFlightUseCase
+) : ViewModel() {
+    private val _state = MutableStateFlow<PassengerFlightUiState>(PassengerFlightUiState.Loading)
+    val state: StateFlow<PassengerFlightUiState> = _state.asStateFlow()
+
+    fun onAppear() {
+        viewModelScope.launch {
+            try {
+                val result = fetchUseCase.execute()
+                _state.value = PassengerFlightUiState.Idle(result.passengers, result.flights)
+            } catch (e: PreventionException) {
+                _state.value = PassengerFlightUiState.Error(e.code)
+            }
+        }
+    }
+}
+
+sealed interface PassengerFlightUiState {
+    data object Loading : PassengerFlightUiState
+    data class Idle(val passengers: List<Passenger>, val flights: List<Flight>) : PassengerFlightUiState
+    data class Error(val code: PreventionCode) : PassengerFlightUiState
+}
+```
+
+Folder: `feature/checkin/src/main/java/<package>/passengerflight/ui/`
+Test name: `fun fetch_validInput_returnsIdle()`
+testTag: `passengerFlightContinueButton`
+strings.xml: `passenger_flight_continue_button`
+
+## Backend render example
+
+Conventions extracted: layered Python FastAPI, router + service + repository, Pydantic DTO, pytest snake_case, FastAPI Depends.
+
+```python
+class PassengerFlightService:
+    def __init__(
+        self,
+        repository: PassengerFlightRepository,
+        validator: PassengerSelectionValidator,
+    ):
+        self.repository = repository
+        self.validator = validator
+
+    async def fetch(self, request: PassengerFlightIn) -> PassengerFlightOut:
+        passengers = await self.repository.search_passengers(request.pnr, request.surname)
+        flights = await self.repository.get_flight_details(request.pnr)
+        return PassengerFlightOut(passengers=passengers, flights=flights)
+
+
+@router.post("/start-checkin", response_model=PassengerFlightOut)
+async def start_checkin(
+    request: PassengerFlightIn,
+    service: PassengerFlightService = Depends(get_passenger_flight_service),
+) -> PassengerFlightOut:
+    return await service.fetch(request)
+```
+
+Folder: `app/api/checkin/`, `app/services/checkin/`, `app/schemas/checkin/`
+Test name: `def test_fetch_valid_input_returns_passenger_list():`
+OpenAPI operationId: `startCheckin`
+
+## Frontend render example
+
+Conventions extracted: Next.js App Router, feature folder, React Query hooks, Zustand stores, Vitest, kebab data-testid, hierarchical dot camelCase i18n.
+
+```tsx
+type PassengerFlightState =
+  | { kind: "loading" }
+  | { kind: "idle"; passengers: Passenger[]; flights: Flight[] }
+  | { kind: "error"; code: PreventionCode };
+
+export function usePassengerFlight(pnr: string, surname: string) {
+  return useQuery<PassengerFlightDto, PreventionError>({
+    queryKey: ["passenger-flight", pnr, surname],
+    queryFn: () => passengerFlightApi.fetch({ pnr, surname }),
+  });
+}
+
+export function PassengerFlightPage({ pnr, surname }: Props) {
+  const query = usePassengerFlight(pnr, surname);
+  if (query.isLoading) return <LoadingState />;
+  if (query.isError) return <ErrorState code={query.error.code} />;
+  return <PassengerFlightContent data={query.data} />;
+}
+```
+
+Folder: `src/features/checkin/passenger-flight/{components,hooks,api,types}/`
+Test name: `it('returns idle state for valid input', ...)`
+data-testid: `passenger-flight-continue-button`
+i18n key: `passengerFlight.continueButton`
+
+---
+
+# Output language matrix
+
+Canonical TR / EN pairs for headings and system strings. The dispatcher reads `outputLanguage` at render time.
+
+| TR | EN |
+|---|---|
+| Geliştirme Özeti | Summary |
+| Hedefler ve Karşı Hedefler | Goals and Non-Goals |
+| Hedef | Goal |
+| Karşı Hedef | Non-Goal |
+| Akış Diyagramı | Flow Chart |
+| Navigasyon Akışı | Navigation Flow |
+| Servis Sırası | Sequence Diagram |
+| Durum Makinesi | State Machine |
+| Kullanıcı Hikayeleri | User Stories |
+| Mutlu yol | Happy path |
+| Tasarım Referansı | Design Reference |
+| Frame galerisi | Frame gallery |
+| Varyant | Variant |
+| Boyut | Dimensions |
+| Görüntü | Screenshot |
+| Ayırt edici | Distinctive |
+| Padding ve hizalama | Padding and alignment |
+| Tier durumu | Tier status |
+| Bileşen Envanteri | Component Inventory |
+| Bileşen | Component |
+| Mevcut | Existing |
+| Konum | Location |
+| Kullanım | Usage |
+| Notlar | Notes |
+| Tasarım Token'ları | Design Tokens |
+| Renkler | Colors |
+| Tipografi | Typography |
+| Asset Envanteri | Asset Inventory |
+| Asset adı | Asset name |
+| Format | Format |
+| Kaynak | Source |
+| API Kontratları | API Contracts |
+| Alan | Field |
+| Tip | Type |
+| Zorunlu | Required |
+| Response varyantları | Response variants |
+| Senaryo | Scenario |
+| UI sonucu | UI outcome |
+| Kod | Code |
+| Anlam | Meaning |
+| UI konumu | UI location |
+| Lokalizasyon Anahtarları | Localization Keys |
+| Anahtar | Key |
+| Yeni | New |
+| Kısmi | Partial |
+| Tetiklenme | Trigger |
+| Parametreler | Params |
+| Deeplink ve Push Notification | Deeplink and Push Notification |
+| Deeplink tablosu | Deeplink table |
+| URL deseni | URL pattern |
+| Hedef route | Target route |
+| Foreground davranışı | Foreground behaviour |
+| Yönlendirme sırası | Routing sequence |
+| Mimari Plan | Architecture Plan |
+| Kavram tablosu | Concept table |
+| Karşılığı | Realization |
+| Validation kuralları | Validation rules |
+| Kural | Rule |
+| Davranış | Behaviour |
+| Standards binding | Standards binding |
+| Eklenecek Dosyalar | Files to Add |
+| Dosya | File |
+| Etiket | Tag |
+| Test Planı | Test Plan |
+| Birim testleri | Unit tests |
+| Hedef | Target |
+| Görsel regresyon | Snapshot tests |
+| Mod | Mode |
+| Sahte servisler | Mock services |
+| Kabul senaryoları | Acceptance scenarios |
+| Performans bütçesi | Performance budget |
+| Metrik | Metric |
+| Erişilebilirlik | Accessibility |
+| Madde | Item |
+| Durum | Status |
+| Güvenlik ve Gizlilik | Security and Privacy |
+| Uygulama | Implementation |
+| Yayılım Planı | Rollout Plan |
+| Aşama | Stage |
+| Aksiyon | Action |
+| Değerlendirilen Alternatifler | Alternatives Considered |
+| Seçenek | Option |
+| Artı | Pro |
+| Eksi | Con |
+| Karar | Decision |
+| Gerekçe | Rationale |
+| Riskler ve Açık Sorular | Risks and Open Questions |
+| Sahibi | Owner |
+| Açık | Open |
+| Referanslar | References |
+| Tür | Type |
+| Rol | Role |
+| Sözlük | Glossary |
+| Kısaltma | Abbreviation |
+| Açıklama | Description |
+| Değişiklik Geçmişi | Changelog |
+| Sürüm | Version |
+| Tarih | Date |
+| Yazar | Author |
+| Değişiklik | Change |
+| İlk taslak | Initial draft |
+| bekleniyor: çeviri ekibi | pending: translation team |
+| Pass B (auto) | Pass B (auto) |
+| convention fallback applied | convention fallback applied |
+| existing X candidate found | existing X candidate found |