sinapse-ai 5.0.8 → 6.0.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 (660) hide show
  1. package/.claude/CLAUDE.md +1 -1
  2. package/.claude/rules/agent-authority.md +10 -10
  3. package/.claude/rules/agent-memory-imports.md +4 -4
  4. package/.claude/rules/coderabbit-integration.md +4 -4
  5. package/.claude/rules/ids-principles.md +5 -5
  6. package/.claude/rules/story-lifecycle.md +15 -15
  7. package/.claude/rules/workflow-execution.md +11 -11
  8. package/.sinapse-ai/constitution.md +3 -3
  9. package/.sinapse-ai/core/code-intel/helpers/dev-helper.js +1 -1
  10. package/.sinapse-ai/core/code-intel/helpers/qa-helper.js +1 -1
  11. package/.sinapse-ai/core/code-intel/helpers/story-helper.js +7 -7
  12. package/.sinapse-ai/core/config/config-loader.js +1 -1
  13. package/.sinapse-ai/core/docs/session-update-pattern.md +1 -1
  14. package/.sinapse-ai/core/ids/framework-governor.js +4 -4
  15. package/.sinapse-ai/core/ids/index.js +1 -1
  16. package/.sinapse-ai/core/memory/gotchas-memory.js +1 -1
  17. package/.sinapse-ai/core/orchestration/agent-invoker.js +1 -1
  18. package/.sinapse-ai/core/orchestration/bob-surface-criteria.yaml +2 -2
  19. package/.sinapse-ai/core/orchestration/executor-assignment.js +1 -1
  20. package/.sinapse-ai/core/orchestration/executors/epic-6-executor.js +1 -1
  21. package/.sinapse-ai/core/orchestration/executors/epic-executor.js +1 -1
  22. package/.sinapse-ai/core/orchestration/greenfield-handler.js +4 -4
  23. package/.sinapse-ai/core/orchestration/master-orchestrator.js +1 -1
  24. package/.sinapse-ai/core/orchestration/skill-dispatcher.js +3 -3
  25. package/.sinapse-ai/core/orchestration/workflow-executor.js +1 -1
  26. package/.sinapse-ai/core/quality-gates/layer2-pr-automation.js +3 -3
  27. package/.sinapse-ai/core/quality-gates/layer3-human-review.js +1 -1
  28. package/.sinapse-ai/core/quality-gates/quality-gate-config.yaml +1 -1
  29. package/.sinapse-ai/core/session/context-loader.js +1 -1
  30. package/.sinapse-ai/data/agent-config-requirements.yaml +3 -3
  31. package/.sinapse-ai/data/entity-registry.yaml +2126 -2570
  32. package/.sinapse-ai/data/registry-update-log.jsonl +316 -0
  33. package/.sinapse-ai/data/sinapse-kb.md +13 -13
  34. package/.sinapse-ai/data/tech-presets/csharp.md +2 -2
  35. package/.sinapse-ai/data/tech-presets/go.md +2 -2
  36. package/.sinapse-ai/data/tech-presets/java.md +2 -2
  37. package/.sinapse-ai/data/tech-presets/nextjs-react.md +1 -1
  38. package/.sinapse-ai/data/tech-presets/php.md +2 -2
  39. package/.sinapse-ai/data/tech-presets/rust.md +2 -2
  40. package/.sinapse-ai/data/technical-preferences.md +1 -1
  41. package/.sinapse-ai/data/workflow-chains.yaml +15 -15
  42. package/.sinapse-ai/development/README.md +1 -1
  43. package/.sinapse-ai/development/agent-teams/team-qa-focused.yaml +7 -7
  44. package/.sinapse-ai/development/agents/analyst.md +6 -6
  45. package/.sinapse-ai/development/agents/architect.md +4 -4
  46. package/.sinapse-ai/development/agents/data-engineer.md +2 -2
  47. package/.sinapse-ai/development/agents/{dev.md → developer.md} +7 -7
  48. package/.sinapse-ai/development/agents/devops.md +4 -4
  49. package/.sinapse-ai/development/agents/{po → product-lead}/MEMORY.md +3 -3
  50. package/.sinapse-ai/development/agents/{po.md → product-lead.md} +25 -25
  51. package/.sinapse-ai/development/agents/{pm → project-lead}/MEMORY.md +2 -2
  52. package/.sinapse-ai/development/agents/{pm.md → project-lead.md} +15 -15
  53. package/.sinapse-ai/development/agents/{qa.md → quality-gate.md} +8 -8
  54. package/.sinapse-ai/development/agents/{sinapse-master.md → sinapse-orqx.md} +12 -12
  55. package/.sinapse-ai/development/agents/{sm.md → sprint-lead.md} +18 -18
  56. package/.sinapse-ai/development/agents/squad-creator.md +4 -4
  57. package/.sinapse-ai/development/agents/ux-design-expert.md +2 -2
  58. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +1 -1
  59. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +1 -1
  60. package/.sinapse-ai/development/scripts/agent-config-loader.js +1 -1
  61. package/.sinapse-ai/development/scripts/apply-inline-greeting-all-agents.js +1 -1
  62. package/.sinapse-ai/development/scripts/audit-agent-config.js +2 -2
  63. package/.sinapse-ai/development/scripts/batch-update-agents-session-context.js +1 -1
  64. package/.sinapse-ai/development/scripts/dev-context-loader.js +1 -1
  65. package/.sinapse-ai/development/scripts/populate-entity-registry.js +2 -2
  66. package/.sinapse-ai/development/scripts/test-greeting-system.js +4 -4
  67. package/.sinapse-ai/development/scripts/unified-activation-pipeline.js +2 -2
  68. package/.sinapse-ai/development/scripts/verify-workflow-gaps.js +9 -9
  69. package/.sinapse-ai/development/tasks/analyze-cross-artifact.md +1 -1
  70. package/.sinapse-ai/development/tasks/analyze-project-structure.md +4 -4
  71. package/.sinapse-ai/development/tasks/apply-qa-fixes.md +1 -1
  72. package/.sinapse-ai/development/tasks/architect-analyze-impact.md +1 -1
  73. package/.sinapse-ai/development/tasks/brownfield-create-epic.md +10 -10
  74. package/.sinapse-ai/development/tasks/brownfield-create-story.md +1 -1
  75. package/.sinapse-ai/development/tasks/build-autonomous.md +1 -1
  76. package/.sinapse-ai/development/tasks/cleanup-utilities.md +6 -6
  77. package/.sinapse-ai/development/tasks/create-agent.md +1 -1
  78. package/.sinapse-ai/development/tasks/create-brownfield-story.md +4 -4
  79. package/.sinapse-ai/development/tasks/create-next-story.md +12 -12
  80. package/.sinapse-ai/development/tasks/create-service.md +2 -2
  81. package/.sinapse-ai/development/tasks/create-suite.md +1 -1
  82. package/.sinapse-ai/development/tasks/dev-backlog-debt.md +3 -3
  83. package/.sinapse-ai/development/tasks/dev-develop-story.md +5 -5
  84. package/.sinapse-ai/development/tasks/environment-bootstrap.md +2 -2
  85. package/.sinapse-ai/development/tasks/execute-checklist.md +1 -1
  86. package/.sinapse-ai/development/tasks/execute-epic-plan.md +11 -11
  87. package/.sinapse-ai/development/tasks/extract-patterns.md +2 -2
  88. package/.sinapse-ai/development/tasks/facilitate-brainstorming-session.md +2 -2
  89. package/.sinapse-ai/development/tasks/github-devops-github-pr-automation.md +1 -1
  90. package/.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md +1 -1
  91. package/.sinapse-ai/development/tasks/ids-governor.md +3 -3
  92. package/.sinapse-ai/development/tasks/next.md +2 -2
  93. package/.sinapse-ai/development/tasks/orchestrate-resume.md +1 -1
  94. package/.sinapse-ai/development/tasks/orchestrate-status.md +1 -1
  95. package/.sinapse-ai/development/tasks/orchestrate-stop.md +1 -1
  96. package/.sinapse-ai/development/tasks/orchestrate.md +1 -1
  97. package/.sinapse-ai/development/tasks/patterns.md +2 -2
  98. package/.sinapse-ai/development/tasks/plan-create-context.md +2 -2
  99. package/.sinapse-ai/development/tasks/plan-execute-subtask.md +3 -3
  100. package/.sinapse-ai/development/tasks/po-close-story.md +3 -3
  101. package/.sinapse-ai/development/tasks/project-status.md +2 -2
  102. package/.sinapse-ai/development/tasks/qa-after-creation.md +2 -2
  103. package/.sinapse-ai/development/tasks/qa-backlog-add-followup.md +3 -3
  104. package/.sinapse-ai/development/tasks/qa-create-fix-request.md +8 -8
  105. package/.sinapse-ai/development/tasks/qa-evidence-requirements.md +1 -1
  106. package/.sinapse-ai/development/tasks/qa-false-positive-detection.md +1 -1
  107. package/.sinapse-ai/development/tasks/qa-fix-issues.md +10 -10
  108. package/.sinapse-ai/development/tasks/qa-gate.md +3 -3
  109. package/.sinapse-ai/development/tasks/qa-review-build.md +3 -3
  110. package/.sinapse-ai/development/tasks/qa-review-story.md +2 -2
  111. package/.sinapse-ai/development/tasks/qa-run-tests.md +1 -1
  112. package/.sinapse-ai/development/tasks/run-workflow-engine.md +1 -1
  113. package/.sinapse-ai/development/tasks/run-workflow.md +1 -1
  114. package/.sinapse-ai/development/tasks/security-scan.md +2 -2
  115. package/.sinapse-ai/development/tasks/setup-llm-routing.md +1 -1
  116. package/.sinapse-ai/development/tasks/spec-critique.md +4 -4
  117. package/.sinapse-ai/development/tasks/spec-gather-requirements.md +4 -4
  118. package/.sinapse-ai/development/tasks/spec-write-spec.md +2 -2
  119. package/.sinapse-ai/development/tasks/story-checkpoint.md +3 -3
  120. package/.sinapse-ai/development/tasks/sync-registry-intel.md +1 -1
  121. package/.sinapse-ai/development/tasks/validate-agents.md +1 -1
  122. package/.sinapse-ai/development/tasks/validate-next-story.md +10 -10
  123. package/.sinapse-ai/development/tasks/validate-workflow.md +1 -1
  124. package/.sinapse-ai/development/tasks/verify-subtask.md +2 -2
  125. package/.sinapse-ai/development/templates/code-intel-integration-pattern.md +3 -3
  126. package/.sinapse-ai/development/templates/subagent-step-prompt.md +2 -2
  127. package/.sinapse-ai/development/workflows/README.md +2 -2
  128. package/.sinapse-ai/development/workflows/auto-worktree.yaml +5 -5
  129. package/.sinapse-ai/development/workflows/brownfield-discovery.yaml +11 -11
  130. package/.sinapse-ai/development/workflows/brownfield-fullstack.yaml +6 -6
  131. package/.sinapse-ai/development/workflows/brownfield-service.yaml +5 -5
  132. package/.sinapse-ai/development/workflows/brownfield-ui.yaml +5 -5
  133. package/.sinapse-ai/development/workflows/development-cycle.yaml +10 -10
  134. package/.sinapse-ai/development/workflows/epic-orchestration.yaml +6 -6
  135. package/.sinapse-ai/development/workflows/greenfield-fullstack.yaml +7 -7
  136. package/.sinapse-ai/development/workflows/greenfield-service.yaml +5 -5
  137. package/.sinapse-ai/development/workflows/greenfield-ui.yaml +5 -5
  138. package/.sinapse-ai/development/workflows/qa-loop.yaml +1 -1
  139. package/.sinapse-ai/development/workflows/spec-pipeline.yaml +2 -2
  140. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +1 -1
  141. package/.sinapse-ai/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +2 -2
  142. package/.sinapse-ai/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +1 -1
  143. package/.sinapse-ai/docs/standards/QUALITY-GATES-SPECIFICATION.md +1 -1
  144. package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md +6 -6
  145. package/.sinapse-ai/docs/standards/STANDARDS-INDEX.md +2 -2
  146. package/.sinapse-ai/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +6 -6
  147. package/.sinapse-ai/infrastructure/scripts/config-loader.js +2 -2
  148. package/.sinapse-ai/infrastructure/scripts/gotchas-documenter.js +1 -1
  149. package/.sinapse-ai/infrastructure/scripts/ide-sync/README.md +3 -3
  150. package/.sinapse-ai/infrastructure/scripts/ide-sync/gemini-commands.js +1 -1
  151. package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +2 -2
  152. package/.sinapse-ai/infrastructure/scripts/ide-sync/redirect-generator.js +2 -2
  153. package/.sinapse-ai/infrastructure/scripts/migrate-agent.js +1 -1
  154. package/.sinapse-ai/infrastructure/scripts/performance-tracker.js +2 -2
  155. package/.sinapse-ai/infrastructure/scripts/qa-report-generator.js +1 -1
  156. package/.sinapse-ai/infrastructure/scripts/recovery-tracker.js +1 -1
  157. package/.sinapse-ai/infrastructure/scripts/rollback-manager.js +1 -1
  158. package/.sinapse-ai/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +1 -1
  159. package/.sinapse-ai/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +1 -1
  160. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +1 -1
  161. package/.sinapse-ai/install-manifest.yaml +344 -344
  162. package/.sinapse-ai/monitor/hooks/lib/enrich.py +1 -1
  163. package/.sinapse-ai/product/checklists/self-critique-checklist.md +1 -1
  164. package/.sinapse-ai/product/checklists/story-draft-checklist.md +3 -3
  165. package/.sinapse-ai/product/templates/command-rationalization-matrix.md +3 -3
  166. package/.sinapse-ai/product/templates/design-story-tmpl.yaml +4 -4
  167. package/.sinapse-ai/product/templates/ide-rules/antigravity-rules.md +1 -1
  168. package/.sinapse-ai/product/templates/ide-rules/claude-rules.md +2 -2
  169. package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +6 -6
  170. package/.sinapse-ai/product/templates/ide-rules/cursor-rules.md +1 -1
  171. package/.sinapse-ai/product/templates/personalized-agent-template.md +1 -1
  172. package/.sinapse-ai/product/templates/personalized-task-template.md +1 -1
  173. package/.sinapse-ai/product/templates/personalized-template-file.yaml +1 -1
  174. package/.sinapse-ai/product/templates/personalized-workflow-template.yaml +3 -3
  175. package/.sinapse-ai/product/templates/story-tmpl.yaml +8 -8
  176. package/.sinapse-ai/schemas/README.md +15 -15
  177. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +2 -2
  178. package/.sinapse-ai/user-guide.md +4 -4
  179. package/.sinapse-ai/working-in-the-brownfield.md +3 -3
  180. package/LICENSE +4 -4
  181. package/README.en.md +6 -6
  182. package/README.md +8 -8
  183. package/bin/cli.js +9 -9
  184. package/bin/sinapse.js +17 -0
  185. package/docs/00-shared-activation-pipeline.md +16 -16
  186. package/docs/FEATURE_PROCESS.md +1 -1
  187. package/docs/ORQX-PLAN.md +264 -0
  188. package/docs/core-architecture.md +2 -2
  189. package/docs/en/sinapse-agent-flows/README.md +2 -2
  190. package/docs/en/sinapse-agent-flows/dev-system.md +2 -2
  191. package/docs/en/sinapse-agent-flows/pm-system.md +2 -2
  192. package/docs/en/sinapse-agent-flows/qa-system.md +2 -2
  193. package/docs/en/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +5 -5
  194. package/docs/en/sinapse-agent-flows/sm-system.md +2 -2
  195. package/docs/framework/entity-layer-classification.md +2 -2
  196. package/docs/framework/source-tree.md +17 -17
  197. package/docs/getting-started.md +13 -13
  198. package/docs/guides/IDS-CONCEITOS-EXPLICADOS.md +17 -17
  199. package/docs/guides/MEMORY-INTEGRATION.md +3 -3
  200. package/docs/guides/MEMORY-INTELLIGENCE-SYSTEM.md +4 -4
  201. package/docs/guides/ade-guide.md +25 -25
  202. package/docs/guides/agent-selection-guide.md +36 -36
  203. package/docs/guides/agents/ANALYST-SYSTEM.md +5 -5
  204. package/docs/guides/agents/ARCHITECT-SYSTEM.md +9 -9
  205. package/docs/guides/agents/DATA-ENGINEER-SYSTEM.md +8 -8
  206. package/docs/guides/agents/DEV-SYSTEM.md +27 -27
  207. package/docs/guides/agents/DEVOPS-SYSTEM.md +5 -5
  208. package/docs/guides/agents/PM-SYSTEM.md +24 -24
  209. package/docs/guides/agents/QA-SYSTEM.md +24 -24
  210. package/docs/guides/agents/SINAPSE-MASTER-SYSTEM.md +26 -26
  211. package/docs/guides/agents/SM-SYSTEM.md +31 -31
  212. package/docs/guides/agents/SQUAD-CREATOR-SYSTEM.md +2 -2
  213. package/docs/guides/agents/UX-DESIGN-EXPERT-SYSTEM.md +10 -10
  214. package/docs/guides/agents/traces/00-shared-activation-pipeline.md +16 -16
  215. package/docs/guides/agents/traces/00-shared-activation-pipeline.v1-act8.md +16 -16
  216. package/docs/guides/agents/traces/README.md +20 -20
  217. package/docs/guides/agents/traces/analyst-execution-trace.md +6 -6
  218. package/docs/guides/agents/traces/architect-execution-trace.md +3 -3
  219. package/docs/guides/agents/traces/data-engineer-execution-trace.md +4 -4
  220. package/docs/guides/agents/traces/dev-execution-trace.md +12 -12
  221. package/docs/guides/agents/traces/devops-execution-trace.md +6 -6
  222. package/docs/guides/agents/traces/pm-execution-trace.md +14 -14
  223. package/docs/guides/agents/traces/po-execution-trace.md +17 -17
  224. package/docs/guides/agents/traces/qa-execution-trace.md +15 -15
  225. package/docs/guides/agents/traces/{sinapse-master-execution-trace.md → sinapse-orqx-execution-trace.md} +22 -22
  226. package/docs/guides/agents/traces/sm-execution-trace.md +15 -15
  227. package/docs/guides/agents/traces/squad-creation-execution-trace.md +9 -9
  228. package/docs/guides/agents/traces/ux-design-expert-execution-trace.md +4 -4
  229. package/docs/guides/api-reference.md +27 -27
  230. package/docs/guides/coderabbit/README.md +9 -9
  231. package/docs/guides/contextual-greeting-system-guide.md +5 -5
  232. package/docs/guides/development-setup.md +1 -1
  233. package/docs/guides/project-status-feature.md +2 -2
  234. package/docs/guides/quality-dashboard.md +2 -2
  235. package/docs/guides/quality-gates.md +6 -6
  236. package/docs/guides/template-engine-v2.md +2 -2
  237. package/docs/guides/user-guide.md +13 -13
  238. package/docs/guides/workflows/AUTO-WORKTREE-WORKFLOW.md +3 -3
  239. package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md +6 -6
  240. package/docs/guides/workflows/BROWNFIELD-FULLSTACK-WORKFLOW.md +30 -30
  241. package/docs/guides/workflows/BROWNFIELD-SERVICE-WORKFLOW.md +38 -38
  242. package/docs/guides/workflows/BROWNFIELD-UI-WORKFLOW.md +25 -25
  243. package/docs/guides/workflows/GREENFIELD-FULLSTACK-WORKFLOW.md +37 -37
  244. package/docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md +5 -5
  245. package/docs/guides/workflows/GREENFIELD-UI-WORKFLOW.md +19 -19
  246. package/docs/guides/workflows/QA-LOOP-WORKFLOW.md +13 -13
  247. package/docs/guides/workflows/SINAPSE-COMPLETE-CROSS-REFERENCE-ANALYSIS.md +19 -19
  248. package/docs/guides/workflows/SPEC-PIPELINE-WORKFLOW.md +25 -25
  249. package/docs/guides/workflows/STORY-DEVELOPMENT-CYCLE-WORKFLOW.md +28 -28
  250. package/docs/guides/workflows/WORKFLOW-TASK-AGENT-ANALYSIS.md +94 -94
  251. package/docs/guides/workflows/xref-phase2-templates.md +29 -29
  252. package/docs/guides/workflows/xref-phase3-scripts.md +33 -33
  253. package/docs/guides/workflows/xref-phase4-infra.md +2 -2
  254. package/docs/guides/workflows/xref-phase6-supporting.md +1 -1
  255. package/docs/guides/workflows-guide.md +2 -2
  256. package/docs/installation/faq.md +1 -1
  257. package/docs/installation/troubleshooting.md +2 -2
  258. package/docs/installation/v4-quick-start.md +2 -2
  259. package/docs/prd-cli-graph-dashboard.md +1 -1
  260. package/docs/pt/DOCUMENTATION-ROADMAP.md +1 -1
  261. package/docs/pt/FEATURE_PROCESS.md +1 -1
  262. package/docs/pt/README.md +2 -2
  263. package/docs/pt/agents/archetype-rationale.md +4 -4
  264. package/docs/pt/agents/persona-definitions.md +9 -9
  265. package/docs/pt/architecture/ADE-ARCHITECT-HANDOFF.md +15 -15
  266. package/docs/pt/architecture/ADE-EPIC1-HANDOFF.md +2 -2
  267. package/docs/pt/architecture/ADE-EPIC2-HANDOFF.md +2 -2
  268. package/docs/pt/architecture/ADE-EPIC3-HANDOFF.md +8 -8
  269. package/docs/pt/architecture/ade-architecture.md +4 -4
  270. package/docs/pt/architecture/adr/adr-hcs-health-check-system.md +3 -3
  271. package/docs/pt/architecture/agent-config-audit.md +4 -4
  272. package/docs/pt/architecture/agent-responsibility-matrix.md +20 -20
  273. package/docs/pt/architecture/agent-tool-integration-guide.md +8 -8
  274. package/docs/pt/architecture/contribution-workflow-research.md +1 -1
  275. package/docs/pt/architecture/dashboard-architecture.md +1 -1
  276. package/docs/pt/architecture/hcs-check-specifications.md +1 -1
  277. package/docs/pt/architecture/hcs-execution-modes.md +1 -1
  278. package/docs/pt/architecture/hcs-self-healing-spec.md +1 -1
  279. package/docs/pt/architecture/high-level-architecture.md +1 -1
  280. package/docs/pt/architecture/module-system.md +1 -1
  281. package/docs/pt/architecture/source-tree.md +1 -1
  282. package/docs/pt/architecture/squad-improvement-recommended-approach.md +2 -2
  283. package/docs/pt/architecture/utility-integration-guide.md +2 -2
  284. package/docs/pt/contributing.md +1 -1
  285. package/docs/pt/core-architecture.md +2 -2
  286. package/docs/pt/framework/source-tree.md +1 -1
  287. package/docs/pt/guides/ade-guide.md +25 -25
  288. package/docs/pt/guides/agent-selection-guide.md +36 -36
  289. package/docs/pt/guides/api-reference.md +25 -25
  290. package/docs/pt/guides/contextual-greeting-system-guide.md +5 -5
  291. package/docs/pt/guides/development-setup.md +1 -1
  292. package/docs/pt/guides/project-status-feature.md +2 -2
  293. package/docs/pt/guides/quality-dashboard.md +2 -2
  294. package/docs/pt/guides/quality-gates.md +6 -6
  295. package/docs/pt/guides/template-engine-v2.md +2 -2
  296. package/docs/pt/guides/user-guide.md +8 -8
  297. package/docs/pt/guides/workflows-guide.md +2 -2
  298. package/docs/pt/installation/faq.md +1 -1
  299. package/docs/pt/installation/troubleshooting.md +2 -2
  300. package/docs/pt/installation/v4-quick-start.md +2 -2
  301. package/docs/pt/platforms/antigravity.md +9 -9
  302. package/docs/pt/platforms/cursor.md +15 -15
  303. package/docs/pt/platforms/gemini-cli.md +3 -3
  304. package/docs/pt/roadmap.md +1 -1
  305. package/docs/pt/sinapse-nomenclature-specification.md +15 -15
  306. package/docs/pt/specifications/docs-agent-technical-specification.md +11 -11
  307. package/docs/roadmap.md +1 -1
  308. package/docs/sinapse-agent-flows/README.md +2 -2
  309. package/docs/sinapse-agent-flows/analyst-system.md +5 -5
  310. package/docs/sinapse-agent-flows/architect-system.md +9 -9
  311. package/docs/sinapse-agent-flows/data-engineer-system.md +8 -8
  312. package/docs/sinapse-agent-flows/dev-system.md +27 -27
  313. package/docs/sinapse-agent-flows/devops-system.md +5 -5
  314. package/docs/sinapse-agent-flows/pm-system.md +24 -24
  315. package/docs/sinapse-agent-flows/qa-system.md +24 -24
  316. package/docs/sinapse-agent-flows/{sinapse-master-system.md → sinapse-orqx-system.md} +26 -26
  317. package/docs/sinapse-agent-flows/sm-system.md +31 -31
  318. package/docs/sinapse-agent-flows/squad-creator-system.md +2 -2
  319. package/docs/sinapse-agent-flows/ux-design-expert-system.md +10 -10
  320. package/docs/sinapse-workflows/auto-worktree-workflow.md +3 -3
  321. package/docs/sinapse-workflows/brownfield-discovery-workflow.md +6 -6
  322. package/docs/sinapse-workflows/brownfield-fullstack-workflow.md +30 -30
  323. package/docs/sinapse-workflows/brownfield-service-workflow.md +38 -38
  324. package/docs/sinapse-workflows/brownfield-ui-workflow.md +25 -25
  325. package/docs/sinapse-workflows/greenfield-fullstack-workflow.md +37 -37
  326. package/docs/sinapse-workflows/greenfield-service-workflow.md +5 -5
  327. package/docs/sinapse-workflows/greenfield-ui-workflow.md +19 -19
  328. package/docs/sinapse-workflows/qa-loop-workflow.md +13 -13
  329. package/docs/sinapse-workflows/spec-pipeline-workflow.md +25 -25
  330. package/docs/sinapse-workflows/story-development-cycle-workflow.md +28 -28
  331. package/package.json +1 -1
  332. package/packages/gemini-sinapse-extension/README.md +1 -1
  333. package/packages/gemini-sinapse-extension/commands/lib/agent-launcher.js +1 -1
  334. package/packages/gemini-sinapse-extension/commands/{sinapse-master.js → sinapse-orqx.js} +1 -1
  335. package/packages/gemini-sinapse-extension/extension.json +3 -3
  336. package/packages/gemini-sinapse-extension/gemini-extension.json +3 -3
  337. package/packages/installer/src/config/configure-environment.js +2 -2
  338. package/packages/installer/src/updater/index.js +105 -0
  339. package/packages/installer/src/wizard/feedback.js +38 -30
  340. package/packages/installer/src/wizard/i18n.js +25 -182
  341. package/packages/installer/src/wizard/ide-config-generator.js +1 -1
  342. package/packages/installer/src/wizard/index.js +253 -69
  343. package/packages/installer/src/wizard/questions.js +35 -7
  344. package/packages/installer/tests/unit/artifact-copy-pipeline/artifact-copy-pipeline.test.js +1 -1
  345. package/packages/sinapse-install/README.md +1 -1
  346. package/packages/sinapse-install/src/installer.js +1 -1
  347. package/scripts/package-synapse.js +1 -1
  348. package/sinapse/agents/{sinapse-master.md → sinapse-orqx.md} +16 -16
  349. package/sinapse/knowledge-base/cross-squad-patterns.md +1 -1
  350. package/sinapse/knowledge-base/routing-catalog.md +1 -1
  351. package/sinapse/squad.yaml +1 -1
  352. package/sinapse/tasks/compose-multi-squad-plan.md +2 -2
  353. package/sinapse/tasks/coordinate-cross-squad.md +2 -2
  354. package/sinapse/tasks/diagnose-and-route.md +2 -2
  355. package/sinapse/tasks/onboard-user.md +2 -2
  356. package/sinapse/tasks/resolve-conflict.md +2 -2
  357. package/sinapse/tasks/squad-status-report.md +2 -2
  358. package/sinapse/tasks/strategic-brief.md +3 -3
  359. package/squads/squad-animations/agents/animations-orqx.md +2 -2
  360. package/squads/squad-brand/agents/brand-creative-engineer.md +1 -1
  361. package/squads/squad-brand/agents/brand-motion-vfx.md +1 -1
  362. package/squads/squad-brand/agents/brand-orqx.md +2 -2
  363. package/squads/squad-brand/agents/brand-sonic-designer.md +1 -1
  364. package/squads/squad-brand/agents/brand-system-architect.md +1 -1
  365. package/squads/squad-claude/agents/claude-orqx.md +2 -2
  366. package/squads/squad-cloning/agents/cloning-orqx.md +3 -3
  367. package/squads/squad-commercial/agents/commercial-orqx.md +1 -1
  368. package/squads/squad-commercial/agents/cs-business-auditor.md +1 -1
  369. package/squads/squad-commercial/agents/cs-client-success.md +1 -1
  370. package/squads/squad-commercial/agents/cs-crm-specialist.md +1 -1
  371. package/squads/squad-commercial/agents/cs-funnel-architect.md +1 -1
  372. package/squads/squad-commercial/agents/cs-lead-generation-strategist.md +1 -1
  373. package/squads/squad-commercial/agents/cs-offer-designer.md +1 -1
  374. package/squads/squad-commercial/agents/cs-revops-analyst.md +1 -1
  375. package/squads/squad-commercial/agents/cs-sales-closer.md +1 -1
  376. package/squads/squad-commercial/agents/cs-sales-enablement.md +1 -1
  377. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +1 -1
  378. package/squads/squad-content/agents/content-orqx.md +2 -2
  379. package/squads/squad-content/knowledge-base/ai-leverage-content-framework.md +1 -1
  380. package/squads/squad-copy/agents/copy-strategist.md +3 -3
  381. package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +1 -1
  382. package/squads/squad-council/agents/council-orqx.md +1 -1
  383. package/squads/squad-courses/agents/courses-orqx.md +1 -1
  384. package/squads/squad-cybersecurity/agents/cyber-orqx.md +2 -2
  385. package/squads/squad-design/agents/design-orqx.md +2 -2
  386. package/squads/squad-finance/agents/finance-orqx.md +2 -2
  387. package/squads/squad-growth/agents/growth-orqx.md +2 -2
  388. package/squads/squad-paidmedia/agents/paidmedia-orqx.md +2 -2
  389. package/squads/squad-product/agents/product-orqx.md +2 -2
  390. package/squads/squad-research/agents/research-orqx.md +2 -2
  391. package/squads/squad-research/tasks/create-executive-briefing.md +1 -1
  392. package/squads/squad-research/tasks/create-insight-deck.md +1 -1
  393. package/squads/squad-research/tasks/forecast-industry-trends.md +1 -1
  394. package/squads/squad-research/tasks/generate-actionable-recommendations.md +2 -2
  395. package/squads/squad-research/tasks/run-scenario-planning.md +2 -2
  396. package/squads/squad-research/tasks/synthesize-research-report.md +2 -2
  397. package/squads/squad-research/tasks/track-emerging-technologies.md +1 -1
  398. package/squads/squad-storytelling/agents/storytelling-orqx.md +2 -2
  399. package/docs/es/CHANGELOG.md +0 -117
  400. package/docs/es/DOCUMENTATION-ROADMAP.md +0 -216
  401. package/docs/es/ENVIRONMENT.md +0 -140
  402. package/docs/es/FEATURE_PROCESS.md +0 -99
  403. package/docs/es/GUIDING-PRINCIPLES.md +0 -101
  404. package/docs/es/README.md +0 -134
  405. package/docs/es/agent-reference-guide.md +0 -570
  406. package/docs/es/agents/archetype-rationale.md +0 -566
  407. package/docs/es/agents/persona-definitions.md +0 -501
  408. package/docs/es/api/squads-api.md +0 -753
  409. package/docs/es/architecture/ADE-AGENT-CHANGES.md +0 -469
  410. package/docs/es/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
  411. package/docs/es/architecture/ADE-EPIC1-HANDOFF.md +0 -85
  412. package/docs/es/architecture/ADE-EPIC2-HANDOFF.md +0 -106
  413. package/docs/es/architecture/ADE-EPIC3-HANDOFF.md +0 -327
  414. package/docs/es/architecture/ARCHITECTURE-INDEX.md +0 -188
  415. package/docs/es/architecture/ade-architecture.md +0 -586
  416. package/docs/es/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
  417. package/docs/es/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
  418. package/docs/es/architecture/adr/adr-hcs-health-check-system.md +0 -489
  419. package/docs/es/architecture/adr/adr-isolated-vm-decision.md +0 -70
  420. package/docs/es/architecture/agent-config-audit.md +0 -222
  421. package/docs/es/architecture/agent-responsibility-matrix.md +0 -444
  422. package/docs/es/architecture/agent-tool-integration-guide.md +0 -334
  423. package/docs/es/architecture/ci-cd.md +0 -151
  424. package/docs/es/architecture/coding-standards.md +0 -896
  425. package/docs/es/architecture/contribution-workflow-research.md +0 -376
  426. package/docs/es/architecture/dashboard-architecture.md +0 -926
  427. package/docs/es/architecture/dashboard-realtime.md +0 -1253
  428. package/docs/es/architecture/hcs-check-specifications.md +0 -897
  429. package/docs/es/architecture/hcs-execution-modes.md +0 -519
  430. package/docs/es/architecture/hcs-self-healing-spec.md +0 -695
  431. package/docs/es/architecture/high-level-architecture.md +0 -357
  432. package/docs/es/architecture/introduction.md +0 -21
  433. package/docs/es/architecture/mcp-api-keys-management.md +0 -246
  434. package/docs/es/architecture/mcp-system-diagrams.md +0 -113
  435. package/docs/es/architecture/module-system.md +0 -382
  436. package/docs/es/architecture/multi-repo-strategy.md +0 -390
  437. package/docs/es/architecture/source-tree.md +0 -708
  438. package/docs/es/architecture/squad-improvement-analysis.md +0 -204
  439. package/docs/es/architecture/squad-improvement-recommended-approach.md +0 -390
  440. package/docs/es/architecture/tech-stack.md +0 -806
  441. package/docs/es/architecture/utility-integration-guide.md +0 -358
  442. package/docs/es/community/README-community-snippet-core.md +0 -57
  443. package/docs/es/community/README-community-snippet-mcp.md +0 -49
  444. package/docs/es/community/README-community-snippet-squads.md +0 -40
  445. package/docs/es/community.md +0 -227
  446. package/docs/es/core-architecture.md +0 -229
  447. package/docs/es/docker-mcp-setup.md +0 -426
  448. package/docs/es/framework/README.md +0 -99
  449. package/docs/es/framework/coding-standards.md +0 -892
  450. package/docs/es/framework/source-tree.md +0 -725
  451. package/docs/es/framework/tech-stack.md +0 -802
  452. package/docs/es/getting-started.md +0 -572
  453. package/docs/es/git-workflow-guide.md +0 -995
  454. package/docs/es/guides/README.md +0 -133
  455. package/docs/es/guides/ade-guide.md +0 -452
  456. package/docs/es/guides/agent-selection-guide.md +0 -295
  457. package/docs/es/guides/api-reference.md +0 -899
  458. package/docs/es/guides/build-recovery-guide.md +0 -270
  459. package/docs/es/guides/contextual-greeting-system-guide.md +0 -387
  460. package/docs/es/guides/contributing-squads.md +0 -256
  461. package/docs/es/guides/development-setup.md +0 -1111
  462. package/docs/es/guides/ide-sync-guide.md +0 -194
  463. package/docs/es/guides/installation-troubleshooting.md +0 -327
  464. package/docs/es/guides/llm-routing.md +0 -312
  465. package/docs/es/guides/mcp/desktop-commander.md +0 -368
  466. package/docs/es/guides/mcp/docker-gateway-tutorial.md +0 -336
  467. package/docs/es/guides/mcp-global-setup.md +0 -663
  468. package/docs/es/guides/permission-modes.md +0 -313
  469. package/docs/es/guides/project-status-feature.md +0 -473
  470. package/docs/es/guides/quality-dashboard.md +0 -367
  471. package/docs/es/guides/quality-gates.md +0 -614
  472. package/docs/es/guides/security-hardening.md +0 -1359
  473. package/docs/es/guides/service-discovery.md +0 -524
  474. package/docs/es/guides/squad-examples/README.md +0 -64
  475. package/docs/es/guides/squad-migration.md +0 -356
  476. package/docs/es/guides/squads-guide.md +0 -836
  477. package/docs/es/guides/squads-overview.md +0 -332
  478. package/docs/es/guides/template-engine-v2.md +0 -484
  479. package/docs/es/guides/testing-guide.md +0 -1215
  480. package/docs/es/guides/user-guide.md +0 -452
  481. package/docs/es/guides/workflows-guide.md +0 -400
  482. package/docs/es/how-to-contribute-with-pull-requests.md +0 -160
  483. package/docs/es/ide-integration.md +0 -425
  484. package/docs/es/installation/README.md +0 -108
  485. package/docs/es/installation/faq.md +0 -616
  486. package/docs/es/installation/linux.md +0 -311
  487. package/docs/es/installation/macos.md +0 -189
  488. package/docs/es/installation/troubleshooting.md +0 -735
  489. package/docs/es/installation/v4-quick-start.md +0 -269
  490. package/docs/es/installation/windows.md +0 -342
  491. package/docs/es/meta-agent-commands.md +0 -990
  492. package/docs/es/migration-guide.md +0 -310
  493. package/docs/es/npx-install.md +0 -193
  494. package/docs/es/performance-tuning-guide.md +0 -707
  495. package/docs/es/platforms/README.md +0 -283
  496. package/docs/es/platforms/antigravity.md +0 -510
  497. package/docs/es/platforms/claude-code.md +0 -650
  498. package/docs/es/platforms/cursor.md +0 -635
  499. package/docs/es/platforms/gemini-cli.md +0 -483
  500. package/docs/es/platforms/github-copilot.md +0 -480
  501. package/docs/es/roadmap.md +0 -119
  502. package/docs/es/security-best-practices.md +0 -613
  503. package/docs/es/security.md +0 -124
  504. package/docs/es/sinapse-agent-flows/README.md +0 -190
  505. package/docs/es/sinapse-agent-flows/analyst-system.md +0 -36
  506. package/docs/es/sinapse-agent-flows/architect-system.md +0 -36
  507. package/docs/es/sinapse-agent-flows/data-engineer-system.md +0 -36
  508. package/docs/es/sinapse-agent-flows/dev-system.md +0 -36
  509. package/docs/es/sinapse-agent-flows/devops-system.md +0 -36
  510. package/docs/es/sinapse-agent-flows/pm-system.md +0 -36
  511. package/docs/es/sinapse-agent-flows/qa-system.md +0 -36
  512. package/docs/es/sinapse-agent-flows/sinapse-master-system.md +0 -36
  513. package/docs/es/sinapse-agent-flows/sm-system.md +0 -36
  514. package/docs/es/sinapse-agent-flows/squad-creator-system.md +0 -36
  515. package/docs/es/sinapse-agent-flows/ux-design-expert-system.md +0 -36
  516. package/docs/es/sinapse-nomenclature-specification.md +0 -673
  517. package/docs/es/sinapse-workflows/README.md +0 -247
  518. package/docs/es/sinapse-workflows/auto-worktree-workflow.md +0 -39
  519. package/docs/es/sinapse-workflows/brownfield-discovery-workflow.md +0 -41
  520. package/docs/es/sinapse-workflows/brownfield-fullstack-workflow.md +0 -42
  521. package/docs/es/sinapse-workflows/brownfield-service-workflow.md +0 -43
  522. package/docs/es/sinapse-workflows/brownfield-ui-workflow.md +0 -42
  523. package/docs/es/sinapse-workflows/design-system-build-quality-workflow.md +0 -40
  524. package/docs/es/sinapse-workflows/greenfield-fullstack-workflow.md +0 -44
  525. package/docs/es/sinapse-workflows/greenfield-service-workflow.md +0 -43
  526. package/docs/es/sinapse-workflows/greenfield-ui-workflow.md +0 -43
  527. package/docs/es/sinapse-workflows/qa-loop-workflow.md +0 -39
  528. package/docs/es/sinapse-workflows/spec-pipeline-workflow.md +0 -40
  529. package/docs/es/sinapse-workflows/story-development-cycle-workflow.md +0 -42
  530. package/docs/es/specifications/docs-agent-technical-specification.md +0 -2161
  531. package/docs/es/troubleshooting.md +0 -887
  532. package/docs/es/uninstallation.md +0 -556
  533. package/docs/es/versioning-and-releases.md +0 -146
  534. package/docs/zh/CHANGELOG.md +0 -191
  535. package/docs/zh/ENVIRONMENT.md +0 -136
  536. package/docs/zh/FEATURE_PROCESS.md +0 -92
  537. package/docs/zh/GLOSSARY.md +0 -179
  538. package/docs/zh/GUIDING-PRINCIPLES.md +0 -97
  539. package/docs/zh/README.md +0 -133
  540. package/docs/zh/TRANSLATION-PLAN.md +0 -508
  541. package/docs/zh/agent-reference-guide.md +0 -566
  542. package/docs/zh/agents/archetype-rationale.md +0 -631
  543. package/docs/zh/agents/persona-definitions.md +0 -560
  544. package/docs/zh/api/squads-api.md +0 -753
  545. package/docs/zh/architecture/ADE-ARCHITECT-HANDOFF.md +0 -338
  546. package/docs/zh/architecture/ADE-EPIC1-HANDOFF.md +0 -85
  547. package/docs/zh/architecture/ADE-EPIC2-HANDOFF.md +0 -106
  548. package/docs/zh/architecture/ADE-EPIC3-HANDOFF.md +0 -327
  549. package/docs/zh/architecture/ARCHITECTURE-INDEX.md +0 -190
  550. package/docs/zh/architecture/SINAPSE-VISUAL-OVERVIEW.md +0 -595
  551. package/docs/zh/architecture/ade-architecture.md +0 -474
  552. package/docs/zh/architecture/adr/ADR-COLLAB-1-current-state-audit.md +0 -259
  553. package/docs/zh/architecture/adr/ADR-COLLAB-2-proposed-configuration.md +0 -518
  554. package/docs/zh/architecture/adr/adr-hcs-health-check-system.md +0 -489
  555. package/docs/zh/architecture/adr/adr-isolated-vm-decision.md +0 -70
  556. package/docs/zh/architecture/agent-config-audit.md +0 -220
  557. package/docs/zh/architecture/agent-responsibility-matrix.md +0 -444
  558. package/docs/zh/architecture/agent-tool-integration-guide.md +0 -336
  559. package/docs/zh/architecture/ci-cd.md +0 -151
  560. package/docs/zh/architecture/coding-standards.md +0 -898
  561. package/docs/zh/architecture/command-authority-matrix.md +0 -18
  562. package/docs/zh/architecture/contribution-workflow-research.md +0 -376
  563. package/docs/zh/architecture/dashboard-architecture.md +0 -569
  564. package/docs/zh/architecture/dashboard-realtime.md +0 -415
  565. package/docs/zh/architecture/hcs-check-specifications.md +0 -102
  566. package/docs/zh/architecture/hcs-execution-modes.md +0 -114
  567. package/docs/zh/architecture/hcs-self-healing-spec.md +0 -148
  568. package/docs/zh/architecture/high-level-architecture.md +0 -355
  569. package/docs/zh/architecture/introduction.md +0 -21
  570. package/docs/zh/architecture/mcp-api-keys-management.md +0 -248
  571. package/docs/zh/architecture/mcp-system-diagrams.md +0 -113
  572. package/docs/zh/architecture/module-system.md +0 -382
  573. package/docs/zh/architecture/multi-repo-strategy.md +0 -237
  574. package/docs/zh/architecture/source-tree.md +0 -710
  575. package/docs/zh/architecture/squad-improvement-analysis.md +0 -204
  576. package/docs/zh/architecture/squad-improvement-recommended-approach.md +0 -390
  577. package/docs/zh/architecture/tech-stack.md +0 -808
  578. package/docs/zh/architecture/utility-integration-guide.md +0 -358
  579. package/docs/zh/code-of-conduct.md +0 -113
  580. package/docs/zh/community/README-community-snippet-core.md +0 -57
  581. package/docs/zh/community/README-community-snippet-mcp.md +0 -49
  582. package/docs/zh/community/README-community-snippet-squads.md +0 -40
  583. package/docs/zh/community.md +0 -227
  584. package/docs/zh/contributing.md +0 -581
  585. package/docs/zh/core-architecture.md +0 -229
  586. package/docs/zh/docker-mcp-setup.md +0 -226
  587. package/docs/zh/framework/README.md +0 -97
  588. package/docs/zh/framework/coding-standards.md +0 -886
  589. package/docs/zh/framework/source-tree.md +0 -888
  590. package/docs/zh/framework/tech-stack.md +0 -796
  591. package/docs/zh/getting-started.md +0 -317
  592. package/docs/zh/git-workflow-guide.md +0 -988
  593. package/docs/zh/guides/MEMORY-INTEGRATION.md +0 -497
  594. package/docs/zh/guides/MEMORY-INTELLIGENCE-SYSTEM.md +0 -1083
  595. package/docs/zh/guides/MEMORY-SYSTEM.md +0 -1003
  596. package/docs/zh/guides/README.md +0 -127
  597. package/docs/zh/guides/ade-guide.md +0 -446
  598. package/docs/zh/guides/agent-selection-guide.md +0 -289
  599. package/docs/zh/guides/api-reference.md +0 -427
  600. package/docs/zh/guides/build-recovery-guide.md +0 -266
  601. package/docs/zh/guides/contextual-greeting-system-guide.md +0 -381
  602. package/docs/zh/guides/contributing-squads.md +0 -250
  603. package/docs/zh/guides/development-setup.md +0 -384
  604. package/docs/zh/guides/ide-sync-guide.md +0 -193
  605. package/docs/zh/guides/installation-troubleshooting.md +0 -321
  606. package/docs/zh/guides/llm-routing.md +0 -306
  607. package/docs/zh/guides/mcp/desktop-commander.md +0 -368
  608. package/docs/zh/guides/mcp/docker-gateway-tutorial.md +0 -336
  609. package/docs/zh/guides/mcp-global-setup.md +0 -696
  610. package/docs/zh/guides/permission-modes.md +0 -307
  611. package/docs/zh/guides/project-status-feature.md +0 -467
  612. package/docs/zh/guides/quality-dashboard.md +0 -361
  613. package/docs/zh/guides/quality-gates.md +0 -462
  614. package/docs/zh/guides/security-hardening.md +0 -1055
  615. package/docs/zh/guides/service-discovery.md +0 -518
  616. package/docs/zh/guides/squad-examples/README.md +0 -63
  617. package/docs/zh/guides/squad-migration.md +0 -336
  618. package/docs/zh/guides/template-engine-v2.md +0 -478
  619. package/docs/zh/guides/workflows-guide.md +0 -408
  620. package/docs/zh/how-to-contribute-with-pull-requests.md +0 -158
  621. package/docs/zh/installation/README.md +0 -106
  622. package/docs/zh/installation/faq.md +0 -611
  623. package/docs/zh/installation/linux.md +0 -447
  624. package/docs/zh/installation/macos.md +0 -187
  625. package/docs/zh/installation/troubleshooting.md +0 -729
  626. package/docs/zh/installation/windows.md +0 -475
  627. package/docs/zh/meta-agent-commands.md +0 -990
  628. package/docs/zh/security-best-practices.md +0 -610
  629. package/docs/zh/security.md +0 -124
  630. package/docs/zh/sinapse-agent-flows/README.md +0 -196
  631. package/docs/zh/sinapse-agent-flows/analyst-system.md +0 -679
  632. package/docs/zh/sinapse-agent-flows/architect-system.md +0 -246
  633. package/docs/zh/sinapse-agent-flows/data-engineer-system.md +0 -418
  634. package/docs/zh/sinapse-agent-flows/dev-system.md +0 -209
  635. package/docs/zh/sinapse-agent-flows/devops-system.md +0 -643
  636. package/docs/zh/sinapse-agent-flows/pm-system.md +0 -733
  637. package/docs/zh/sinapse-agent-flows/qa-system.md +0 -268
  638. package/docs/zh/sinapse-agent-flows/sinapse-master-system.md +0 -81
  639. package/docs/zh/sinapse-agent-flows/sm-system.md +0 -501
  640. package/docs/zh/sinapse-agent-flows/squad-creator-system.md +0 -704
  641. package/docs/zh/sinapse-agent-flows/ux-design-expert-system.md +0 -160
  642. package/docs/zh/sinapse-workflows/README.md +0 -247
  643. package/docs/zh/sinapse-workflows/auto-worktree-workflow.md +0 -793
  644. package/docs/zh/sinapse-workflows/brownfield-discovery-workflow.md +0 -915
  645. package/docs/zh/sinapse-workflows/brownfield-fullstack-workflow.md +0 -764
  646. package/docs/zh/sinapse-workflows/brownfield-service-workflow.md +0 -812
  647. package/docs/zh/sinapse-workflows/brownfield-ui-workflow.md +0 -891
  648. package/docs/zh/sinapse-workflows/design-system-build-quality-workflow.md +0 -845
  649. package/docs/zh/sinapse-workflows/greenfield-fullstack-workflow.md +0 -796
  650. package/docs/zh/sinapse-workflows/greenfield-service-workflow.md +0 -786
  651. package/docs/zh/sinapse-workflows/greenfield-ui-workflow.md +0 -922
  652. package/docs/zh/sinapse-workflows/qa-loop-workflow.md +0 -1111
  653. package/docs/zh/sinapse-workflows/spec-pipeline-workflow.md +0 -1031
  654. package/docs/zh/sinapse-workflows/story-development-cycle-workflow.md +0 -843
  655. package/docs/zh/troubleshooting.md +0 -883
  656. package/docs/zh/uninstallation.md +0 -348
  657. package/docs/zh/versioning-and-releases.md +0 -140
  658. /package/.sinapse-ai/development/agents/{dev → developer}/MEMORY.md +0 -0
  659. /package/.sinapse-ai/development/agents/{qa → quality-gate}/MEMORY.md +0 -0
  660. /package/.sinapse-ai/development/agents/{sm → sprint-lead}/MEMORY.md +0 -0
@@ -1,764 +0,0 @@
1
- # 工作流:棕地项目全栈增强
2
-
3
- > **版本:** 1.0.0
4
- > **创建时间:** 2026-02-04
5
- > **类型:** 棕地项目开发
6
- > **状态:** 官方文档
7
- > **源文件:** `.sinapse-ai/development/workflows/brownfield-fullstack.yaml`
8
-
9
- ---
10
-
11
- ## 概述
12
-
13
- **棕地项目全栈增强**工作流设计用于通过新功能、现代化或重大变更来增强现有的全栈应用程序。此工作流处理现有系统的分析和安全集成,确保修改不会破坏已建立的功能。
14
-
15
- ### 何时使用此工作流
16
-
17
- **在以下情况下使用此工作流:**
18
-
19
- - 增强需要协调的故事
20
- - 需要架构更改
21
- - 需要大量集成工作
22
- - 需要评估和风险缓解
23
- - 多个团队成员将从事相关更改
24
-
25
- **支持的项目类型:**
26
-
27
- - `feature-addition` - 添加新功能
28
- - `refactoring` - 重构现有代码
29
- - `modernization` - 现代化技术
30
- - `integration-enhancement` - 增强集成
31
-
32
- ---
33
-
34
- ## 主工作流图
35
-
36
- ```mermaid
37
- flowchart TB
38
- subgraph CLASSIFICATION["1. 增强分类"]
39
- START[("启动:棕地项目增强")] --> ANALYST_CLASSIFY
40
- ANALYST_CLASSIFY["@analyst<br/>分类增强范围"]
41
- end
42
-
43
- ANALYST_CLASSIFY --> DECISION_SIZE{{"增强规模?"}}
44
-
45
- subgraph ROUTING["2. 按大小路由"]
46
- DECISION_SIZE -->|"单个故事<br/>(< 4小时)"| PM_STORY
47
- DECISION_SIZE -->|"小功能<br/>(1-3个故事)"| PM_EPIC
48
- DECISION_SIZE -->|"主要增强<br/>(多个史诗)"| ANALYST_DOCS
49
-
50
- PM_STORY["@pm<br/>brownfield-create-story"]
51
- PM_EPIC["@pm<br/>brownfield-create-epic"]
52
- end
53
-
54
- PM_STORY --> EXIT_STORY[/"输出:开发实现"/]
55
- PM_EPIC --> EXIT_EPIC[/"输出:故事创建"/]
56
-
57
- subgraph DOCUMENTATION["3. 文档验证"]
58
- ANALYST_DOCS["@analyst<br/>验证现有文档"]
59
- ANALYST_DOCS --> DECISION_DOCS{{"文档充分?"}}
60
- DECISION_DOCS -->|否| ARCHITECT_DOCPROJ["@architect<br/>document-project"]
61
- DECISION_DOCS -->|是| PM_PRD["@pm<br/>创建brownfield-prd.md"]
62
- ARCHITECT_DOCPROJ --> PM_PRD
63
- end
64
-
65
- subgraph PLANNING["4. 规划"]
66
- PM_PRD --> DECISION_ARCH{{"架构<br/>变更?"}}
67
- DECISION_ARCH -->|是| ARCHITECT_ARCH["@architect<br/>创建architecture.md"]
68
- DECISION_ARCH -->|否| PO_VALIDATE
69
- ARCHITECT_ARCH --> PO_VALIDATE["@po<br/>验证工件<br/>(po-master-checklist)"]
70
- end
71
-
72
- subgraph VALIDATION["5. 验证和修正"]
73
- PO_VALIDATE --> DECISION_ISSUES{{"PO发现<br/>问题?"}}
74
- DECISION_ISSUES -->|是| FIX_ISSUES["修复问题<br/>(相关代理)"]
75
- FIX_ISSUES --> PO_VALIDATE
76
- DECISION_ISSUES -->|否| PO_SHARD["@po<br/>分片文档"]
77
- end
78
-
79
- subgraph DEVELOPMENT["6. 开发周期"]
80
- PO_SHARD --> SM_STORY["@sm<br/>创建故事"]
81
- SM_STORY --> DECISION_STORY_TYPE{{"文档<br/>类型?"}}
82
- DECISION_STORY_TYPE -->|"PRD分片"| SM_NEXT["create-next-story"]
83
- DECISION_STORY_TYPE -->|"棕地文档"| SM_BROWNFIELD["create-brownfield-story"]
84
- SM_NEXT --> DECISION_REVIEW{{"审查草稿?"}}
85
- SM_BROWNFIELD --> DECISION_REVIEW
86
- DECISION_REVIEW -->|是| REVIEW_APPROVE["审查和批准"]
87
- DECISION_REVIEW -->|否| DEV_IMPLEMENT
88
- REVIEW_APPROVE --> DEV_IMPLEMENT["@dev<br/>实现故事"]
89
- end
90
-
91
- subgraph QA_CYCLE["7. QA周期"]
92
- DEV_IMPLEMENT --> DECISION_QA{{"QA审查?"}}
93
- DECISION_QA -->|是| QA_REVIEW["@qa<br/>审查实现"]
94
- DECISION_QA -->|否| DECISION_MORE_STORIES
95
- QA_REVIEW --> DECISION_QA_ISSUES{{"问题?"}}
96
- DECISION_QA_ISSUES -->|是| DEV_FIX["@dev<br/>修复反馈"]
97
- DECISION_QA_ISSUES -->|否| DECISION_MORE_STORIES
98
- DEV_FIX --> QA_REVIEW
99
- end
100
-
101
- subgraph COMPLETION["8. 完成"]
102
- DECISION_MORE_STORIES{{"更多故事?"}}
103
- DECISION_MORE_STORIES -->|是| SM_STORY
104
- DECISION_MORE_STORIES -->|否| DECISION_RETRO
105
- DECISION_RETRO{{"回顾?"}}
106
- DECISION_RETRO -->|是| PO_RETRO["@po<br/>史诗回顾"]
107
- DECISION_RETRO -->|否| COMPLETE
108
- PO_RETRO --> COMPLETE[("项目完成")]
109
- end
110
-
111
- style START fill:#87CEEB
112
- style COMPLETE fill:#90EE90
113
- style EXIT_STORY fill:#90EE90
114
- style EXIT_EPIC fill:#90EE90
115
- style PM_STORY fill:#87CEEB
116
- style PM_EPIC fill:#87CEEB
117
- style PM_PRD fill:#FFE4B5
118
- style ARCHITECT_ARCH fill:#FFE4B5
119
- style PO_SHARD fill:#ADD8E6
120
- style SM_STORY fill:#ADD8E6
121
- style DEV_IMPLEMENT fill:#ADD8E6
122
- style REVIEW_APPROVE fill:#F0E68C
123
- style QA_REVIEW fill:#F0E68C
124
- style PO_RETRO fill:#F0E68C
125
- ```
126
-
127
- ---
128
-
129
- ## 简化的路由图
130
-
131
- ```mermaid
132
- flowchart LR
133
- subgraph INPUT["输入"]
134
- A["增强请求"]
135
- end
136
-
137
- subgraph CLASSIFICATION["分类"]
138
- B["@analyst<br/>分类范围"]
139
- end
140
-
141
- subgraph ROUTES["路由"]
142
- C1["单个故事<br/>(< 4小时)"]
143
- C2["小功能<br/>(1-3个故事)"]
144
- C3["主要增强<br/>(多个史诗)"]
145
- end
146
-
147
- subgraph OUTPUT["输出"]
148
- D1["brownfield-create-story<br/>@pm"]
149
- D2["brownfield-create-epic<br/>@pm"]
150
- D3["完整工作流<br/>(继续下面)"]
151
- end
152
-
153
- A --> B
154
- B --> C1 --> D1
155
- B --> C2 --> D2
156
- B --> C3 --> D3
157
-
158
- style A fill:#e1f5fe
159
- style D1 fill:#c8e6c9
160
- style D2 fill:#c8e6c9
161
- style D3 fill:#fff3e0
162
- ```
163
-
164
- ---
165
-
166
- ## 详细步骤
167
-
168
- ### 步骤1:增强分类
169
-
170
- | 属性 | 值 |
171
- |------|-----|
172
- | **代理** | @analyst (Atlas) |
173
- | **操作** | 分类增强范围 |
174
- | **输入** | 用户的增强描述 |
175
- | **输出** | 分类:single_story / small_feature / major_enhancement |
176
-
177
- **流程:**
178
-
179
- 分析师确定增强的复杂性以路由到适当的路径。向用户提出的关键问题是:
180
-
181
- > "你能描述增强的范围吗?这是一个小修复、功能添加还是需要架构更改的较大增强?"
182
-
183
- **分类标准:**
184
-
185
- - **单个故事** (< 4小时):使用任务 `brownfield-create-story`
186
- - **小功能** (1-3个故事):使用任务 `brownfield-create-epic`
187
- - **主要增强** (多个史诗):继续完整工作流
188
-
189
- ---
190
-
191
- ### 步骤2:决策路由
192
-
193
- | 路由 | 代理 | 任务 | 下一步操作 |
194
- |------|------|------|----------|
195
- | `single_story` | @pm | `brownfield-create-story` | 创建故事后退出工作流 |
196
- | `small_feature` | @pm | `brownfield-create-epic` | 创建史诗后退出工作流 |
197
- | `major_enhancement` | - | - | 继续下一步 |
198
-
199
- ---
200
-
201
- ### 步骤3:文档验证
202
-
203
- | 属性 | 值 |
204
- |------|-----|
205
- | **代理** | @analyst (Atlas) |
206
- | **操作** | 验证现有文档 |
207
- | **条件** | 仅适用于 `major_enhancement` |
208
- | **输入** | 代码库和现有文档 |
209
- | **输出** | 评估:documentation_adequate / documentation_inadequate |
210
-
211
- **验证清单:**
212
-
213
- - [ ] 架构文档存在吗?
214
- - [ ] API规范是否最新?
215
- - [ ] 代码编码标准是否已记录?
216
- - [ ] 文档是否最新且全面?
217
-
218
- **决策:**
219
-
220
- - **如果充分**:跳过 `document-project`,继续创建PRD
221
- - **如果不充分**:先执行 `document-project`
222
-
223
- ---
224
-
225
- ### 步骤4:项目分析(条件性)
226
-
227
- | 属性 | 值 |
228
- |------|-----|
229
- | **代理** | @architect (Aria) |
230
- | **任务** | `document-project` |
231
- | **条件** | 如果文档不充分,则执行 |
232
- | **输入** | 现有代码库 |
233
- | **输出** | `brownfield-architecture.md` (或多个文档) |
234
-
235
- **目的:**
236
-
237
- 捕获系统的当前状态、技术债务和限制。发现结果将传递给PRD创建。
238
-
239
- **任务文件:** `.sinapse-ai/development/tasks/document-project.md`
240
-
241
- ---
242
-
243
- ### 步骤5:创建棕地项目PRD
244
-
245
- | 属性 | 值 |
246
- |------|-----|
247
- | **代理** | @pm (Morgan) |
248
- | **模板** | `brownfield-prd-tmpl` |
249
- | **要求** | 现有文档或步骤4的分析 |
250
- | **输出** | `docs/prd.md` |
251
-
252
- **说明:**
253
-
254
- - 如果执行了 `document-project`,请参考其输出以避免重新分析
255
- - 如果跳过,请使用项目的现有文档
256
- - **重要**:将最终 `prd.md` 复制到项目的 `docs/` 文件夹
257
-
258
- ---
259
-
260
- ### 步骤6:架构决策
261
-
262
- | 属性 | 值 |
263
- |------|-----|
264
- | **代理** | @pm (Morgan) / @architect (Aria) |
265
- | **操作** | 确定是否需要架构文档 |
266
- | **条件** | 创建PRD后 |
267
-
268
- **创建架构文档的标准:**
269
-
270
- - [ ] 需要新的架构模式
271
- - [ ] 需要采用新的库/框架
272
- - [ ] 平台/基础设施变更
273
- - [ ] 遵循现有模式? -> 跳过创建故事
274
-
275
- ---
276
-
277
- ### 步骤7:创建架构(条件性)
278
-
279
- | 属性 | 值 |
280
- |------|-----|
281
- | **代理** | @architect (Aria) |
282
- | **模板** | `brownfield-architecture-tmpl` |
283
- | **要求** | `prd.md` |
284
- | **条件** | 需要架构变更 |
285
- | **输出** | `docs/architecture.md` |
286
-
287
- **说明:**
288
-
289
- 仅为重大架构更改创建架构文档。
290
-
291
- **重要**:将最终 `architecture.md` 复制到项目的 `docs/` 文件夹
292
-
293
- ---
294
-
295
- ### 步骤8:PO验证
296
-
297
- | 属性 | 值 |
298
- |------|-----|
299
- | **代理** | @po (Pax) |
300
- | **清单** | `po-master-checklist` |
301
- | **输入** | 所有创建的工件 |
302
- | **输出** | 验证或问题列表 |
303
-
304
- **清单文件:** `.sinapse-ai/development/checklists/po-master-checklist.md`
305
-
306
- **流程:**
307
-
308
- 验证所有文档的:
309
- - 集成安全性
310
- - 完整性
311
- - 需求对齐
312
- - 特定的棕地项目风险
313
-
314
- ---
315
-
316
- ### 步骤9:问题修复(条件性)
317
-
318
- | 属性 | 值 |
319
- |------|-----|
320
- | **代理** | 可变(取决于问题) |
321
- | **条件** | PO发现问题 |
322
- | **操作** | 修复并重新导出更新的文档 |
323
-
324
- **流程:**
325
-
326
- 1. PO识别问题
327
- 2. 相关代理修复
328
- 3. 更新的文档保存在 `docs/` 中
329
- 4. 返回进行PO验证
330
-
331
- ---
332
-
333
- ### 步骤10:文档分片
334
-
335
- | 属性 | 值 |
336
- |------|-----|
337
- | **代理** | @po (Pax) |
338
- | **任务** | `shard-doc` |
339
- | **输入** | 项目中验证的文档 |
340
- | **输出** | `docs/prd/` 和 `docs/architecture/` 中的分片内容 |
341
-
342
- **执行选项:**
343
-
344
- - **选项A**:使用PO代理进行分片:`@po` 并要求分片 `docs/prd.md`
345
- - **选项B**:手动:将任务 `shard-doc` + `docs/prd.md` 拖到聊天中
346
-
347
- **任务文件:** `.sinapse-ai/development/tasks/shard-doc.md`
348
-
349
- ---
350
-
351
- ### 步骤11:创建故事
352
-
353
- | 属性 | 值 |
354
- |------|-----|
355
- | **代理** | @sm (River) |
356
- | **重复** | 对于每个史诗或增强 |
357
- | **输入** | 分片的文档或棕地文档 |
358
- | **输出** | `story.md` 处于"草稿"状态 |
359
-
360
- **任务决策:**
361
-
362
- | 文档类型 | 任务 |
363
- |---------|------|
364
- | PRD分片 | `create-next-story` |
365
- | 棕地文档 | `create-brownfield-story` |
366
-
367
- **任务文件:**
368
- - `.sinapse-ai/development/tasks/create-next-story.md`
369
- - `.sinapse-ai/development/tasks/create-brownfield-story.md`
370
-
371
- ---
372
-
373
- ### 步骤12:草稿审查(可选)
374
-
375
- | 属性 | 值 |
376
- |------|-----|
377
- | **代理** | @analyst / @pm |
378
- | **条件** | 用户希望审查故事 |
379
- | **输入** | `story.md` 处于草稿状态 |
380
- | **输出** | 更新的故事:草稿 -> 已批准 |
381
-
382
- **注意**:任务 `story-review` 正在开发中。
383
-
384
- ---
385
-
386
- ### 步骤13:实现
387
-
388
- | 属性 | 值 |
389
- |------|-----|
390
- | **代理** | @dev (Dex) |
391
- | **要求** | 已批准的故事 |
392
- | **输出** | 实现文件 |
393
-
394
- **说明:**
395
-
396
- 1. 开发代理(新聊天会话):`@dev`
397
- 2. 实现已批准的故事
398
- 3. 使用所有更改更新文件列表
399
- 4. 完成时将故事标记为"审查"
400
-
401
- ---
402
-
403
- ### 步骤14:QA审查(可选)
404
-
405
- | 属性 | 值 |
406
- |------|-----|
407
- | **代理** | @qa (Quinn) |
408
- | **任务** | `review-story` |
409
- | **要求** | 实现的文件 |
410
- | **输出** | 审查的实现 |
411
-
412
- **流程:**
413
-
414
- 1. QA代理(新聊天会话):`@qa` -> `review-story`
415
- 2. 具有重构能力的高级开发人员审查
416
- 3. 直接修复小问题
417
- 4. 为剩余项目留下清单
418
- 5. 更新故事状态(审查 -> 完成或保持审查)
419
-
420
- ---
421
-
422
- ### 步骤15:修复QA反馈(条件性)
423
-
424
- | 属性 | 值 |
425
- |------|-----|
426
- | **代理** | @dev (Dex) |
427
- | **条件** | QA留下未检查的项目 |
428
- | **操作** | 处理剩余项目 |
429
-
430
- **流程:**
431
-
432
- 1. 开发代理(新聊天会话):处理剩余项目
433
- 2. 返回QA进行最终批准
434
-
435
- ---
436
-
437
- ### 步骤16:开发周期
438
-
439
- **重复:** SM -> Dev -> QA 周期用于史诗中的所有故事
440
-
441
- 继续进行,直到PRD中的所有故事都完成。
442
-
443
- ---
444
-
445
- ### 步骤17:史诗回顾(可选)
446
-
447
- | 属性 | 值 |
448
- |------|-----|
449
- | **代理** | @po (Pax) |
450
- | **条件** | 史诗完成 |
451
- | **输出** | `epic-retrospective.md` |
452
-
453
- **流程:**
454
-
455
- 1. 验证史诗是否正确完成
456
- 2. 记录学习和改进
457
-
458
- **注意**:任务 `epic-retrospective` 正在开发中。
459
-
460
- ---
461
-
462
- ### 步骤18:工作流结论
463
-
464
- **状态:** 所有故事已实现和审查
465
-
466
- **参考:** `.sinapse-ai/data/sinapse-kb.md#IDE Development Workflow`
467
-
468
- ---
469
-
470
- ## 参与的代理
471
-
472
- | 代理 | 名称 | 工作流中的角色 | 步骤 |
473
- |------|------|--------------|------|
474
- | @analyst | Atlas | 范围分类、文档验证 | 1, 3 |
475
- | @architect | Aria | 项目文档、架构设计 | 4, 6, 7 |
476
- | @pm | Morgan | PRD创建、史诗和简单故事 | 2, 5, 6 |
477
- | @po | Pax | 工件验证、分片、回顾 | 8, 10, 17 |
478
- | @sm | River | 详细故事创建 | 11 |
479
- | @dev | Dex | 故事实现 | 13, 15 |
480
- | @qa | Quinn | 实现审查 | 14 |
481
-
482
- ---
483
-
484
- ## 执行的任务
485
-
486
- | 任务 | 步骤 | 代理 | 目的 |
487
- |------|------|------|------|
488
- | `brownfield-create-story` | 2 | @pm | 为简单增强创建单个故事 |
489
- | `brownfield-create-epic` | 2 | @pm | 创建聚焦的史诗(1-3个故事) |
490
- | `document-project` | 4 | @architect | 记录棕地项目的当前状态 |
491
- | `brownfield-prd-tmpl` | 5 | @pm | 棕地项目PRD的模板 |
492
- | `brownfield-architecture-tmpl` | 7 | @architect | 棕地架构的模板 |
493
- | `po-master-checklist` | 8 | @po | 工件的全面验证 |
494
- | `shard-doc` | 10 | @po | 将文档分割成较小的文件 |
495
- | `create-next-story` | 11 | @sm | 从分片PRD创建故事 |
496
- | `create-brownfield-story` | 11 | @sm | 从棕地文档创建故事 |
497
- | `review-story` | 14 | @qa | 实现审查 |
498
-
499
- ---
500
-
501
- ## 前置条件
502
-
503
- 在开始此工作流之前,请确保:
504
-
505
- ### 环境
506
-
507
- - [ ] 访问现有项目存储库
508
- - [ ] 开发环境已配置
509
- - [ ] 依赖关系已安装
510
-
511
- ### 文档
512
-
513
- - [ ] 对现有系统的基本理解
514
- - [ ] 访问现有文档(如果有)
515
- - [ ] 增强需求清楚
516
-
517
- ### 工具
518
-
519
- - [ ] GitHub CLI已配置 (`gh auth status`)
520
- - [ ] 如适用,可访问PM工具 (ClickUp/GitHub/Jira)
521
- - [ ] SINAPSE核心配置已配置 (`.sinapse-ai/core-config.yaml`)
522
-
523
- ---
524
-
525
- ## 输入和输出
526
-
527
- ### 工作流输入
528
-
529
- | 输入 | 来源 | 格式 | 必需 |
530
- |------|------|------|------|
531
- | 增强请求 | 用户 | 文本描述 | 是 |
532
- | 现有代码库 | 存储库 | 源代码 | 是 |
533
- | 现有文档 | `docs/` | Markdown | 否 |
534
- | 利益相关者需求 | 用户/PM工具 | 文本/工单 | 否 |
535
-
536
- ### 工作流输出
537
-
538
- | 输出 | 目标 | 格式 | 条件 |
539
- |------|------|------|------|
540
- | `brownfield-architecture.md` | `docs/` | Markdown | 如果文档不充分 |
541
- | `prd.md` | `docs/` | Markdown | 主要增强 |
542
- | `architecture.md` | `docs/` | Markdown | 如果架构变更 |
543
- | 分片故事 | `docs/stories/` | Markdown | 总是 |
544
- | 实现的代码 | `src/` | 各种 | 总是 |
545
- | `epic-retrospective.md` | `docs/` | Markdown | 可选 |
546
-
547
- ---
548
-
549
- ## 决策点
550
-
551
- ### 决策1:增强的大小
552
-
553
- ```mermaid
554
- flowchart LR
555
- A[增强请求] --> B{大小?}
556
- B -->|"< 4小时"| C[单个故事]
557
- B -->|"1-3个故事"| D[小功能]
558
- B -->|"多个史诗"| E[主要增强]
559
- C --> F[退出:开发实现]
560
- D --> G[退出:故事创建]
561
- E --> H[继续工作流]
562
- ```
563
-
564
- ### 决策2:文档充分
565
-
566
- ```mermaid
567
- flowchart LR
568
- A[验证文档] --> B{充分?}
569
- B -->|是| C[跳过document-project]
570
- B -->|否| D[执行document-project]
571
- C --> E[创建PRD]
572
- D --> E
573
- ```
574
-
575
- ### 决策3:架构变更
576
-
577
- ```mermaid
578
- flowchart LR
579
- A[审查PRD] --> B{架构变更?}
580
- B -->|新模式| C[创建architecture.md]
581
- B -->|新库| C
582
- B -->|基础设施变更| C
583
- B -->|遵循现有| D[跳过验证]
584
- C --> D
585
- ```
586
-
587
- ### 决策4:PO问题
588
-
589
- ```mermaid
590
- flowchart LR
591
- A[PO验证] --> B{问题?}
592
- B -->|是| C[修复问题]
593
- C --> A
594
- B -->|否| D[继续]
595
- ```
596
-
597
- ### 决策5:QA审查
598
-
599
- ```mermaid
600
- flowchart LR
601
- A[实现] --> B{QA审查?}
602
- B -->|是| C[执行审查]
603
- C --> D{问题?}
604
- D -->|是| E[开发修复]
605
- E --> C
606
- D -->|否| F[下一个故事]
607
- B -->|否| F
608
- ```
609
-
610
- ---
611
-
612
- ## 故障排除
613
-
614
- ### 问题:增强分类不当
615
-
616
- **症状:** 简单工作流用于复杂增强或反之亦然
617
-
618
- **解决方案:**
619
- 1. 暂停当前工作流
620
- 2. 使用 @analyst 重新执行分类
621
- 3. 提供关于集成和复杂性的更多背景
622
-
623
- ### 问题:文档不充分未检测
624
-
625
- **症状:** 未对系统有充分背景的情况下创建PRD
626
-
627
- **解决方案:**
628
- 1. 使用 @architect 手动执行 `document-project`
629
- 2. 使用新发现更新PRD
630
- 3. 使用 @po 重新验证
631
-
632
- ### 问题:PO验证无限循环
633
-
634
- **症状:** 更正后问题仍然出现
635
-
636
- **解决方案:**
637
- 1. 与利益相关者安排同步会议
638
- 2. 记录更清晰的验收标准
639
- 3. 如有必要,考虑减少增强范围
640
-
641
- ### 问题:故事太大
642
-
643
- **症状:** 故事无法在一个会话中完成
644
-
645
- **解决方案:**
646
- 1. 将故事分成多个子故事
647
- 2. 重新评估增强分类
648
- 3. 考虑使用 `brownfield-create-epic` 而不是单个故事
649
-
650
- ### 问题:集成破坏现有功能
651
-
652
- **症状:** 回归测试失败
653
-
654
- **解决方案:**
655
- 1. 审查PRD中的影响分析
656
- 2. 添加更多集成测试
657
- 3. 考虑使用功能标志进行渐进式推出
658
-
659
- ### 问题:QA审查不确定
660
-
661
- **症状:** 问题在开发和QA之间来回
662
-
663
- **解决方案:**
664
- 1. 记录更清晰的验收标准
665
- 2. 为复杂问题安排结对编程
666
- 3. 考虑添加自动化测试
667
-
668
- ---
669
-
670
- ## 状态图
671
-
672
- ### 故事状态
673
-
674
- ```mermaid
675
- stateDiagram-v2
676
- [*] --> Draft: 创建故事
677
- Draft --> Approved: 审查通过
678
- Draft --> Draft: 审查调整
679
- Approved --> InProgress: 开发启动
680
- InProgress --> Review: 开发完成
681
- Review --> InProgress: QA问题
682
- Review --> Done: QA批准
683
- Done --> [*]
684
-
685
- note right of Draft: SM创建的故事
686
- note right of Approved: 准备开发
687
- note right of Review: 等待QA
688
- note right of Done: 完成并验证
689
- ```
690
-
691
- ### 史诗状态
692
-
693
- ```mermaid
694
- stateDiagram-v2
695
- [*] --> Planning: 增强分类
696
- Planning --> Documented: 创建文档
697
- Documented --> Validated: PO批准
698
- Validated --> InDevelopment: 创建故事
699
- InDevelopment --> InDevelopment: 更多故事
700
- InDevelopment --> Retrospective: 所有故事完成
701
- Retrospective --> Complete: 回顾完成
702
- Complete --> [*]
703
- ```
704
-
705
- ---
706
-
707
- ## 成功指标
708
-
709
- | 指标 | 描述 | 目标 |
710
- |------|------|------|
711
- | 分类准确度 | 正确分类的增强百分比 | > 90% |
712
- | 到PRD的时间 | 从请求到批准PRD的天数 | < 3天 |
713
- | 每次验证的问题 | PO发现的平均问题数 | < 3 |
714
- | QA周期 | 开发/QA往返的平均数 | < 2 |
715
- | 零回归 | 发布中没有回归错误的百分比 | 100% |
716
-
717
- ---
718
-
719
- ## 参考
720
-
721
- ### 工作流核心文件
722
-
723
- | 文件 | 目的 |
724
- |------|------|
725
- | `.sinapse-ai/development/workflows/brownfield-fullstack.yaml` | 工作流定义 |
726
- | `.sinapse-ai/development/tasks/brownfield-create-story.md` | 创建简单故事的任务 |
727
- | `.sinapse-ai/development/tasks/brownfield-create-epic.md` | 创建史诗的任务 |
728
- | `.sinapse-ai/development/tasks/document-project.md` | 记录现有项目的任务 |
729
- | `.sinapse-ai/development/tasks/shard-doc.md` | 分割文档的任务 |
730
- | `.sinapse-ai/development/tasks/create-brownfield-story.md` | 创建棕地故事的任务 |
731
- | `.sinapse-ai/development/tasks/create-next-story.md` | 从PRD创建故事的任务 |
732
- | `.sinapse-ai/product/checklists/po-master-checklist.md` | PO验证清单 |
733
-
734
- ### 代理文件
735
-
736
- | 文件 | 代理 |
737
- |------|------|
738
- | `.sinapse-ai/development/agents/analyst.md` | @analyst (Atlas) |
739
- | `.sinapse-ai/development/agents/architect.md` | @architect (Aria) |
740
- | `.sinapse-ai/development/agents/pm.md` | @pm (Morgan) |
741
- | `.sinapse-ai/development/agents/po.md` | @po (Pax) |
742
- | `.sinapse-ai/development/agents/sm.md` | @sm (River) |
743
- | `.sinapse-ai/development/agents/dev.md` | @dev (Dex) |
744
- | `.sinapse-ai/development/agents/qa.md` | @qa (Quinn) |
745
-
746
- ### 相关文档
747
-
748
- | 文档 | 目的 |
749
- |------|------|
750
- | `docs/guides/BACKLOG-MANAGEMENT-SYSTEM.md` | 待办事项管理系统 |
751
- | `docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md` | 绿地项目工作流 |
752
- | `.sinapse-ai/working-in-the-brownfield.md` | 棕地工作指南 |
753
-
754
- ---
755
-
756
- ## 变更日志
757
-
758
- | 日期 | 作者 | 描述 |
759
- |------|------|------|
760
- | 2026-02-04 | @analyst | 初始文档创建 |
761
-
762
- ---
763
-
764
- *-- Atlas,将复杂性解码为清晰度*