sinapse-ai 1.14.0 → 1.16.0

package/.sinapse-ai/development/workflows/spec-pipeline.yaml

@@ -4,8 +4,10 @@ workflow:
   version: "1.0"
   description: >-
     Pipeline completo que transforma requisitos informais em especificações
-    executáveis. Orquestra 5 fases: Gather → Assess → Research → Write → Critique.
-    Adapta as fases baseado na complexidade do requisito.
+    executáveis. Orquestra as fases: Gather → Assess → Research → Write → Clarify →
+    Critique → Plan → Analyze. Adapta as fases baseado na complexidade do requisito.
+    Clarify desambigua a spec antes do QA gate; Analyze faz a consistência cruzada
+    (read-only) antes da implementação.
 
     Part of the Auto-Claude ADE (Autonomous Development Engine) infrastructure.
 
@@ -51,11 +53,21 @@ workflow:
       action: run_phase
       phase: spec
 
+    - event: command
+      command: "*clarify-spec"
+      action: run_phase
+      phase: clarify
+
     - event: command
       command: "*critique-spec"
       action: run_phase
       phase: critique
 
+    - event: command
+      command: "*analyze-spec"
+      action: run_phase
+      phase: analyze
+
   # ═══════════════════════════════════════════════════════════════════════════════════
   #                              CONFIGURATION
   # ═══════════════════════════════════════════════════════════════════════════════════
@@ -86,15 +98,17 @@ workflow:
 
   phases:
     # SIMPLE: Minimal pipeline for straightforward tasks
+    # Includes clarify (cheap, avoids rework) but skips analyze.
     SIMPLE:
       description: "Tarefa direta, padrões existentes"
       steps:
         - gather
         - spec
+        - clarify
         - critique
       estimated_time: "30-60 min"
 
-    # STANDARD: Full pipeline for moderate complexity
+    # STANDARD: Full pipeline for moderate complexity (clarify + analyze)
     STANDARD:
       description: "Complexidade moderada, alguma pesquisa necessária"
       steps:
@@ -102,11 +116,13 @@ workflow:
         - assess
         - research
         - spec
+        - clarify
         - critique
         - plan
+        - analyze
       estimated_time: "2-4 hours"
 
-    # COMPLEX: Extended pipeline with revision loop
+    # COMPLEX: Extended pipeline with revision loop (clarify + analyze)
     COMPLEX:
       description: "Alta complexidade, múltiplas iterações"
       steps:
@@ -114,10 +130,12 @@ workflow:
         - assess
         - research
         - spec
+        - clarify
         - critique_1
         - revise
         - critique_2
         - plan
+        - analyze
       estimated_time: "4-8 hours"
       flags:
         - "Architectural review recommended"
@@ -293,12 +311,54 @@ workflow:
 
       on_success:
         log: "📝 Specification written: docs/stories/{storyId}/spec/spec.md"
-        next: critique
+        next: clarify
 
       on_failure:
         action: halt
         error: "Failed to write specification"
 
+    # ═════════════════════════════════════════════════════════════════════════════════
+    # PHASE 4b: CLARIFY SPECIFICATION
+    # ═════════════════════════════════════════════════════════════════════════════════
+
+    - step: clarify
+      phase: "4b"
+      phase_name: "Clarify Specification"
+      agent: pm
+
+      description: >-
+        Interactive ambiguity resolution BEFORE the QA gate. Scans the spec across a
+        9-category coverage taxonomy, asks at most 5 questions (one at a time, guided by
+        Impact × Uncertainty), and integrates each answer atomically into spec.md
+        (## Clarifications section). Reduces costly downstream rework.
+
+      task: spec-clarify.md
+
+      inputs:
+        storyId: "{storyId}"
+        spec: "docs/stories/{storyId}/spec/spec.md"
+        requirements: "docs/stories/{storyId}/spec/requirements.json"
+
+      outputs:
+        - spec.md (updated)
+
+      elicit: true  # Requires user interaction
+
+      gate: true  # Order gate: complete BEFORE plan
+      blocking: false  # Skippable with explicit rework-risk warning
+
+      on_success:
+        log: "💬 Clarification complete: {clarify.questionsAsked} questions resolved"
+        next: critique
+
+      on_skip:
+        log: "⚠️ Clarification skipped - downstream rework risk increases"
+        next: critique
+
+      on_failure:
+        action: continue
+        fallback: "Proceed to critique; flag open ambiguities as risks"
+
     # ═════════════════════════════════════════════════════════════════════════════════
     # PHASE 5: CRITIQUE SPECIFICATION
     # ═════════════════════════════════════════════════════════════════════════════════
@@ -435,7 +495,50 @@ workflow:
 
       on_success:
         log: "📋 Implementation plan created"
-        complete: true
+        next: analyze
+
+    # ═════════════════════════════════════════════════════════════════════════════════
+    # PHASE 7: ANALYZE CROSS-CONSISTENCY (final, READ-ONLY)
+    # ═════════════════════════════════════════════════════════════════════════════════
+
+    - step: analyze
+      phase: 7
+      phase_name: "Analyze Cross-Consistency"
+      agent: qa
+
+      description: >-
+        READ-ONLY cross-consistency gate. Cross-references spec ↔ plan ↔ tasks ↔ constitution
+        in 6 detection passes (Duplication, Ambiguity, Underspecification, Constitution Alignment,
+        Coverage Gaps, Inconsistency) and emits a findings table + coverage metrics. Does not
+        modify any file. CRITICAL findings (any constitution conflict) block implementation.
+
+      condition: "complexity.result !== 'SIMPLE'"  # SIMPLE skips analyze
+
+      task: spec-analyze.md
+
+      inputs:
+        storyId: "{storyId}"
+        spec: "docs/stories/{storyId}/spec/spec.md"
+        plan: "docs/stories/{storyId}/spec/plan.json"
+        tasks: "docs/stories/{storyId}/spec/tasks.md"
+        constitution: ".sinapse-ai/constitution.md"
+
+      outputs:
+        - analyze-report.json
+
+      gate: true  # Blocking gate
+      read_only: true  # Never mutates artifacts
+
+      on_verdict:
+        PASS:
+          log: "✅ Analyze PASS (coverage: {analyze.metrics.coveragePct}%, 0 CRITICAL)"
+          action: continue
+          complete: true
+
+        BLOCKED:
+          log: "🛑 Analyze BLOCKED: {analyze.metrics.criticalCount} CRITICAL finding(s)"
+          action: halt
+          escalate_to: "@architect"
 
   # ═══════════════════════════════════════════════════════════════════════════════════
   #                              WORKFLOW COMPLETION
@@ -458,6 +561,7 @@ workflow:
          • docs/stories/{storyId}/spec/research.json
          • docs/stories/{storyId}/spec/spec.md
          • docs/stories/{storyId}/spec/critique.json
+         • docs/stories/{storyId}/spec/analyze-report.json
 
       📌 Next Steps:
          • Review spec.md
@@ -470,11 +574,13 @@ workflow:
       - research.json
       - spec.md
       - critique.json
+      - analyze-report.json
 
     next_steps:
       - "Review specification: docs/stories/{storyId}/spec/spec.md"
       - "Start development: @developer *develop {storyId}"
       - "View critique: docs/stories/{storyId}/spec/critique.json"
+      - "View analyze report: docs/stories/{storyId}/spec/analyze-report.json"
 
   # ═══════════════════════════════════════════════════════════════════════════════════
   #                              ERROR HANDLING
@@ -519,15 +625,21 @@ workflow:
         state: research_complete
       - after: spec
         state: spec_written
+      - after: clarify
+        state: clarification_complete
       - after: critique
         state: critique_complete
+      - after: plan
+        state: plan_complete
 
     resume_from:
       requirements_gathered: assess
       complexity_assessed: research
       research_complete: spec
-      spec_written: critique
+      spec_written: clarify
+      clarification_complete: critique
       critique_complete: plan
+      plan_complete: analyze
 
   # ═══════════════════════════════════════════════════════════════════════════════════
   #                              INTEGRATION
@@ -568,7 +680,9 @@ workflow:
       - spec-assess-complexity.md
       - spec-research-dependencies.md
       - spec-write-spec.md
+      - spec-clarify.md
       - spec-critique.md
+      - spec-analyze.md
     tags:
       - spec-pipeline
       - workflow

package/.sinapse-ai/install-manifest.yaml

@@ -7,9 +7,9 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.14.0
+version: 1.16.0
 generator: scripts/generate-install-manifest.js
-file_count: 1147
+file_count: 1152
 files:
   - path: cli/commands/config/index.js
     hash: sha256:bfa83cb1dc111b0b30dd298dc0abc2150b73f939b6cd4458effa8e6d407bc9e2
@@ -1344,9 +1344,9 @@ files:
     type: data
     size: 9602
   - path: data/entity-registry.yaml
-    hash: sha256:8b5182998467ccf39613571300eb714e7bdd1f51e0f031582cadaf44fcdf555a
+    hash: sha256:5afcfac2ecfcbda210a85f77a18829c23a0dd80a0be5fc42c5081d419a3ac73b
     type: data
-    size: 547889
+    size: 549348
   - path: data/learned-patterns.yaml
     hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
     type: data
@@ -2547,10 +2547,18 @@ files:
     hash: sha256:702907ff987ef8db70bc7dba93aadcf40ba9d080321f8305dad7f9e2de10d1b2
     type: task
     size: 18077
+  - path: development/tasks/spec-analyze.md
+    hash: sha256:5a73974cb88ca58274f907416839e8c864a3e35cf832668d3b2c582de3f6b26a
+    type: task
+    size: 11675
   - path: development/tasks/spec-assess-complexity.md
     hash: sha256:7ef9f00dad98113dcf6c273e0d56333aece4fa892c91fff8935d3c3c552748ae
     type: task
     size: 10451
+  - path: development/tasks/spec-clarify.md
+    hash: sha256:e4eee7ea80f146a697433462287aaff138536b148705337f2f32d66d2a83db5c
+    type: task
+    size: 8932
   - path: development/tasks/spec-critique.md
     hash: sha256:7d0243ab61b08e5c70fdd12ead90a2403b7dd3659ce3a68e54f4274b3347b07a
     type: task
@@ -2708,9 +2716,13 @@ files:
     type: template
     size: 2048
   - path: development/templates/chrome-brain/rules/chrome-brain-autoload.md
-    hash: sha256:a3079e8e30f252f4a0da766b930bccc15d0288c3012482c0ad4901ccba27bc5d
+    hash: sha256:ff4eb0dfda916b7441e020ff722336c46d87ef47234f08cb2fef009cb5aaa467
+    type: template
+    size: 2540
+  - path: development/templates/chrome-brain/scripts/chrome-brain-log.cjs
+    hash: sha256:baddce09225c16076a67afc0029e89dafcf9dcebbcef39a51c53dd9e63390710
     type: template
-    size: 1944
+    size: 2268
   - path: development/templates/chrome-brain/scripts/chrome-brain-log.sh
     hash: sha256:d72c54d9b67745fac667f1fb05387f11b9bfc55b8bebb64cca67c9a44171d436
     type: template
@@ -2719,6 +2731,10 @@ files:
     hash: sha256:5907538f71757df0954533507e5efac4ebb4c18f92fb93cd305b61fa1c379809
     type: template
     size: 7207
+  - path: development/templates/chrome-brain/scripts/chrome-ensure.cjs
+    hash: sha256:7ff77f28a86fa655e89f292b6b5ebe51a20befb4faf7be99d221b338388472ba
+    type: template
+    size: 3578
   - path: development/templates/chrome-brain/scripts/chrome-ensure.sh
     hash: sha256:eab2018b622c8550381c6d4555f4496595859b98401dff63a3036abf8433ebfa
     type: template
@@ -2980,9 +2996,9 @@ files:
     type: workflow
     size: 2606
   - path: development/workflows/spec-pipeline.yaml
-    hash: sha256:890753d02dd6469441fe82a5eba0ecf48a3ac7969cfda3cd888c94cb74695c39
+    hash: sha256:d0da3844cdf7e71c59a13b22e6c715b23a0ae55337aaa6dfc7248de99bdc6ff4
     type: workflow
-    size: 23746
+    size: 28350
   - path: development/workflows/story-development-cycle.yaml
     hash: sha256:137fc6d2a7aedb50bbebfa045e877c382399604708ce03477f358f282b76727f
     type: workflow
@@ -4180,25 +4196,29 @@ files:
     type: template
     size: 16666
   - path: product/templates/spec-tmpl.md
-    hash: sha256:03a71c8a3758864c3d27e4f0865734d986f4259f64af477d9fa4244f8972c7eb
+    hash: sha256:58207c62ca73c18d9584232bc62ec43ee5f11dc4337d231eee5bf2cc87d15b78
     type: template
-    size: 3403
+    size: 4220
   - path: product/templates/state-persistence-tmpl.yaml
     hash: sha256:3f8bb48230df89cf987330f7c9aff19edbc35a65a9cbff799e28480155dd8919
     type: template
     size: 6764
+  - path: product/templates/statusline/agent-badges.json
+    hash: sha256:9a926dc37107a34880aef351f540f3425f1ec60e77870f7f319980ee53576ead
+    type: template
+    size: 18475
   - path: product/templates/statusline/statusline-script.js
-    hash: sha256:05945437a07c0156ff5bff3238ad8fc71728c591933db64fde94aa219d6f9146
+    hash: sha256:5860eecf6b02701666ff42f858bf25e3524f124210ef70d2b5243b829e893bb8
     type: template
-    size: 7530
+    size: 8748
   - path: product/templates/statusline/track-agent-clear.cjs
     hash: sha256:3cda606de2463374e60440ba6cae9ca98e39b782b19c6ae39aa7569a1b211f09
     type: template
     size: 2137
   - path: product/templates/statusline/track-agent.cjs
-    hash: sha256:898d576f257734e9954e8949e5a4685f38167af0dcad986745b411a3b318559e
+    hash: sha256:0194c9a5750ed9e7a11fb5de21060021f64636f21e8b91039543abccaf6a4c86
     type: template
-    size: 6244
+    size: 10990
   - path: product/templates/story-tmpl.yaml
     hash: sha256:43a050de5ef51f53f890fd20f77ac567b297a40597f467b3bc6d00c8193c7fa6
     type: template

package/.sinapse-ai/product/templates/spec-tmpl.md

@@ -7,6 +7,11 @@
 
 ---
 
+> **Marking uncertainty:** For any point that is genuinely undefined, inline the marker
+> `[NEEDS CLARIFICATION: <the specific question>]` instead of guessing. Ceiling: **3 markers**.
+> If more than 3 are needed, the spec is too ambiguous to proceed — run the clarify gate
+> (`*clarify-spec {story-id}`) before continuing.
+
 ## 1. Overview
 
 ### 1.1 Summary
@@ -63,6 +68,19 @@
 - {{this}}
   {{/each}}
 
+### 2.5 Success Criteria
+
+> Measurable, **technology-agnostic** outcomes — describe the observable result, never the
+> implementation. No tool, framework, or library names here (e.g. "user completes checkout in
+> < 3s", not "Stripe call returns in < 3s").
+
+| ID     | Success Criterion                          | How it's measured |
+| ------ | ------------------------------------------ | ----------------- |
+
+{{#each success-criteria}}
+| {{id}} | {{criterion}} | {{measure}} |
+{{/each}}
+
 ---
 
 ## 3. Technical Approach