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.
- package/.claude/hooks/doc-first-gate.cjs +156 -0
- package/.claude/hooks/enforce-story-gate.cjs +6 -2
- package/.claude/rules/hook-governance.md +1 -0
- package/.sinapse-ai/constitution.md +1 -1
- package/.sinapse-ai/core/atlas/atlas-data.js +278 -0
- package/.sinapse-ai/core/atlas/flows-pt.js +253 -0
- package/.sinapse-ai/core/atlas/flows.js +266 -0
- package/.sinapse-ai/core/atlas/index.js +62 -0
- package/.sinapse-ai/core/atlas/render-html.js +216 -0
- package/.sinapse-ai/core/atlas/render-markdown.js +313 -0
- package/.sinapse-ai/core/atlas/render-research-card.js +164 -0
- package/.sinapse-ai/core/orchestration/build-command.js +136 -0
- package/.sinapse-ai/core/orchestration/doc-first-resolver.js +322 -0
- package/.sinapse-ai/core/orchestration/route-command.js +97 -0
- package/.sinapse-ai/data/entity-registry.yaml +113 -16
- package/.sinapse-ai/development/agents/snps-orqx.md +9 -0
- package/.sinapse-ai/development/tasks/create-doc.md +1 -1
- package/.sinapse-ai/development/tasks/create-next-story.md +2 -3
- package/.sinapse-ai/development/tasks/spec-analyze.md +460 -0
- package/.sinapse-ai/development/tasks/spec-clarify.md +374 -0
- package/.sinapse-ai/development/tasks/spec-gather-requirements.md +11 -0
- package/.sinapse-ai/development/templates/approval-table.md +106 -0
- package/.sinapse-ai/development/workflows/spec-pipeline.yaml +122 -7
- package/.sinapse-ai/install-manifest.yaml +70 -18
- package/.sinapse-ai/product/templates/prd-tmpl.yaml +6 -2
- package/.sinapse-ai/product/templates/spec-tmpl.md +18 -0
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +18 -3
- package/bin/sinapse.js +121 -0
- package/docs/framework/atlas/OPERATING-ATLAS.md +537 -0
- package/docs/framework/atlas/README.md +34 -0
- package/docs/framework/atlas/atlas-data.json +2810 -0
- package/docs/framework/atlas/atlas.html +392 -0
- package/package.json +1 -1
- package/packages/installer/src/wizard/ide-config-generator.js +6 -0
- package/scripts/install-chrome-brain.sh +2 -2
- package/scripts/validate-no-personal-leaks.js +24 -9
- package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +2 -2
- 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
|
|
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:
|
|
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
|
-
|
|
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:
|
|
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.
|
|
10
|
+
version: 1.17.0
|
|
11
11
|
generator: scripts/generate-install-manifest.js
|
|
12
|
-
file_count:
|
|
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:
|
|
1387
|
+
hash: sha256:9f8ab1fd062c3d4ec2f17f1ce664fbceb5a40f356e4be340b1def175595249de
|
|
1348
1388
|
type: data
|
|
1349
|
-
size:
|
|
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:
|
|
1523
|
+
hash: sha256:18a195a4484b1b4b76d6a2fe71669b428e87336293a4c5764bc702249083e101
|
|
1484
1524
|
type: agent
|
|
1485
|
-
size:
|
|
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:
|
|
2023
|
+
hash: sha256:c59435108b2a016040bafbcf6bbcf1a9ce3502446871ef5a3af908f38602cbfa
|
|
1984
2024
|
type: task
|
|
1985
|
-
size:
|
|
2025
|
+
size: 10669
|
|
1986
2026
|
- path: development/tasks/create-next-story.md
|
|
1987
|
-
hash: sha256:
|
|
2027
|
+
hash: sha256:5e3d0b592821b1136db7dcfa911ee5080055d76b2f390fe0497e8702b06f330d
|
|
1988
2028
|
type: task
|
|
1989
|
-
size:
|
|
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:
|
|
2607
|
+
hash: sha256:7ed12b65fca5657d218fbfaa40c0a05af5d3e14a17a332c089dd1147d7cb1ca9
|
|
2560
2608
|
type: task
|
|
2561
|
-
size:
|
|
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:
|
|
3043
|
+
hash: sha256:fc739f0f5ec927ed9daecbd0fc74b68017ed548ce445c40b9b1ecd5f1ff2ff4b
|
|
2992
3044
|
type: workflow
|
|
2993
|
-
size:
|
|
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:
|
|
4207
|
+
hash: sha256:ae365825677131fc9f5c6762c6a4a036be0737442bcbdb04cdbd4e3e3f547265
|
|
4156
4208
|
type: template
|
|
4157
|
-
size:
|
|
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:
|
|
4243
|
+
hash: sha256:58207c62ca73c18d9584232bc62ec43ee5f11dc4337d231eee5bf2cc87d15b78
|
|
4192
4244
|
type: template
|
|
4193
|
-
size:
|
|
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,
|
|
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.
|
|
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
|
-
* **
|
|
6
|
-
* **
|
|
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
|
|