baldart 3.6.2

package/framework/.claude/skills/prd/assets/epic-template.yml

@@ -0,0 +1,190 @@
+# =============================================================================
+# {{FEAT-EPIC-ID}} — Epic: {{Feature Name}}
+# =============================================================================
+#
+# Template for PRD epic cards. Every PRD that produces backlog work creates
+# exactly 1 epic (this file) + N children (using card-template.yml).
+#
+# Filename: backlog/{{FEAT-XXXX-00}}-{{slug}}-epic.yml
+# (suffix `-epic` is mandatory; suffix `-00` is mandatory)
+#
+# The epic is a TRACKER, not implementation work:
+#   - NO files_likely_touched pointing to code (only docs allowed)
+#   - NO validation_commands, existing_patterns, anti_patterns
+#   - NO data_fields, firestore_indexes
+#   - NO test_plan with scenarios (test scenarios live on children)
+#   - data_sources: [] (always empty)
+#
+# What the epic OWNS:
+#   - AC-EPIC roll-up of PRD acceptance criteria
+#   - execution_strategy with parallel_groups and file_conflicts
+#   - documentation_impact map with owner_card per doc
+#   - Strategic business_rationale (full context, not just 2-3 lines)
+# =============================================================================
+
+id: {{FEAT-XXXX-00}}
+title: "Epic: {{Feature Name}} — {{short tagline}}"
+status: TODO
+priority: {{HIGH|MEDIUM|LOW}}
+owner_agent: claude
+execution_mode: cloud
+
+# Epic's group.parent is the PRD slug (string), NOT a FEAT-ID.
+# This is the only card where parent is a string slug.
+group:
+  parent: {{prd-slug}}
+  sequence: 0
+
+git_strategy:
+  branch: "feat/{{FEAT-XXXX-00}}-{{slug}}-epic"
+  base: "develop"
+  target: "develop"
+
+context: |
+  Epic tracker per la feature "{{Feature Name}}".
+
+  {{2-4 paragrafi che descrivono:
+   - cosa fa la feature (1 paragrafo)
+   - quale stack riusa / cosa introduce di nuovo (1 paragrafo)
+   - come è strutturato lo storage / data model ad alto livello (1 paragrafo)
+  }}
+
+  PRD: docs/prd/{{slug}}/PRD.md
+  Design: docs/prd/{{slug}}/design.html
+  Cards: {{FEAT-XXXX-01}} .. {{FEAT-XXXX-NN}} ({{N}} sub-card, {{K}} livelli di esecuzione)
+
+business_rationale: |
+  {{Full strategic rationale, 4-6 paragrafi:
+   - perché adesso (urgenza/timing)
+   - segnale cliente/mercato (con citazioni o dati)
+   - impatto atteso (qualitativo + quantitativo dove possibile)
+   - allineamento strategico (come si inserisce in roadmap/macro initiative)
+  }}
+
+scope:
+  summary: |
+    Coordinamento delle {{N}} sub-card che implementano l'epic:
+    {{breve descrizione di ogni sub-card in 1 riga ciascuna}}
+  users: [{{CUSTOMER|MERCHANT|SUPER_ADMIN}}]
+  value: "{{one-line business value}}"
+
+scope_boundaries:
+  in_scope:
+    - "{{capability 1 — high level, l'epic delega i dettagli ai child}}"
+    - "{{capability 2}}"
+  out_of_scope:
+    - "{{esplicito out-of-scope v1 (deferito a v2 o non in roadmap)}}"
+    - "{{altro out-of-scope}}"
+
+requirements:
+  - >
+    Tutte le {{N}} sub-card chiuse con AC verificati e merge in develop.
+  - >
+    Documentation Impact tutte aggiornate (vedi documentation_impact[] sotto).
+  - >
+    Test scenarios del PRD §13 eseguiti con esito atteso (ownership: card E2E).
+  - >
+    {{Altri requirements end-to-end}}
+
+# AC-EPIC = roll-up del PRD, NON duplicazione delle AC dei child.
+# Pattern: tracking outcome end-to-end, non singoli step implementativi.
+acceptance_criteria:
+  - "[ ] [AC-EPIC-1] Tutte le {{N}} sub-card in stato DONE."
+  - "[ ] [AC-EPIC-2] AC-1 .. AC-{{N}} del PRD verificati end-to-end."
+  - "[ ] [AC-EPIC-3] {{outcome capability principale verificato — es. 'Auto-translate funzionante: customer ?lang=en vede output tradotto'}}"
+  - "[ ] [AC-EPIC-4] {{outcome di sicurezza/perf — es. 'HTML pericoloso strippato server-side'}}"
+  - "[ ] [AC-EPIC-5] Entry '{{Feature Name}}' in ${paths.references_dir}/ssot-registry.md."
+
+definition_of_done:
+  - "Tutte le sub-card DONE e mergiate in develop"
+  - "PRD §13 test scenarios eseguiti con esito atteso"
+  - "Documentation Impact eseguita (vedi documentation_impact[] sotto)"
+  - "{{Altri DoD epic-level}}"
+
+# Epic has no dependencies (it's the root) and blocks nothing
+# (children block via their own depends_on).
+depends_on: []
+blocks: []
+
+estimated_complexity: {{LOW|MEDIUM|HIGH}}
+
+parallel_group: 0
+
+# =============================================================================
+# Execution Strategy (auto-computed by prd-card-writer)
+# Consumed by /new orchestrator for parallel runs.
+# =============================================================================
+
+execution_strategy:
+  total_cards: {{N}}
+  recommended_mode: {{team|sequential}}
+  groups:
+    - level: 0
+      cards: [{{FEAT-XXXX-01}}]
+      rationale: "{{foundation / first dependency layer}}"
+    - level: 1
+      cards: [{{FEAT-XXXX-02}}, {{FEAT-XXXX-03}}]
+      rationale: "{{parallel after L0}}"
+    # ... add levels as needed
+  file_conflicts:
+    - "{{FEAT-XXXX-N}} e {{FEAT-XXXX-M}} entrambi modificano {{file}} — forzato sequenziale"
+    # omit if no conflicts
+
+# =============================================================================
+# Canonical Docs (epic-level — children inherit subset)
+# =============================================================================
+
+canonical_docs:
+  prd_ref: docs/prd/{{slug}}/PRD.md
+  design_ref: docs/prd/{{slug}}/design.html
+  traceability_ref: docs/prd/{{slug}}/traceability.md
+  ssot_registry_entry: "{{Feature Name as registered/to-register in ssot-registry.md}}"
+  data_model_refs:
+    - ${paths.references_dir}/collections/{{collection}}.md
+    - ${paths.references_dir}/data-model.md
+  api_refs:
+    - ${paths.references_dir}/api/{{module}}.md
+  ui_refs:
+    - ${paths.design_system}/INDEX.md
+    - ${paths.design_system}/components/{{Component}}.md
+
+# =============================================================================
+# Documentation Impact (PRD § Documentation Impact)
+# Each entry has an owner_card — the child card responsible for the update.
+# This makes ownership explicit and verifiable post-merge.
+# =============================================================================
+
+documentation_impact:
+  - file: ${paths.references_dir}/data-model.md
+    action: "{{what to add/update}}"
+    owner_card: {{FEAT-XXXX-NN}}
+  - file: ${paths.references_dir}/collections/{{collection}}.md
+    action: "{{schema additions}}"
+    owner_card: {{FEAT-XXXX-NN}}
+  - file: ${paths.references_dir}/api/{{module}}.md
+    action: "{{endpoint extensions}}"
+    owner_card: {{FEAT-XXXX-NN}}
+  - file: ${paths.design_system}/INDEX.md
+    action: "{{component registration}}"
+    owner_card: {{FEAT-XXXX-NN}}
+  - file: ${paths.references_dir}/ssot-registry.md
+    action: "Aggiungi riga '{{Feature Name}}' → docs/prd/{{slug}}/PRD.md"
+    owner_card: {{FEAT-XXXX-NN-last}}  # tipicamente l'ultima card (E2E o docs-sync)
+
+# =============================================================================
+# Epic-only fields below — keep at defaults
+# =============================================================================
+
+# No code is touched by the epic itself — only docs (via owner_card chain).
+files_likely_touched: []
+
+# Tracker has no implementation, so these are explicit empty.
+data_sources: []
+test_plan:
+  e2e_required: false
+  e2e_rationale: "Epic tracker — test scenarios live on child cards."
+
+assumptions: []
+unknowns: []
+notes:
+  - "Epic created via /prd skill. Children: {{FEAT-XXXX-01}} .. {{FEAT-XXXX-NN}}."

package/framework/.claude/skills/prd/assets/prd-template.md

@@ -0,0 +1,230 @@
+---
+doc_type: prd
+domain: {{stable domain label from document-metadata-contract-v1.md}}
+canonicality: canonical
+owner: prd
+status: draft
+freshness_status: fresh
+---
+
+# {{Feature Name}} PRD
+
+**Version**: 1.0
+**Owner**: Antonio Baldassarre
+**Date**: {{YYYY-MM-DD}}
+**Status**: Draft
+**Feature ID**: {{FEAT-ID}}
+
+---
+
+## Canonical Sources
+
+| Source | Document |
+|--------|----------|
+| Macro feature | {{macro feature name}} |
+| Requirements owner | This PRD |
+| Obsidian spec | {{[[Note Name]] — remove row if no Obsidian note was provided}} |
+| Data model | {{link to ${paths.references_dir}/collections/...}} |
+| API reference | {{link to ${paths.references_dir}/api/...}} |
+| SSOT registry | {{link to ${paths.references_dir}/ssot-registry.md}} |
+
+## Implementation References
+
+| Reference | Path | Relevance |
+|-----------|------|-----------|
+| {{name}} | `{{file path}}` | {{why relevant}} |
+
+## Backlog Links
+
+Backlog cards to be created after PRD approval.
+
+## Documentation Impact
+
+| Document | Action |
+|----------|--------|
+| {{doc path}} | {{what to update}} |
+
+---
+
+## 1. Problem Statement
+
+{{Problem description with business impact.}}
+
+### Ratio Strategica
+
+#### Perché adesso, perché questo
+{{Quale evento di business, segnale di mercato o priorità strategica rende questa feature necessaria in questo momento.}}
+
+#### Segnale cliente / mercato
+{{Feedback specifici dei clienti, dati d'uso, pressione competitiva o trend di mercato che hanno innescato questa iniziativa. Includere dati dove disponibili.}}
+
+#### Impatto di business atteso
+{{Risultati misurabili attesi: ricavi, retention, efficienza operativa, riduzione rischio. Quantificare dove possibile.}}
+
+#### Allineamento strategico
+{{Come questa feature si inserisce nella visione del prodotto e nelle priorità della roadmap attuale.}}
+
+#### Alternative considerate
+| Alternativa | Perché scartata |
+|-------------|-----------------|
+| {{opzione}} | {{motivo}} |
+
+---
+
+## 2. Goals and Non-Goals
+
+### Goals
+
+- **G1**: {{goal}}
+
+### Non-Goals
+
+- **NG1**: {{non-goal}}
+
+---
+
+## 3. Personas
+
+### {{Persona 1}}
+
+{{Description and context.}}
+
+---
+
+## 4. User Stories
+
+- **US-1**: As a {{persona}}, I want to {{action}} so that {{benefit}}.
+
+---
+
+## 5. Data Model
+
+{{TypeScript interfaces, Firestore schema changes, validation rules.}}
+
+### Firestore Composite Indexes
+
+Every query that combines `where()` on one field with `orderBy()` on a different field,
+or multiple `where()` on different fields, REQUIRES a composite index. Missing indexes
+cause runtime `FAILED_PRECONDITION` errors (500s in production).
+
+| # | Collection | Fields | Order | Query Location | Status |
+|---|-----------|--------|-------|----------------|--------|
+| IDX-1 | `{{collection}}` | `{{field1}}` ASC, `{{field2}}` DESC | {{ASC/DESC}} | `{{file:function}}` | NEW / EXISTS |
+
+**Rules:**
+- Every API endpoint or server action that reads from Firestore with compound queries MUST have its indexes listed here.
+- The `firestore.indexes.json` file MUST be updated in the same commit as the query code.
+- If no compound queries are needed: state "Nessun indice composito richiesto — tutte le query usano un singolo campo."
+
+---
+
+## 6. API Contract Changes
+
+{{Endpoints, request/response formats, validation.}}
+
+---
+
+## 7. UI Specifications
+
+{{Layout, components, styling, responsive behavior, a11y.}}
+
+---
+
+## 8. i18n Specification
+
+{{Dictionary keys, locale files, provider patterns.}}
+
+---
+
+## 9. Acceptance Criteria
+
+### {{Area}}
+
+- **AC-1**: {{testable criterion}}
+
+---
+
+## 10. Edge Cases and Failure Modes
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| {{scenario}} | {{behavior}} |
+
+---
+
+## 11. Out of Scope
+
+1. {{excluded item}}
+
+---
+
+## 12. Dependencies
+
+| Dependency | Type | Status |
+|------------|------|--------|
+| {{dependency}} | {{type}} | {{status}} |
+
+---
+
+## 13. Test Plan
+
+### E2E Evaluation
+
+| Criterion | Result |
+|-----------|--------|
+| Has UI impact? | {{yes/no}} |
+| Multi-step flow? | {{yes/no}} |
+| Critical path? (auth/payment/booking) | {{yes/no}} |
+| UI acceptance criteria count | {{N}} |
+| **Verdict** | **{{NOT NEEDED / RECOMMENDED / REQUIRED}}** |
+| Rationale | {{reason}} |
+
+### Test Scenarios
+
+{{If E2E NOT NEEDED: "Nessun test E2E pianificato — [rationale]"}}
+
+{{If E2E REQUIRED or RECOMMENDED:}}
+
+| # | Scenario | User Story | Acceptance Criteria | Priority |
+|---|----------|------------|---------------------|----------|
+| TS-1 | {{scenario description}} | US-{{N}} | AC-{{N}} | {{HIGH/MEDIUM}} |
+
+### Test Credentials
+
+| Persona | Auth Method | Credentials | Notes |
+|---------|------------|-------------|-------|
+| {{Consumer}} | OTP | phone: 3486417303 | OTP inserito manualmente dall'utente durante il test |
+| {{Merchant}} | password | {{username}} / {{password}} | Store: {{store name}} |
+
+### Test Data Prerequisites
+
+{{Any data that must exist in Firestore before tests can run (e.g., active promos, store config, existing reservations).}}
+
+---
+
+## 14. Pipeline Touchpoints (Implementation Summary)
+
+| Step | File | Change |
+|------|------|--------|
+| 1 | `{{file}}` | {{change}} |
+
+---
+
+## 15. Integration Surface Map (ISA)
+
+Existing code that must reference, link to, or interact with this feature.
+Every ISA entry MUST be covered by at least one backlog card.
+
+| # | Category | Existing File | Action Required | Risk if Omitted | Card |
+|---|----------|--------------|-----------------|-----------------|------|
+| ISA-1 | {{NAVIGATION / PERMISSIONS / SETTINGS / SEARCH / NOTIFICATIONS / DASHBOARD / API_CONSUMERS / SHARED_STATE}} | `{{file path}}` | {{what to do}} | {{consequence}} | {{FEAT-ID or TBD}} |
+
+**Risk summary:** HIGH: {{N}} | MEDIUM: {{N}} | LOW: {{N}}
+
+### ISA Traceability Matrix
+
+| ISA # | Touchpoint | Card(s) | Status |
+|-------|-----------|---------|--------|
+| ISA-1 | {{touchpoint}} | {{FEAT-ID}} | Covered / Missing |
+
+**Every ISA entry MUST map to at least one card. Missing entries = incomplete plan.**

package/framework/.claude/skills/prd/assets/state-template.md

@@ -0,0 +1,78 @@
+# PRD Session: {{slug}}
+Created: {{YYYY-MM-DD HH:MM}}
+Status: discovery
+
+## Feature Description
+{{user's description verbatim}}
+
+## Business Rationale
+
+### Perché adesso, perché questo
+(pending)
+
+### Segnale cliente / mercato
+(pending)
+
+### Impatto di business atteso
+(pending)
+
+### Allineamento strategico
+(pending)
+
+### Alternative considerate
+(pending)
+
+## Comprehension Checklist
+| Dimension | Status | Source | Detail |
+|---|---|---|---|
+| Business rationale | - | | |
+| Target users | - | | |
+| User journey | - | | |
+| Data model impact | - | | |
+| API impact | - | | |
+| UI impact | - | | |
+| Permissions/roles | - | | |
+| Edge cases | - | | |
+| Rollout/migration | - | | |
+| Integration surface | - | | |
+| Test strategy | - | | |
+
+Comprehension: 0% (0/11)
+
+## Discovery Log
+
+## Research
+
+Confidence: pending
+Signals: pending
+Status: pending
+Topics: pending
+
+## Research Findings
+
+## Research-Driven Discovery
+
+## Integration Surface Map
+
+| # | Category | Existing File | Action Required | Risk | Card |
+|---|----------|--------------|-----------------|------|------|
+
+## Test Plan
+
+E2E evaluation: pending
+E2E needed: pending
+Persona: pending
+Credentials: pending
+Scenarios: pending
+
+## UI Design
+
+## Confirmed Specs
+
+## Backlog Cards
+
+## Change Requests
+
+<!-- Populated by /prd-add when scope expansion is detected -->
+
+## Validation

package/framework/.claude/skills/prd/references/api-perf-gate.md

@@ -0,0 +1,152 @@
+# API Performance Gate (Step 4.5)
+
+**Precondition:** PRD written (Step 4 complete), not yet presented to user.
+
+This gate audits the PRD for performance bottlenecks and cost inefficiencies
+**before** the user sees it, so findings are integrated into the spec — not
+flagged after implementation.
+
+---
+
+## When to Run
+
+**Gate 5 (Text Scan) runs ALWAYS** on every PRD. It is a fast keyword match.
+
+**Gates 1-4 run ONLY** when Gate 5 finds matches OR the PRD contains any of:
+- `## API contract changes` section with endpoints
+- `## Data model` section with new Firestore collections/fields
+- Server Actions with Firestore writes
+- Background jobs, cron, batch operations
+
+If none of the above: log `API Performance Gate: N/A — no API/data surface` in
+state file and skip to "Present and Confirm".
+
+---
+
+## The 5-Gate Protocol
+
+### Gate 5 — Text Scan (ALWAYS RUNS FIRST)
+
+Scan the PRD text for these keywords. Each match = a finding.
+
+| Keyword Pattern | Problem | Severity |
+|-----------------|---------|----------|
+| "show all" / "list all" / "fetch all" / "mostra tutti" | Unbounded read — no pagination | CRITICAL |
+| "for each X" + "get/read Y" / "per ogni X" + "leggi Y" | N+1 query pattern | CRITICAL |
+| "notify all" / "update all" / "notifica tutti" | Fan-out write | HIGH |
+| "live" / "real-time" / "tempo reale" / "auto-update" | Listener cost (1 read/doc at attach + 1/change) | HIGH |
+| "global counter" / "total X" / "increment count" / "contatore" | Transaction hotspot (serializes writers) | HIGH |
+| "no limit" / "unlimited" / "senza limiti" / "illimitato" | Unbounded data growth | HIGH |
+| "save all in document" / "embed list" / "array nel documento" | Unbounded array in doc (max 1MB, degrades at 40K) | HIGH |
+| "upload file/image via API" / "carica file" | 4.5MB payload limit on Vercel Functions | HIGH |
+| "auto-increment ID" / "sequential ID" / "ID sequenziale" | Firestore hotspot | HIGH |
+| "search by name" / "full-text search" / "cerca per nome" | Firestore cannot do full-text search | HIGH |
+| "page N" / "skip" / "offset" / "pagina N" | Offset pagination (charges for ALL skipped docs) | MEDIUM |
+| "send email/SMS" in request path / "invia email/SMS" | Blocking I/O in request path (use waitUntil) | MEDIUM |
+| "filter by A and B and C" / "filtra per A e B e C" | Composite index explosion | MEDIUM |
+| "import CSV" / "bulk insert" / "importa CSV" | Batch 500-doc limit per write | MEDIUM |
+
+**If 0 matches AND no API/data sections**: skip Gates 1-4, proceed to present.
+**If any match**: continue to Gates 1-4.
+
+### Gate 1 — Data Model Review
+
+Check the PRD `## Data model` section for:
+
+- [ ] **Unbounded arrays**: any array field that can grow without limit → CRITICAL
+- [ ] **Document size**: will any document exceed ~100KB regularly? → HIGH
+- [ ] **Sequential/predictable IDs**: custom IDs based on timestamp or counter → HIGH (Firestore hotspot, use auto-ID)
+- [ ] **Fan-out writes**: one user action writing to N documents where N scales with users/data → HIGH
+- [ ] **Global counters**: fields incremented by many concurrent writers → HIGH (transaction serialization)
+- [ ] **Real-time listeners**: justified? Can polling or ISR replace them? → HIGH (1 read/matched doc at attach)
+- [ ] **Denormalization strategy**: read-heavy paths should denormalize; write-heavy should normalize → MEDIUM
+- [ ] **Index exemptions**: large text/description fields should exempt from indexing → MEDIUM (N+1 index writes per doc write)
+
+### Gate 2 — Query & Index Review
+
+Check the PRD `## API contract changes` and data access patterns for:
+
+- [ ] **Pagination on all list endpoints**: every endpoint returning multiple docs MUST specify cursor-based pagination (startAfter), never offset → CRITICAL
+- [ ] **N+1 queries**: "get parent, then for each child get details" pattern → CRITICAL (use collectionGroup or denormalize)
+- [ ] **Composite index specification**: every query combining `where()` + `orderBy()` on different fields, or multiple `where()` on different fields, MUST have an explicit entry in the PRD's `### Firestore Composite Indexes` table (Section 5). Missing index = runtime FAILED_PRECONDITION (500 in production) → **CRITICAL**
+- [ ] **Composite index count**: >3 inequality filters on different fields = index explosion → MEDIUM
+- [ ] **orderBy + inequality on different fields**: requires composite index, max 1 inequality per query. Verify the PRD index table includes the correct field order (the inequality field MUST be last in the index definition) → **HIGH**
+- [ ] **Full-text search**: Firestore doesn't support it natively; require Algolia/Typesense or array-contains workaround → HIGH
+- [ ] **Index table completeness**: if the PRD has API endpoints that read from Firestore but Section 5 has no `### Firestore Composite Indexes` table (or says "nessun indice"), verify this is actually correct by checking each query pattern. Missing the table when compound queries exist → **CRITICAL**
+
+### Gate 3 — Serverless Architecture Review
+
+Check endpoint design and background processing for:
+
+- [ ] **Payload size**: any endpoint accepting/returning >4.5MB → CRITICAL (use signed URL pattern for uploads)
+- [ ] **Sync vs async**: long operations (email, PDF, image processing) in request path → HIGH (use waitUntil or background job)
+- [ ] **Function duration**: operations that may exceed 300s → HIGH (split into steps or use queue)
+- [ ] **CPU-intensive ops**: image resize, PDF gen, heavy computation in serverless → MEDIUM (consider dedicated worker)
+- [ ] **GET Route Handler caching**: new GET endpoints MUST specify `revalidate` or `use cache` — dynamic by default since Next.js 15 → HIGH
+
+### Gate 4 — Caching Strategy Review
+
+Check data display and freshness requirements for:
+
+- [ ] **Freshness requirement defined**: every read endpoint should specify acceptable staleness → HIGH
+- [ ] **Per-user vs shared data**: shared data (menu, store info) should use ISR/cache; per-user data (orders, profile) stays dynamic → MEDIUM
+- [ ] **Cache invalidation plan**: if using cache, how is it invalidated on writes? revalidateTag? revalidatePath? → MEDIUM
+- [ ] **Redundant reads**: same data fetched in multiple components without dedup → MEDIUM (use React.cache for single-request dedup)
+
+---
+
+## Severity Actions
+
+| Severity | Action |
+|----------|--------|
+| CRITICAL | MUST fix in PRD before presenting to user. Add/modify NFR, add edge case, change API design. |
+| HIGH | MUST add as NFR or documented design decision in PRD. User sees it in the spec. |
+| MEDIUM | Add to `Edge cases and failure modes` table in PRD as advisory. |
+| LOW | Log in state file only. No PRD change. |
+
+---
+
+## Execution Procedure
+
+1. Run Gate 5 on the full PRD text.
+2. If matches found OR API/data sections present → run Gates 1-4.
+3. For each finding:
+   - CRITICAL/HIGH: edit the PRD directly (add NFR, modify API contract, add edge case).
+   - MEDIUM: add to edge cases table.
+   - LOW: note in state file.
+4. Update state file: `## API Performance Gate` section with findings count and actions taken.
+5. If any CRITICAL findings were resolved, add a `### Performance-Informed Decisions` subsection
+   to the PRD listing what was changed and why.
+6. Proceed to "Present and Confirm" — the user sees an already-optimized PRD.
+
+---
+
+## Reference Data
+
+### Firestore Pricing (Blaze Plan)
+- Reads: $0.06 / 100K
+- Writes: $0.18 / 100K
+- Deletes: $0.02 / 100K
+- Offset pagination charges for ALL skipped docs
+- Index writes: N+1 per document (1 doc + N indexed fields)
+- Listener: 1 read/matched doc at attach + 1 per change
+
+### Vercel Fluid Compute
+- Payload limit: 4.5 MB request/response
+- Active CPU pricing: pauses during I/O
+- Max duration: 300s (Hobby) / 800s (Pro)
+- File descriptor limit: 1,024 shared
+- Cold start: archived after 2 weeks (prod) / 48h (preview)
+
+### Next.js App Router
+- GET Route Handlers: DYNAMIC by default since v15 (must opt-in to caching)
+- `use cache` in serverless: in-memory LRU, not persisted across cold starts
+- `React.cache()`: single-request dedup only
+- Sequential `await` = waterfall; use `Promise.all()` for independent fetches
+
+### When to Skip
+
+- Hotfix cards (single-line bug fixes): Gate 5 only
+- Purely frontend cards (no API/Firestore): skip entirely
+- Documentation-only: skip entirely
+- Prototype/spike (throw-away): skip entirely