eai-cli 0.0.0-bootstrap.0

package/resources/gofer/templates/cto-architecture-summary-template.md

@@ -0,0 +1,83 @@
+---
+feature: '{{feature-name}}'
+created: '{{ISO-timestamp}}'
+updated: '{{ISO-timestamp}}'
+audience: cto-architecture
+source_inputs:
+  - plan.md
+  - contract-pack.md
+  - data-model.md
+  - service-fit-matrix.md
+  - eai-preflight.md
+  - visuals/c4-context.md
+  - visuals/c4-container.md
+  - .specify/memory/brand-profile.json
+---
+
+# CTO Architecture Summary: {{feature-name}}
+
+## Executive Summary
+
+{{three-sentence-architecture-summary}}
+
+## Branding And Presentation
+
+Use the approved brand profile for document styling while keeping diagrams
+source-controlled, readable in monochrome, and linked to architecture evidence.
+If a branded Marp deck is produced, use the approved theme path from
+`.specify/memory/brand-profile.json`.
+
+## Architecture Direction
+
+| Decision                   | Direction                             | Rationale                  | Evidence |
+| -------------------------- | ------------------------------------- | -------------------------- | -------- |
+| Primary platform           | EAI Platform                          | {{why-eai-platform}}       | {{path}} |
+| Cloud/supporting substrate | Azure-first unless exception approved | {{why-azure-or-exception}} | {{path}} |
+| App template / UI blocks   | {{eai-app-template-or-na}}            | {{block-rationale}}        | {{path}} |
+| Integration model          | {{integration-model}}                 | {{rationale}}              | {{path}} |
+
+## EAI Platform Fit
+
+| Capability     | EAI Platform service / template asset | Fit status                                 | Evidence |
+| -------------- | ------------------------------------- | ------------------------------------------ | -------- |
+| {{capability}} | {{service-or-block}}                  | {{accessible-now-purchasable-unavailable}} | {{path}} |
+
+## Auth, Tenancy, Data, And Contracts
+
+| Area                 | Summary                         | Evidence |
+| -------------------- | ------------------------------- | -------- |
+| Authentication       | {{auth-summary}}                | {{path}} |
+| Authorization        | {{authorization-summary}}       | {{path}} |
+| Tenant boundaries    | {{tenant-boundary-summary}}     | {{path}} |
+| Data model           | {{object-types-and-data-model}} | {{path}} |
+| API/events/contracts | {{contract-summary}}            | {{path}} |
+
+## Diagrams
+
+| Visual                                      | Question answered                                               | Evidence / render proof                 | Freshness             |
+| ------------------------------------------- | --------------------------------------------------------------- | --------------------------------------- | --------------------- |
+| C4 context: `visuals/c4-context.md`         | Who uses the system and what external systems does it rely on?  | {{path-or-render-proof}}                | {{fresh-stale-or-na}} |
+| C4 container: `visuals/c4-container.md`     | What deployable/runtime parts exist and where does code belong? | {{path-or-render-proof}}                | {{fresh-stale-or-na}} |
+| Data model ERD: `visuals/data-model-erd.md` | What objects/data relationships must be preserved?              | {{path-or-render-proof}}                | {{fresh-stale-or-na}} |
+| Sequence/state/value/risk visuals           | What flow, lifecycle, business process, or risk needs review?   | {{path-or-render-proof}}                | {{fresh-stale-or-na}} |
+| Presentation deck: `presentation.marp.md`   | What is the simple architecture story for stakeholder review?   | {{path-or-render-proof-or-skip-reason}} | {{fresh-stale-or-na}} |
+
+Visuals should be simple enough for a reviewer to understand without external
+docs: one question per visual, about seven or fewer primary nodes/steps where
+practical, a plain-language preamble, Mermaid/source-controlled source or text
+fallback, Marp when slides help, and links back to requirements, code/tests, and
+EAI Platform evidence.
+
+## Architecture Risks And Open Questions
+
+| Risk / question | Impact     | Owner              | Next action     |
+| --------------- | ---------- | ------------------ | --------------- |
+| {{risk}}        | {{impact}} | CTO / Architecture | {{next-action}} |
+
+## Review Ask
+
+CTO / Architecture should approve, revise, or defer:
+
+- EAI Platform and Azure direction.
+- Auth, tenant, data, and integration model.
+- Any non-EAI or non-Azure exception with owner, expiry, and evidence.

package/resources/gofer/templates/discovery-template.md

@@ -0,0 +1,92 @@
+---
+feature: '[Feature Name]'
+created: '[ISO timestamp]'
+discoveredBy: Gofer + [User]
+status: complete
+---
+
+# Business Discovery: [Feature Name]
+
+## Problem Statement
+
+**Pain Point**: [User's description of the problem they're solving]
+
+**Current State**: [How the problem is currently addressed, if at all]
+
+**Impact**: [Who is affected and the severity/frequency of the problem]
+
+## Target Users
+
+### Primary Users
+
+- **Persona**: [Role/title of primary user]
+- **Technical Level**: [Non-technical / Technical / Mixed]
+- **Key Needs**: [What they need from this feature]
+- **Usage Context**: [When/where they would use this]
+
+### Secondary Users (if applicable)
+
+- **Persona**: [Role/title]
+- **Relationship**: [How they interact with primary users]
+- **Key Needs**: [Their specific needs]
+
+## Competitive Analysis
+
+**Researched**: [Yes / No / Skipped]
+
+### Key Insights (if researched)
+
+| Company     | Approach            | Strengths         | Gaps             |
+| ----------- | ------------------- | ----------------- | ---------------- |
+| [Company A] | [How they solve it] | [What works well] | [What's missing] |
+| [Company B] | [How they solve it] | [What works well] | [What's missing] |
+
+**Differentiation Opportunity**: [What we can do better or differently]
+
+## Value Proposition
+
+**Primary Value**: [Main benefit this feature delivers]
+
+**Value Type**: [Time savings / Cost reduction / Quality improvement / User
+satisfaction]
+
+**Quantified Goal**: [Specific metric target, e.g., "Reduce X by 50%"]
+
+## Success Metrics
+
+### Outcome Metrics (Primary)
+
+| Metric     | Target         | Measurement Method |
+| ---------- | -------------- | ------------------ |
+| [Metric 1] | [Target value] | [How to measure]   |
+| [Metric 2] | [Target value] | [How to measure]   |
+
+### Supporting Metrics (as applicable)
+
+| Category   | Metric   | Target   |
+| ---------- | -------- | -------- |
+| Engagement | [Metric] | [Target] |
+| Business   | [Metric] | [Target] |
+| Quality    | [Metric] | [Target] |
+
+## Constraints & Requirements
+
+- [Constraint 1 - technical, business, or timeline]
+- [Constraint 2]
+- [Constraint 3]
+
+## Discovery Decisions
+
+| Decision  | Choice            | Rationale         |
+| --------- | ----------------- | ----------------- |
+| [Topic 1] | [What was chosen] | [Why this choice] |
+| [Topic 2] | [What was chosen] | [Why this choice] |
+
+## Notes
+
+[Any additional context, questions for later, or observations from the discovery
+conversation]
+
+---
+
+_Discovery completed: [timestamp]_ _Ready for: /1_gofer_research_

package/resources/gofer/templates/eai-preflight-template.md

@@ -0,0 +1,144 @@
+---
+artifact: eai-preflight
+feature: '{{feature_id}}'
+status: '{{ready|blocked|deferred|not_applicable}}'
+created: '{{iso_timestamp}}'
+updated: '{{iso_timestamp}}'
+---
+
+# EAI App Delivery Preflight
+
+## Summary
+
+| Field                       | Status        | Evidence              |
+| --------------------------- | ------------- | --------------------- | ---------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------- |
+| EAI app delivery applies    | {{yes         | no}}                  | {{classification evidence}}  |
+| CLI installed               | {{ready       | missing               | failed}}                     | {{command -v eai, eai --version}}                                                  |
+| CLI release status          | {{current     | upgrade_required      | blocked}}                    | {{eai update --check}}                                                             |
+| CLI capabilities discovered | {{ready       | blocked}}             | {{eai --describe timestamp}} |
+| Logged in                   | {{ready       | login_required        | account_required}}           | {{eai whoami summary, no tokens}}                                                  |
+| Tenant ready                | {{ready       | tenant_required       | operator_required}}          | {{tenant role category, no private payloads}}                                      |
+| Template ready              | {{ready       | template_required     | deferred}}                   | {{template markers or eai verify result}}                                          |
+| Drift readiness             | {{ready       | drift_detected        | not_applicable}}             | {{eai template check / eai gofer refresh --check}}                                 |
+| App enrollment ready        | {{ready       | confirmation_required | blocked                      | deferred}}                                                                         | {{app list/create/select summary}}                                 |
+| Entra redirect readiness    | {{ready       | not_required          | blocked                      | deferred}}                                                                         | {{callback URI, client ID label, and AADSTS50011 recovery status}} |
+| Resource provisioning       | {{not_started | in_progress           | ready                        | blocked                                                                            | deferred}}                                                         | {{eai app provision, entra, and storage-health evidence}}           |
+| Object-type publish         | {{not_started | in_progress           | ready                        | blocked                                                                            | deferred}}                                                         | {{eai types validate/seed/diff evidence}}                           |
+| Schema and storage health   | {{not_started | in_progress           | ready                        | blocked                                                                            | deferred}}                                                         | {{resource schema, storage status/doctor, verify storage evidence}} |
+| Workflow readiness          | {{ready       | blocked               | deferred}}                   | {{eai workflow readiness evidence}}                                                |
+| Block catalog ready         | {{ready       | blocked               | deferred}}                   | {{blocks list/readiness/describe summary}}                                         |
+| App stack policy            | {{ready       | exception_required    | blocked}}                    | {{EAI Platform including app template first, Azure second, or approved exception}} |
+
+## Safe Public Sources Used
+
+- EAI CLI overview: https://eai-tools.github.io/eai/docs/overview
+- EAI API reference: https://eai-tools.github.io/eai/docs/api-reference
+- EAI static registry: https://eai-tools.github.io/eai/registry/
+- EAI scenario library: https://eai-tools.github.io/eai/scenarios
+- EAI app template: https://github.com/eai-tools/eai-app-template
+
+## Commands Run
+
+| Purpose                   | Command                                                                                                           | Result                |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------- |
+| Install check             | `command -v eai`                                                                                                  | {{result}}            |
+| Version check             | `eai --version`                                                                                                   | {{result}}            |
+| Release check             | `eai update --check`                                                                                              | {{result}}            |
+| Capability discovery      | `eai --describe`                                                                                                  | {{result}}            |
+| Login check               | `eai whoami`                                                                                                      | {{result}}            |
+| Tenant check              | `eai tenant list --format json`                                                                                   | {{result}}            |
+| Project check             | `eai verify`                                                                                                      | {{result_or_not_run}} |
+| Template drift check      | `eai template check --format json`                                                                                | {{result_or_not_run}} |
+| Gofer drift check         | `eai gofer refresh --check --format json`                                                                         | {{result_or_not_run}} |
+| App enrollment check      | `eai app list --format json`                                                                                      | {{result_or_not_run}} |
+| App selection             | `eai app select <key> --format json`                                                                              | {{result_or_not_run}} |
+| App resource provisioning | `eai app provision <key> --tenant-id <tenant-id> --select --format json`                                          | {{result_or_not_run}} |
+| Entra provisioning        | `eai provision entra`                                                                                             | {{result_or_not_run}} |
+| Entra redirect recovery   | `eai provision entra --force --redirect-uri <confirmed-callback-uri>`; artifact uses redacted callback route only | {{result_or_not_run}} |
+| Environment pull          | `eai env pull`                                                                                                    | {{result_or_not_run}} |
+| Object-type validation    | `eai types validate`                                                                                              | {{result_or_not_run}} |
+| Object-type publish       | `eai types seed --tenant-key <key> --tenant-id <tenant-id> --format json`                                         | {{result_or_not_run}} |
+| Object-type convergence   | `eai types diff --tenant-key <key> --tenant-id <tenant-id>`                                                       | {{result_or_not_run}} |
+| Resource schema           | `eai resources schema --tenant-id <tenant-id> --format json`                                                      | {{result_or_not_run}} |
+| Storage status            | `eai resources storage status --tenant-id <tenant-id> --format json`                                              | {{result_or_not_run}} |
+| Storage doctor            | `eai resources storage doctor --tenant-id <tenant-id> --format json`                                              | {{result_or_not_run}} |
+| Storage verify            | `eai verify storage --tenant-id <tenant-id>`                                                                      | {{result_or_not_run}} |
+| Resource call verify      | `eai verify calls --tenant-id <tenant-id> --resource-type <resource-type>`                                        | {{result_or_not_run}} |
+| Workflow readiness check  | `eai workflow readiness --format json`                                                                            | {{result_or_not_run}} |
+| Block catalog check       | `eai blocks list --format json`                                                                                   | {{result_or_not_run}} |
+| Block readiness check     | `eai blocks readiness --package-profile {{profile}} --format json`                                                | {{result_or_not_run}} |
+
+## Template Markers
+
+| Marker                           | Present |
+| -------------------------------- | ------- | ---- |
+| `src/eai.config/object-types.ts` | {{yes   | no}} |
+| `src/eai.config/register.ts`     | {{yes   | no}} |
+| `.env.example`                   | {{yes   | no}} |
+| `.npmrc`                         | {{yes   | no}} |
+| `package.json`                   | {{yes   | no}} |
+
+## Decisions
+
+| Decision              | Value                | Rationale          |
+| --------------------- | -------------------- | ------------------ | --------------------- | ------------------- | ------------------------------------- | ---------- |
+| Initialize template   | {{yes                | no                 | deferred}}            | {{reason}}          |
+| App directory         | {{current_repo       | new_sibling        | existing_eai_app}}    | {{reason}}          |
+| Company tenant        | {{selected           | blocked            | deferred}}            | {{safe label only}} |
+| Child tenant boundary | {{none               | required           | deferred}}            | {{reason}}          |
+| Package profile       | {{external           | internal           | hybrid                | deferred}}          | {{reason}}                            |
+| App enrollment        | {{existing           | create_confirmed   | confirmation_required | blocked             | deferred}}                            | {{reason}} |
+| Entra callback URI    | {{not_required       | confirmed          | blocked               | deferred}}          | {{exact callback URI or safe reason}} |
+| App stack             | {{eai_platform_azure | approved_exception | blocked}}             | {{reason}}          |
+
+## Execution Order And Gate Tracking
+
+| Field                          | Value                                                                                                                                                                                                                                                                                               |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | --------------------- |
+| Planned execution order        | {{template_init -> dependency_install -> login -> tenant_select -> app_list_or_create -> app_select -> app_provision -> entra_provision -> env_pull_if_needed -> types_validate -> types_seed -> types_diff -> resources_schema -> storage_status_doctor_verify -> verify_calls -> preview_or_dev}} |
+| Last completed gate            | {{safe_status_label}}                                                                                                                                                                                                                                                                               |
+| Blocked gate                   | {{safe_status_label_or_none}}                                                                                                                                                                                                                                                                       |
+| Next recovery command          | {{command_or_none}}                                                                                                                                                                                                                                                                                 |
+| Known error matched            | {{none                                                                                                                                                                                                                                                                                              | EAI_ENTRA_REDIRECT_URI_MISMATCH | other_catalog_error}} |
+| Preview/doc URL readiness      | {{not_ready                                                                                                                                                                                                                                                                                         | ready                           | deferred}}            |
+| Repo-owned fallback references | {{.specify/references/platform/eai-repo-contract.md + eai-error-catalog.yaml}}                                                                                                                                                                                                                      |
+
+## App Stack Policy
+
+For app delivery, Gofer builds on EAI Platform first, including the EAI app
+template, and Azure second. Use the EAI app template, CLI, PublicAPI, object
+types, workflows, block catalog, ResourceAPI/resource schema, tenant/app
+enrollment, provisioning, diagnostics, and Azure-compatible
+deployment/supporting services before any non-EAI exception. Record Firebase,
+Supabase, Vercel primary runtime, AWS, GCP, bespoke backend, unmanaged database,
+or unrelated SaaS usage only as an approved integration/migration/exception with
+rationale, owner, expiry, and validation evidence.
+
+## Next Action
+
+{{continue_discovery|install_eai|login_required|tenant_access_required|initialize_template|confirm_app_enrollment|entra_redirect_recovery|stop_non_eai}}
+
+## Recovery Rules
+
+- If `eai types seed` fails with an app-resources/provisioning error, return to
+  `eai app provision <key> --tenant-id <tenant-id> --select --format json` and
+  keep `Object-type publish` blocked.
+- If `eai resources schema`, storage endpoints, app endpoints, or preview URLs
+  return `503` or equivalent readiness failures, run
+  `eai resources storage status --tenant-id <tenant-id> --format json`,
+  `eai resources storage doctor --tenant-id <tenant-id> --format json`, and
+  `eai verify storage --tenant-id <tenant-id>` before claiming schema or preview
+  readiness.
+- If v4 passive ResourceAPI search reports `resource_search_embedding_required`,
+  `search_embedding_required`, or missing vector embedding readiness, inspect
+  `capabilities.search` from storage doctor. Use full-text search when
+  `fulltext` is ready and reserve hybrid/vector search for tenants where storage
+  doctor reports those modes ready. Do not apply this fallback to legacy v1/v3
+  or active ResourceAPI behavior.
+- Do not claim provisioning, seeding, schema readiness, or preview readiness as
+  equivalent states. Record each gate separately.
+
+## Privacy Guardrail
+
+Do not record access tokens, refresh tokens, secrets, full `.env.local` values,
+private tenant payloads, or private platform topology in this artifact.

package/resources/gofer/templates/goal-ledger-template.json

@@ -0,0 +1,69 @@
+{
+  "schemaVersion": 1,
+  "featureId": "{{feature-id}}",
+  "featureName": "{{feature-name}}",
+  "status": "draft",
+  "lastRebaselineAt": "{{ISO-timestamp}}",
+  "objectiveConfidence": "medium",
+  "goals": [
+    {
+      "id": "G1",
+      "goal": "{{business-outcome}}",
+      "metric": "{{primary-metric}}",
+      "target": "{{target-threshold}}",
+      "owner": "{{owner}}",
+      "status": "proposed",
+      "confidence": "medium",
+      "lastChangedAt": "{{ISO-timestamp}}",
+      "trace": {
+        "stories": ["US1"],
+        "requirements": ["FR-001", "SC-001"],
+        "tasks": ["T001"],
+        "code": ["src/example.ts"],
+        "tests": ["tests/example.test.ts"]
+      }
+    }
+  ],
+  "deliveryStates": [
+    {
+      "capability": "{{capability-name}}",
+      "currentState": "mock",
+      "targetState": "live",
+      "owner": "{{owner}}",
+      "promotionCriteria": ["{{criterion-1}}"],
+      "blockedBy": []
+    }
+  ],
+  "assumptionDrift": [
+    {
+      "assumptionId": "A1",
+      "owner": "{{owner}}",
+      "expiresAt": "{{ISO-timestamp}}",
+      "revalidateTrigger": "{{trigger}}",
+      "reopenStage": "2_specify"
+    }
+  ],
+  "reloopTriggers": [
+    {
+      "id": "R1",
+      "label": "Goal ledger moved after spec approval",
+      "watch": ["goal-ledger.json"],
+      "baselineArtifact": "spec.md",
+      "reopenStage": "2_specify"
+    },
+    {
+      "id": "R2",
+      "label": "Spec or contract drift after planning",
+      "watch": ["spec.md", "contract-pack.md", "contracts"],
+      "baselineArtifact": "tasks.md",
+      "reopenStage": "4_tasks"
+    },
+    {
+      "id": "R3",
+      "label": "UX or implementation changed after validation",
+      "watch": ["ui-preview-brief.md", "ui-approval.md", "src", "tests"],
+      "baselineArtifact": "validation-report.md",
+      "reopenStage": "6_validate"
+    }
+  ]
+}

package/resources/gofer/templates/gofer-model-policy.yaml

@@ -0,0 +1,97 @@
+# Gofer model policy
+#
+# This file is copied to .specify/memory/gofer-model-policy.yaml on bootstrap.
+# Edit the memory copy in each repo to tune cost, quality, and account-specific
+# model availability. Generated Gofer commands reference the memory copy; do not
+# hand-edit generated command files for model routing.
+#
+# Last verified against public provider docs: 2026-05-30.
+version: 1
+lastVerified: "2026-05-30"
+profile: balanced
+
+principles:
+  - Use the cheapest capable model first for repetitive scouting, extraction, and summarization.
+  - Use the default workhorse model for normal implementation, synthesis, and validation.
+  - Use the best available model for security, architecture, release-critical review, or repeated failure.
+  - Use provider prompt/context caching only for stable, non-secret prefixes.
+  - Compact or checkpoint after large research, planning, implementation, and validation bursts.
+
+contextPolicy:
+  healthyBelowPercent: 40
+  summarizeAtPercent: 55
+  compactAtPercent: 70
+  checkpointAtPercent: 85
+  durableArtifact: .specify/specs/{feature}/context-bundle.md
+
+surfaces:
+  claude:
+    simple:
+      model: claude-haiku-4-5
+      claudeCodeAlias: haiku
+      contextWindowTokens: 200000
+      useFor: scouting, extraction, summarization, low-risk helpers
+    medium:
+      model: claude-sonnet-4-6
+      claudeCodeAlias: sonnet
+      contextWindowTokens: 1000000
+      useFor: default implementation, synthesis, validation, everyday coding
+    hard:
+      model: claude-opus-4-8
+      claudeCodeAlias: opus
+      contextWindowTokens: 1000000
+      useFor: hardest bugs, security review, architecture arbitration, release-critical validation
+  codex:
+    simple:
+      model: gpt-5.4-mini
+      reasoningEffort: low
+      contextWindowTokens: 400000
+      useFor: simple coding, focused edits, routine test fixes
+    mechanical:
+      model: gpt-5.4-nano
+      reasoningEffort: low
+      contextWindowTokens: 400000
+      useFor: locate, classify, summarize, transform text
+    medium:
+      model: gpt-5.4
+      reasoningEffort: medium
+      contextWindowTokens: 1000000
+      useFor: default planning, implementation, research synthesis
+    hard:
+      model: gpt-5.3-codex
+      reasoningEffort: high
+      contextWindowTokens: 400000
+      useFor: agentic terminal coding, tool-heavy debugging, code review
+    arbiter:
+      model: gpt-5.5
+      reasoningEffort: high
+      contextWindowTokens: 1050000
+      useFor: broad frontier reasoning, complex architecture, final arbitration
+  gemini:
+    simple:
+      model: gemini-3.1-flash-lite
+      contextWindowTokens: 1000000
+      useFor: cheap large-context scans, summarization, extraction
+    medium:
+      model: gemini-3-flash-preview
+      contextWindowTokens: 1000000
+      useFor: default research and broad synthesis when cost matters
+    hard:
+      model: gemini-3.1-pro-preview
+      contextWindowTokens: 1000000
+      useFor: large-context architecture, cross-repo reasoning, high-risk research
+    highThroughputCoding:
+      model: gemini-3.5-flash
+      contextWindowTokens: 1000000
+      useFor: fast tool/coding workflows when account pricing makes it worthwhile
+  copilot:
+    simple:
+      model: Auto
+      useFor: default Copilot Chat, routine coding, completion, and quick fixes
+    medium:
+      model: Auto
+      useFor: normal Gofer stage prompts and workspace questions
+    hard:
+      model: "Best available in picker: GPT-5.3-Codex, GPT-5.5, Claude Opus, or Gemini Pro"
+      useFor: explicit hard review, security, architecture, or release gates
+    note: Copilot model availability depends on plan, organization policy, client, and feature surface.

package/resources/gofer/templates/issues-template.md

@@ -0,0 +1,106 @@
+---
+description: 'GitHub issues template - ready to convert to actual GitHub issues'
+---
+
+# GitHub Issues: [FEATURE NAME]
+
+**Generated from**: tasks.md **Feature ID**: [###-feature-name] **Total
+Issues**: [COUNT]
+
+This file contains GitHub-ready issue definitions for each task. Each issue
+follows the Requirements Ticket template from enterpriseaigroup/Issues2025.
+
+---
+
+## Issue #1: [Task ID] - [Task Title]
+
+**Labels**: `enhancement`, `phase-1-setup`, `[story-label]` **Assignees**:
+@MikeNowosadko **Title**: [Feature]: [Task Description]
+
+### Screen described (Mike)
+
+[Description of the UI/functionality this task creates or modifies. If
+backend-only, describe the API/service behavior.]
+
+### Business Rationale
+
+**Problem**: [What problem does this task solve?]
+
+**Value**: [What value does completing this task provide?]
+
+**Impact**: [How does this contribute to the overall feature goal?]
+
+**Priority**: [P1/P2/P3] - [Reason for priority level]
+
+### Fields required (Mike)
+
+| Field        | Type                        | Source                      | Validation         |
+| ------------ | --------------------------- | --------------------------- | ------------------ |
+| [field-name] | [string/number/boolean/etc] | [where the data comes from] | [validation rules] |
+
+[If no fields: "N/A - This is a backend/infrastructure task"]
+
+### Acceptance Criteria
+
+- [ ] [Specific testable condition 1]
+- [ ] [Specific testable condition 2]
+- [ ] [Specific testable condition 3]
+
+### Data needed (Mike)
+
+[What data entities, sources, and APIs does this task require?]
+
+**Entities**: [Entity name and description]
+
+**Sources**: [System/API name and what data it provides]
+
+### Integrations Needed (Team)
+
+[External or internal systems this task must integrate with]
+
+[If no integrations: "N/A - Standalone implementation"]
+
+### Navigation (Mike)
+
+[How users reach this functionality, or how this code is accessed]
+
+### Blocks needed (Team)
+
+**New Components**: [List components to build]
+
+**Reusable Components**: [List components to reuse]
+
+### Definition of Ready
+
+- [ ] Mock up screen signed off (Mike)
+- [ ] Business Content (Mike)
+- [ ] Screen Understood by Dev team (Mike, Gareth & Team)
+- [ ] Requirements Documented: Data (Mike & Team)
+- [ ] Requirements Documented: Integrations (Mike & Team)
+- [ ] Requirements Documented: Navigation (Mike & Team)
+- [ ] Requirements Documented: Fields (Mike & Team)
+- [ ] Requirements Documented: Blocks (Mike & Team)
+- [ ] Dependencies Identified
+- [ ] AC Agreed
+- [ ] Identify if we can re-use components (Doug)
+- [ ] Effort is sized and prioritised
+
+### Definition of Done
+
+- [ ] Functional: Works as described in acceptance criteria
+- [ ] Documented: Architecture changes and implementation documented
+- [ ] Demonstrated: Can show it working
+- [ ] Stable: No critical bugs
+- [ ] Reviewed: PO confirmed
+
+**File Path**: `[file-path-from-task]` **Estimated Effort**: [S/M/L or hours]
+
+---
+
+## Notes
+
+- This template is auto-populated by: `.specify/scripts/node/generate-issues.js`
+- Run after creating tasks.md:
+  `node .specify/scripts/node/generate-issues.js <feature-dir>`
+- All issues follow the enterprise Requirements Ticket template
+- See tasks.md for complete task definitions