sinapse-ai 9.4.0 → 9.5.0

package/.sinapse-ai/product/templates/prd.hbs

@@ -1,202 +1,202 @@
----
-template_id: prd
-template_name: Product Requirements Document
-version: 2.0
-variables:
-  - name: title
-    type: string
-    required: true
-    prompt: "Product/Feature title:"
-  - name: version
-    type: string
-    required: true
-    default: "1.0"
-    prompt: "Document version:"
-  - name: status
-    type: choice
-    required: true
-    choices: [Draft, In Review, Approved, Deprecated]
-    default: Draft
-  - name: owner
-    type: string
-    required: true
-    prompt: "Product owner name:"
-  - name: stakeholders
-    type: array
-    required: false
-    prompt: "Stakeholders (comma-separated):"
-  - name: problem_statement
-    type: text
-    required: true
-    prompt: "What problem does this solve?"
-  - name: goals
-    type: array
-    required: true
-    prompt: "Product goals (comma-separated):"
----
-
-# {{title}}
-
-**Version:** {{version}}
-**Status:** {{status}}
-**Owner:** {{owner}}
-**Date:** {{formatDate now "YYYY-MM-DD"}}
-
----
-
-## Stakeholders
-
-{{#if stakeholders}}
-{{#each stakeholders}}
-- {{this}}
-{{/each}}
-{{else}}
-_No stakeholders listed._
-{{/if}}
-
----
-
-## Problem Statement
-
-{{problem_statement}}
-
----
-
-## Goals
-
-{{#each goals}}
-- {{this}}
-{{/each}}
-
-{{#if non_goals}}
-## Non-Goals
-
-{{#each non_goals}}
-- {{this}}
-{{/each}}
-{{/if}}
-
----
-
-## User Stories
-
-{{#if user_stories}}
-{{#each user_stories}}
-### {{add @index 1}}. {{this.persona}}
-
-**As a** {{this.persona}},
-**I want** {{this.want}},
-**So that** {{this.so_that}}.
-
-{{#if this.priority}}**Priority:** {{this.priority}}{{/if}}
-
-{{/each}}
-{{else}}
-_User stories to be defined._
-{{/if}}
-
----
-
-## Functional Requirements
-
-{{#if functional_requirements}}
-| ID | Requirement | Priority |
-|----|-------------|----------|
-{{#each functional_requirements}}
-| {{this.id}} | {{this.description}} | {{default this.priority "P1"}} |
-{{/each}}
-
-{{#each functional_requirements}}
-{{#if this.acceptance_criteria}}
-### {{this.id}}: Acceptance Criteria
-
-{{#each this.acceptance_criteria}}
-- [ ] {{this}}
-{{/each}}
-{{/if}}
-{{/each}}
-{{else}}
-_Functional requirements to be defined._
-{{/if}}
-
----
-
-## Non-Functional Requirements
-
-{{#if non_functional_requirements}}
-| Category | Requirement | Metric |
-|----------|-------------|--------|
-{{#each non_functional_requirements}}
-| {{this.category}} | {{this.requirement}} | {{default this.metric "N/A"}} |
-{{/each}}
-{{else}}
-_Non-functional requirements to be defined._
-{{/if}}
-
----
-
-## Success Metrics
-
-{{#if success_metrics}}
-| Metric | Current | Target | Timeline |
-|--------|---------|--------|----------|
-{{#each success_metrics}}
-| {{this.metric}} | {{default this.current "N/A"}} | {{this.target}} | {{default this.timeline "TBD"}} |
-{{/each}}
-{{else}}
-_Success metrics to be defined._
-{{/if}}
-
----
-
-## Milestones
-
-{{#if milestones}}
-{{#each milestones}}
-### {{this.name}}
-
-{{this.description}}
-
-{{#if this.deliverables}}
-**Deliverables:**
-{{#each this.deliverables}}
-- {{this}}
-{{/each}}
-{{/if}}
-
-{{/each}}
-{{else}}
-_Milestones to be defined._
-{{/if}}
-
----
-
-## Risks
-
-{{#if risks}}
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-{{#each risks}}
-| {{this.risk}} | {{default this.impact "Medium"}} | {{default this.mitigation "TBD"}} |
-{{/each}}
-{{else}}
-_No risks identified._
-{{/if}}
-
----
-
-## Open Questions
-
-{{#if open_questions}}
-{{#each open_questions}}
-- [ ] {{this}}
-{{/each}}
-{{else}}
-_No open questions._
-{{/if}}
-
----
-
-**Generated by:** SINAPSE Template Engine v2.0
-**Template Version:** prd-2.0
-
+---
+template_id: prd
+template_name: Product Requirements Document
+version: 2.0
+variables:
+  - name: title
+    type: string
+    required: true
+    prompt: "Product/Feature title:"
+  - name: version
+    type: string
+    required: true
+    default: "1.0"
+    prompt: "Document version:"
+  - name: status
+    type: choice
+    required: true
+    choices: [Draft, In Review, Approved, Deprecated]
+    default: Draft
+  - name: owner
+    type: string
+    required: true
+    prompt: "Product owner name:"
+  - name: stakeholders
+    type: array
+    required: false
+    prompt: "Stakeholders (comma-separated):"
+  - name: problem_statement
+    type: text
+    required: true
+    prompt: "What problem does this solve?"
+  - name: goals
+    type: array
+    required: true
+    prompt: "Product goals (comma-separated):"
+---
+
+# {{title}}
+
+**Version:** {{version}}
+**Status:** {{status}}
+**Owner:** {{owner}}
+**Date:** {{formatDate now "YYYY-MM-DD"}}
+
+---
+
+## Stakeholders
+
+{{#if stakeholders}}
+{{#each stakeholders}}
+- {{this}}
+{{/each}}
+{{else}}
+_No stakeholders listed._
+{{/if}}
+
+---
+
+## Problem Statement
+
+{{problem_statement}}
+
+---
+
+## Goals
+
+{{#each goals}}
+- {{this}}
+{{/each}}
+
+{{#if non_goals}}
+## Non-Goals
+
+{{#each non_goals}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+## User Stories
+
+{{#if user_stories}}
+{{#each user_stories}}
+### {{add @index 1}}. {{this.persona}}
+
+**As a** {{this.persona}},
+**I want** {{this.want}},
+**So that** {{this.so_that}}.
+
+{{#if this.priority}}**Priority:** {{this.priority}}{{/if}}
+
+{{/each}}
+{{else}}
+_User stories to be defined._
+{{/if}}
+
+---
+
+## Functional Requirements
+
+{{#if functional_requirements}}
+| ID | Requirement | Priority |
+|----|-------------|----------|
+{{#each functional_requirements}}
+| {{this.id}} | {{this.description}} | {{default this.priority "P1"}} |
+{{/each}}
+
+{{#each functional_requirements}}
+{{#if this.acceptance_criteria}}
+### {{this.id}}: Acceptance Criteria
+
+{{#each this.acceptance_criteria}}
+- [ ] {{this}}
+{{/each}}
+{{/if}}
+{{/each}}
+{{else}}
+_Functional requirements to be defined._
+{{/if}}
+
+---
+
+## Non-Functional Requirements
+
+{{#if non_functional_requirements}}
+| Category | Requirement | Metric |
+|----------|-------------|--------|
+{{#each non_functional_requirements}}
+| {{this.category}} | {{this.requirement}} | {{default this.metric "N/A"}} |
+{{/each}}
+{{else}}
+_Non-functional requirements to be defined._
+{{/if}}
+
+---
+
+## Success Metrics
+
+{{#if success_metrics}}
+| Metric | Current | Target | Timeline |
+|--------|---------|--------|----------|
+{{#each success_metrics}}
+| {{this.metric}} | {{default this.current "N/A"}} | {{this.target}} | {{default this.timeline "TBD"}} |
+{{/each}}
+{{else}}
+_Success metrics to be defined._
+{{/if}}
+
+---
+
+## Milestones
+
+{{#if milestones}}
+{{#each milestones}}
+### {{this.name}}
+
+{{this.description}}
+
+{{#if this.deliverables}}
+**Deliverables:**
+{{#each this.deliverables}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{else}}
+_Milestones to be defined._
+{{/if}}
+
+---
+
+## Risks
+
+{{#if risks}}
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+{{#each risks}}
+| {{this.risk}} | {{default this.impact "Medium"}} | {{default this.mitigation "TBD"}} |
+{{/each}}
+{{else}}
+_No risks identified._
+{{/if}}
+
+---
+
+## Open Questions
+
+{{#if open_questions}}
+{{#each open_questions}}
+- [ ] {{this}}
+{{/each}}
+{{else}}
+_No open questions._
+{{/if}}
+
+---
+
+**Generated by:** SINAPSE Template Engine v2.0
+**Template Version:** prd-2.0
+

package/.sinapse-ai/product/templates/story-tmpl.yaml

@@ -306,10 +306,69 @@ sections:
       - If known add Relevant Source Tree info that relates to this story
       - If there were important notes from previous story that are relevant to this one, include them here
       - Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
+
+      **Opus 4.7 Optimization — Upfront Spec Block (REQUIRED):**
+      The Dev Notes MUST begin with an "Upfront Spec" structured block (see `upfront-spec` sub-section).
+      This consolidates intent + constraints + AC summary + key file locations at the top of Dev Notes,
+      so the developer agent loads the full problem specification in one read instead of discovering
+      it mid-implementation. Adaptive thinking in Opus 4.7 benefits strongly from upfront specification.
     elicit: true
     owner: scrum-master
     editors: [scrum-master]
     sections:
+      - id: upfront-spec
+        title: Upfront Spec
+        instruction: |
+          **REQUIRED — appears at the TOP of Dev Notes.**
+
+          Consolidate the full problem specification in a single structured block, so the developer
+          agent has everything needed before making the first tool call. This is an Opus 4.7 best
+          practice: upfront specification reduces mid-task re-planning and improves adaptive thinking
+          quality.
+
+          Fill all four fields; do not leave placeholders.
+        template: |
+          **Intent:** {{intent_one_paragraph}}
+
+          **Constraints:**
+          - {{constraint_1}}
+          - {{constraint_2}}
+          - {{constraint_3}}
+
+          **Acceptance Criteria Summary:** {{ac_summary_one_paragraph}}
+
+          **Key Files:**
+          - `{{file_path_1}}` — {{purpose_1}}
+          - `{{file_path_2}}` — {{purpose_2}}
+          - `{{file_path_3}}` — {{purpose_3}}
+        elicit: true
+        owner: scrum-master
+        editors: [scrum-master]
+
+      - id: prompt-hints
+        title: Prompt Hints by Story Type
+        instruction: |
+          **Opus 4.7 Adaptive Thinking Hints (STRUCTURED FIELDS — survive YAML parse).**
+
+          Emit the appropriate hint based on story type classification. These are NOT comments —
+          they are structured fields consumed by the developer agent at story load time to calibrate
+          thinking depth for Opus 4.7's adaptive reasoning.
+
+          Story type classification:
+          - `critical` → migration, security, architecture, data integrity, irreversible operations
+          - `routine` → lint, rename, documentation edits, formatting, trivial refactors
+          - `standard` → feature implementation, bug fix with known cause, test additions (no hint emitted)
+
+          Only ONE hint field is populated per story (critical OR routine). Standard stories omit both.
+        template: |
+          prompt_hint_critical: "Think carefully and step-by-step — this problem is harder than it looks"
+          prompt_hint_routine: "Prioritize responding quickly rather than thinking deeply"
+          story_type_classification: "{{critical|routine|standard}}"
+          active_hint: "{{prompt_hint_critical or prompt_hint_routine or none}}"
+        elicit: false
+        owner: scrum-master
+        editors: [scrum-master]
+
       - id: testing-standards
         title: Testing
         instruction: |