```xml The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml You MUST have already loaded and processed: {installed_path}/workflow.yaml Communicate all responses in {communication_language} This workflow generates a comprehensive Technical Specification from PRD and Architecture, including detailed design, NFRs, acceptance criteria, and traceability mapping. If required inputs cannot be auto-discovered HALT with a clear message listing missing documents, allow user to provide them to proceed. Identify PRD and Architecture documents from recommended_inputs. Attempt to auto-discover at default paths. ask the user for file paths. HALT and wait for docs to proceed with the rest of step 2 Extract {{epic_title}} and {{epic_id}} from PRD. Resolve output file path using workflow variables and initialize by writing the template. MUST read COMPLETE sprint-status.yaml file to find epic status Load the FULL file: {{output_folder}}/sprint-status.yaml Read ALL development_status entries Look for epic key "epic-{{epic_id}}" in development_status Get current status value if epic exists ⚠️ Epic {{epic_id}} not found in sprint-status.yaml This epic hasn't been registered in the sprint plan yet. Run sprint-planning workflow to initialize epic tracking. HALT ℹ️ Epic {{epic_id}} already marked as contexted Continuing to regenerate tech spec... Read COMPLETE PRD and Architecture files. Replace {{overview}} with a concise 1-2 paragraph summary referencing PRD context and goals Replace {{objectives_scope}} with explicit in-scope and out-of-scope bullets Replace {{system_arch_alignment}} with a short alignment summary to the architecture (components referenced, constraints) Derive concrete implementation specifics from Architecture and PRD (CRITICAL: NO invention). Replace {{services_modules}} with a table or bullets listing services/modules with responsibilities, inputs/outputs, and owners Replace {{data_models}} with normalized data model definitions (entities, fields, types, relationships); include schema snippets where available Replace {{apis_interfaces}} with API endpoint specs or interface signatures (method, path, request/response models, error codes) Replace {{workflows_sequencing}} with sequence notes or diagrams-as-text (steps, actors, data flow) Replace {{nfr_performance}} with measurable targets (latency, throughput); link to any performance requirements in PRD/Architecture Replace {{nfr_security}} with authn/z requirements, data handling, threat notes; cite source sections Replace {{nfr_reliability}} with availability, recovery, and degradation behavior Replace {{nfr_observability}} with logging, metrics, tracing requirements; name required signals Scan repository for dependency manifests (e.g., package.json, pyproject.toml, go.mod, Unity Packages/manifest.json). Replace {{dependencies_integrations}} with a structured list of dependencies and integration points with version or commit constraints when known Extract acceptance criteria from PRD; normalize into atomic, testable statements. Replace {{acceptance_criteria}} with a numbered list of testable acceptance criteria Replace {{traceability_mapping}} with a table mapping: AC → Spec Section(s) → Component(s)/API(s) → Test Idea Replace {{risks_assumptions_questions}} with explicit list (each item labeled as Risk/Assumption/Question) with mitigation or next step Replace {{test_strategy}} with a brief plan (test levels, frameworks, coverage of ACs, edge cases) Validate against checklist at {installed_path}/checklist.md using bmad/core/tasks/validate-workflow.xml Load the FULL file: {{output_folder}}/sprint-status.yaml Find development_status key "epic-{{epic_id}}" Verify current status is "backlog" (expected previous state) Update development_status["epic-{{epic_id}}"] = "contexted" Save file, preserving ALL comments and structure including STATUS DEFINITIONS ⚠️ Could not update epic status: epic-{{epic_id}} not found **✅ Tech Spec Generated Successfully, {user_name}!** **Epic Details:** - Epic ID: {{epic_id}} - Epic Title: {{epic_title}} - Tech Spec File: {{default_output_file}} - Epic Status: contexted (was backlog) **Note:** This is a JIT (Just-In-Time) workflow - run again for other epics as needed. **Next Steps:** 1. If more epics need tech specs: Run tech-spec again with different epic_id 2. If all tech specs complete: Proceed to Phase 4 implementation - Load SM agent and run `create-story` to begin implementing stories ```