mindforge-cc 9.0.0 → 10.0.1

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 (717) hide show
  1. package/.mindforge/config.json +1 -1
  2. package/.mindforge/personas/a11y-architect.md +190 -0
  3. package/.mindforge/personas/accessibility-tester.md +108 -0
  4. package/.mindforge/personas/api-designer.md +190 -0
  5. package/.mindforge/personas/api-gateway-architect.md +168 -0
  6. package/.mindforge/personas/api-load-tester.md +144 -0
  7. package/.mindforge/personas/authentication-architect.md +163 -0
  8. package/.mindforge/personas/backup-recovery-specialist.md +181 -0
  9. package/.mindforge/personas/browser-extension-architect.md +96 -0
  10. package/.mindforge/personas/build-optimizer.md +160 -0
  11. package/.mindforge/personas/caching-strategist.md +180 -0
  12. package/.mindforge/personas/chaos-engineer.md +207 -0
  13. package/.mindforge/personas/cli-designer.md +151 -0
  14. package/.mindforge/personas/cloud-architect.md +229 -0
  15. package/.mindforge/personas/code-archeologist.md +176 -0
  16. package/.mindforge/personas/code-explorer.md +144 -0
  17. package/.mindforge/personas/compliance-auditor.md +190 -0
  18. package/.mindforge/personas/concurrency-expert.md +310 -0
  19. package/.mindforge/personas/config-management-expert.md +277 -0
  20. package/.mindforge/personas/contract-tester.md +224 -0
  21. package/.mindforge/personas/cost-analyst.md +209 -0
  22. package/.mindforge/personas/data-engineer.md +235 -0
  23. package/.mindforge/personas/data-privacy-engineer.md +187 -0
  24. package/.mindforge/personas/database-expert.md +223 -0
  25. package/.mindforge/personas/dependency-auditor.md +181 -0
  26. package/.mindforge/personas/design-system-engineer.md +115 -0
  27. package/.mindforge/personas/devops-engineer.md +561 -0
  28. package/.mindforge/personas/domain-modeler.md +127 -0
  29. package/.mindforge/personas/email-systems-engineer.md +119 -0
  30. package/.mindforge/personas/error-handling-architect.md +246 -0
  31. package/.mindforge/personas/event-driven-architect.md +134 -0
  32. package/.mindforge/personas/frontend-architect.md +107 -0
  33. package/.mindforge/personas/git-forensics.md +146 -0
  34. package/.mindforge/personas/git-workflow-expert.md +161 -0
  35. package/.mindforge/personas/go-specialist.md +249 -0
  36. package/.mindforge/personas/graphql-specialist.md +195 -0
  37. package/.mindforge/personas/incident-commander.md +214 -0
  38. package/.mindforge/personas/internationalization-expert.md +164 -0
  39. package/.mindforge/personas/java-specialist.md +271 -0
  40. package/.mindforge/personas/kubernetes-debugger.md +175 -0
  41. package/.mindforge/personas/logging-architect.md +200 -0
  42. package/.mindforge/personas/migration-specialist.md +237 -0
  43. package/.mindforge/personas/ml-engineer.md +312 -0
  44. package/.mindforge/personas/mobile-engineer.md +183 -0
  45. package/.mindforge/personas/monorepo-architect.md +323 -0
  46. package/.mindforge/personas/observability-engineer.md +217 -0
  47. package/.mindforge/personas/onboarding-guide.md +265 -0
  48. package/.mindforge/personas/performance-optimizer.md +293 -0
  49. package/.mindforge/personas/product-manager.md +105 -0
  50. package/.mindforge/personas/prompt-engineer.md +200 -0
  51. package/.mindforge/personas/python-specialist.md +277 -0
  52. package/.mindforge/personas/queue-architect.md +136 -0
  53. package/.mindforge/personas/react-specialist.md +97 -0
  54. package/.mindforge/personas/real-time-engineer.md +121 -0
  55. package/.mindforge/personas/refactoring-expert.md +117 -0
  56. package/.mindforge/personas/regex-craftsman.md +130 -0
  57. package/.mindforge/personas/rust-specialist.md +262 -0
  58. package/.mindforge/personas/sdk-designer.md +185 -0
  59. package/.mindforge/personas/search-engineer.md +290 -0
  60. package/.mindforge/personas/senior-reviewer.md +372 -0
  61. package/.mindforge/personas/seo-specialist.md +99 -0
  62. package/.mindforge/personas/spec-reviewer.md +172 -0
  63. package/.mindforge/personas/state-machine-designer.md +172 -0
  64. package/.mindforge/personas/swarm-templates.json +72 -18
  65. package/.mindforge/personas/tailwind-specialist.md +95 -0
  66. package/.mindforge/personas/tech-debt-analyst.md +200 -0
  67. package/.mindforge/personas/tech-stack-selector.md +118 -0
  68. package/.mindforge/personas/technical-interviewer.md +158 -0
  69. package/.mindforge/personas/test-data-engineer.md +169 -0
  70. package/.mindforge/personas/typescript-wizard.md +247 -0
  71. package/.mindforge/personas/ux-auditor.md +251 -0
  72. package/.mindforge/personas/webhook-designer.md +161 -0
  73. package/CHANGELOG.md +82 -0
  74. package/LICENSE +1 -1
  75. package/MINDFORGE.md +18 -5
  76. package/README.md +7 -1
  77. package/RELEASENOTES.md +121 -193
  78. package/SECURITY.md +108 -2
  79. package/bin/autonomous/audit-writer.js +90 -0
  80. package/bin/autonomous/auto-runner.js +209 -431
  81. package/bin/autonomous/state-manager.js +116 -0
  82. package/bin/autonomous/task-dispatcher.js +114 -0
  83. package/bin/autonomous/wave-executor.js +169 -0
  84. package/bin/browser/browser-daemon.js +31 -1
  85. package/bin/change-classifier.js +3 -3
  86. package/bin/dashboard/api-router.js +21 -22
  87. package/bin/dashboard/metrics-aggregator.js +44 -3
  88. package/bin/dashboard/server.js +54 -10
  89. package/bin/dashboard/sse-bridge.js +51 -5
  90. package/bin/engine/learning-manager.js +1 -1
  91. package/bin/engine/mesh-syncer.js +26 -22
  92. package/bin/engine/nexus-tracer.js +6 -5
  93. package/bin/engine/orbital-guardian.js +13 -10
  94. package/bin/engine/skill-evolver.js +12 -14
  95. package/bin/engine/temporal-hub.js +25 -1
  96. package/bin/governance/policy-engine.js +5 -5
  97. package/bin/governance/policy-gate-hardened.js +2 -2
  98. package/bin/governance/quantum-crypto.js +10 -2
  99. package/bin/memory/identity-synthesizer.js +9 -11
  100. package/bin/memory/knowledge-store.js +62 -6
  101. package/bin/memory/semantic-hub.js +26 -30
  102. package/bin/memory/vector-hub.js +377 -193
  103. package/bin/migrations/v8-sqlite-migration.js +22 -21
  104. package/bin/migrations/v9-unified-memory.js +1 -1
  105. package/bin/mindforge-cli.js +47 -11
  106. package/bin/models/model-broker.js +2 -0
  107. package/bin/revops/remediation-queue.js +16 -55
  108. package/bin/utils/errors.js +40 -0
  109. package/bin/utils/file-io.js +102 -0
  110. package/bin/utils/index.js +6 -0
  111. package/bin/utils/paths.js +33 -0
  112. package/docs/commands-reference.md +38 -2
  113. package/docs/getting-started.md +16 -6
  114. package/docs/sdk-reference.md +374 -24
  115. package/docs/troubleshooting.md +4 -4
  116. package/docs/user-guide.md +31 -11
  117. package/examples/sdk-integration/README.md +24 -0
  118. package/examples/sdk-integration/index.js +24 -0
  119. package/examples/starter-project/MINDFORGE.md +8 -8
  120. package/package.json +30 -15
  121. package/.agent/bin/lib/commands.cjs +0 -959
  122. package/.agent/bin/lib/config.cjs +0 -421
  123. package/.agent/bin/lib/core.cjs +0 -1166
  124. package/.agent/bin/lib/frontmatter.cjs +0 -307
  125. package/.agent/bin/lib/init.cjs +0 -1336
  126. package/.agent/bin/lib/milestone.cjs +0 -252
  127. package/.agent/bin/lib/model-profiles.cjs +0 -68
  128. package/.agent/bin/lib/phase.cjs +0 -888
  129. package/.agent/bin/lib/profile-output.cjs +0 -952
  130. package/.agent/bin/lib/profile-pipeline.cjs +0 -539
  131. package/.agent/bin/lib/roadmap.cjs +0 -329
  132. package/.agent/bin/lib/security.cjs +0 -356
  133. package/.agent/bin/lib/state.cjs +0 -969
  134. package/.agent/bin/lib/template.cjs +0 -222
  135. package/.agent/bin/lib/uat.cjs +0 -189
  136. package/.agent/bin/lib/verify.cjs +0 -851
  137. package/.agent/bin/lib/workstream.cjs +0 -491
  138. package/.agent/bin/mindforge-tools.cjs +0 -897
  139. package/.agent/file-manifest.json +0 -219
  140. package/.agent/forge/help.md +0 -11
  141. package/.agent/forge/init-project.md +0 -36
  142. package/.agent/forge/plan-phase.md +0 -34
  143. package/.agent/mindforge/add-backlog.md +0 -32
  144. package/.agent/mindforge/agent.md +0 -31
  145. package/.agent/mindforge/approve.md +0 -22
  146. package/.agent/mindforge/audit.md +0 -34
  147. package/.agent/mindforge/auto.md +0 -26
  148. package/.agent/mindforge/benchmark.md +0 -37
  149. package/.agent/mindforge/browse.md +0 -30
  150. package/.agent/mindforge/complete-milestone.md +0 -22
  151. package/.agent/mindforge/costs.md +0 -15
  152. package/.agent/mindforge/cross-review.md +0 -21
  153. package/.agent/mindforge/dashboard.md +0 -102
  154. package/.agent/mindforge/debug.md +0 -133
  155. package/.agent/mindforge/discuss-phase.md +0 -142
  156. package/.agent/mindforge/do.md +0 -31
  157. package/.agent/mindforge/execute-phase.md +0 -200
  158. package/.agent/mindforge/health.md +0 -31
  159. package/.agent/mindforge/help.md +0 -33
  160. package/.agent/mindforge/init-org.md +0 -135
  161. package/.agent/mindforge/init-project.md +0 -170
  162. package/.agent/mindforge/install-skill.md +0 -28
  163. package/.agent/mindforge/learn.md +0 -147
  164. package/.agent/mindforge/learning.md +0 -20
  165. package/.agent/mindforge/map-codebase.md +0 -302
  166. package/.agent/mindforge/marketplace.md +0 -124
  167. package/.agent/mindforge/metrics.md +0 -26
  168. package/.agent/mindforge/migrate.md +0 -44
  169. package/.agent/mindforge/milestone.md +0 -16
  170. package/.agent/mindforge/new-runtime.md +0 -23
  171. package/.agent/mindforge/next.md +0 -109
  172. package/.agent/mindforge/note.md +0 -35
  173. package/.agent/mindforge/plan-phase.md +0 -131
  174. package/.agent/mindforge/plant-seed.md +0 -31
  175. package/.agent/mindforge/plugins.md +0 -44
  176. package/.agent/mindforge/pr-review.md +0 -45
  177. package/.agent/mindforge/profile-team.md +0 -27
  178. package/.agent/mindforge/publish-skill.md +0 -23
  179. package/.agent/mindforge/qa.md +0 -20
  180. package/.agent/mindforge/quick.md +0 -139
  181. package/.agent/mindforge/record-learning.md +0 -22
  182. package/.agent/mindforge/release.md +0 -14
  183. package/.agent/mindforge/remember.md +0 -30
  184. package/.agent/mindforge/research.md +0 -16
  185. package/.agent/mindforge/retrospective.md +0 -31
  186. package/.agent/mindforge/review-backlog.md +0 -34
  187. package/.agent/mindforge/review.md +0 -161
  188. package/.agent/mindforge/security-scan.md +0 -242
  189. package/.agent/mindforge/session-report.md +0 -39
  190. package/.agent/mindforge/ship.md +0 -111
  191. package/.agent/mindforge/skills.md +0 -145
  192. package/.agent/mindforge/status.md +0 -113
  193. package/.agent/mindforge/steer.md +0 -17
  194. package/.agent/mindforge/sync-confluence.md +0 -15
  195. package/.agent/mindforge/sync-jira.md +0 -16
  196. package/.agent/mindforge/tokens.md +0 -12
  197. package/.agent/mindforge/ui-phase.md +0 -34
  198. package/.agent/mindforge/ui-review.md +0 -36
  199. package/.agent/mindforge/update.md +0 -46
  200. package/.agent/mindforge/validate-phase.md +0 -31
  201. package/.agent/mindforge/verify-phase.md +0 -66
  202. package/.agent/mindforge/workspace.md +0 -33
  203. package/.agent/mindforge/workstreams.md +0 -35
  204. package/.agent/settings.json +0 -42
  205. package/.agent/skills/mindforge-add-backlog/SKILL.md +0 -72
  206. package/.agent/skills/mindforge-add-phase/SKILL.md +0 -39
  207. package/.agent/skills/mindforge-add-tests/SKILL.md +0 -28
  208. package/.agent/skills/mindforge-add-todo/SKILL.md +0 -42
  209. package/.agent/skills/mindforge-audit-milestone/SKILL.md +0 -29
  210. package/.agent/skills/mindforge-audit-uat/SKILL.md +0 -20
  211. package/.agent/skills/mindforge-autonomous/SKILL.md +0 -33
  212. package/.agent/skills/mindforge-brainstorming/SKILL.md +0 -164
  213. package/.agent/skills/mindforge-brainstorming/scripts/frame-template.html +0 -214
  214. package/.agent/skills/mindforge-brainstorming/scripts/helper.js +0 -88
  215. package/.agent/skills/mindforge-brainstorming/scripts/server.cjs +0 -354
  216. package/.agent/skills/mindforge-brainstorming/scripts/start-server.sh +0 -148
  217. package/.agent/skills/mindforge-brainstorming/scripts/stop-server.sh +0 -56
  218. package/.agent/skills/mindforge-brainstorming/spec-document-reviewer-prompt.md +0 -49
  219. package/.agent/skills/mindforge-brainstorming/visual-companion.md +0 -287
  220. package/.agent/skills/mindforge-check-todos/SKILL.md +0 -40
  221. package/.agent/skills/mindforge-cleanup/SKILL.md +0 -19
  222. package/.agent/skills/mindforge-complete-milestone/SKILL.md +0 -131
  223. package/.agent/skills/mindforge-debug/SKILL.md +0 -163
  224. package/.agent/skills/mindforge-debug_extended/CREATION-LOG.md +0 -119
  225. package/.agent/skills/mindforge-debug_extended/SKILL.md +0 -296
  226. package/.agent/skills/mindforge-debug_extended/condition-based-waiting-example.ts +0 -158
  227. package/.agent/skills/mindforge-debug_extended/condition-based-waiting.md +0 -115
  228. package/.agent/skills/mindforge-debug_extended/defense-in-depth.md +0 -122
  229. package/.agent/skills/mindforge-debug_extended/find-polluter.sh +0 -63
  230. package/.agent/skills/mindforge-debug_extended/root-cause-tracing.md +0 -169
  231. package/.agent/skills/mindforge-debug_extended/test-academic.md +0 -14
  232. package/.agent/skills/mindforge-debug_extended/test-pressure-1.md +0 -58
  233. package/.agent/skills/mindforge-debug_extended/test-pressure-2.md +0 -68
  234. package/.agent/skills/mindforge-debug_extended/test-pressure-3.md +0 -69
  235. package/.agent/skills/mindforge-discuss-phase/SKILL.md +0 -54
  236. package/.agent/skills/mindforge-do/SKILL.md +0 -26
  237. package/.agent/skills/mindforge-execute-phase/SKILL.md +0 -49
  238. package/.agent/skills/mindforge-execute-phase_extended/SKILL.md +0 -70
  239. package/.agent/skills/mindforge-fast/SKILL.md +0 -23
  240. package/.agent/skills/mindforge-forensics/SKILL.md +0 -49
  241. package/.agent/skills/mindforge-health/SKILL.md +0 -17
  242. package/.agent/skills/mindforge-help/SKILL.md +0 -23
  243. package/.agent/skills/mindforge-insert-phase/SKILL.md +0 -28
  244. package/.agent/skills/mindforge-join-discord/SKILL.md +0 -19
  245. package/.agent/skills/mindforge-list-phase-assumptions/SKILL.md +0 -41
  246. package/.agent/skills/mindforge-list-workspaces/SKILL.md +0 -17
  247. package/.agent/skills/mindforge-manager/SKILL.md +0 -32
  248. package/.agent/skills/mindforge-map-codebase/SKILL.md +0 -64
  249. package/.agent/skills/mindforge-milestone-summary/SKILL.md +0 -44
  250. package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +0 -115
  251. package/.agent/skills/mindforge-neural-orchestrator/references/codex-tools.md +0 -100
  252. package/.agent/skills/mindforge-neural-orchestrator/references/gemini-tools.md +0 -33
  253. package/.agent/skills/mindforge-new-milestone/SKILL.md +0 -38
  254. package/.agent/skills/mindforge-new-project/SKILL.md +0 -36
  255. package/.agent/skills/mindforge-new-workspace/SKILL.md +0 -39
  256. package/.agent/skills/mindforge-next/SKILL.md +0 -19
  257. package/.agent/skills/mindforge-note/SKILL.md +0 -29
  258. package/.agent/skills/mindforge-parallel-mesh_extended/SKILL.md +0 -182
  259. package/.agent/skills/mindforge-pause-work/SKILL.md +0 -35
  260. package/.agent/skills/mindforge-plan-milestone-gaps/SKILL.md +0 -28
  261. package/.agent/skills/mindforge-plan-phase/SKILL.md +0 -38
  262. package/.agent/skills/mindforge-plan-phase_extended/SKILL.md +0 -152
  263. package/.agent/skills/mindforge-plan-phase_extended/plan-document-reviewer-prompt.md +0 -49
  264. package/.agent/skills/mindforge-plant-seed/SKILL.md +0 -22
  265. package/.agent/skills/mindforge-pr-branch/SKILL.md +0 -21
  266. package/.agent/skills/mindforge-profile-user/SKILL.md +0 -38
  267. package/.agent/skills/mindforge-progress/SKILL.md +0 -19
  268. package/.agent/skills/mindforge-quick/SKILL.md +0 -38
  269. package/.agent/skills/mindforge-reapply-patches/SKILL.md +0 -124
  270. package/.agent/skills/mindforge-remove-phase/SKILL.md +0 -26
  271. package/.agent/skills/mindforge-remove-workspace/SKILL.md +0 -22
  272. package/.agent/skills/mindforge-research-phase/SKILL.md +0 -186
  273. package/.agent/skills/mindforge-resume-work/SKILL.md +0 -35
  274. package/.agent/skills/mindforge-review/SKILL.md +0 -31
  275. package/.agent/skills/mindforge-review-backlog/SKILL.md +0 -58
  276. package/.agent/skills/mindforge-review-inbound/SKILL.md +0 -213
  277. package/.agent/skills/mindforge-review-request/SKILL.md +0 -105
  278. package/.agent/skills/mindforge-review-request/code-reviewer.md +0 -146
  279. package/.agent/skills/mindforge-session-report/SKILL.md +0 -16
  280. package/.agent/skills/mindforge-set-profile/SKILL.md +0 -9
  281. package/.agent/skills/mindforge-settings/SKILL.md +0 -32
  282. package/.agent/skills/mindforge-ship/SKILL.md +0 -16
  283. package/.agent/skills/mindforge-ship_extended/SKILL.md +0 -200
  284. package/.agent/skills/mindforge-skill-creation/SKILL.md +0 -655
  285. package/.agent/skills/mindforge-skill-creation/anthropic-best-practices.md +0 -1150
  286. package/.agent/skills/mindforge-skill-creation/examples/CLAUDE_MD_TESTING.md +0 -189
  287. package/.agent/skills/mindforge-skill-creation/graphviz-conventions.dot +0 -172
  288. package/.agent/skills/mindforge-skill-creation/persuasion-principles.md +0 -187
  289. package/.agent/skills/mindforge-skill-creation/render-graphs.js +0 -168
  290. package/.agent/skills/mindforge-skill-creation/testing-skills-with-subagents.md +0 -384
  291. package/.agent/skills/mindforge-stats/SKILL.md +0 -16
  292. package/.agent/skills/mindforge-swarm-execution/SKILL.md +0 -277
  293. package/.agent/skills/mindforge-swarm-execution/code-quality-reviewer-prompt.md +0 -26
  294. package/.agent/skills/mindforge-swarm-execution/implementer-prompt.md +0 -113
  295. package/.agent/skills/mindforge-swarm-execution/spec-reviewer-prompt.md +0 -61
  296. package/.agent/skills/mindforge-system-architecture/SKILL.md +0 -136
  297. package/.agent/skills/mindforge-system-architecture/examples.md +0 -120
  298. package/.agent/skills/mindforge-system-architecture/scaling-checklist.md +0 -76
  299. package/.agent/skills/mindforge-tdd/SKILL.md +0 -112
  300. package/.agent/skills/mindforge-tdd/deep-modules.md +0 -21
  301. package/.agent/skills/mindforge-tdd/interface-design.md +0 -22
  302. package/.agent/skills/mindforge-tdd/mocking.md +0 -24
  303. package/.agent/skills/mindforge-tdd/refactoring.md +0 -21
  304. package/.agent/skills/mindforge-tdd/tests.md +0 -28
  305. package/.agent/skills/mindforge-tdd_extended/SKILL.md +0 -371
  306. package/.agent/skills/mindforge-tdd_extended/testing-anti-patterns.md +0 -299
  307. package/.agent/skills/mindforge-thread/SKILL.md +0 -123
  308. package/.agent/skills/mindforge-ui-phase/SKILL.md +0 -24
  309. package/.agent/skills/mindforge-ui-review/SKILL.md +0 -24
  310. package/.agent/skills/mindforge-update/SKILL.md +0 -35
  311. package/.agent/skills/mindforge-validate-phase/SKILL.md +0 -26
  312. package/.agent/skills/mindforge-verify-work/SKILL.md +0 -30
  313. package/.agent/skills/mindforge-verify-work_extended/SKILL.md +0 -139
  314. package/.agent/skills/mindforge-workspace-isolated/SKILL.md +0 -218
  315. package/.agent/skills/mindforge-workstreams/SKILL.md +0 -65
  316. package/.agent/workflows/forge:help.md +0 -10
  317. package/.agent/workflows/forge:init-project.md +0 -35
  318. package/.agent/workflows/forge:plan-phase.md +0 -33
  319. package/.agent/workflows/mindforge-add-phase.md +0 -112
  320. package/.agent/workflows/mindforge-add-tests.md +0 -351
  321. package/.agent/workflows/mindforge-add-todo.md +0 -158
  322. package/.agent/workflows/mindforge-audit-milestone.md +0 -332
  323. package/.agent/workflows/mindforge-audit-uat.md +0 -109
  324. package/.agent/workflows/mindforge-autonomous.md +0 -815
  325. package/.agent/workflows/mindforge-check-todos.md +0 -177
  326. package/.agent/workflows/mindforge-cleanup.md +0 -152
  327. package/.agent/workflows/mindforge-complete-milestone.md +0 -766
  328. package/.agent/workflows/mindforge-diagnose-issues.md +0 -220
  329. package/.agent/workflows/mindforge-discovery-phase.md +0 -289
  330. package/.agent/workflows/mindforge-discuss-phase-assumptions.md +0 -645
  331. package/.agent/workflows/mindforge-discuss-phase.md +0 -1047
  332. package/.agent/workflows/mindforge-do.md +0 -104
  333. package/.agent/workflows/mindforge-execute-phase.md +0 -838
  334. package/.agent/workflows/mindforge-execute-plan.md +0 -509
  335. package/.agent/workflows/mindforge-fast.md +0 -105
  336. package/.agent/workflows/mindforge-forensics.md +0 -265
  337. package/.agent/workflows/mindforge-health.md +0 -181
  338. package/.agent/workflows/mindforge-help.md +0 -606
  339. package/.agent/workflows/mindforge-insert-phase.md +0 -130
  340. package/.agent/workflows/mindforge-list-phase-assumptions.md +0 -178
  341. package/.agent/workflows/mindforge-list-workspaces.md +0 -56
  342. package/.agent/workflows/mindforge-manager.md +0 -360
  343. package/.agent/workflows/mindforge-map-codebase.md +0 -370
  344. package/.agent/workflows/mindforge-milestone-summary.md +0 -223
  345. package/.agent/workflows/mindforge-new-milestone.md +0 -469
  346. package/.agent/workflows/mindforge-new-project.md +0 -1226
  347. package/.agent/workflows/mindforge-new-workspace.md +0 -237
  348. package/.agent/workflows/mindforge-next.md +0 -97
  349. package/.agent/workflows/mindforge-node-repair.md +0 -92
  350. package/.agent/workflows/mindforge-note.md +0 -156
  351. package/.agent/workflows/mindforge-pause-work.md +0 -176
  352. package/.agent/workflows/mindforge-plan-milestone-gaps.md +0 -273
  353. package/.agent/workflows/mindforge-plan-phase.md +0 -877
  354. package/.agent/workflows/mindforge-plant-seed.md +0 -169
  355. package/.agent/workflows/mindforge-pr-branch.md +0 -129
  356. package/.agent/workflows/mindforge-profile-user.md +0 -450
  357. package/.agent/workflows/mindforge-progress.md +0 -507
  358. package/.agent/workflows/mindforge-quick.md +0 -732
  359. package/.agent/workflows/mindforge-remove-phase.md +0 -155
  360. package/.agent/workflows/mindforge-remove-workspace.md +0 -90
  361. package/.agent/workflows/mindforge-research-phase.md +0 -74
  362. package/.agent/workflows/mindforge-resume-project.md +0 -325
  363. package/.agent/workflows/mindforge-review.md +0 -228
  364. package/.agent/workflows/mindforge-session-report.md +0 -146
  365. package/.agent/workflows/mindforge-settings.md +0 -283
  366. package/.agent/workflows/mindforge-ship.md +0 -228
  367. package/.agent/workflows/mindforge-stats.md +0 -60
  368. package/.agent/workflows/mindforge-transition.md +0 -671
  369. package/.agent/workflows/mindforge-ui-phase.md +0 -290
  370. package/.agent/workflows/mindforge-ui-review.md +0 -157
  371. package/.agent/workflows/mindforge-update.md +0 -323
  372. package/.agent/workflows/mindforge-validate-phase.md +0 -167
  373. package/.agent/workflows/mindforge-verify-phase.md +0 -254
  374. package/.agent/workflows/mindforge-verify-work.md +0 -628
  375. package/.agent/workflows/mindforge:add-backlog.md +0 -24
  376. package/.agent/workflows/mindforge:agent.md +0 -25
  377. package/.agent/workflows/mindforge:approve.md +0 -21
  378. package/.agent/workflows/mindforge:architecture.md +0 -40
  379. package/.agent/workflows/mindforge:audit.md +0 -33
  380. package/.agent/workflows/mindforge:auto.md +0 -25
  381. package/.agent/workflows/mindforge:benchmark.md +0 -36
  382. package/.agent/workflows/mindforge:brainstorming.md +0 -16
  383. package/.agent/workflows/mindforge:browse.md +0 -29
  384. package/.agent/workflows/mindforge:complete-milestone.md +0 -21
  385. package/.agent/workflows/mindforge:costs.md +0 -14
  386. package/.agent/workflows/mindforge:cross-review.md +0 -20
  387. package/.agent/workflows/mindforge:dashboard.md +0 -101
  388. package/.agent/workflows/mindforge:debug.md +0 -131
  389. package/.agent/workflows/mindforge:discuss-phase.md +0 -141
  390. package/.agent/workflows/mindforge:do.md +0 -25
  391. package/.agent/workflows/mindforge:execute-phase.md +0 -205
  392. package/.agent/workflows/mindforge:executor.md +0 -18
  393. package/.agent/workflows/mindforge:health.md +0 -24
  394. package/.agent/workflows/mindforge:help.md +0 -26
  395. package/.agent/workflows/mindforge:identity.md +0 -18
  396. package/.agent/workflows/mindforge:init-org.md +0 -134
  397. package/.agent/workflows/mindforge:init-project.md +0 -185
  398. package/.agent/workflows/mindforge:install-skill.md +0 -27
  399. package/.agent/workflows/mindforge:learn.md +0 -146
  400. package/.agent/workflows/mindforge:map-codebase.md +0 -301
  401. package/.agent/workflows/mindforge:marketplace.md +0 -123
  402. package/.agent/workflows/mindforge:memory.md +0 -18
  403. package/.agent/workflows/mindforge:metrics.md +0 -25
  404. package/.agent/workflows/mindforge:migrate.md +0 -43
  405. package/.agent/workflows/mindforge:milestone.md +0 -15
  406. package/.agent/workflows/mindforge:new-runtime.md +0 -22
  407. package/.agent/workflows/mindforge:next.md +0 -108
  408. package/.agent/workflows/mindforge:note.md +0 -27
  409. package/.agent/workflows/mindforge:plan-phase.md +0 -139
  410. package/.agent/workflows/mindforge:planner.md +0 -18
  411. package/.agent/workflows/mindforge:plant-seed.md +0 -24
  412. package/.agent/workflows/mindforge:plugins.md +0 -43
  413. package/.agent/workflows/mindforge:pr-review.md +0 -44
  414. package/.agent/workflows/mindforge:profile-team.md +0 -26
  415. package/.agent/workflows/mindforge:publish-skill.md +0 -22
  416. package/.agent/workflows/mindforge:qa.md +0 -19
  417. package/.agent/workflows/mindforge:quick.md +0 -138
  418. package/.agent/workflows/mindforge:release.md +0 -13
  419. package/.agent/workflows/mindforge:remember.md +0 -29
  420. package/.agent/workflows/mindforge:research.md +0 -15
  421. package/.agent/workflows/mindforge:researcher.md +0 -18
  422. package/.agent/workflows/mindforge:retrospective.md +0 -29
  423. package/.agent/workflows/mindforge:review-backlog.md +0 -26
  424. package/.agent/workflows/mindforge:review.md +0 -160
  425. package/.agent/workflows/mindforge:reviewer.md +0 -18
  426. package/.agent/workflows/mindforge:security-scan.md +0 -236
  427. package/.agent/workflows/mindforge:session-report.md +0 -31
  428. package/.agent/workflows/mindforge:ship.md +0 -108
  429. package/.agent/workflows/mindforge:skills.md +0 -144
  430. package/.agent/workflows/mindforge:soul.md +0 -54
  431. package/.agent/workflows/mindforge:status.md +0 -107
  432. package/.agent/workflows/mindforge:steer.md +0 -16
  433. package/.agent/workflows/mindforge:sync-confluence.md +0 -14
  434. package/.agent/workflows/mindforge:sync-jira.md +0 -15
  435. package/.agent/workflows/mindforge:tdd.md +0 -46
  436. package/.agent/workflows/mindforge:tokens.md +0 -11
  437. package/.agent/workflows/mindforge:tool.md +0 -18
  438. package/.agent/workflows/mindforge:ui-phase.md +0 -27
  439. package/.agent/workflows/mindforge:ui-review.md +0 -28
  440. package/.agent/workflows/mindforge:update.md +0 -45
  441. package/.agent/workflows/mindforge:validate-phase.md +0 -25
  442. package/.agent/workflows/mindforge:verify-phase.md +0 -65
  443. package/.agent/workflows/mindforge:workspace.md +0 -32
  444. package/.agent/workflows/mindforge:workstreams.md +0 -27
  445. package/.agent/workflows/publish-release.md +0 -36
  446. package/.claude/CLAUDE.md +0 -102
  447. package/.claude/commands/forge/help.md +0 -7
  448. package/.claude/commands/forge/init-project.md +0 -32
  449. package/.claude/commands/forge/plan-phase.md +0 -30
  450. package/.claude/commands/mindforge/add-backlog.md +0 -32
  451. package/.claude/commands/mindforge/agent.md +0 -31
  452. package/.claude/commands/mindforge/approve.md +0 -22
  453. package/.claude/commands/mindforge/audit.md +0 -34
  454. package/.claude/commands/mindforge/auto.md +0 -26
  455. package/.claude/commands/mindforge/benchmark.md +0 -37
  456. package/.claude/commands/mindforge/browse.md +0 -30
  457. package/.claude/commands/mindforge/complete-milestone.md +0 -22
  458. package/.claude/commands/mindforge/costs.md +0 -15
  459. package/.claude/commands/mindforge/cross-review.md +0 -21
  460. package/.claude/commands/mindforge/dashboard.md +0 -102
  461. package/.claude/commands/mindforge/debug.md +0 -133
  462. package/.claude/commands/mindforge/discuss-phase.md +0 -142
  463. package/.claude/commands/mindforge/do.md +0 -31
  464. package/.claude/commands/mindforge/execute-phase.md +0 -200
  465. package/.claude/commands/mindforge/health.md +0 -31
  466. package/.claude/commands/mindforge/help.md +0 -33
  467. package/.claude/commands/mindforge/init-org.md +0 -135
  468. package/.claude/commands/mindforge/init-project.md +0 -170
  469. package/.claude/commands/mindforge/install-skill.md +0 -28
  470. package/.claude/commands/mindforge/learn.md +0 -147
  471. package/.claude/commands/mindforge/learning.md +0 -20
  472. package/.claude/commands/mindforge/map-codebase.md +0 -302
  473. package/.claude/commands/mindforge/marketplace.md +0 -124
  474. package/.claude/commands/mindforge/metrics.md +0 -26
  475. package/.claude/commands/mindforge/migrate.md +0 -44
  476. package/.claude/commands/mindforge/milestone.md +0 -16
  477. package/.claude/commands/mindforge/new-runtime.md +0 -23
  478. package/.claude/commands/mindforge/next.md +0 -109
  479. package/.claude/commands/mindforge/note.md +0 -35
  480. package/.claude/commands/mindforge/plan-phase.md +0 -131
  481. package/.claude/commands/mindforge/plant-seed.md +0 -31
  482. package/.claude/commands/mindforge/plugins.md +0 -44
  483. package/.claude/commands/mindforge/pr-review.md +0 -45
  484. package/.claude/commands/mindforge/profile-team.md +0 -27
  485. package/.claude/commands/mindforge/publish-skill.md +0 -23
  486. package/.claude/commands/mindforge/qa.md +0 -20
  487. package/.claude/commands/mindforge/quick.md +0 -139
  488. package/.claude/commands/mindforge/record-learning.md +0 -22
  489. package/.claude/commands/mindforge/release.md +0 -14
  490. package/.claude/commands/mindforge/remember.md +0 -30
  491. package/.claude/commands/mindforge/research.md +0 -16
  492. package/.claude/commands/mindforge/retrospective.md +0 -31
  493. package/.claude/commands/mindforge/review-backlog.md +0 -34
  494. package/.claude/commands/mindforge/review.md +0 -161
  495. package/.claude/commands/mindforge/security-scan.md +0 -242
  496. package/.claude/commands/mindforge/session-report.md +0 -39
  497. package/.claude/commands/mindforge/ship.md +0 -111
  498. package/.claude/commands/mindforge/skills.md +0 -145
  499. package/.claude/commands/mindforge/status.md +0 -113
  500. package/.claude/commands/mindforge/steer.md +0 -17
  501. package/.claude/commands/mindforge/sync-confluence.md +0 -15
  502. package/.claude/commands/mindforge/sync-jira.md +0 -16
  503. package/.claude/commands/mindforge/tokens.md +0 -12
  504. package/.claude/commands/mindforge/ui-phase.md +0 -34
  505. package/.claude/commands/mindforge/ui-review.md +0 -36
  506. package/.claude/commands/mindforge/update.md +0 -46
  507. package/.claude/commands/mindforge/validate-phase.md +0 -31
  508. package/.claude/commands/mindforge/verify-phase.md +0 -66
  509. package/.claude/commands/mindforge/workspace.md +0 -33
  510. package/.claude/commands/mindforge/workstreams.md +0 -35
  511. package/.claude/settings.local.json +0 -16
  512. package/.mindforge/audit/AUDIT-SCHEMA.md +0 -470
  513. package/.mindforge/browser/daemon-protocol.md +0 -24
  514. package/.mindforge/browser/qa-engine.md +0 -16
  515. package/.mindforge/browser/session-manager.md +0 -18
  516. package/.mindforge/browser/visual-verify-spec.md +0 -31
  517. package/.mindforge/celestial.db +0 -0
  518. package/.mindforge/ci/ci-config-schema.md +0 -21
  519. package/.mindforge/ci/ci-mode.md +0 -179
  520. package/.mindforge/ci/github-actions-adapter.md +0 -224
  521. package/.mindforge/ci/gitlab-ci-adapter.md +0 -31
  522. package/.mindforge/ci/jenkins-adapter.md +0 -44
  523. package/.mindforge/dashboard/api-reference.md +0 -122
  524. package/.mindforge/dashboard/dashboard-spec.md +0 -96
  525. package/.mindforge/distribution/marketplace.md +0 -53
  526. package/.mindforge/distribution/registry-client.md +0 -166
  527. package/.mindforge/distribution/registry-schema.md +0 -96
  528. package/.mindforge/distribution/skill-publisher.md +0 -44
  529. package/.mindforge/distribution/skill-validator.md +0 -74
  530. package/.mindforge/governance/GOVERNANCE-CONFIG.md +0 -17
  531. package/.mindforge/governance/approval-workflow.md +0 -37
  532. package/.mindforge/governance/change-classifier.md +0 -63
  533. package/.mindforge/governance/compliance-gates.md +0 -31
  534. package/.mindforge/governance/policies/sovereign-default.json +0 -16
  535. package/.mindforge/integrations/confluence.md +0 -27
  536. package/.mindforge/integrations/connection-manager.md +0 -163
  537. package/.mindforge/integrations/github.md +0 -25
  538. package/.mindforge/integrations/gitlab.md +0 -13
  539. package/.mindforge/integrations/jira.md +0 -102
  540. package/.mindforge/integrations/slack.md +0 -41
  541. package/.mindforge/intelligence/antipattern-detector.md +0 -75
  542. package/.mindforge/intelligence/difficulty-scorer.md +0 -55
  543. package/.mindforge/intelligence/health-engine.md +0 -208
  544. package/.mindforge/intelligence/skill-gap-analyser.md +0 -40
  545. package/.mindforge/intelligence/smart-compaction.md +0 -71
  546. package/.mindforge/memory/MEMORY-SCHEMA.md +0 -155
  547. package/.mindforge/memory/engine/capture-protocol.md +0 -36
  548. package/.mindforge/memory/engine/global-sync-spec.md +0 -42
  549. package/.mindforge/memory/engine/retrieval-spec.md +0 -44
  550. package/.mindforge/memory/sync-manifest.json +0 -6
  551. package/.mindforge/metrics/METRICS-SCHEMA.md +0 -42
  552. package/.mindforge/metrics/quality-tracker.md +0 -32
  553. package/.mindforge/models/model-registry.md +0 -48
  554. package/.mindforge/models/model-router.md +0 -30
  555. package/.mindforge/monorepo/cross-package-planner.md +0 -114
  556. package/.mindforge/monorepo/dependency-graph-builder.md +0 -32
  557. package/.mindforge/monorepo/workspace-detector.md +0 -129
  558. package/.mindforge/org/CONVENTIONS.md +0 -62
  559. package/.mindforge/org/ORG.md +0 -51
  560. package/.mindforge/org/SECURITY.md +0 -50
  561. package/.mindforge/org/TOOLS.md +0 -53
  562. package/.mindforge/org/integrations/INTEGRATIONS-CONFIG.md +0 -58
  563. package/.mindforge/org/skills/MANIFEST.md +0 -15
  564. package/.mindforge/plugins/PLUGINS-MANIFEST.md +0 -23
  565. package/.mindforge/plugins/plugin-loader.md +0 -93
  566. package/.mindforge/plugins/plugin-registry.md +0 -44
  567. package/.mindforge/plugins/plugin-schema.md +0 -68
  568. package/.mindforge/pr-review/ai-reviewer.md +0 -266
  569. package/.mindforge/pr-review/finding-formatter.md +0 -46
  570. package/.mindforge/pr-review/review-prompt-templates.md +0 -44
  571. package/.mindforge/production/compatibility-layer.md +0 -39
  572. package/.mindforge/production/migration-engine.md +0 -52
  573. package/.mindforge/production/production-checklist.md +0 -76
  574. package/.mindforge/production/token-optimiser.md +0 -68
  575. package/.mindforge/skills-builder/auto-capture-protocol.md +0 -88
  576. package/.mindforge/skills-builder/learn-protocol.md +0 -161
  577. package/.mindforge/skills-builder/quality-scoring.md +0 -120
  578. package/.mindforge/team/TEAM-PROFILE.md +0 -42
  579. package/.mindforge/team/multi-handoff.md +0 -23
  580. package/.mindforge/team/profiles/README.md +0 -13
  581. package/.mindforge/team/session-merger.md +0 -18
  582. package/.planning/ARCHITECTURE.md +0 -0
  583. package/.planning/HANDOFF.json +0 -8
  584. package/.planning/PROJECT.md +0 -33
  585. package/.planning/RELEASE-CHECKLIST.md +0 -68
  586. package/.planning/REQUIREMENTS.md +0 -35
  587. package/.planning/ROADMAP.md +0 -12
  588. package/.planning/STATE.md +0 -36
  589. package/.planning/approvals/.gitkeep +0 -1
  590. package/.planning/archive/.gitkeep +0 -1
  591. package/.planning/audit-archive/.gitkeep +0 -1
  592. package/.planning/decisions/.gitkeep +0 -0
  593. package/.planning/jira-sync.json +0 -1
  594. package/.planning/milestones/.gitkeep +0 -1
  595. package/.planning/phases/.gitkeep +0 -0
  596. package/.planning/research/.gitkeep +0 -0
  597. package/.planning/screenshots/.gitkeep +0 -0
  598. package/.planning/slack-threads.json +0 -1
  599. package/docs/CAPABILITIES-MANIFEST.md +0 -64
  600. package/docs/Context/Master-Context.md +0 -731
  601. package/docs/INTELLIGENCE-MESH.md +0 -37
  602. package/docs/MIND-FORGE-REFERENCE-V6.md +0 -96
  603. package/docs/PERSONAS.md +0 -960
  604. package/docs/References/audit-events.md +0 -59
  605. package/docs/References/checkpoints.md +0 -778
  606. package/docs/References/commands.md +0 -107
  607. package/docs/References/config-reference.md +0 -81
  608. package/docs/References/continuation-format.md +0 -249
  609. package/docs/References/decimal-phase-calculation.md +0 -64
  610. package/docs/References/git-integration.md +0 -295
  611. package/docs/References/git-planning-commit.md +0 -38
  612. package/docs/References/model-profile-resolution.md +0 -36
  613. package/docs/References/model-profiles.md +0 -139
  614. package/docs/References/phase-argument-parsing.md +0 -61
  615. package/docs/References/planning-config.md +0 -202
  616. package/docs/References/questioning.md +0 -162
  617. package/docs/References/sdk-api.md +0 -53
  618. package/docs/References/skills-api.md +0 -57
  619. package/docs/References/tdd.md +0 -263
  620. package/docs/References/ui-brand.md +0 -160
  621. package/docs/References/user-profiling.md +0 -681
  622. package/docs/References/verification-patterns.md +0 -612
  623. package/docs/References/workstream-flag.md +0 -58
  624. package/docs/Templates/Agents/CLAUDE-MD.md +0 -122
  625. package/docs/Templates/Agents/COPILOT-INSTRUCTIONS.md +0 -7
  626. package/docs/Templates/Agents/DEBUGGER-PROMPT.md +0 -91
  627. package/docs/Templates/Agents/PLANNER-PROMPT.md +0 -117
  628. package/docs/Templates/Codebase/architecture.md +0 -255
  629. package/docs/Templates/Codebase/concerns.md +0 -310
  630. package/docs/Templates/Codebase/conventions.md +0 -307
  631. package/docs/Templates/Codebase/integrations.md +0 -280
  632. package/docs/Templates/Codebase/stack.md +0 -186
  633. package/docs/Templates/Codebase/structure.md +0 -285
  634. package/docs/Templates/Codebase/testing.md +0 -480
  635. package/docs/Templates/Execution/CONTINUE-HERE.md +0 -78
  636. package/docs/Templates/Execution/DISCUSSION-LOG.md +0 -63
  637. package/docs/Templates/Execution/PHASE-PROMPT.md +0 -610
  638. package/docs/Templates/Execution/STATE.md +0 -176
  639. package/docs/Templates/Execution/SUMMARY-COMPLEX.md +0 -59
  640. package/docs/Templates/Execution/SUMMARY-MINIMAL.md +0 -41
  641. package/docs/Templates/Execution/SUMMARY-STANDARD.md +0 -48
  642. package/docs/Templates/Execution/SUMMARY.md +0 -248
  643. package/docs/Templates/Profile/DEV-PREFERENCES.md +0 -21
  644. package/docs/Templates/Profile/USER-PROFILE.md +0 -146
  645. package/docs/Templates/Profile/USER-SETUP.md +0 -311
  646. package/docs/Templates/Project/AGENTS_LEARNING.md +0 -88
  647. package/docs/Templates/Project/DISCOVERY.md +0 -146
  648. package/docs/Templates/Project/MILESTONE-ARCHIVE.md +0 -123
  649. package/docs/Templates/Project/MILESTONE.md +0 -115
  650. package/docs/Templates/Project/PROJECT.md +0 -206
  651. package/docs/Templates/Project/REQUIREMENTS.md +0 -231
  652. package/docs/Templates/Project/RETROSPECTIVE.md +0 -54
  653. package/docs/Templates/Project/ROADMAP.md +0 -202
  654. package/docs/Templates/Quality/DEBUG.md +0 -164
  655. package/docs/Templates/Quality/UAT.md +0 -280
  656. package/docs/Templates/Quality/UI-SPEC.md +0 -100
  657. package/docs/Templates/Quality/VALIDATION.md +0 -76
  658. package/docs/Templates/Quality/VERIFICATION-REPORT.md +0 -322
  659. package/docs/Templates/Research/ARCHITECTURE.md +0 -204
  660. package/docs/Templates/Research/FEATURES.md +0 -147
  661. package/docs/Templates/Research/PITFALLS.md +0 -200
  662. package/docs/Templates/Research/STACK.md +0 -120
  663. package/docs/Templates/Research/SUMMARY.md +0 -170
  664. package/docs/Templates/System/CONFIG.json +0 -43
  665. package/docs/Templates/System/CONTEXT.md +0 -352
  666. package/docs/adr/ADR-024-browser-localhost-only.md +0 -17
  667. package/docs/adr/ADR-025-visual-verify-failure-treatment.md +0 -19
  668. package/docs/adr/ADR-026-session-persistence-security.md +0 -20
  669. package/docs/adr/ADR-042-ads-protocol.md +0 -30
  670. package/docs/architecture/NEXUS-DASHBOARD.md +0 -35
  671. package/docs/architecture/PAR-ZTS-SURVEY.md +0 -43
  672. package/docs/architecture/README.md +0 -78
  673. package/docs/architecture/V3-CORE.md +0 -52
  674. package/docs/architecture/V4-SWARM-MESH.md +0 -77
  675. package/docs/architecture/V5-ENTERPRISE.md +0 -131
  676. package/docs/architecture/V6-SOVEREIGN.md +0 -43
  677. package/docs/architecture/V8-SRE.md +0 -88
  678. package/docs/architecture/V9-BEDROCK.md +0 -162
  679. package/docs/architecture/adr-039-multi-runtime-support.md +0 -20
  680. package/docs/architecture/adr-040-additive-schema-migration.md +0 -21
  681. package/docs/architecture/adr-041-stable-runtime-interface-contract.md +0 -20
  682. package/docs/architecture/decision-records-index.md +0 -29
  683. package/docs/ci-cd-integration.md +0 -30
  684. package/docs/ci-cd.md +0 -92
  685. package/docs/ci-quickstart.md +0 -78
  686. package/docs/commands-skills/DISCOVERED_SKILLS.md +0 -21
  687. package/docs/contributing/CONTRIBUTING.md +0 -38
  688. package/docs/contributing/plugin-authoring.md +0 -50
  689. package/docs/contributing/skill-authoring.md +0 -41
  690. package/docs/enterprise-setup.md +0 -25
  691. package/docs/feature-dashboard.md +0 -63
  692. package/docs/governance-guide.md +0 -134
  693. package/docs/monorepo-guide.md +0 -26
  694. package/docs/persona-customisation.md +0 -56
  695. package/docs/publishing-guide.md +0 -43
  696. package/docs/quick-verify.md +0 -33
  697. package/docs/registry/AGENTS.md +0 -37
  698. package/docs/registry/COMMANDS.md +0 -87
  699. package/docs/registry/HOOKS.md +0 -38
  700. package/docs/registry/PERSONAS.md +0 -64
  701. package/docs/registry/README.md +0 -27
  702. package/docs/registry/SKILLS.md +0 -142
  703. package/docs/registry/WORKFLOWS.md +0 -72
  704. package/docs/release-checklist-guide.md +0 -37
  705. package/docs/requirements.md +0 -29
  706. package/docs/security/SECURITY.md +0 -55
  707. package/docs/security/ZTAI-OVERVIEW.md +0 -37
  708. package/docs/security/penetration-test-results.md +0 -31
  709. package/docs/security/threat-model.md +0 -142
  710. package/docs/skills-authoring-guide.md +0 -176
  711. package/docs/skills-publishing-guide.md +0 -22
  712. package/docs/team-setup-guide.md +0 -21
  713. package/docs/testing-current-version.md +0 -130
  714. package/docs/tutorial.md +0 -162
  715. package/docs/upgrade.md +0 -58
  716. package/docs/usp-features.md +0 -102
  717. package/docs/workflow-atlas.md +0 -57
@@ -1,354 +0,0 @@
1
- const crypto = require('crypto');
2
- const http = require('http');
3
- const fs = require('fs');
4
- const path = require('path');
5
-
6
- // ========== WebSocket Protocol (RFC 6455) ==========
7
-
8
- const OPCODES = { TEXT: 0x01, CLOSE: 0x08, PING: 0x09, PONG: 0x0A };
9
- const WS_MAGIC = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
10
-
11
- function computeAcceptKey(clientKey) {
12
- return crypto.createHash('sha1').update(clientKey + WS_MAGIC).digest('base64');
13
- }
14
-
15
- function encodeFrame(opcode, payload) {
16
- const fin = 0x80;
17
- const len = payload.length;
18
- let header;
19
-
20
- if (len < 126) {
21
- header = Buffer.alloc(2);
22
- header[0] = fin | opcode;
23
- header[1] = len;
24
- } else if (len < 65536) {
25
- header = Buffer.alloc(4);
26
- header[0] = fin | opcode;
27
- header[1] = 126;
28
- header.writeUInt16BE(len, 2);
29
- } else {
30
- header = Buffer.alloc(10);
31
- header[0] = fin | opcode;
32
- header[1] = 127;
33
- header.writeBigUInt64BE(BigInt(len), 2);
34
- }
35
-
36
- return Buffer.concat([header, payload]);
37
- }
38
-
39
- function decodeFrame(buffer) {
40
- if (buffer.length < 2) return null;
41
-
42
- const secondByte = buffer[1];
43
- const opcode = buffer[0] & 0x0F;
44
- const masked = (secondByte & 0x80) !== 0;
45
- let payloadLen = secondByte & 0x7F;
46
- let offset = 2;
47
-
48
- if (!masked) throw new Error('Client frames must be masked');
49
-
50
- if (payloadLen === 126) {
51
- if (buffer.length < 4) return null;
52
- payloadLen = buffer.readUInt16BE(2);
53
- offset = 4;
54
- } else if (payloadLen === 127) {
55
- if (buffer.length < 10) return null;
56
- payloadLen = Number(buffer.readBigUInt64BE(2));
57
- offset = 10;
58
- }
59
-
60
- const maskOffset = offset;
61
- const dataOffset = offset + 4;
62
- const totalLen = dataOffset + payloadLen;
63
- if (buffer.length < totalLen) return null;
64
-
65
- const mask = buffer.slice(maskOffset, dataOffset);
66
- const data = Buffer.alloc(payloadLen);
67
- for (let i = 0; i < payloadLen; i++) {
68
- data[i] = buffer[dataOffset + i] ^ mask[i % 4];
69
- }
70
-
71
- return { opcode, payload: data, bytesConsumed: totalLen };
72
- }
73
-
74
- // ========== Configuration ==========
75
-
76
- const PORT = process.env.BRAINSTORM_PORT || (49152 + Math.floor(Math.random() * 16383));
77
- const HOST = process.env.BRAINSTORM_HOST || '127.0.0.1';
78
- const URL_HOST = process.env.BRAINSTORM_URL_HOST || (HOST === '127.0.0.1' ? 'localhost' : HOST);
79
- const SESSION_DIR = process.env.BRAINSTORM_DIR || '/tmp/brainstorm';
80
- const CONTENT_DIR = path.join(SESSION_DIR, 'content');
81
- const STATE_DIR = path.join(SESSION_DIR, 'state');
82
- let ownerPid = process.env.BRAINSTORM_OWNER_PID ? Number(process.env.BRAINSTORM_OWNER_PID) : null;
83
-
84
- const MIME_TYPES = {
85
- '.html': 'text/html', '.css': 'text/css', '.js': 'application/javascript',
86
- '.json': 'application/json', '.png': 'image/png', '.jpg': 'image/jpeg',
87
- '.jpeg': 'image/jpeg', '.gif': 'image/gif', '.svg': 'image/svg+xml'
88
- };
89
-
90
- // ========== Templates and Constants ==========
91
-
92
- const WAITING_PAGE = `<!DOCTYPE html>
93
- <html>
94
- <head><meta charset="utf-8"><title>Brainstorm Companion</title>
95
- <style>body { font-family: system-ui, sans-serif; padding: 2rem; max-width: 800px; margin: 0 auto; }
96
- h1 { color: #333; } p { color: #666; }</style>
97
- </head>
98
- <body><h1>Brainstorm Companion</h1>
99
- <p>Waiting for the agent to push a screen...</p></body></html>`;
100
-
101
- const frameTemplate = fs.readFileSync(path.join(__dirname, 'frame-template.html'), 'utf-8');
102
- const helperScript = fs.readFileSync(path.join(__dirname, 'helper.js'), 'utf-8');
103
- const helperInjection = '<script>\n' + helperScript + '\n</script>';
104
-
105
- // ========== Helper Functions ==========
106
-
107
- function isFullDocument(html) {
108
- const trimmed = html.trimStart().toLowerCase();
109
- return trimmed.startsWith('<!doctype') || trimmed.startsWith('<html');
110
- }
111
-
112
- function wrapInFrame(content) {
113
- return frameTemplate.replace('<!-- CONTENT -->', content);
114
- }
115
-
116
- function getNewestScreen() {
117
- const files = fs.readdirSync(CONTENT_DIR)
118
- .filter(f => f.endsWith('.html'))
119
- .map(f => {
120
- const fp = path.join(CONTENT_DIR, f);
121
- return { path: fp, mtime: fs.statSync(fp).mtime.getTime() };
122
- })
123
- .sort((a, b) => b.mtime - a.mtime);
124
- return files.length > 0 ? files[0].path : null;
125
- }
126
-
127
- // ========== HTTP Request Handler ==========
128
-
129
- function handleRequest(req, res) {
130
- touchActivity();
131
- if (req.method === 'GET' && req.url === '/') {
132
- const screenFile = getNewestScreen();
133
- let html = screenFile
134
- ? (raw => isFullDocument(raw) ? raw : wrapInFrame(raw))(fs.readFileSync(screenFile, 'utf-8'))
135
- : WAITING_PAGE;
136
-
137
- if (html.includes('</body>')) {
138
- html = html.replace('</body>', helperInjection + '\n</body>');
139
- } else {
140
- html += helperInjection;
141
- }
142
-
143
- res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
144
- res.end(html);
145
- } else if (req.method === 'GET' && req.url.startsWith('/files/')) {
146
- const fileName = req.url.slice(7);
147
- const filePath = path.join(CONTENT_DIR, path.basename(fileName));
148
- if (!fs.existsSync(filePath)) {
149
- res.writeHead(404);
150
- res.end('Not found');
151
- return;
152
- }
153
- const ext = path.extname(filePath).toLowerCase();
154
- const contentType = MIME_TYPES[ext] || 'application/octet-stream';
155
- res.writeHead(200, { 'Content-Type': contentType });
156
- res.end(fs.readFileSync(filePath));
157
- } else {
158
- res.writeHead(404);
159
- res.end('Not found');
160
- }
161
- }
162
-
163
- // ========== WebSocket Connection Handling ==========
164
-
165
- const clients = new Set();
166
-
167
- function handleUpgrade(req, socket) {
168
- const key = req.headers['sec-websocket-key'];
169
- if (!key) { socket.destroy(); return; }
170
-
171
- const accept = computeAcceptKey(key);
172
- socket.write(
173
- 'HTTP/1.1 101 Switching Protocols\r\n' +
174
- 'Upgrade: websocket\r\n' +
175
- 'Connection: Upgrade\r\n' +
176
- 'Sec-WebSocket-Accept: ' + accept + '\r\n\r\n'
177
- );
178
-
179
- let buffer = Buffer.alloc(0);
180
- clients.add(socket);
181
-
182
- socket.on('data', (chunk) => {
183
- buffer = Buffer.concat([buffer, chunk]);
184
- while (buffer.length > 0) {
185
- let result;
186
- try {
187
- result = decodeFrame(buffer);
188
- } catch (e) {
189
- socket.end(encodeFrame(OPCODES.CLOSE, Buffer.alloc(0)));
190
- clients.delete(socket);
191
- return;
192
- }
193
- if (!result) break;
194
- buffer = buffer.slice(result.bytesConsumed);
195
-
196
- switch (result.opcode) {
197
- case OPCODES.TEXT:
198
- handleMessage(result.payload.toString());
199
- break;
200
- case OPCODES.CLOSE:
201
- socket.end(encodeFrame(OPCODES.CLOSE, Buffer.alloc(0)));
202
- clients.delete(socket);
203
- return;
204
- case OPCODES.PING:
205
- socket.write(encodeFrame(OPCODES.PONG, result.payload));
206
- break;
207
- case OPCODES.PONG:
208
- break;
209
- default: {
210
- const closeBuf = Buffer.alloc(2);
211
- closeBuf.writeUInt16BE(1003);
212
- socket.end(encodeFrame(OPCODES.CLOSE, closeBuf));
213
- clients.delete(socket);
214
- return;
215
- }
216
- }
217
- }
218
- });
219
-
220
- socket.on('close', () => clients.delete(socket));
221
- socket.on('error', () => clients.delete(socket));
222
- }
223
-
224
- function handleMessage(text) {
225
- let event;
226
- try {
227
- event = JSON.parse(text);
228
- } catch (e) {
229
- console.error('Failed to parse WebSocket message:', e.message);
230
- return;
231
- }
232
- touchActivity();
233
- console.log(JSON.stringify({ source: 'user-event', ...event }));
234
- if (event.choice) {
235
- const eventsFile = path.join(STATE_DIR, 'events');
236
- fs.appendFileSync(eventsFile, JSON.stringify(event) + '\n');
237
- }
238
- }
239
-
240
- function broadcast(msg) {
241
- const frame = encodeFrame(OPCODES.TEXT, Buffer.from(JSON.stringify(msg)));
242
- for (const socket of clients) {
243
- try { socket.write(frame); } catch (e) { clients.delete(socket); }
244
- }
245
- }
246
-
247
- // ========== Activity Tracking ==========
248
-
249
- const IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
250
- let lastActivity = Date.now();
251
-
252
- function touchActivity() {
253
- lastActivity = Date.now();
254
- }
255
-
256
- // ========== File Watching ==========
257
-
258
- const debounceTimers = new Map();
259
-
260
- // ========== Server Startup ==========
261
-
262
- function startServer() {
263
- if (!fs.existsSync(CONTENT_DIR)) fs.mkdirSync(CONTENT_DIR, { recursive: true });
264
- if (!fs.existsSync(STATE_DIR)) fs.mkdirSync(STATE_DIR, { recursive: true });
265
-
266
- // Track known files to distinguish new screens from updates.
267
- // macOS fs.watch reports 'rename' for both new files and overwrites,
268
- // so we can't rely on eventType alone.
269
- const knownFiles = new Set(
270
- fs.readdirSync(CONTENT_DIR).filter(f => f.endsWith('.html'))
271
- );
272
-
273
- const server = http.createServer(handleRequest);
274
- server.on('upgrade', handleUpgrade);
275
-
276
- const watcher = fs.watch(CONTENT_DIR, (eventType, filename) => {
277
- if (!filename || !filename.endsWith('.html')) return;
278
-
279
- if (debounceTimers.has(filename)) clearTimeout(debounceTimers.get(filename));
280
- debounceTimers.set(filename, setTimeout(() => {
281
- debounceTimers.delete(filename);
282
- const filePath = path.join(CONTENT_DIR, filename);
283
-
284
- if (!fs.existsSync(filePath)) return; // file was deleted
285
- touchActivity();
286
-
287
- if (!knownFiles.has(filename)) {
288
- knownFiles.add(filename);
289
- const eventsFile = path.join(STATE_DIR, 'events');
290
- if (fs.existsSync(eventsFile)) fs.unlinkSync(eventsFile);
291
- console.log(JSON.stringify({ type: 'screen-added', file: filePath }));
292
- } else {
293
- console.log(JSON.stringify({ type: 'screen-updated', file: filePath }));
294
- }
295
-
296
- broadcast({ type: 'reload' });
297
- }, 100));
298
- });
299
- watcher.on('error', (err) => console.error('fs.watch error:', err.message));
300
-
301
- function shutdown(reason) {
302
- console.log(JSON.stringify({ type: 'server-stopped', reason }));
303
- const infoFile = path.join(STATE_DIR, 'server-info');
304
- if (fs.existsSync(infoFile)) fs.unlinkSync(infoFile);
305
- fs.writeFileSync(
306
- path.join(STATE_DIR, 'server-stopped'),
307
- JSON.stringify({ reason, timestamp: Date.now() }) + '\n'
308
- );
309
- watcher.close();
310
- clearInterval(lifecycleCheck);
311
- server.close(() => process.exit(0));
312
- }
313
-
314
- function ownerAlive() {
315
- if (!ownerPid) return true;
316
- try { process.kill(ownerPid, 0); return true; } catch (e) { return e.code === 'EPERM'; }
317
- }
318
-
319
- // Check every 60s: exit if owner process died or idle for 30 minutes
320
- const lifecycleCheck = setInterval(() => {
321
- if (!ownerAlive()) shutdown('owner process exited');
322
- else if (Date.now() - lastActivity > IDLE_TIMEOUT_MS) shutdown('idle timeout');
323
- }, 60 * 1000);
324
- lifecycleCheck.unref();
325
-
326
- // Validate owner PID at startup. If it's already dead, the PID resolution
327
- // was wrong (common on WSL, Tailscale SSH, and cross-user scenarios).
328
- // Disable monitoring and rely on the idle timeout instead.
329
- if (ownerPid) {
330
- try { process.kill(ownerPid, 0); }
331
- catch (e) {
332
- if (e.code !== 'EPERM') {
333
- console.log(JSON.stringify({ type: 'owner-pid-invalid', pid: ownerPid, reason: 'dead at startup' }));
334
- ownerPid = null;
335
- }
336
- }
337
- }
338
-
339
- server.listen(PORT, HOST, () => {
340
- const info = JSON.stringify({
341
- type: 'server-started', port: Number(PORT), host: HOST,
342
- url_host: URL_HOST, url: 'http://' + URL_HOST + ':' + PORT,
343
- screen_dir: CONTENT_DIR, state_dir: STATE_DIR
344
- });
345
- console.log(info);
346
- fs.writeFileSync(path.join(STATE_DIR, 'server-info'), info + '\n');
347
- });
348
- }
349
-
350
- if (require.main === module) {
351
- startServer();
352
- }
353
-
354
- module.exports = { computeAcceptKey, encodeFrame, decodeFrame, OPCODES };
@@ -1,148 +0,0 @@
1
- #!/usr/bin/env bash
2
- # Start the brainstorm server and output connection info
3
- # Usage: start-server.sh [--project-dir <path>] [--host <bind-host>] [--url-host <display-host>] [--foreground] [--background]
4
- #
5
- # Starts server on a random high port, outputs JSON with URL.
6
- # Each session gets its own directory to avoid conflicts.
7
- #
8
- # Options:
9
- # --project-dir <path> Store session files under <path>/.MindForge/brainstorm/
10
- # instead of /tmp. Files persist after server stops.
11
- # --host <bind-host> Host/interface to bind (default: 127.0.0.1).
12
- # Use 0.0.0.0 in remote/containerized environments.
13
- # --url-host <host> Hostname shown in returned URL JSON.
14
- # --foreground Run server in the current terminal (no backgrounding).
15
- # --background Force background mode (overrides Codex auto-foreground).
16
-
17
- SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
18
-
19
- # Parse arguments
20
- PROJECT_DIR=""
21
- FOREGROUND="false"
22
- FORCE_BACKGROUND="false"
23
- BIND_HOST="127.0.0.1"
24
- URL_HOST=""
25
- while [[ $# -gt 0 ]]; do
26
- case "$1" in
27
- --project-dir)
28
- PROJECT_DIR="$2"
29
- shift 2
30
- ;;
31
- --host)
32
- BIND_HOST="$2"
33
- shift 2
34
- ;;
35
- --url-host)
36
- URL_HOST="$2"
37
- shift 2
38
- ;;
39
- --foreground|--no-daemon)
40
- FOREGROUND="true"
41
- shift
42
- ;;
43
- --background|--daemon)
44
- FORCE_BACKGROUND="true"
45
- shift
46
- ;;
47
- *)
48
- echo "{\"error\": \"Unknown argument: $1\"}"
49
- exit 1
50
- ;;
51
- esac
52
- done
53
-
54
- if [[ -z "$URL_HOST" ]]; then
55
- if [[ "$BIND_HOST" == "127.0.0.1" || "$BIND_HOST" == "localhost" ]]; then
56
- URL_HOST="localhost"
57
- else
58
- URL_HOST="$BIND_HOST"
59
- fi
60
- fi
61
-
62
- # Some environments reap detached/background processes. Auto-foreground when detected.
63
- if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
64
- FOREGROUND="true"
65
- fi
66
-
67
- # Windows/Git Bash reaps nohup background processes. Auto-foreground when detected.
68
- if [[ "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
69
- case "${OSTYPE:-}" in
70
- msys*|cygwin*|mingw*) FOREGROUND="true" ;;
71
- esac
72
- if [[ -n "${MSYSTEM:-}" ]]; then
73
- FOREGROUND="true"
74
- fi
75
- fi
76
-
77
- # Generate unique session directory
78
- SESSION_ID="$$-$(date +%s)"
79
-
80
- if [[ -n "$PROJECT_DIR" ]]; then
81
- SESSION_DIR="${PROJECT_DIR}/.MindForge/brainstorm/${SESSION_ID}"
82
- else
83
- SESSION_DIR="/tmp/brainstorm-${SESSION_ID}"
84
- fi
85
-
86
- STATE_DIR="${SESSION_DIR}/state"
87
- PID_FILE="${STATE_DIR}/server.pid"
88
- LOG_FILE="${STATE_DIR}/server.log"
89
-
90
- # Create fresh session directory with content and state peers
91
- mkdir -p "${SESSION_DIR}/content" "$STATE_DIR"
92
-
93
- # Kill any existing server
94
- if [[ -f "$PID_FILE" ]]; then
95
- old_pid=$(cat "$PID_FILE")
96
- kill "$old_pid" 2>/dev/null
97
- rm -f "$PID_FILE"
98
- fi
99
-
100
- cd "$SCRIPT_DIR"
101
-
102
- # Resolve the harness PID (grandparent of this script).
103
- # $PPID is the ephemeral shell the harness spawned to run us — it dies
104
- # when this script exits. The harness itself is $PPID's parent.
105
- OWNER_PID="$(ps -o ppid= -p "$PPID" 2>/dev/null | tr -d ' ')"
106
- if [[ -z "$OWNER_PID" || "$OWNER_PID" == "1" ]]; then
107
- OWNER_PID="$PPID"
108
- fi
109
-
110
- # Foreground mode for environments that reap detached/background processes.
111
- if [[ "$FOREGROUND" == "true" ]]; then
112
- echo "$$" > "$PID_FILE"
113
- env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs
114
- exit $?
115
- fi
116
-
117
- # Start server, capturing output to log file
118
- # Use nohup to survive shell exit; disown to remove from job table
119
- nohup env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs > "$LOG_FILE" 2>&1 &
120
- SERVER_PID=$!
121
- disown "$SERVER_PID" 2>/dev/null
122
- echo "$SERVER_PID" > "$PID_FILE"
123
-
124
- # Wait for server-started message (check log file)
125
- for i in {1..50}; do
126
- if grep -q "server-started" "$LOG_FILE" 2>/dev/null; then
127
- # Verify server is still alive after a short window (catches process reapers)
128
- alive="true"
129
- for _ in {1..20}; do
130
- if ! kill -0 "$SERVER_PID" 2>/dev/null; then
131
- alive="false"
132
- break
133
- fi
134
- sleep 0.1
135
- done
136
- if [[ "$alive" != "true" ]]; then
137
- echo "{\"error\": \"Server started but was killed. Retry in a persistent terminal with: $SCRIPT_DIR/start-server.sh${PROJECT_DIR:+ --project-dir $PROJECT_DIR} --host $BIND_HOST --url-host $URL_HOST --foreground\"}"
138
- exit 1
139
- fi
140
- grep "server-started" "$LOG_FILE" | head -1
141
- exit 0
142
- fi
143
- sleep 0.1
144
- done
145
-
146
- # Timeout - server didn't start
147
- echo '{"error": "Server failed to start within 5 seconds"}'
148
- exit 1
@@ -1,56 +0,0 @@
1
- #!/usr/bin/env bash
2
- # Stop the brainstorm server and clean up
3
- # Usage: stop-server.sh <session_dir>
4
- #
5
- # Kills the server process. Only deletes session directory if it's
6
- # under /tmp (ephemeral). Persistent directories (.MindForge/) are
7
- # kept so mockups can be reviewed later.
8
-
9
- SESSION_DIR="$1"
10
-
11
- if [[ -z "$SESSION_DIR" ]]; then
12
- echo '{"error": "Usage: stop-server.sh <session_dir>"}'
13
- exit 1
14
- fi
15
-
16
- STATE_DIR="${SESSION_DIR}/state"
17
- PID_FILE="${STATE_DIR}/server.pid"
18
-
19
- if [[ -f "$PID_FILE" ]]; then
20
- pid=$(cat "$PID_FILE")
21
-
22
- # Try to stop gracefully, fallback to force if still alive
23
- kill "$pid" 2>/dev/null || true
24
-
25
- # Wait for graceful shutdown (up to ~2s)
26
- for i in {1..20}; do
27
- if ! kill -0 "$pid" 2>/dev/null; then
28
- break
29
- fi
30
- sleep 0.1
31
- done
32
-
33
- # If still running, escalate to SIGKILL
34
- if kill -0 "$pid" 2>/dev/null; then
35
- kill -9 "$pid" 2>/dev/null || true
36
-
37
- # Give SIGKILL a moment to take effect
38
- sleep 0.1
39
- fi
40
-
41
- if kill -0 "$pid" 2>/dev/null; then
42
- echo '{"status": "failed", "error": "process still running"}'
43
- exit 1
44
- fi
45
-
46
- rm -f "$PID_FILE" "${STATE_DIR}/server.log"
47
-
48
- # Only delete ephemeral /tmp directories
49
- if [[ "$SESSION_DIR" == /tmp/* ]]; then
50
- rm -rf "$SESSION_DIR"
51
- fi
52
-
53
- echo '{"status": "stopped"}'
54
- else
55
- echo '{"status": "not_running"}'
56
- fi
@@ -1,49 +0,0 @@
1
- # Spec Document Reviewer Prompt Template
2
-
3
- Use this template when dispatching a spec document reviewer subagent.
4
-
5
- **Purpose:** Verify the spec is complete, consistent, and ready for implementation planning.
6
-
7
- **Dispatch after:** Spec document is written to docs/mindforge/specs/
8
-
9
- ```
10
- Task tool (general-purpose):
11
- description: "Review spec document"
12
- prompt: |
13
- You are a spec document reviewer. Verify this spec is complete and ready for planning.
14
-
15
- **Spec to review:** [SPEC_FILE_PATH]
16
-
17
- ## What to Check
18
-
19
- | Category | What to Look For |
20
- |----------|------------------|
21
- | Completeness | TODOs, placeholders, "TBD", incomplete sections |
22
- | Consistency | Internal contradictions, conflicting requirements |
23
- | Clarity | Requirements ambiguous enough to cause someone to build the wrong thing |
24
- | Scope | Focused enough for a single plan — not covering multiple independent subsystems |
25
- | YAGNI | Unrequested features, over-engineering |
26
-
27
- ## Calibration
28
-
29
- **Only flag issues that would cause real problems during implementation planning.**
30
- A missing section, a contradiction, or a requirement so ambiguous it could be
31
- interpreted two different ways — those are issues. Minor wording improvements,
32
- stylistic preferences, and "sections less detailed than others" are not.
33
-
34
- Approve unless there are serious gaps that would lead to a flawed plan.
35
-
36
- ## Output Format
37
-
38
- ## Spec Review
39
-
40
- **Status:** Approved | Issues Found
41
-
42
- **Issues (if any):**
43
- - [Section X]: [specific issue] - [why it matters for planning]
44
-
45
- **Recommendations (advisory, do not block approval):**
46
- - [suggestions for improvement]
47
- ```
48
-
49
- **Reviewer returns:** Status, Issues (if any), Recommendations