sinapse-ai 1.15.0 → 1.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/.claude/hooks/doc-first-gate.cjs +156 -0
  2. package/.claude/hooks/enforce-story-gate.cjs +6 -2
  3. package/.claude/rules/hook-governance.md +1 -0
  4. package/.sinapse-ai/constitution.md +1 -1
  5. package/.sinapse-ai/core/atlas/atlas-data.js +278 -0
  6. package/.sinapse-ai/core/atlas/flows-pt.js +253 -0
  7. package/.sinapse-ai/core/atlas/flows.js +266 -0
  8. package/.sinapse-ai/core/atlas/index.js +62 -0
  9. package/.sinapse-ai/core/atlas/render-html.js +216 -0
  10. package/.sinapse-ai/core/atlas/render-markdown.js +313 -0
  11. package/.sinapse-ai/core/atlas/render-research-card.js +164 -0
  12. package/.sinapse-ai/core/orchestration/build-command.js +136 -0
  13. package/.sinapse-ai/core/orchestration/doc-first-resolver.js +322 -0
  14. package/.sinapse-ai/core/orchestration/route-command.js +97 -0
  15. package/.sinapse-ai/data/entity-registry.yaml +113 -16
  16. package/.sinapse-ai/development/agents/snps-orqx.md +9 -0
  17. package/.sinapse-ai/development/tasks/create-doc.md +1 -1
  18. package/.sinapse-ai/development/tasks/create-next-story.md +2 -3
  19. package/.sinapse-ai/development/tasks/spec-analyze.md +460 -0
  20. package/.sinapse-ai/development/tasks/spec-clarify.md +374 -0
  21. package/.sinapse-ai/development/tasks/spec-gather-requirements.md +11 -0
  22. package/.sinapse-ai/development/templates/approval-table.md +106 -0
  23. package/.sinapse-ai/development/workflows/spec-pipeline.yaml +122 -7
  24. package/.sinapse-ai/install-manifest.yaml +70 -18
  25. package/.sinapse-ai/product/templates/prd-tmpl.yaml +6 -2
  26. package/.sinapse-ai/product/templates/spec-tmpl.md +18 -0
  27. package/AGENTS.md +1 -1
  28. package/CHANGELOG.md +18 -3
  29. package/bin/sinapse.js +121 -0
  30. package/docs/framework/atlas/OPERATING-ATLAS.md +537 -0
  31. package/docs/framework/atlas/README.md +34 -0
  32. package/docs/framework/atlas/atlas-data.json +2810 -0
  33. package/docs/framework/atlas/atlas.html +392 -0
  34. package/package.json +1 -1
  35. package/packages/installer/src/wizard/ide-config-generator.js +6 -0
  36. package/scripts/install-chrome-brain.sh +2 -2
  37. package/scripts/validate-no-personal-leaks.js +24 -9
  38. package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +2 -2
  39. package/docs/guides/hooks-two-layers.md +0 -66
@@ -4,8 +4,10 @@ workflow:
4
4
  version: "1.0"
5
5
  description: >-
6
6
  Pipeline completo que transforma requisitos informais em especificações
7
- executáveis. Orquestra 5 fases: Gather → Assess → Research → Write → Critique.
8
- Adapta as fases baseado na complexidade do requisito.
7
+ executáveis. Orquestra as fases: Gather → Assess → Research → Write → Clarify →
8
+ Critique → Plan → Analyze. Adapta as fases baseado na complexidade do requisito.
9
+ Clarify desambigua a spec antes do QA gate; Analyze faz a consistência cruzada
10
+ (read-only) antes da implementação.
9
11
 
10
12
  Part of the Auto-Claude ADE (Autonomous Development Engine) infrastructure.
11
13
 
@@ -51,11 +53,21 @@ workflow:
51
53
  action: run_phase
52
54
  phase: spec
53
55
 
56
+ - event: command
57
+ command: "*clarify-spec"
58
+ action: run_phase
59
+ phase: clarify
60
+
54
61
  - event: command
55
62
  command: "*critique-spec"
56
63
  action: run_phase
57
64
  phase: critique
58
65
 
66
+ - event: command
67
+ command: "*analyze-spec"
68
+ action: run_phase
69
+ phase: analyze
70
+
59
71
  # ═══════════════════════════════════════════════════════════════════════════════════
60
72
  # CONFIGURATION
61
73
  # ═══════════════════════════════════════════════════════════════════════════════════
@@ -86,15 +98,17 @@ workflow:
86
98
 
87
99
  phases:
88
100
  # SIMPLE: Minimal pipeline for straightforward tasks
101
+ # Includes clarify (cheap, avoids rework) but skips analyze.
89
102
  SIMPLE:
90
103
  description: "Tarefa direta, padrões existentes"
91
104
  steps:
92
105
  - gather
93
106
  - spec
107
+ - clarify
94
108
  - critique
95
109
  estimated_time: "30-60 min"
96
110
 
97
- # STANDARD: Full pipeline for moderate complexity
111
+ # STANDARD: Full pipeline for moderate complexity (clarify + analyze)
98
112
  STANDARD:
99
113
  description: "Complexidade moderada, alguma pesquisa necessária"
100
114
  steps:
@@ -102,11 +116,13 @@ workflow:
102
116
  - assess
103
117
  - research
104
118
  - spec
119
+ - clarify
105
120
  - critique
106
121
  - plan
122
+ - analyze
107
123
  estimated_time: "2-4 hours"
108
124
 
109
- # COMPLEX: Extended pipeline with revision loop
125
+ # COMPLEX: Extended pipeline with revision loop (clarify + analyze)
110
126
  COMPLEX:
111
127
  description: "Alta complexidade, múltiplas iterações"
112
128
  steps:
@@ -114,10 +130,12 @@ workflow:
114
130
  - assess
115
131
  - research
116
132
  - spec
133
+ - clarify
117
134
  - critique_1
118
135
  - revise
119
136
  - critique_2
120
137
  - plan
138
+ - analyze
121
139
  estimated_time: "4-8 hours"
122
140
  flags:
123
141
  - "Architectural review recommended"
@@ -190,6 +208,7 @@ workflow:
190
208
 
191
209
  on_success:
192
210
  log: "✅ Requirements gathered: {requirements.functional.length} FR, {requirements.nonFunctional.length} NFR"
211
+ present_table: ".sinapse-ai/development/templates/approval-table.md" # Render FR/NFR/CON as scannable approval tables, not just the count
193
212
  next: assess
194
213
 
195
214
  on_failure:
@@ -293,12 +312,54 @@ workflow:
293
312
 
294
313
  on_success:
295
314
  log: "📝 Specification written: docs/stories/{storyId}/spec/spec.md"
296
- next: critique
315
+ next: clarify
297
316
 
298
317
  on_failure:
299
318
  action: halt
300
319
  error: "Failed to write specification"
301
320
 
321
+ # ═════════════════════════════════════════════════════════════════════════════════
322
+ # PHASE 4b: CLARIFY SPECIFICATION
323
+ # ═════════════════════════════════════════════════════════════════════════════════
324
+
325
+ - step: clarify
326
+ phase: "4b"
327
+ phase_name: "Clarify Specification"
328
+ agent: pm
329
+
330
+ description: >-
331
+ Interactive ambiguity resolution BEFORE the QA gate. Scans the spec across a
332
+ 9-category coverage taxonomy, asks at most 5 questions (one at a time, guided by
333
+ Impact × Uncertainty), and integrates each answer atomically into spec.md
334
+ (## Clarifications section). Reduces costly downstream rework.
335
+
336
+ task: spec-clarify.md
337
+
338
+ inputs:
339
+ storyId: "{storyId}"
340
+ spec: "docs/stories/{storyId}/spec/spec.md"
341
+ requirements: "docs/stories/{storyId}/spec/requirements.json"
342
+
343
+ outputs:
344
+ - spec.md (updated)
345
+
346
+ elicit: true # Requires user interaction
347
+
348
+ gate: true # Order gate: complete BEFORE plan
349
+ blocking: false # Skippable with explicit rework-risk warning
350
+
351
+ on_success:
352
+ log: "💬 Clarification complete: {clarify.questionsAsked} questions resolved"
353
+ next: critique
354
+
355
+ on_skip:
356
+ log: "⚠️ Clarification skipped - downstream rework risk increases"
357
+ next: critique
358
+
359
+ on_failure:
360
+ action: continue
361
+ fallback: "Proceed to critique; flag open ambiguities as risks"
362
+
302
363
  # ═════════════════════════════════════════════════════════════════════════════════
303
364
  # PHASE 5: CRITIQUE SPECIFICATION
304
365
  # ═════════════════════════════════════════════════════════════════════════════════
@@ -435,7 +496,50 @@ workflow:
435
496
 
436
497
  on_success:
437
498
  log: "📋 Implementation plan created"
438
- complete: true
499
+ next: analyze
500
+
501
+ # ═════════════════════════════════════════════════════════════════════════════════
502
+ # PHASE 7: ANALYZE CROSS-CONSISTENCY (final, READ-ONLY)
503
+ # ═════════════════════════════════════════════════════════════════════════════════
504
+
505
+ - step: analyze
506
+ phase: 7
507
+ phase_name: "Analyze Cross-Consistency"
508
+ agent: qa
509
+
510
+ description: >-
511
+ READ-ONLY cross-consistency gate. Cross-references spec ↔ plan ↔ tasks ↔ constitution
512
+ in 6 detection passes (Duplication, Ambiguity, Underspecification, Constitution Alignment,
513
+ Coverage Gaps, Inconsistency) and emits a findings table + coverage metrics. Does not
514
+ modify any file. CRITICAL findings (any constitution conflict) block implementation.
515
+
516
+ condition: "complexity.result !== 'SIMPLE'" # SIMPLE skips analyze
517
+
518
+ task: spec-analyze.md
519
+
520
+ inputs:
521
+ storyId: "{storyId}"
522
+ spec: "docs/stories/{storyId}/spec/spec.md"
523
+ plan: "docs/stories/{storyId}/spec/plan.json"
524
+ tasks: "docs/stories/{storyId}/spec/tasks.md"
525
+ constitution: ".sinapse-ai/constitution.md"
526
+
527
+ outputs:
528
+ - analyze-report.json
529
+
530
+ gate: true # Blocking gate
531
+ read_only: true # Never mutates artifacts
532
+
533
+ on_verdict:
534
+ PASS:
535
+ log: "✅ Analyze PASS (coverage: {analyze.metrics.coveragePct}%, 0 CRITICAL)"
536
+ action: continue
537
+ complete: true
538
+
539
+ BLOCKED:
540
+ log: "🛑 Analyze BLOCKED: {analyze.metrics.criticalCount} CRITICAL finding(s)"
541
+ action: halt
542
+ escalate_to: "@architect"
439
543
 
440
544
  # ═══════════════════════════════════════════════════════════════════════════════════
441
545
  # WORKFLOW COMPLETION
@@ -458,6 +562,7 @@ workflow:
458
562
  • docs/stories/{storyId}/spec/research.json
459
563
  • docs/stories/{storyId}/spec/spec.md
460
564
  • docs/stories/{storyId}/spec/critique.json
565
+ • docs/stories/{storyId}/spec/analyze-report.json
461
566
 
462
567
  📌 Next Steps:
463
568
  • Review spec.md
@@ -470,11 +575,13 @@ workflow:
470
575
  - research.json
471
576
  - spec.md
472
577
  - critique.json
578
+ - analyze-report.json
473
579
 
474
580
  next_steps:
475
581
  - "Review specification: docs/stories/{storyId}/spec/spec.md"
476
582
  - "Start development: @developer *develop {storyId}"
477
583
  - "View critique: docs/stories/{storyId}/spec/critique.json"
584
+ - "View analyze report: docs/stories/{storyId}/spec/analyze-report.json"
478
585
 
479
586
  # ═══════════════════════════════════════════════════════════════════════════════════
480
587
  # ERROR HANDLING
@@ -519,15 +626,21 @@ workflow:
519
626
  state: research_complete
520
627
  - after: spec
521
628
  state: spec_written
629
+ - after: clarify
630
+ state: clarification_complete
522
631
  - after: critique
523
632
  state: critique_complete
633
+ - after: plan
634
+ state: plan_complete
524
635
 
525
636
  resume_from:
526
637
  requirements_gathered: assess
527
638
  complexity_assessed: research
528
639
  research_complete: spec
529
- spec_written: critique
640
+ spec_written: clarify
641
+ clarification_complete: critique
530
642
  critique_complete: plan
643
+ plan_complete: analyze
531
644
 
532
645
  # ═══════════════════════════════════════════════════════════════════════════════════
533
646
  # INTEGRATION
@@ -568,7 +681,9 @@ workflow:
568
681
  - spec-assess-complexity.md
569
682
  - spec-research-dependencies.md
570
683
  - spec-write-spec.md
684
+ - spec-clarify.md
571
685
  - spec-critique.md
686
+ - spec-analyze.md
572
687
  tags:
573
688
  - spec-pipeline
574
689
  - workflow
@@ -7,9 +7,9 @@
7
7
  # - SHA256 hashes for change detection
8
8
  # - File types for categorization
9
9
  #
10
- version: 1.15.0
10
+ version: 1.17.0
11
11
  generator: scripts/generate-install-manifest.js
12
- file_count: 1150
12
+ file_count: 1163
13
13
  files:
14
14
  - path: cli/commands/config/index.js
15
15
  hash: sha256:bfa83cb1dc111b0b30dd298dc0abc2150b73f939b6cd4458effa8e6d407bc9e2
@@ -195,6 +195,34 @@ files:
195
195
  hash: sha256:e3da197727d22d7b95f31cf288faa7810f4806dcc8e448163c154ec9c0755c64
196
196
  type: config
197
197
  size: 12646
198
+ - path: core/atlas/atlas-data.js
199
+ hash: sha256:ab6ef91bd2de1498dbe3892a80b5f18d67624db1fb2da74b0e53f83de902f383
200
+ type: core
201
+ size: 11444
202
+ - path: core/atlas/flows-pt.js
203
+ hash: sha256:8db1cd79a9b3abbbf666162405bc59b8bf1e81c523d7a2709434d91118f1d5e0
204
+ type: core
205
+ size: 11499
206
+ - path: core/atlas/flows.js
207
+ hash: sha256:099392b58b9a8e2dfadb7e108949f19420acfde472406a94bd9c21e356615cab
208
+ type: core
209
+ size: 11033
210
+ - path: core/atlas/index.js
211
+ hash: sha256:ea1e47887854cf348cf29c99c6e5d6218d4e6e709db14a6caa0b289303200363
212
+ type: core
213
+ size: 2028
214
+ - path: core/atlas/render-html.js
215
+ hash: sha256:d84e928fbaa7f20f4c253758af3af486805683b66027d38d682cc453a5f68a0c
216
+ type: core
217
+ size: 11656
218
+ - path: core/atlas/render-markdown.js
219
+ hash: sha256:6d379f52785f81a697ed7e7e4a673564492f58fd79ef9a915e22331a3fdde23a
220
+ type: core
221
+ size: 12076
222
+ - path: core/atlas/render-research-card.js
223
+ hash: sha256:86086e58ea6e3f4a19229f7c755cb4072a8582e8de70e5610c58ea578276204e
224
+ type: core
225
+ size: 6069
198
226
  - path: core/code-intel/code-intel-client.js
199
227
  hash: sha256:65f6c0f2bb639ff3080db3d85660e0b8097e5af7c60dc04f582ef20f42cc9cfc
200
228
  type: core
@@ -915,6 +943,10 @@ files:
915
943
  hash: sha256:8ef9a6d27f9d1d4145fbbfb8657691582aaf0c348278edd638d55fd139edddd4
916
944
  type: core
917
945
  size: 28608
946
+ - path: core/orchestration/build-command.js
947
+ hash: sha256:b758cfc7c0fad3d0d875460630b9ac7b2c968b82cdec14e9885e0744ee7012d0
948
+ type: core
949
+ size: 5236
918
950
  - path: core/orchestration/checklist-runner.js
919
951
  hash: sha256:9bee322fb2572ef81361a3f695b2855f61d610739c612d8b6317cb1b5d6d84c9
920
952
  type: core
@@ -939,6 +971,10 @@ files:
939
971
  hash: sha256:14e91bfefde4f1ee9ecea1e2902bcc43a754719b1572d93f7d2ca357c87c8312
940
972
  type: core
941
973
  size: 10880
974
+ - path: core/orchestration/doc-first-resolver.js
975
+ hash: sha256:92a4170f3ed0b6b214608c80e17c8c6b1769a50b849532af4ae34db070a6931f
976
+ type: core
977
+ size: 14592
942
978
  - path: core/orchestration/epic-context-accumulator.js
943
979
  hash: sha256:9f38c7e3b4de7fbcfeae5fe1dc88aa3f0ae38667f1dc1da025519d40b3b9daa9
944
980
  type: core
@@ -1011,6 +1047,10 @@ files:
1011
1047
  hash: sha256:cfbf41b69336548b2fc4179a5513243491ca6eb501de3426f98254f118b074e7
1012
1048
  type: core
1013
1049
  size: 27167
1050
+ - path: core/orchestration/route-command.js
1051
+ hash: sha256:b7a5aa520936eb819d7b577fd7b15bcee8c7f8e9e147c6fa3db9fd12a493b7f3
1052
+ type: core
1053
+ size: 4766
1014
1054
  - path: core/orchestration/session-state.js
1015
1055
  hash: sha256:e4591fc968e8c2be07cc4572128415f3459eec75d831ba139d69faf9c7d9cacc
1016
1056
  type: core
@@ -1344,9 +1384,9 @@ files:
1344
1384
  type: data
1345
1385
  size: 9602
1346
1386
  - path: data/entity-registry.yaml
1347
- hash: sha256:1754430439419493ac7b1c5a6c3473bfafb08a6f2bdb94826188f3dfcfb86849
1387
+ hash: sha256:9f8ab1fd062c3d4ec2f17f1ce664fbceb5a40f356e4be340b1def175595249de
1348
1388
  type: data
1349
- size: 547841
1389
+ size: 550671
1350
1390
  - path: data/learned-patterns.yaml
1351
1391
  hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
1352
1392
  type: data
@@ -1480,9 +1520,9 @@ files:
1480
1520
  type: agent
1481
1521
  size: 23745
1482
1522
  - path: development/agents/snps-orqx.md
1483
- hash: sha256:313fd53fcb43bec1a0e0e1dc90867c6a6b3643e08a9a41e32e2fa86e090ce8ae
1523
+ hash: sha256:18a195a4484b1b4b76d6a2fe71669b428e87336293a4c5764bc702249083e101
1484
1524
  type: agent
1485
- size: 42694
1525
+ size: 43849
1486
1526
  - path: development/agents/sprint-lead.md
1487
1527
  hash: sha256:572289b770cdbb0cff9ae2de4b2d19c38ce814fe978df397aa2794297f562c91
1488
1528
  type: agent
@@ -1980,13 +2020,13 @@ files:
1980
2020
  type: task
1981
2021
  size: 12499
1982
2022
  - path: development/tasks/create-doc.md
1983
- hash: sha256:86d38d0a9872d7e1e57edb2aa2be1e8a74a9e5ff78b9047ab15bc463fcf1cad6
2023
+ hash: sha256:c59435108b2a016040bafbcf6bbcf1a9ce3502446871ef5a3af908f38602cbfa
1984
2024
  type: task
1985
- size: 10344
2025
+ size: 10669
1986
2026
  - path: development/tasks/create-next-story.md
1987
- hash: sha256:8a42add94bb0e1233d6f47203786ff57ec53bac148be37ec6ac3ca2cb3e5e2b8
2027
+ hash: sha256:5e3d0b592821b1136db7dcfa911ee5080055d76b2f390fe0497e8702b06f330d
1988
2028
  type: task
1989
- size: 30701
2029
+ size: 30945
1990
2030
  - path: development/tasks/create-service.md
1991
2031
  hash: sha256:5ad5920b06934637f8057e53d5acdbb918c71cd7990bfea41177f74b09f82889
1992
2032
  type: task
@@ -2547,18 +2587,26 @@ files:
2547
2587
  hash: sha256:702907ff987ef8db70bc7dba93aadcf40ba9d080321f8305dad7f9e2de10d1b2
2548
2588
  type: task
2549
2589
  size: 18077
2590
+ - path: development/tasks/spec-analyze.md
2591
+ hash: sha256:5a73974cb88ca58274f907416839e8c864a3e35cf832668d3b2c582de3f6b26a
2592
+ type: task
2593
+ size: 11675
2550
2594
  - path: development/tasks/spec-assess-complexity.md
2551
2595
  hash: sha256:7ef9f00dad98113dcf6c273e0d56333aece4fa892c91fff8935d3c3c552748ae
2552
2596
  type: task
2553
2597
  size: 10451
2598
+ - path: development/tasks/spec-clarify.md
2599
+ hash: sha256:e4eee7ea80f146a697433462287aaff138536b148705337f2f32d66d2a83db5c
2600
+ type: task
2601
+ size: 8932
2554
2602
  - path: development/tasks/spec-critique.md
2555
2603
  hash: sha256:7d0243ab61b08e5c70fdd12ead90a2403b7dd3659ce3a68e54f4274b3347b07a
2556
2604
  type: task
2557
2605
  size: 13643
2558
2606
  - path: development/tasks/spec-gather-requirements.md
2559
- hash: sha256:1a1b02926d2fc13d85caf9da0cbc84122cd4ec1e7ec8ec292b4d1cac190c70d3
2607
+ hash: sha256:7ed12b65fca5657d218fbfaa40c0a05af5d3e14a17a332c089dd1147d7cb1ca9
2560
2608
  type: task
2561
- size: 14542
2609
+ size: 15182
2562
2610
  - path: development/tasks/spec-research-dependencies.md
2563
2611
  hash: sha256:28e087134ce19d2c9f3c422604f3414d25bda5f718e0daca7da8c4620f2f62e7
2564
2612
  type: task
@@ -2699,6 +2747,10 @@ files:
2699
2747
  hash: sha256:9887e0f126e9041f70b8809efd0a659a582d08bd2a5fdd14a0e858b84529d76e
2700
2748
  type: template
2701
2749
  size: 1106
2750
+ - path: development/templates/approval-table.md
2751
+ hash: sha256:847bca537a5790ba9e636703cf1e36cb6b3cd9d0b8640cee9689eb1ab136a3b0
2752
+ type: template
2753
+ size: 5172
2702
2754
  - path: development/templates/chrome-brain/knowledge-base/chrome-brain.md
2703
2755
  hash: sha256:4b73f2a5c680aa9260e7c66a0a222a6927a0032784ca803eb309816774a5de84
2704
2756
  type: template
@@ -2988,9 +3040,9 @@ files:
2988
3040
  type: workflow
2989
3041
  size: 2606
2990
3042
  - path: development/workflows/spec-pipeline.yaml
2991
- hash: sha256:890753d02dd6469441fe82a5eba0ecf48a3ac7969cfda3cd888c94cb74695c39
3043
+ hash: sha256:fc739f0f5ec927ed9daecbd0fc74b68017ed548ce445c40b9b1ecd5f1ff2ff4b
2992
3044
  type: workflow
2993
- size: 23746
3045
+ size: 28497
2994
3046
  - path: development/workflows/story-development-cycle.yaml
2995
3047
  hash: sha256:137fc6d2a7aedb50bbebfa045e877c382399604708ce03477f358f282b76727f
2996
3048
  type: workflow
@@ -4152,9 +4204,9 @@ files:
4152
4204
  type: template
4153
4205
  size: 3243
4154
4206
  - path: product/templates/prd-tmpl.yaml
4155
- hash: sha256:cc68f141e09386096f6add62717f63f0b56bb53f315eafcafc4bb649f151d25f
4207
+ hash: sha256:ae365825677131fc9f5c6762c6a4a036be0737442bcbdb04cdbd4e3e3f547265
4156
4208
  type: template
4157
- size: 11954
4209
+ size: 12512
4158
4210
  - path: product/templates/prd-v2.0.hbs
4159
4211
  hash: sha256:efcdadfcd994d02cb04f61de67e4b42156e49b64e9374ad57037e60104297134
4160
4212
  type: template
@@ -4188,9 +4240,9 @@ files:
4188
4240
  type: template
4189
4241
  size: 16666
4190
4242
  - path: product/templates/spec-tmpl.md
4191
- hash: sha256:03a71c8a3758864c3d27e4f0865734d986f4259f64af477d9fa4244f8972c7eb
4243
+ hash: sha256:58207c62ca73c18d9584232bc62ec43ee5f11dc4337d231eee5bf2cc87d15b78
4192
4244
  type: template
4193
- size: 3403
4245
+ size: 4220
4194
4246
  - path: product/templates/state-persistence-tmpl.yaml
4195
4247
  hash: sha256:3f8bb48230df89cf987330f7c9aff19edbc35a65a9cbff799e28480155dd8919
4196
4248
  type: template
@@ -126,7 +126,9 @@ sections:
126
126
  title: Epic List
127
127
  instruction: |
128
128
  Present a high-level list of all epics for user approval. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
129
-
129
+
130
+ PRESENTATION: Render the epic list as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic list schema: `| # | Epic | Goal (1 line) | Stories |`) BEFORE the 1-9 elicitation menu. Do not present epics as a count or plain prose.
131
+
130
132
  CRITICAL: Epics MUST be logically sequential following agile best practices:
131
133
 
132
134
  - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
@@ -147,7 +149,9 @@ sections:
147
149
  repeatable: true
148
150
  instruction: |
149
151
  After the epic list is approved, present each epic with all its stories and acceptance criteria as a complete review unit.
150
-
152
+
153
+ PRESENTATION: For each epic, render its stories as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic detail schema: `| Story | As a … / I want … | ACs | Depends on |`) BEFORE the 1-9 elicitation menu, then the expanded goal and per-story detail.
154
+
151
155
  For each epic provide expanded goal (2-3 sentences describing the objective and value all the stories will achieve).
152
156
 
153
157
  CRITICAL STORY SEQUENCING REQUIREMENTS:
@@ -7,6 +7,11 @@
7
7
 
8
8
  ---
9
9
 
10
+ > **Marking uncertainty:** For any point that is genuinely undefined, inline the marker
11
+ > `[NEEDS CLARIFICATION: <the specific question>]` instead of guessing. Ceiling: **3 markers**.
12
+ > If more than 3 are needed, the spec is too ambiguous to proceed — run the clarify gate
13
+ > (`*clarify-spec {story-id}`) before continuing.
14
+
10
15
  ## 1. Overview
11
16
 
12
17
  ### 1.1 Summary
@@ -63,6 +68,19 @@
63
68
  - {{this}}
64
69
  {{/each}}
65
70
 
71
+ ### 2.5 Success Criteria
72
+
73
+ > Measurable, **technology-agnostic** outcomes — describe the observable result, never the
74
+ > implementation. No tool, framework, or library names here (e.g. "user completes checkout in
75
+ > < 3s", not "Stripe call returns in < 3s").
76
+
77
+ | ID | Success Criterion | How it's measured |
78
+ | ------ | ------------------------------------------ | ----------------- |
79
+
80
+ {{#each success-criteria}}
81
+ | {{id}} | {{criterion}} | {{measure}} |
82
+ {{/each}}
83
+
66
84
  ---
67
85
 
68
86
  ## 3. Technical Approach
package/AGENTS.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # AGENTS.md
2
2
 
3
3
  > SINAPSE AI -- AI-Orchestrated System for Full Stack Development
4
- > 17 squads · 172 agents (all `@`-resolvable in Codex) · 1,410 task files, 1,348 resolvable via the parametric activator
4
+ > 17 squads · 172 agents (all `@`-resolvable in Codex) · 1,412 task files, 1,348 resolvable via the parametric activator
5
5
  >
6
6
  > Codex resolves every agent and its real tasks at runtime from source (no frozen
7
7
  > snapshot): `node .codex/scripts/resolve-codex-agent.js <agent> [command]`.
package/CHANGELOG.md CHANGED
@@ -1,9 +1,24 @@
1
- ## [1.15.0](https://github.com/caioimori/sinapse-ai/compare/1.14.0...1.15.0) (2026-06-24)
1
+ ## [1.17.0](https://github.com/caioimori/sinapse-ai/compare/1.16.0...1.17.0) (2026-06-27)
2
2
 
3
3
  ### Features
4
4
 
5
- * **chrome-brain:** scripts nativos Node, ensure que nao mata janela boa, janela fixa + login ([e1f921b](https://github.com/caioimori/sinapse-ai/commit/e1f921b76627fe9eb2322fa81e35c31dfffe3862))
6
- * **statusline:** selos de identidade de agente + banner de install ([a80a353](https://github.com/caioimori/sinapse-ai/commit/a80a3532eb5143d882872301aad2aadc7e9abe79))
5
+ * **atlas:** complete framework flows 6 12 meta-workflows ([#287](https://github.com/caioimori/sinapse-ai/issues/287)) ([1cfcb21](https://github.com/caioimori/sinapse-ai/commit/1cfcb21343336b287606d2c3c6026dcf5d2ba460))
6
+ * **atlas:** Framework Operating Atlas self-documenting map (LLM + visual) ([#283](https://github.com/caioimori/sinapse-ai/issues/283)) ([d3e3975](https://github.com/caioimori/sinapse-ai/commit/d3e3975f4a814eb6b658eca310cdb50eb43e722b))
7
+ * **atlas:** framework operating flows — visual meta-workflows of how it works ([#284](https://github.com/caioimori/sinapse-ai/issues/284)) ([2dfef2f](https://github.com/caioimori/sinapse-ai/commit/2dfef2fe4e490dfdb6c59487baa519a94d8e72ae))
8
+ * **atlas:** PT-BR research card — SINAPSE as a case-study card + LOOPS ([#288](https://github.com/caioimori/sinapse-ai/issues/288)) ([834e4f7](https://github.com/caioimori/sinapse-ai/commit/834e4f71cf2782d17f7712e50d104f5449994f72))
9
+ * **doc-first:** routing engine + enforcement gate (Camadas 1+2) ([#282](https://github.com/caioimori/sinapse-ai/issues/282)) ([0f69937](https://github.com/caioimori/sinapse-ai/commit/0f69937933849b3262195f3ca478a61bbd0767cc))
10
+ * **doc-first:** scannable approval tables for PRD/epic/story/spec ([#281](https://github.com/caioimori/sinapse-ai/issues/281)) ([87bba5b](https://github.com/caioimori/sinapse-ai/commit/87bba5b1cf06763a01796d8b157b82fc7e2fb536))
11
+ * **orchestration:** sinapse build — reconnect BobOrchestrator engine to CLI ([#286](https://github.com/caioimori/sinapse-ai/issues/286)) ([c36fa09](https://github.com/caioimori/sinapse-ai/commit/c36fa095ba6a440df3d461413b305fc0e844f021))
12
+
13
+ ### Bug Fixes
14
+
15
+ * **atlas:** remove personal-vault leak from public framework + harden guard ([#290](https://github.com/caioimori/sinapse-ai/issues/290)) ([647d16b](https://github.com/caioimori/sinapse-ai/commit/647d16bcd8df0490553412f51a3aa724677adf01))
16
+ * **atlas:** research-card LOOPS headings use the site parser format (MF1 — …) ([#289](https://github.com/caioimori/sinapse-ai/issues/289)) ([8363fcb](https://github.com/caioimori/sinapse-ai/commit/8363fcb0a5523270e2914c51b3e9e906f97142cd))
17
+ * **security:** deep sweep — remove residual personal/client leaks + harden guard ([#291](https://github.com/caioimori/sinapse-ai/issues/291)) ([7e82be9](https://github.com/caioimori/sinapse-ai/commit/7e82be9496b616f24b42c3af8e5f433eb729a1a8))
18
+
19
+ ### Documentation
20
+
21
+ * **orqx:** align Imperator bootstrap prose to doc-first resolver engine ([#285](https://github.com/caioimori/sinapse-ai/issues/285)) ([9f98162](https://github.com/caioimori/sinapse-ai/commit/9f98162b238abf7e4e65c4c6ea91d9bd453aaa1d))
7
22
 
8
23
  # Changelog
9
24