valent-pipeline 0.2.20 → 0.2.21

package/pipeline/templates/data-handoff.template.md

@@ -0,0 +1,96 @@
+# data-handoff
+<!-- Template version: 1.0 | Used by: DATA | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Pipeline Stages Implemented -- required
+<!-- Every pipeline stage implemented in this story. CRITIC and QA-B use this to validate coverage and data flow. -->
+
+| Stage | Input | Transform | Output | Row Count Change |
+|-------|-------|-----------|--------|-----------------|
+| {stage-name} | {input source/format} | {transform description} | {output target/format} | {e.g., 1000 -> 950 (-50 filtered)} |
+
+## Data Quality Rules -- required
+<!-- All data quality rules enforced by this pipeline. -->
+
+| Rule | Stage | Description | Action on Violation |
+|------|-------|-------------|-------------------|
+| {rule-name} | {stage} | {what is checked} | {drop row \| reject batch \| default value \| log warning} |
+
+### Row Count Assertions
+<!-- Expected row count behavior at each stage boundary. -->
+
+- **Stage:** {stage-name}
+  - Input rows: {count or formula}
+  - Output rows: {count or formula}
+  - Drop reason: {why rows are removed, or "none"}
+
+### Null Handling
+<!-- How nulls are handled for each critical field. -->
+
+- **Field:** {field-name}
+  - Null strategy: {reject \| default to X \| propagate \| coalesce}
+
+### Dedup Rules
+<!-- Deduplication strategy if applicable. -->
+
+- **Dedup key:** {field(s) forming the natural key}
+- **Strategy:** {keep first \| keep last \| merge}
+
+## Checkpoint/Resume Design -- conditional
+<!-- Only include if pipeline has checkpoint/resume capability. -->
+
+| Checkpoint | Location | Trigger | Resume Behavior |
+|-----------|----------|---------|----------------|
+| {checkpoint-name} | {where state is stored} | {after stage X completes} | {resume from stage X+1 with saved state} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the pipeline test suite. -->
+
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`

package/pipeline/templates/docgen-handoff.template.md

@@ -0,0 +1,83 @@
+# docgen-handoff
+<!-- Template version: 1.0 | Used by: DOCGEN | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Templates Implemented -- required
+<!-- Every template implemented in this story. CRITIC and QA-B use this to validate coverage and correctness. -->
+
+| Template Name | Variables (with types) | Output Format | Description |
+|---------------|----------------------|---------------|-------------|
+| {template-name} | {var: type, var: type, ...} | {PDF \| HTML \| Markdown \| ...} | {one-line description} |
+
+## Variable Schema -- required
+<!-- Input data contract per template. Every variable, its type, whether required/optional, and default value if any. -->
+
+| Template | Variable | Type | Required | Default | Description |
+|----------|----------|------|----------|---------|-------------|
+| {template-name} | {variable-name} | {string \| number \| boolean \| array \| object} | {yes \| no} | {default or "none"} | {one-line description} |
+
+## Output Formats -- required
+<!-- All supported output types, their MIME types, and any format-specific notes. -->
+
+| Format | MIME Type | Notes |
+|--------|----------|-------|
+| {PDF \| HTML \| Markdown \| ...} | {application/pdf \| text/html \| text/markdown \| ...} | {encoding, compression, or other format-specific details} |
+
+## Asset Dependencies -- conditional
+<!-- Only include if templates reference external assets (fonts, images, stylesheets). -->
+
+| Asset | Type | Path/URL | Required By |
+|-------|------|----------|-------------|
+| {asset-name} | {font \| image \| stylesheet} | {file path or URL} | {template-name} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the test suite. -->
+
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`

package/pipeline/templates/iac-handoff.template.md

@@ -0,0 +1,83 @@
+# iac-handoff
+<!-- Template version: 1.0 | Used by: IAC | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Resources Provisioned -- required
+<!-- Every infrastructure resource created or modified in this story. -->
+
+| Resource Type | Name | Provider | Purpose |
+|---------------|------|----------|---------|
+| {resource-type} | {resource-name} | {provider} | {one-line description} |
+
+## State Management -- required
+<!-- Remote state backend and locking configuration. -->
+
+- **Backend:** {state backend type, e.g., S3+DynamoDB, Azure Blob, GCS}
+- **Locking mechanism:** {DynamoDB, Blob lease, GCS object lock, etc.}
+- **State file path:** {key/path in remote backend}
+
+## IAM/Security -- required
+<!-- Roles, policies, and security configurations created. -->
+
+| Role/Policy | Resource | Actions | Scope | Least-Privilege Verification |
+|-------------|----------|---------|-------|------------------------------|
+| {role-or-policy-name} | {target-resource} | {allowed-actions} | {scope/arn} | {verified: yes/no + rationale} |
+
+## Environment Configuration -- conditional
+<!-- Only include if environment variables, secrets references, or connection strings were configured -->
+
+| Config Key | Source | Type | Consuming Service |
+|------------|--------|------|-------------------|
+| {env-var-or-key} | {secret manager ref, parameter store, etc.} | {env-var \| secret \| connection-string} | {service-name} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the infrastructure test suite. -->
+
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`

package/pipeline/templates/judge-decision.template.md

@@ -33,6 +33,7 @@ blockers: []
 | Traceability matrix complete — no uncovered ACs | {PASS \| FAIL} | {coverage percentage, gap count} |
 | PMCP screenshot evidence present | {PASS \| FAIL \| N/A} | {checkpoint count, any missing} |
 | Bug review approved | {PASS \| FAIL} | {detail} |
+| Platform coverage complete | {PASS \| FAIL \| PARTIAL} | {Android: {result}, iOS: {result or "deferred"}} |
 
 ## Socratic Validation -- required
 <!-- "Does this test actually prove what it claims? Could this screenshot show a passing state that masks a broken state? Does 'all tests green' mean 'all specified tests green' or could tests have been removed?" -->
@@ -43,10 +44,19 @@ blockers: []
 
 ## Verdict -- required
 
-- **Decision:** {SHIP | REJECT}
+- **Decision:** {SHIP | SHIP-PARTIAL | REJECT}
 - **Rationale:** {1-3 sentences justifying the decision}
 - **Confidence:** {high | medium | low}
 
+### SHIP-PARTIAL Detail -- conditional
+<!-- Only include if verdict is SHIP-PARTIAL (mobile-app with deferred iOS tests) -->
+
+- **Platforms shipped:** {Android}
+- **Platforms deferred:** {iOS}
+- **Deferred test count:** {count}
+- **Deferred flow files:** {list of flow file paths}
+- **Resolution:** Run `/run-deferred-tests {story_id}` on a Mac host
+
 ### Rejection Detail -- conditional
 <!-- Only include if verdict is REJECT -->
 

package/pipeline/templates/libdev-handoff.template.md

@@ -0,0 +1,82 @@
+# libdev-handoff
+<!-- Template version: 1.0 | Used by: LIBDEV | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Public API Surface -- required
+<!-- Every public export implemented in this story. CRITIC and QA-B use this to validate coverage and contracts. -->
+
+| Export Name | Type/Signature | Module Path | Usage Example |
+|-------------|---------------|-------------|---------------|
+| {export-name} | {type or function signature} | {module path in exports map} | {one-line usage} |
+
+## Package Configuration -- required
+<!-- Exports map, entry points, and packaging metadata. -->
+
+- **Exports map:**
+  ```json
+  {exports field from package.json / pyproject.toml / Cargo.toml}
+  ```
+- **Entry points:**
+  - main: {CJS entry point or "n/a"}
+  - module: {ESM entry point or "n/a"}
+  - types: {type declarations entry point or "n/a"}
+- **sideEffects:** {true | false | list of files with side effects}
+
+## Breaking Changes -- conditional
+<!-- Only include if this story introduces breaking changes to the public API. -->
+
+| Change | Before | After | Semver Impact |
+|--------|--------|-------|---------------|
+| {removed/renamed export or signature change} | {previous API} | {new API} | {major \| minor \| patch} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the library test suite. -->
+
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`

package/pipeline/templates/mcp-dev-handoff.template.md

@@ -0,0 +1,87 @@
+# mcp-dev-handoff
+<!-- Template version: 1.0 | Used by: MCP-DEV | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Tools Implemented -- required
+<!-- Every MCP tool implemented in this story. CRITIC and QA-B use this to validate coverage and schema compliance. -->
+
+| Tool Name | Description | inputSchema | Output Content Types |
+|-----------|-------------|-------------|---------------------|
+| {tool-name} | {one-line description} | {JSON Schema summary or pointer to code} | {text \| image \| resource \| embedded-resource} |
+
+## Capabilities Declared -- required
+<!-- What the server advertises in the initialize response. Must match actual implementation. -->
+
+- **Server name:** {server-name}
+- **Server version:** {version}
+- **Capabilities:**
+  - {capability}: {details}
+
+## Error Model -- required
+<!-- Two-tier error model: protocol errors vs tool failures. -->
+
+### Protocol Errors (JSON-RPC codes)
+| Code | Meaning | When Returned |
+|------|---------|---------------|
+| -32700 | Parse error | Malformed JSON received |
+| -32600 | Invalid request | Missing required JSON-RPC fields |
+| -32601 | Method not found | Unknown JSON-RPC method |
+| -32602 | Invalid params | Tool input fails schema validation |
+| -32603 | Internal error | Unhandled server exception |
+
+### Tool Failures (isError: true)
+| Tool | Failure Condition | Error Message Pattern |
+|------|-------------------|----------------------|
+| {tool-name} | {condition} | {message pattern} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the test suite. -->
+
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`

package/pipeline/templates/mobile-handoff.template.md

@@ -0,0 +1,122 @@
+# mobile-handoff
+<!-- Template version: 1.0 | Used by: MOBILE | Read by: CRITIC, QA-B -->
+
+---
+agent: {agent-name}
+story: {story-id}
+status: {in_progress | completed}
+stepsCompleted: []
+pendingSteps: []
+lastCheckpoint: {ISO-8601 timestamp}
+inputsRead: []
+outputsWritten: []
+blockers: []
+ios_deferred: {true | false}
+---
+
+## Orchestrator Summary -- required
+- **Agent:** {agent-name}
+- **Story:** {story-id}
+- **Verdict:** {pass | fail | needs-review}
+- **State transition:** {from-phase} -> {to-phase}
+- **Files created/modified:** {list of file paths}
+- **Flags:** {alerts for downstream agents, or "none"}
+
+## Files Created/Modified -- required
+<!-- All production and test files created or modified, with purpose. -->
+
+| File | Action | Purpose |
+|------|--------|---------|
+| {file-path} | {created \| modified} | {one-line description} |
+
+## Screens Implemented -- required
+<!-- Mobile screens implemented in this story. -->
+
+| Screen | File Path | Description | Navigation |
+|--------|-----------|-------------|------------|
+| {screen-name} | {file-path} | {one-line description} | {stack \| tab \| drawer \| modal \| deep-link} |
+
+## Components Created -- required
+<!-- UI components implemented in this story. -->
+
+| Component | File Path | Description | Props |
+|-----------|-----------|-------------|-------|
+| {component-name} | {file-path} | {one-line description} | {key props and types} |
+
+## Navigation Structure -- conditional
+<!-- Only include if new navigation routes were added -->
+
+| Route / Deep Link | Screen | Description | Auth Required |
+|-------------------|--------|-------------|---------------|
+| {deep-link-uri or nav-route} | {screen-name} | {one-line description} | {yes \| no} |
+
+## API Dependencies on BEND -- required
+<!-- Every backend endpoint consumed by the mobile app, with integration details. -->
+
+| Method | Endpoint | Used By | Purpose | Error Handling |
+|--------|----------|---------|---------|----------------|
+| {HTTP method} | {route path} | {screen-name} | {one-line description} | {how errors are displayed to user} |
+
+## Emulator Configuration -- required
+<!-- Emulator/simulator used for testing. -->
+
+| Platform | Device | OS Version | Status |
+|----------|--------|------------|--------|
+| Android | {AVD name or device} | {API level} | {booted \| failed \| skipped} |
+| iOS | {simulator name} | {iOS version} | {booted \| failed \| skipped \| deferred} |
+
+## Maestro Flow Files -- required
+<!-- E2E test flows written and executed. -->
+
+| Flow File | AC Coverage | Platform | Status |
+|-----------|-------------|----------|--------|
+| {file-path} | {AC-ids} | {both \| android \| ios} | {passed \| failed \| deferred} |
+
+## Test Files Written -- required
+<!-- All test files created or modified, mapped to the spec cases they satisfy. -->
+
+| Test File | Test Cases | Spec Reference |
+|-----------|-----------|----------------|
+| {file-path} | {list of test case names} | `qa-test-spec.md#{ac-id}` |
+
+## Test Results Summary -- required
+<!-- Aggregate results from running the test suite, separated by platform. -->
+
+### Android
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name} | {count} | {count} | {count} | {count} | {duration} |
+
+### iOS
+| Suite | Total | Passed | Failed | Skipped | Duration |
+|-------|-------|--------|--------|---------|----------|
+| {suite-name or "Deferred"} | {count} | {count} | {count} | {count} | {duration} |
+
+## Platform Coverage -- required
+<!-- Summary of platform test coverage for this story. -->
+
+| Platform | Tests Run | Tests Passed | Deferred | Reason |
+|----------|-----------|--------------|----------|--------|
+| Android | {count} | {count} | 0 | N/A |
+| iOS | {count} | {count} | {count} | {reason or "N/A"} |
+
+## Deferred iOS Tests -- conditional
+<!-- Only include when ios_deferred is true. Lists Maestro flows that could not run on this host. -->
+
+| Flow File | AC Coverage | Reason |
+|-----------|-------------|--------|
+| {file-path} | {AC-ids} | {Host OS lacks iOS simulator} |
+
+## Implementation Decisions -- required
+<!-- Key decisions made during implementation. Each entry: decision, rationale, alternatives rejected. -->
+
+- **Decision:** {what was decided}
+  - **Rationale:** {why}
+  - **Rejected:** {alternatives considered and why they lost}
+
+## Cross-References -- required
+<!-- Explicit pointers to upstream artifacts consumed. -->
+- Reqs brief: `reqs-brief.md#{section}`
+- UXA spec: `uxa-spec.md#{section}`
+- Test spec: `qa-test-spec.md#{section}`
+- BEND handoff: `bend-handoff.md#{section}`

package/pipeline/templates/reqs-brief.template.md

@@ -1,5 +1,5 @@
 # reqs-brief
-<!-- Template version: 1.0 | Used by: REQS | Read by: UXA, QA-A, BEND, FEND, CRITIC, READINESS -->
+<!-- Template version: 1.0 | Used by: REQS | Read by: UXA, QA-A, BEND, FEND, DATA, MCP-DEV, LIBDEV, DOCGEN, IAC, CRITIC, READINESS -->
 
 ---
 agent: reqs
@@ -35,7 +35,8 @@ blockers: []
 |---------|------|-------------|------------|
 | {br-id} | {rule statement} | {ac-id list} | {edge case notes or "none"} |
 
-## Database Changes -- required
+## Database Changes -- conditional
+<!-- Only include if api or data-pipeline in testing_profiles -->
 <!-- Tables to create/modify. Each entry: table name, action (create/alter/drop), columns with types, constraints, indexes, relationships. -->
 
 ```yaml
@@ -48,14 +49,16 @@ database_changes:
     relationships: [{relationship}]
 ```
 
-## API Endpoints -- required
+## API Endpoints -- conditional
+<!-- Only include if api in testing_profiles -->
 <!-- Each endpoint: method, path, request body, response codes, response body shape, auth requirements. -->
 
 | Method | Path | Request Body | Response Codes | Response Shape | Auth |
 |--------|------|-------------|---------------|----------------|------|
 | {method} | {path} | {body or "none"} | {codes} | {shape} | {auth requirement} |
 
-## Authentication and Authorization -- required
+## Authentication and Authorization -- conditional
+<!-- Only include if api or ui in testing_profiles -->
 <!-- Auth flow, token handling, role/permission requirements, tenant isolation rules. -->
 - **Auth mechanism:** {mechanism}
 - **Roles:** {role list with permissions}
@@ -71,6 +74,59 @@ database_changes:
 - **Pagination:** {strategy or "n/a"}
 - **Rate limiting:** {strategy or "n/a"}
 
+## Data Pipeline Specification -- conditional
+<!-- Only include if data-pipeline in testing_profiles -->
+
+| Stage | Input | Transform | Output | Quality Rules | Error Handling |
+|-------|-------|-----------|--------|---------------|----------------|
+| {stage-name} | {input source/format} | {transformation logic} | {output target/format} | {quality checks} | {error strategy} |
+
+- **Idempotency strategy:** {approach — natural keys, upsert, dedup}
+- **Checkpoint/resume:** {what state is persisted, recovery granularity}
+- **Schema evolution:** {strategy — additive-only, migration scripts, etc.}
+
+## Tool Definitions -- conditional
+<!-- Only include if mcp-server in testing_profiles -->
+
+| Tool Name | Description | inputSchema | Output Types | Error Behavior |
+|-----------|-------------|-------------|-------------|----------------|
+| {name} | {purpose} | {JSON Schema summary} | {text/image/audio/resource} | {JSON-RPC error code or isError:true scenario} |
+
+- **Capabilities:** {what server advertises at initialize}
+- **Transport:** {stdio / SSE / streamable HTTP}
+
+## Public API Surface -- conditional
+<!-- Only include if library in testing_profiles -->
+
+| Export | Signature | Return Type | Module Path | Breaking Change? |
+|--------|-----------|-------------|-------------|-----------------|
+| {symbol} | {function signature or type} | {return type} | {path in exports map} | {yes/no — vs prior version} |
+
+- **Semver policy:** {what constitutes major/minor/patch}
+- **Module system:** {CJS / ESM / dual}
+- **Peer dependencies:** {required peer deps and version ranges}
+
+## Template Specifications -- conditional
+<!-- Only include if document-generation in testing_profiles -->
+
+| Template | Variables (required) | Variables (optional) | Output Format | Conditional Sections |
+|----------|---------------------|---------------------|---------------|---------------------|
+| {template-name} | {var: type, var: type} | {var: type (default)} | {PDF/HTML/Markdown} | {section: condition} |
+
+- **Encoding:** {UTF-8, unicode support, RTL}
+- **Asset dependencies:** {fonts, images, logos — embedded or referenced}
+
+## Infrastructure Resources -- conditional
+<!-- Only include if iac in testing_profiles -->
+
+| Resource | Provider | Type | Purpose | Tags | Destroy Protection |
+|----------|----------|------|---------|------|--------------------|
+| {name} | {AWS/Azure/GCP} | {resource type} | {purpose} | {required tags} | {yes/no} |
+
+- **State management:** {remote backend, locking mechanism}
+- **IAM policy:** {roles/permissions created, least-privilege verification}
+- **Environment topology:** {dev/staging/prod differences}
+
 ## NFR Targets -- required
 <!-- Non-functional requirement targets. Each entry: category, metric, target value, measurement method. -->