agileflow 3.4.3 → 4.0.0-alpha.2

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 (762) hide show
  1. package/CHANGELOG.md +238 -473
  2. package/README.md +22 -114
  3. package/bin/agileflow.js +15 -0
  4. package/bin/hooks/pre-bash.js +35 -0
  5. package/bin/hooks/pre-compact.js +34 -0
  6. package/bin/hooks/pre-edit.js +32 -0
  7. package/bin/hooks/pre-write.js +32 -0
  8. package/bin/hooks/session-start.js +42 -0
  9. package/bin/hooks/stop.js +34 -0
  10. package/content/plugins/ads/plugin.yaml +14 -0
  11. package/content/plugins/audit/plugin.yaml +14 -0
  12. package/content/plugins/core/hooks/babysit-mentor-injector.js +55 -0
  13. package/content/plugins/core/hooks/context-loader.js +169 -0
  14. package/content/plugins/core/hooks/damage-control-bash.js +78 -0
  15. package/content/plugins/core/hooks/damage-control-edit.js +76 -0
  16. package/content/plugins/core/hooks/damage-control-patterns.yaml +100 -0
  17. package/content/plugins/core/hooks/damage-control-write.js +72 -0
  18. package/content/plugins/core/hooks/pre-compact-state.js +90 -0
  19. package/content/plugins/core/hooks/session-welcome.js +19 -0
  20. package/content/plugins/core/plugin.yaml +82 -0
  21. package/content/plugins/core/skills/agileflow-adr/SKILL.md +179 -0
  22. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +144 -0
  23. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +179 -0
  24. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +132 -0
  25. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +200 -0
  26. package/content/plugins/council/plugin.yaml +14 -0
  27. package/content/plugins/seo/plugin.yaml +14 -0
  28. package/package.json +29 -49
  29. package/src/cli/commands/doctor.js +159 -0
  30. package/src/cli/commands/hook.js +80 -0
  31. package/src/cli/commands/setup.js +292 -0
  32. package/src/cli/commands/status.js +47 -0
  33. package/src/cli/commands/update.js +83 -0
  34. package/src/cli/index.js +73 -0
  35. package/src/cli/wizard/behaviors-picker.js +108 -0
  36. package/src/cli/wizard/ide-picker.js +57 -0
  37. package/src/cli/wizard/personalization.js +64 -0
  38. package/src/cli/wizard/plugin-picker.js +106 -0
  39. package/src/lib/hash.js +41 -0
  40. package/src/runtime/config/defaults.js +61 -0
  41. package/src/runtime/config/loader.js +117 -0
  42. package/src/runtime/config/schema.json +99 -0
  43. package/src/runtime/config/writer.js +55 -0
  44. package/src/runtime/hooks/aggregator.js +157 -0
  45. package/src/runtime/hooks/chain.js +93 -0
  46. package/src/runtime/hooks/logger.js +68 -0
  47. package/src/runtime/hooks/manifest-loader.js +228 -0
  48. package/src/runtime/hooks/orchestrator.js +322 -0
  49. package/src/runtime/ide/capabilities.js +111 -0
  50. package/src/runtime/ide/claude-code-settings.js +234 -0
  51. package/src/runtime/ide/claude-code-skills.js +202 -0
  52. package/src/runtime/installer/file-index.js +112 -0
  53. package/src/runtime/installer/install.js +329 -0
  54. package/src/runtime/installer/stash.js +61 -0
  55. package/src/runtime/installer/sync-engine.js +205 -0
  56. package/src/runtime/plugins/registry.js +132 -0
  57. package/src/runtime/plugins/resolver.js +138 -0
  58. package/src/runtime/plugins/validator.js +196 -0
  59. package/src/runtime/skills/validator.js +335 -0
  60. package/lib/README.md +0 -178
  61. package/lib/api-routes.js +0 -625
  62. package/lib/api-server.js +0 -278
  63. package/lib/cache-provider.js +0 -155
  64. package/lib/codebase-indexer.js +0 -819
  65. package/lib/colors.generated.js +0 -117
  66. package/lib/colors.js +0 -341
  67. package/lib/consent.js +0 -232
  68. package/lib/content-sanitizer.js +0 -464
  69. package/lib/correlation.js +0 -277
  70. package/lib/drivers/claude-driver.ts +0 -312
  71. package/lib/drivers/codex-driver.ts +0 -464
  72. package/lib/drivers/driver-manager.ts +0 -159
  73. package/lib/drivers/gemini-driver.ts +0 -498
  74. package/lib/drivers/index.ts +0 -17
  75. package/lib/error-codes.js +0 -590
  76. package/lib/errors.js +0 -670
  77. package/lib/feature-flags.js +0 -171
  78. package/lib/feedback.js +0 -595
  79. package/lib/file-cache.js +0 -541
  80. package/lib/flag-detection.js +0 -344
  81. package/lib/format-error.js +0 -156
  82. package/lib/gate-runner.js +0 -282
  83. package/lib/generator-factory.js +0 -333
  84. package/lib/git-operations.js +0 -266
  85. package/lib/lazy-require.js +0 -59
  86. package/lib/lock-file.js +0 -144
  87. package/lib/logger.js +0 -106
  88. package/lib/merge-operations.js +0 -1006
  89. package/lib/path-resolver.js +0 -544
  90. package/lib/path-utils.js +0 -49
  91. package/lib/paths.js +0 -291
  92. package/lib/placeholder-registry.js +0 -822
  93. package/lib/process-executor.js +0 -214
  94. package/lib/progress.js +0 -334
  95. package/lib/protocol/driver.ts +0 -354
  96. package/lib/protocol/index.ts +0 -12
  97. package/lib/protocol/ir.ts +0 -271
  98. package/lib/registry-cache.js +0 -80
  99. package/lib/registry-di.js +0 -358
  100. package/lib/result-schema.js +0 -363
  101. package/lib/result.js +0 -210
  102. package/lib/session-display.js +0 -331
  103. package/lib/session-operations.js +0 -611
  104. package/lib/session-registry.js +0 -484
  105. package/lib/session-state-machine.js +0 -465
  106. package/lib/session-switching.js +0 -191
  107. package/lib/skill-loader.js +0 -213
  108. package/lib/smart-json-file.js +0 -682
  109. package/lib/state-machine.js +0 -286
  110. package/lib/table-formatter.js +0 -519
  111. package/lib/template-loader.js +0 -143
  112. package/lib/transient-status.js +0 -374
  113. package/lib/ui-manager.js +0 -612
  114. package/lib/validate-args.js +0 -213
  115. package/lib/validate-commands.js +0 -308
  116. package/lib/validate-names.js +0 -143
  117. package/lib/validate-paths.js +0 -434
  118. package/lib/validate.js +0 -134
  119. package/lib/worktree-operations.js +0 -201
  120. package/lib/yaml-utils.js +0 -164
  121. package/scripts/README.md +0 -267
  122. package/scripts/af +0 -34
  123. package/scripts/agent-loop.js +0 -879
  124. package/scripts/agileflow-configure.js +0 -368
  125. package/scripts/agileflow-statusline.sh +0 -857
  126. package/scripts/agileflow-welcome.js +0 -2246
  127. package/scripts/api-server-runner.js +0 -177
  128. package/scripts/archive-completed-stories.sh +0 -308
  129. package/scripts/auto-self-improve.js +0 -326
  130. package/scripts/automation-run-due.js +0 -128
  131. package/scripts/babysit-clear-restore.js +0 -154
  132. package/scripts/babysit-context-restore.js +0 -89
  133. package/scripts/backfill-ideation-status.js +0 -128
  134. package/scripts/batch-pmap-loop.js +0 -551
  135. package/scripts/check-sessions.js +0 -116
  136. package/scripts/check-update.js +0 -282
  137. package/scripts/ci-summary.js +0 -294
  138. package/scripts/claude-smart.sh +0 -85
  139. package/scripts/claude-tmux.sh +0 -737
  140. package/scripts/claude-watchdog.sh +0 -225
  141. package/scripts/clear-active-command.js +0 -48
  142. package/scripts/compress-status.sh +0 -116
  143. package/scripts/context-loader.js +0 -310
  144. package/scripts/damage-control/bash-tool-damage-control.js +0 -22
  145. package/scripts/damage-control/edit-tool-damage-control.js +0 -19
  146. package/scripts/damage-control/patterns.yaml +0 -227
  147. package/scripts/damage-control/write-tool-damage-control.js +0 -19
  148. package/scripts/damage-control-bash.js +0 -51
  149. package/scripts/damage-control-edit.js +0 -48
  150. package/scripts/damage-control-multi-agent.js +0 -231
  151. package/scripts/damage-control-write.js +0 -48
  152. package/scripts/dependency-check.js +0 -311
  153. package/scripts/document-repl.js +0 -793
  154. package/scripts/expertise-metrics.sh +0 -264
  155. package/scripts/generate-all.sh +0 -77
  156. package/scripts/generate-colors.js +0 -314
  157. package/scripts/generators/agent-registry.js +0 -183
  158. package/scripts/generators/command-registry.js +0 -166
  159. package/scripts/generators/index.js +0 -85
  160. package/scripts/generators/inject-babysit.js +0 -191
  161. package/scripts/generators/inject-help.js +0 -125
  162. package/scripts/generators/inject-readme.js +0 -166
  163. package/scripts/generators/skill-registry.js +0 -188
  164. package/scripts/get-env.js +0 -225
  165. package/scripts/init.sh +0 -76
  166. package/scripts/lib/README-portable-tasks.md +0 -424
  167. package/scripts/lib/ac-test-matcher.js +0 -452
  168. package/scripts/lib/audit-cleanup.js +0 -250
  169. package/scripts/lib/audit-registry.js +0 -340
  170. package/scripts/lib/automation-registry.js +0 -544
  171. package/scripts/lib/automation-runner.js +0 -476
  172. package/scripts/lib/browser-qa-evidence.js +0 -409
  173. package/scripts/lib/browser-qa-status.js +0 -192
  174. package/scripts/lib/bus-utils.js +0 -473
  175. package/scripts/lib/colors.generated.sh +0 -82
  176. package/scripts/lib/colors.sh +0 -46
  177. package/scripts/lib/command-prereqs.js +0 -280
  178. package/scripts/lib/concurrency-limiter.js +0 -511
  179. package/scripts/lib/configure-detect.js +0 -596
  180. package/scripts/lib/configure-features.js +0 -1927
  181. package/scripts/lib/configure-repair.js +0 -327
  182. package/scripts/lib/configure-utils.js +0 -114
  183. package/scripts/lib/context-formatter.js +0 -1158
  184. package/scripts/lib/context-loader.js +0 -840
  185. package/scripts/lib/counter.js +0 -103
  186. package/scripts/lib/damage-control-utils.js +0 -619
  187. package/scripts/lib/feature-catalog.js +0 -332
  188. package/scripts/lib/file-lock.js +0 -392
  189. package/scripts/lib/file-tracking.js +0 -735
  190. package/scripts/lib/frontmatter-parser.js +0 -133
  191. package/scripts/lib/gate-enforcer.js +0 -295
  192. package/scripts/lib/hook-metrics.js +0 -324
  193. package/scripts/lib/ideation-index.js +0 -1205
  194. package/scripts/lib/json-utils.sh +0 -162
  195. package/scripts/lib/lifecycle-detector.js +0 -125
  196. package/scripts/lib/model-profiles.js +0 -118
  197. package/scripts/lib/portable-tasks-cli.js +0 -274
  198. package/scripts/lib/portable-tasks.js +0 -479
  199. package/scripts/lib/process-cleanup.js +0 -527
  200. package/scripts/lib/quality-gates.js +0 -788
  201. package/scripts/lib/scale-detector.js +0 -396
  202. package/scripts/lib/sessionRegistry.js +0 -678
  203. package/scripts/lib/signal-detectors.js +0 -867
  204. package/scripts/lib/skill-catalog.js +0 -557
  205. package/scripts/lib/skill-recommender.js +0 -311
  206. package/scripts/lib/state-migrator.js +0 -353
  207. package/scripts/lib/status-task-bridge.js +0 -522
  208. package/scripts/lib/status-writer.js +0 -255
  209. package/scripts/lib/story-claiming.js +0 -704
  210. package/scripts/lib/story-state-machine.js +0 -437
  211. package/scripts/lib/sync-ideation-status.js +0 -291
  212. package/scripts/lib/task-registry-cache.js +0 -490
  213. package/scripts/lib/task-registry.js +0 -1191
  214. package/scripts/lib/task-sync.js +0 -230
  215. package/scripts/lib/tdd-phase-manager.js +0 -455
  216. package/scripts/lib/team-events.js +0 -510
  217. package/scripts/lib/tmux-audit-monitor.js +0 -612
  218. package/scripts/lib/tmux-group-colors.js +0 -113
  219. package/scripts/lib/tool-registry.yaml +0 -241
  220. package/scripts/lib/tool-shed.js +0 -441
  221. package/scripts/lib/validation-registry.js +0 -177
  222. package/scripts/messaging-bridge.js +0 -561
  223. package/scripts/migrate-ideation-index.js +0 -553
  224. package/scripts/native-team-observer.js +0 -219
  225. package/scripts/obtain-context.js +0 -272
  226. package/scripts/pre-push-check.sh +0 -46
  227. package/scripts/precompact-context.sh +0 -306
  228. package/scripts/query-codebase.js +0 -543
  229. package/scripts/ralph-loop.js +0 -1278
  230. package/scripts/resume-session.sh +0 -121
  231. package/scripts/screenshot-verifier.js +0 -215
  232. package/scripts/session-boundary.js +0 -138
  233. package/scripts/session-coordinator.sh +0 -232
  234. package/scripts/session-manager.js +0 -546
  235. package/scripts/smart-detect.js +0 -449
  236. package/scripts/spawn-audit-sessions.js +0 -877
  237. package/scripts/spawn-parallel.js +0 -751
  238. package/scripts/strip-ai-attribution.js +0 -63
  239. package/scripts/task-completed-gate.js +0 -237
  240. package/scripts/team-manager.js +0 -596
  241. package/scripts/team-status-display.js +0 -200
  242. package/scripts/teammate-idle-gate.js +0 -237
  243. package/scripts/test-session-boundary.js +0 -80
  244. package/scripts/tmux-close-windows.sh +0 -180
  245. package/scripts/tmux-restore-window.sh +0 -67
  246. package/scripts/tmux-save-closed-window.sh +0 -35
  247. package/scripts/tui/App.js +0 -151
  248. package/scripts/tui/Dashboard.js +0 -277
  249. package/scripts/tui/blessed/data/watcher.js +0 -180
  250. package/scripts/tui/blessed/index.js +0 -244
  251. package/scripts/tui/blessed/panels/output.js +0 -101
  252. package/scripts/tui/blessed/panels/sessions.js +0 -150
  253. package/scripts/tui/blessed/panels/trace.js +0 -97
  254. package/scripts/tui/blessed/ui/help.js +0 -77
  255. package/scripts/tui/blessed/ui/screen.js +0 -52
  256. package/scripts/tui/blessed/ui/statusbar.js +0 -47
  257. package/scripts/tui/blessed/ui/tabbar.js +0 -99
  258. package/scripts/tui/index.js +0 -70
  259. package/scripts/tui/lib/crashRecovery.js +0 -304
  260. package/scripts/tui/lib/eventStream.js +0 -309
  261. package/scripts/tui/lib/keyboard.js +0 -261
  262. package/scripts/tui/lib/loopControl.js +0 -371
  263. package/scripts/tui/panels/OutputPanel.js +0 -240
  264. package/scripts/tui/panels/SessionPanel.js +0 -170
  265. package/scripts/tui/panels/TracePanel.js +0 -298
  266. package/scripts/tui/simple-tui.js +0 -510
  267. package/scripts/validate-expertise.sh +0 -263
  268. package/scripts/validate-tokens.sh +0 -73
  269. package/scripts/validators/README.md +0 -143
  270. package/scripts/validators/component-validator.js +0 -239
  271. package/scripts/validators/json-schema-validator.js +0 -186
  272. package/scripts/validators/markdown-validator.js +0 -152
  273. package/scripts/validators/migration-validator.js +0 -129
  274. package/scripts/validators/security-validator.js +0 -380
  275. package/scripts/validators/story-format-validator.js +0 -197
  276. package/scripts/validators/test-result-validator.js +0 -114
  277. package/scripts/validators/workflow-validator.js +0 -247
  278. package/scripts/welcome-deferred.js +0 -437
  279. package/scripts/worktree-create.sh +0 -111
  280. package/src/core/agents/a11y-analyzer-aria.md +0 -155
  281. package/src/core/agents/a11y-analyzer-forms.md +0 -162
  282. package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
  283. package/src/core/agents/a11y-analyzer-semantic.md +0 -153
  284. package/src/core/agents/a11y-analyzer-visual.md +0 -158
  285. package/src/core/agents/a11y-consensus.md +0 -248
  286. package/src/core/agents/accessibility.md +0 -515
  287. package/src/core/agents/adr-writer.md +0 -463
  288. package/src/core/agents/ads-audit-budget.md +0 -181
  289. package/src/core/agents/ads-audit-compliance.md +0 -169
  290. package/src/core/agents/ads-audit-creative.md +0 -164
  291. package/src/core/agents/ads-audit-google.md +0 -226
  292. package/src/core/agents/ads-audit-meta.md +0 -183
  293. package/src/core/agents/ads-audit-tracking.md +0 -197
  294. package/src/core/agents/ads-consensus.md +0 -396
  295. package/src/core/agents/ads-generate.md +0 -145
  296. package/src/core/agents/ads-performance-tracker.md +0 -197
  297. package/src/core/agents/analytics.md +0 -617
  298. package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
  299. package/src/core/agents/api-quality-analyzer-docs.md +0 -176
  300. package/src/core/agents/api-quality-analyzer-errors.md +0 -183
  301. package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
  302. package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
  303. package/src/core/agents/api-quality-consensus.md +0 -214
  304. package/src/core/agents/api-validator.md +0 -183
  305. package/src/core/agents/api.md +0 -665
  306. package/src/core/agents/arch-analyzer-circular.md +0 -148
  307. package/src/core/agents/arch-analyzer-complexity.md +0 -171
  308. package/src/core/agents/arch-analyzer-coupling.md +0 -146
  309. package/src/core/agents/arch-analyzer-layering.md +0 -151
  310. package/src/core/agents/arch-analyzer-patterns.md +0 -162
  311. package/src/core/agents/arch-consensus.md +0 -227
  312. package/src/core/agents/brainstorm-analyzer-features.md +0 -169
  313. package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
  314. package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
  315. package/src/core/agents/brainstorm-analyzer-market.md +0 -147
  316. package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
  317. package/src/core/agents/brainstorm-consensus.md +0 -237
  318. package/src/core/agents/browser-qa.md +0 -328
  319. package/src/core/agents/ci.md +0 -511
  320. package/src/core/agents/code-reviewer.md +0 -288
  321. package/src/core/agents/codebase-query.md +0 -266
  322. package/src/core/agents/completeness-analyzer-api.md +0 -190
  323. package/src/core/agents/completeness-analyzer-conditional.md +0 -201
  324. package/src/core/agents/completeness-analyzer-handlers.md +0 -159
  325. package/src/core/agents/completeness-analyzer-imports.md +0 -159
  326. package/src/core/agents/completeness-analyzer-routes.md +0 -182
  327. package/src/core/agents/completeness-analyzer-state.md +0 -188
  328. package/src/core/agents/completeness-analyzer-stubs.md +0 -198
  329. package/src/core/agents/completeness-consensus.md +0 -286
  330. package/src/core/agents/compliance.md +0 -509
  331. package/src/core/agents/council-advocate.md +0 -206
  332. package/src/core/agents/council-analyst.md +0 -252
  333. package/src/core/agents/council-optimist.md +0 -170
  334. package/src/core/agents/database.md +0 -601
  335. package/src/core/agents/datamigration.md +0 -699
  336. package/src/core/agents/design.md +0 -525
  337. package/src/core/agents/devops.md +0 -720
  338. package/src/core/agents/documentation.md +0 -504
  339. package/src/core/agents/epic-planner.md +0 -480
  340. package/src/core/agents/error-analyzer.md +0 -201
  341. package/src/core/agents/integrations.md +0 -603
  342. package/src/core/agents/legal-analyzer-a11y.md +0 -110
  343. package/src/core/agents/legal-analyzer-ai.md +0 -117
  344. package/src/core/agents/legal-analyzer-consumer.md +0 -108
  345. package/src/core/agents/legal-analyzer-content.md +0 -113
  346. package/src/core/agents/legal-analyzer-international.md +0 -115
  347. package/src/core/agents/legal-analyzer-licensing.md +0 -115
  348. package/src/core/agents/legal-analyzer-privacy.md +0 -108
  349. package/src/core/agents/legal-analyzer-security.md +0 -112
  350. package/src/core/agents/legal-analyzer-terms.md +0 -111
  351. package/src/core/agents/legal-consensus.md +0 -242
  352. package/src/core/agents/logic-analyzer-edge.md +0 -170
  353. package/src/core/agents/logic-analyzer-flow.md +0 -253
  354. package/src/core/agents/logic-analyzer-invariant.md +0 -206
  355. package/src/core/agents/logic-analyzer-race.md +0 -266
  356. package/src/core/agents/logic-analyzer-type.md +0 -217
  357. package/src/core/agents/logic-consensus.md +0 -253
  358. package/src/core/agents/mentor.md +0 -654
  359. package/src/core/agents/mobile.md +0 -501
  360. package/src/core/agents/monitoring.md +0 -537
  361. package/src/core/agents/multi-expert.md +0 -311
  362. package/src/core/agents/orchestrator.md +0 -749
  363. package/src/core/agents/perf-analyzer-assets.md +0 -174
  364. package/src/core/agents/perf-analyzer-bundle.md +0 -165
  365. package/src/core/agents/perf-analyzer-caching.md +0 -160
  366. package/src/core/agents/perf-analyzer-compute.md +0 -165
  367. package/src/core/agents/perf-analyzer-memory.md +0 -182
  368. package/src/core/agents/perf-analyzer-network.md +0 -157
  369. package/src/core/agents/perf-analyzer-queries.md +0 -155
  370. package/src/core/agents/perf-analyzer-rendering.md +0 -156
  371. package/src/core/agents/perf-consensus.md +0 -280
  372. package/src/core/agents/performance.md +0 -492
  373. package/src/core/agents/product.md +0 -535
  374. package/src/core/agents/qa.md +0 -765
  375. package/src/core/agents/readme-updater.md +0 -579
  376. package/src/core/agents/refactor.md +0 -558
  377. package/src/core/agents/research.md +0 -453
  378. package/src/core/agents/rlm-subcore.md +0 -207
  379. package/src/core/agents/schema-validator.md +0 -454
  380. package/src/core/agents/security-analyzer-api.md +0 -199
  381. package/src/core/agents/security-analyzer-auth.md +0 -160
  382. package/src/core/agents/security-analyzer-authz.md +0 -168
  383. package/src/core/agents/security-analyzer-deps.md +0 -147
  384. package/src/core/agents/security-analyzer-infra.md +0 -176
  385. package/src/core/agents/security-analyzer-injection.md +0 -148
  386. package/src/core/agents/security-analyzer-input.md +0 -191
  387. package/src/core/agents/security-analyzer-secrets.md +0 -175
  388. package/src/core/agents/security-consensus.md +0 -276
  389. package/src/core/agents/security.md +0 -486
  390. package/src/core/agents/seo-analyzer-content.md +0 -167
  391. package/src/core/agents/seo-analyzer-images.md +0 -187
  392. package/src/core/agents/seo-analyzer-performance.md +0 -206
  393. package/src/core/agents/seo-analyzer-schema.md +0 -176
  394. package/src/core/agents/seo-analyzer-sitemap.md +0 -172
  395. package/src/core/agents/seo-analyzer-technical.md +0 -144
  396. package/src/core/agents/seo-consensus.md +0 -289
  397. package/src/core/agents/team-coordinator.md +0 -333
  398. package/src/core/agents/team-lead.md +0 -171
  399. package/src/core/agents/test-analyzer-assertions.md +0 -181
  400. package/src/core/agents/test-analyzer-coverage.md +0 -183
  401. package/src/core/agents/test-analyzer-fragility.md +0 -185
  402. package/src/core/agents/test-analyzer-integration.md +0 -155
  403. package/src/core/agents/test-analyzer-maintenance.md +0 -173
  404. package/src/core/agents/test-analyzer-mocking.md +0 -178
  405. package/src/core/agents/test-analyzer-patterns.md +0 -189
  406. package/src/core/agents/test-analyzer-structure.md +0 -177
  407. package/src/core/agents/test-consensus.md +0 -294
  408. package/src/core/agents/testing.md +0 -527
  409. package/src/core/agents/ui-validator.md +0 -331
  410. package/src/core/agents/ui.md +0 -1227
  411. package/src/core/commands/adr/list.md +0 -191
  412. package/src/core/commands/adr/update.md +0 -258
  413. package/src/core/commands/adr/view.md +0 -274
  414. package/src/core/commands/adr.md +0 -394
  415. package/src/core/commands/ads/audit.md +0 -453
  416. package/src/core/commands/ads/budget.md +0 -97
  417. package/src/core/commands/ads/competitor.md +0 -112
  418. package/src/core/commands/ads/creative.md +0 -85
  419. package/src/core/commands/ads/generate.md +0 -238
  420. package/src/core/commands/ads/google.md +0 -112
  421. package/src/core/commands/ads/health.md +0 -327
  422. package/src/core/commands/ads/landing.md +0 -119
  423. package/src/core/commands/ads/linkedin.md +0 -112
  424. package/src/core/commands/ads/meta.md +0 -91
  425. package/src/core/commands/ads/microsoft.md +0 -115
  426. package/src/core/commands/ads/plan.md +0 -321
  427. package/src/core/commands/ads/test-plan.md +0 -317
  428. package/src/core/commands/ads/tiktok.md +0 -129
  429. package/src/core/commands/ads/track.md +0 -288
  430. package/src/core/commands/ads/youtube.md +0 -124
  431. package/src/core/commands/ads.md +0 -140
  432. package/src/core/commands/agent.md +0 -256
  433. package/src/core/commands/api.md +0 -267
  434. package/src/core/commands/assign.md +0 -369
  435. package/src/core/commands/audit.md +0 -531
  436. package/src/core/commands/auto.md +0 -556
  437. package/src/core/commands/automate.md +0 -415
  438. package/src/core/commands/babysit.md +0 -643
  439. package/src/core/commands/baseline.md +0 -743
  440. package/src/core/commands/batch.md +0 -551
  441. package/src/core/commands/blockers.md +0 -602
  442. package/src/core/commands/board.md +0 -509
  443. package/src/core/commands/browser-qa.md +0 -240
  444. package/src/core/commands/changelog.md +0 -582
  445. package/src/core/commands/choose.md +0 -430
  446. package/src/core/commands/ci.md +0 -330
  447. package/src/core/commands/code/accessibility.md +0 -363
  448. package/src/core/commands/code/api.md +0 -313
  449. package/src/core/commands/code/architecture.md +0 -313
  450. package/src/core/commands/code/completeness.md +0 -519
  451. package/src/core/commands/code/legal.md +0 -509
  452. package/src/core/commands/code/logic.md +0 -432
  453. package/src/core/commands/code/performance.md +0 -506
  454. package/src/core/commands/code/security.md +0 -509
  455. package/src/core/commands/code/test.md +0 -505
  456. package/src/core/commands/compress.md +0 -408
  457. package/src/core/commands/configure.md +0 -1159
  458. package/src/core/commands/context/export.md +0 -296
  459. package/src/core/commands/context/full.md +0 -353
  460. package/src/core/commands/context/note.md +0 -380
  461. package/src/core/commands/council.md +0 -592
  462. package/src/core/commands/debt.md +0 -491
  463. package/src/core/commands/deploy.md +0 -864
  464. package/src/core/commands/deps.md +0 -728
  465. package/src/core/commands/diagnose.md +0 -404
  466. package/src/core/commands/docs.md +0 -469
  467. package/src/core/commands/epic/edit.md +0 -213
  468. package/src/core/commands/epic/list.md +0 -190
  469. package/src/core/commands/epic/view.md +0 -267
  470. package/src/core/commands/epic.md +0 -477
  471. package/src/core/commands/export.md +0 -238
  472. package/src/core/commands/feedback.md +0 -603
  473. package/src/core/commands/handoff.md +0 -386
  474. package/src/core/commands/help.md +0 -194
  475. package/src/core/commands/ideate/brief.md +0 -363
  476. package/src/core/commands/ideate/discover.md +0 -399
  477. package/src/core/commands/ideate/features.md +0 -497
  478. package/src/core/commands/ideate/history.md +0 -403
  479. package/src/core/commands/ideate/new.md +0 -900
  480. package/src/core/commands/impact.md +0 -407
  481. package/src/core/commands/install.md +0 -529
  482. package/src/core/commands/learn/explain.md +0 -118
  483. package/src/core/commands/learn/glossary.md +0 -135
  484. package/src/core/commands/learn/patterns.md +0 -138
  485. package/src/core/commands/learn/tour.md +0 -126
  486. package/src/core/commands/maintain.md +0 -558
  487. package/src/core/commands/metrics.md +0 -844
  488. package/src/core/commands/migrate/codemods.md +0 -151
  489. package/src/core/commands/migrate/plan.md +0 -131
  490. package/src/core/commands/migrate/scan.md +0 -114
  491. package/src/core/commands/migrate/validate.md +0 -119
  492. package/src/core/commands/multi-expert.md +0 -447
  493. package/src/core/commands/packages.md +0 -535
  494. package/src/core/commands/pr.md +0 -337
  495. package/src/core/commands/readme-sync.md +0 -329
  496. package/src/core/commands/research/analyze.md +0 -798
  497. package/src/core/commands/research/ask.md +0 -864
  498. package/src/core/commands/research/import.md +0 -1025
  499. package/src/core/commands/research/list.md +0 -273
  500. package/src/core/commands/research/synthesize.md +0 -928
  501. package/src/core/commands/research/view.md +0 -323
  502. package/src/core/commands/retro.md +0 -795
  503. package/src/core/commands/review.md +0 -694
  504. package/src/core/commands/rlm.md +0 -446
  505. package/src/core/commands/roadmap/analyze.md +0 -400
  506. package/src/core/commands/rpi.md +0 -633
  507. package/src/core/commands/seo/audit.md +0 -444
  508. package/src/core/commands/seo/competitor.md +0 -174
  509. package/src/core/commands/seo/content.md +0 -107
  510. package/src/core/commands/seo/geo.md +0 -229
  511. package/src/core/commands/seo/hreflang.md +0 -140
  512. package/src/core/commands/seo/images.md +0 -96
  513. package/src/core/commands/seo/page.md +0 -198
  514. package/src/core/commands/seo/plan.md +0 -163
  515. package/src/core/commands/seo/programmatic.md +0 -131
  516. package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
  517. package/src/core/commands/seo/references/eeat-framework.md +0 -110
  518. package/src/core/commands/seo/references/quality-gates.md +0 -91
  519. package/src/core/commands/seo/references/schema-types.md +0 -102
  520. package/src/core/commands/seo/schema.md +0 -183
  521. package/src/core/commands/seo/sitemap.md +0 -97
  522. package/src/core/commands/seo/technical.md +0 -100
  523. package/src/core/commands/seo.md +0 -107
  524. package/src/core/commands/session/cleanup.md +0 -452
  525. package/src/core/commands/session/end.md +0 -865
  526. package/src/core/commands/session/history.md +0 -293
  527. package/src/core/commands/session/init.md +0 -210
  528. package/src/core/commands/session/new.md +0 -827
  529. package/src/core/commands/session/resume.md +0 -291
  530. package/src/core/commands/session/spawn.md +0 -205
  531. package/src/core/commands/session/status.md +0 -274
  532. package/src/core/commands/skill/list.md +0 -139
  533. package/src/core/commands/skill/recommend.md +0 -216
  534. package/src/core/commands/sprint.md +0 -714
  535. package/src/core/commands/status/undo.md +0 -191
  536. package/src/core/commands/status.md +0 -423
  537. package/src/core/commands/story/edit.md +0 -204
  538. package/src/core/commands/story/list.md +0 -199
  539. package/src/core/commands/story/view.md +0 -312
  540. package/src/core/commands/story-validate.md +0 -491
  541. package/src/core/commands/story.md +0 -465
  542. package/src/core/commands/tdd-next.md +0 -238
  543. package/src/core/commands/tdd.md +0 -211
  544. package/src/core/commands/team/guide.md +0 -688
  545. package/src/core/commands/team/list.md +0 -59
  546. package/src/core/commands/team/start.md +0 -130
  547. package/src/core/commands/team/status.md +0 -66
  548. package/src/core/commands/team/stop.md +0 -78
  549. package/src/core/commands/template.md +0 -644
  550. package/src/core/commands/tests.md +0 -731
  551. package/src/core/commands/update.md +0 -591
  552. package/src/core/commands/validate-expertise.md +0 -305
  553. package/src/core/commands/velocity.md +0 -630
  554. package/src/core/commands/verify.md +0 -534
  555. package/src/core/commands/whats-new.md +0 -201
  556. package/src/core/commands/workflow.md +0 -449
  557. package/src/core/council/sessions/.gitkeep +0 -0
  558. package/src/core/council/shared_reasoning.template.md +0 -106
  559. package/src/core/experts/README.md +0 -236
  560. package/src/core/experts/_core-expertise.yaml +0 -105
  561. package/src/core/experts/accessibility/expertise.yaml +0 -115
  562. package/src/core/experts/accessibility/question.md +0 -41
  563. package/src/core/experts/accessibility/self-improve.md +0 -45
  564. package/src/core/experts/accessibility/workflow.md +0 -59
  565. package/src/core/experts/adr-writer/expertise.yaml +0 -138
  566. package/src/core/experts/adr-writer/question.md +0 -56
  567. package/src/core/experts/adr-writer/self-improve.md +0 -106
  568. package/src/core/experts/adr-writer/workflow.md +0 -184
  569. package/src/core/experts/analytics/expertise.yaml +0 -119
  570. package/src/core/experts/analytics/question.md +0 -74
  571. package/src/core/experts/analytics/self-improve.md +0 -163
  572. package/src/core/experts/analytics/workflow.md +0 -272
  573. package/src/core/experts/api/expertise.yaml +0 -124
  574. package/src/core/experts/api/question.md +0 -74
  575. package/src/core/experts/api/self-improve.md +0 -122
  576. package/src/core/experts/api/workflow.md +0 -248
  577. package/src/core/experts/ci/expertise.yaml +0 -106
  578. package/src/core/experts/ci/question.md +0 -69
  579. package/src/core/experts/ci/self-improve.md +0 -100
  580. package/src/core/experts/ci/workflow.md +0 -145
  581. package/src/core/experts/codebase-query/expertise.yaml +0 -121
  582. package/src/core/experts/codebase-query/question.md +0 -73
  583. package/src/core/experts/codebase-query/self-improve.md +0 -105
  584. package/src/core/experts/compliance/expertise.yaml +0 -101
  585. package/src/core/experts/compliance/question.md +0 -56
  586. package/src/core/experts/compliance/self-improve.md +0 -106
  587. package/src/core/experts/compliance/workflow.md +0 -184
  588. package/src/core/experts/database/expertise.yaml +0 -109
  589. package/src/core/experts/database/question.md +0 -74
  590. package/src/core/experts/database/self-improve.md +0 -121
  591. package/src/core/experts/database/workflow.md +0 -234
  592. package/src/core/experts/datamigration/expertise.yaml +0 -141
  593. package/src/core/experts/datamigration/question.md +0 -56
  594. package/src/core/experts/datamigration/self-improve.md +0 -106
  595. package/src/core/experts/datamigration/workflow.md +0 -184
  596. package/src/core/experts/design/expertise.yaml +0 -116
  597. package/src/core/experts/design/question.md +0 -56
  598. package/src/core/experts/design/self-improve.md +0 -106
  599. package/src/core/experts/design/workflow.md +0 -184
  600. package/src/core/experts/devops/expertise.yaml +0 -116
  601. package/src/core/experts/devops/question.md +0 -68
  602. package/src/core/experts/devops/self-improve.md +0 -102
  603. package/src/core/experts/devops/workflow.md +0 -142
  604. package/src/core/experts/documentation/expertise.yaml +0 -126
  605. package/src/core/experts/documentation/question.md +0 -41
  606. package/src/core/experts/documentation/self-improve.md +0 -45
  607. package/src/core/experts/documentation/workflow.md +0 -55
  608. package/src/core/experts/epic-planner/expertise.yaml +0 -144
  609. package/src/core/experts/epic-planner/question.md +0 -56
  610. package/src/core/experts/epic-planner/self-improve.md +0 -106
  611. package/src/core/experts/epic-planner/workflow.md +0 -184
  612. package/src/core/experts/integrations/expertise.yaml +0 -113
  613. package/src/core/experts/integrations/question.md +0 -74
  614. package/src/core/experts/integrations/self-improve.md +0 -151
  615. package/src/core/experts/integrations/workflow.md +0 -246
  616. package/src/core/experts/mentor/expertise.yaml +0 -125
  617. package/src/core/experts/mentor/question.md +0 -56
  618. package/src/core/experts/mentor/self-improve.md +0 -106
  619. package/src/core/experts/mentor/workflow.md +0 -184
  620. package/src/core/experts/mobile/expertise.yaml +0 -136
  621. package/src/core/experts/mobile/question.md +0 -72
  622. package/src/core/experts/mobile/self-improve.md +0 -140
  623. package/src/core/experts/mobile/workflow.md +0 -240
  624. package/src/core/experts/monitoring/expertise.yaml +0 -132
  625. package/src/core/experts/monitoring/question.md +0 -76
  626. package/src/core/experts/monitoring/self-improve.md +0 -150
  627. package/src/core/experts/monitoring/workflow.md +0 -264
  628. package/src/core/experts/performance/expertise.yaml +0 -68
  629. package/src/core/experts/performance/question.md +0 -41
  630. package/src/core/experts/performance/self-improve.md +0 -45
  631. package/src/core/experts/performance/workflow.md +0 -61
  632. package/src/core/experts/product/expertise.yaml +0 -143
  633. package/src/core/experts/product/question.md +0 -56
  634. package/src/core/experts/product/self-improve.md +0 -106
  635. package/src/core/experts/product/workflow.md +0 -184
  636. package/src/core/experts/qa/expertise.yaml +0 -110
  637. package/src/core/experts/qa/question.md +0 -56
  638. package/src/core/experts/qa/self-improve.md +0 -106
  639. package/src/core/experts/qa/workflow.md +0 -184
  640. package/src/core/experts/readme-updater/expertise.yaml +0 -141
  641. package/src/core/experts/readme-updater/question.md +0 -56
  642. package/src/core/experts/readme-updater/self-improve.md +0 -106
  643. package/src/core/experts/readme-updater/workflow.md +0 -184
  644. package/src/core/experts/refactor/expertise.yaml +0 -135
  645. package/src/core/experts/refactor/question.md +0 -41
  646. package/src/core/experts/refactor/self-improve.md +0 -45
  647. package/src/core/experts/refactor/workflow.md +0 -57
  648. package/src/core/experts/research/expertise.yaml +0 -143
  649. package/src/core/experts/research/question.md +0 -56
  650. package/src/core/experts/research/self-improve.md +0 -106
  651. package/src/core/experts/research/workflow.md +0 -184
  652. package/src/core/experts/security/expertise.yaml +0 -117
  653. package/src/core/experts/security/question.md +0 -77
  654. package/src/core/experts/security/self-improve.md +0 -102
  655. package/src/core/experts/security/workflow.md +0 -152
  656. package/src/core/experts/templates/expertise-template.yaml +0 -67
  657. package/src/core/experts/templates/question-template.md +0 -56
  658. package/src/core/experts/templates/self-improve-template.md +0 -106
  659. package/src/core/experts/templates/workflow-template.md +0 -184
  660. package/src/core/experts/testing/expertise.yaml +0 -112
  661. package/src/core/experts/testing/question.md +0 -68
  662. package/src/core/experts/testing/self-improve.md +0 -102
  663. package/src/core/experts/testing/workflow.md +0 -143
  664. package/src/core/experts/ui/expertise.yaml +0 -133
  665. package/src/core/experts/ui/question.md +0 -74
  666. package/src/core/experts/ui/self-improve.md +0 -122
  667. package/src/core/experts/ui/workflow.md +0 -262
  668. package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
  669. package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
  670. package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
  671. package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
  672. package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
  673. package/src/core/profiles/COMPARISON.md +0 -170
  674. package/src/core/profiles/README.md +0 -178
  675. package/src/core/profiles/claude-code.yaml +0 -111
  676. package/src/core/profiles/codex.yaml +0 -103
  677. package/src/core/profiles/cursor.yaml +0 -134
  678. package/src/core/profiles/examples.js +0 -250
  679. package/src/core/profiles/loader.js +0 -235
  680. package/src/core/profiles/windsurf.yaml +0 -159
  681. package/src/core/skills/_learnings/README.md +0 -91
  682. package/src/core/skills/_learnings/_template.yaml +0 -106
  683. package/src/core/skills/_learnings/code-review.yaml +0 -118
  684. package/src/core/skills/_learnings/commit.yaml +0 -69
  685. package/src/core/skills/_learnings/story-writer.yaml +0 -71
  686. package/src/core/teams/backend.json +0 -41
  687. package/src/core/teams/builder-validator.json +0 -51
  688. package/src/core/teams/code-review.json +0 -41
  689. package/src/core/teams/frontend.json +0 -41
  690. package/src/core/teams/fullstack.json +0 -41
  691. package/src/core/teams/logic-audit.json +0 -53
  692. package/src/core/teams/perf-audit.json +0 -71
  693. package/src/core/teams/qa.json +0 -41
  694. package/src/core/teams/security-audit.json +0 -71
  695. package/src/core/teams/solo.json +0 -35
  696. package/src/core/teams/test-audit.json +0 -71
  697. package/src/core/templates/CONTEXT.md.example +0 -49
  698. package/src/core/templates/README-template.md +0 -16
  699. package/src/core/templates/adr-template.md +0 -28
  700. package/src/core/templates/agent-coordination-pattern.md +0 -38
  701. package/src/core/templates/agent-profile-template.md +0 -51
  702. package/src/core/templates/agileflow-metadata.json +0 -150
  703. package/src/core/templates/browser-qa-spec.yaml +0 -94
  704. package/src/core/templates/ci-workflow.yml +0 -74
  705. package/src/core/templates/claude-settings.advanced.example.json +0 -75
  706. package/src/core/templates/claude-settings.example.json +0 -26
  707. package/src/core/templates/command-documentation.md +0 -187
  708. package/src/core/templates/command-prerequisites.yaml +0 -169
  709. package/src/core/templates/comms-note-template.md +0 -24
  710. package/src/core/templates/damage-control-patterns.yaml +0 -243
  711. package/src/core/templates/environment.json +0 -18
  712. package/src/core/templates/epic-template.md +0 -27
  713. package/src/core/templates/plan-template.md +0 -125
  714. package/src/core/templates/preserve-rules-common.md +0 -107
  715. package/src/core/templates/preserve-rules.json +0 -42
  716. package/src/core/templates/proactive-action-spec.md +0 -29
  717. package/src/core/templates/product-brief.md +0 -136
  718. package/src/core/templates/quality-gate-priorities.md +0 -34
  719. package/src/core/templates/research-template.md +0 -44
  720. package/src/core/templates/session-harness-protocol.md +0 -128
  721. package/src/core/templates/session-state.json +0 -56
  722. package/src/core/templates/story-lifecycle.md +0 -213
  723. package/src/core/templates/story-template.md +0 -92
  724. package/src/core/templates/tdd-test-template.js +0 -241
  725. package/src/core/templates/worktrees-guide.md +0 -231
  726. package/tools/agileflow-npx.js +0 -52
  727. package/tools/cli/agileflow-cli.js +0 -72
  728. package/tools/cli/commands/config.js +0 -285
  729. package/tools/cli/commands/doctor.js +0 -496
  730. package/tools/cli/commands/list.js +0 -385
  731. package/tools/cli/commands/session.js +0 -1176
  732. package/tools/cli/commands/setup.js +0 -255
  733. package/tools/cli/commands/status.js +0 -101
  734. package/tools/cli/commands/tui.js +0 -56
  735. package/tools/cli/commands/uninstall.js +0 -155
  736. package/tools/cli/commands/update.js +0 -299
  737. package/tools/cli/installers/core/installer.js +0 -892
  738. package/tools/cli/installers/ide/_base-ide.js +0 -518
  739. package/tools/cli/installers/ide/_interface.js +0 -238
  740. package/tools/cli/installers/ide/claude-code.js +0 -432
  741. package/tools/cli/installers/ide/codex.js +0 -426
  742. package/tools/cli/installers/ide/cursor.js +0 -217
  743. package/tools/cli/installers/ide/manager.js +0 -222
  744. package/tools/cli/installers/ide/windsurf.js +0 -282
  745. package/tools/cli/lib/command-context.js +0 -382
  746. package/tools/cli/lib/config-manager.js +0 -446
  747. package/tools/cli/lib/content-injector.js +0 -969
  748. package/tools/cli/lib/content-transformer.js +0 -496
  749. package/tools/cli/lib/docs-setup.js +0 -464
  750. package/tools/cli/lib/error-handler.js +0 -165
  751. package/tools/cli/lib/ide-error-factory.js +0 -421
  752. package/tools/cli/lib/ide-errors.js +0 -367
  753. package/tools/cli/lib/ide-generator.js +0 -357
  754. package/tools/cli/lib/ide-health-monitor.js +0 -364
  755. package/tools/cli/lib/ide-registry.js +0 -297
  756. package/tools/cli/lib/npm-utils.js +0 -103
  757. package/tools/cli/lib/self-update.js +0 -148
  758. package/tools/cli/lib/ui.js +0 -211
  759. package/tools/cli/lib/utils.js +0 -87
  760. package/tools/cli/lib/validation-middleware.js +0 -491
  761. package/tools/cli/lib/version-checker.js +0 -95
  762. package/tools/postinstall.js +0 -190
@@ -1,463 +0,0 @@
1
- ---
2
- name: agileflow-adr-writer
3
- description: Architecture Decision Record specialist. Use for documenting technical decisions, trade-offs, and alternatives considered. Ensures decisions are recorded for future reference.
4
- tools: Read, Write, Edit, Glob, Grep
5
- model: haiku
6
- team_role: teammate
7
- ---
8
-
9
- <!-- AGILEFLOW_META
10
- hooks:
11
- PostToolUse:
12
- - matcher: "Write"
13
- hooks:
14
- - type: command
15
- command: "node .agileflow/hooks/validators/markdown-validator.js"
16
- compact_context:
17
- priority: "high"
18
- preserve_rules:
19
- - "ALWAYS read expertise.yaml first"
20
- - "ALWAYS research alternatives before writing ADR"
21
- - "Minimum 2 alternatives (preferably 3-5)"
22
- - "Sequential numbering (check latest ADR)"
23
- - "Never delete ADRs (historical record)"
24
- - "Update README.md + bus/log.jsonl"
25
- state_fields:
26
- - "adr_number: Next sequential 4-digit (0001, 0002, etc)"
27
- - "decision_status: Proposed | Accepted | Deprecated | Superseded"
28
- - "alternatives_count: Minimum 2"
29
- - "research_cited: Reference to docs/10-research/ file"
30
- AGILEFLOW_META -->
31
-
32
-
33
- ## STEP 0: Gather Context
34
-
35
- ```bash
36
- node .agileflow/scripts/obtain-context.js adr-writer
37
- ```
38
-
39
- ---
40
-
41
- <!-- COMPACT_SUMMARY_START -->
42
-
43
- ## COMPACT SUMMARY - ADR WRITER ACTIVE
44
-
45
- CRITICAL: You document architecture decisions with context, alternatives, and consequences for future teams.
46
-
47
- RULE #1: WHEN TO CREATE ADR (Decision types)
48
- ```
49
- Technology Choices:
50
- - Framework (Next.js vs Express vs FastAPI)
51
- - Database (PostgreSQL vs MongoDB vs DynamoDB)
52
- - Language (TypeScript vs Python vs Go)
53
- - Library (React vs Vue, Jest vs Vitest)
54
-
55
- Architecture Patterns:
56
- - Monolith vs microservices
57
- - REST vs GraphQL vs tRPC
58
- - Sync vs async processing
59
- - Caching strategy (Redis, in-memory, CDN)
60
-
61
- Data & Security:
62
- - Schema design, normalization
63
- - Auth mechanism (JWT, session, OAuth2)
64
- - Encryption approach
65
- - Secrets management
66
-
67
- Infrastructure & DevOps:
68
- - Hosting (AWS, GCP, Heroku, self-hosted)
69
- - CI/CD platform (GitHub Actions, GitLab CI, Jenkins)
70
- - Monitoring & logging solution
71
- - Deployment strategy (blue-green, canary, rolling)
72
-
73
- Development Practices:
74
- - Testing strategy (unit, integration, E2E)
75
- - Git branching model (trunk-based, feature branches)
76
- - Code style (linter configs, formatting)
77
- - Documentation approach
78
- ```
79
-
80
- RULE #2: WORKFLOW (ALWAYS in order)
81
- ```
82
- 1. Read expertise.yaml (learn from past decisions)
83
- 2. Clarify decision (what's being decided, why now?)
84
- 3. Check docs/10-research/ for research
85
- → If missing → Invoke /agileflow:research:ask TOPIC="..."
86
- → Wait for research to complete
87
- 4. Check docs/03-decisions/ for related ADRs
88
- 5. Get next ADR number from README.md (sequential)
89
- 6. Propose ADR structure:
90
- - Context (forces, constraints, timeline)
91
- - Decision (what was chosen, why)
92
- - Alternatives (2-5 options with pros/cons)
93
- - Consequences (positive, negative, neutral)
94
- - Status (Proposed, Accepted, Deprecated, Superseded)
95
- - References (research notes, docs, RFCs, benchmarks)
96
- 7. Show diff-first preview
97
- 8. Get YES/NO confirmation
98
- 9. Create docs/03-decisions/adr-<NUMBER>-<slug>.md
99
- 10. Update docs/03-decisions/README.md
100
- 11. Append bus message
101
- ```
102
-
103
- RULE #3: ADR STRUCTURE (ALWAYS required)
104
- ```markdown
105
- # ADR-<NUMBER>: <Decision Title>
106
-
107
- **Date**: YYYY-MM-DD
108
- **Status**: Proposed | Accepted | Deprecated | Superseded
109
- **Deciders**: [Names/roles]
110
-
111
- ## Context
112
- [Forces at play: technical, business, team, timeline constraints]
113
- [What problem are we solving?]
114
- [Why is this decision needed NOW?]
115
-
116
- ## Decision
117
- [State clearly what was chosen (1-3 sentences)]
118
- [Key reasons for this choice]
119
-
120
- ## Alternatives Considered
121
-
122
- ### Option A: [Name]
123
- **Pros**:
124
- - [Benefit 1]
125
- - [Benefit 2]
126
-
127
- **Cons**:
128
- - [Cost 1]
129
- - [Cost 2]
130
-
131
- **Why rejected**: [Reason if rejected]
132
-
133
- ### Option B: [Name]
134
- ...
135
-
136
- ### Option C: [Name]
137
- ...
138
-
139
- ## Consequences
140
-
141
- ### Positive
142
- - [Benefit we expect]
143
- - [Improvement]
144
-
145
- ### Negative
146
- - [Cost/limitation]
147
- - [Trade-off]
148
-
149
- ### Neutral
150
- - [Change that's neither good nor bad]
151
-
152
- ## References
153
- - [Title](URL) - Description - Retrieved YYYY-MM-DD
154
- - ADR-0001, ADR-0003 (related decisions)
155
- - docs/10-research/20250107-jwt-auth.md (supporting research)
156
-
157
- ## See Also
158
- - Related ADRs: ADR-0005 (predecessor), ADR-0008 (successor)
159
- - Stories: US-0042, US-0055 (implementation)
160
- ```
161
-
162
- RULE #4: STATUS LIFECYCLE (Clear meanings)
163
- | Status | Meaning | Use Case |
164
- |--------|---------|----------|
165
- | **Proposed** | Under review, not approved | New decision being discussed |
166
- | **Accepted** | Approved, should be followed | Decision made, teams should implement |
167
- | **Deprecated** | No longer recommended | Kept for history, superseded |
168
- | **Superseded** | Replaced by newer ADR | Link to new ADR: "See ADR-0008" |
169
-
170
- Example progression:
171
- ```
172
- ADR-0001: Proposed → Accepted (after team review)
173
-
174
- ADR-0001: Accepted → Superseded (newer decision: ADR-0005)
175
-
176
- Keep ADR-0001 for historical record
177
- ```
178
-
179
- RULE #5: QUALITY CHECKLIST (BEFORE creating)
180
- ```
181
- ✅ Context explains WHY now (not just what)
182
- ✅ At least 2 alternatives documented
183
- ✅ Pros/cons for each alternative listed
184
- ✅ Decision clearly stated
185
- ✅ Consequences balanced (positive + negative + neutral)
186
- ✅ References included (research, docs, RFCs)
187
- ✅ Related ADRs linked
188
- ✅ Number sequential (no gaps, check latest)
189
- ✅ Diff reviewed, user confirmed YES/NO
190
- ```
191
-
192
- ### Anti-Patterns (DON'T)
193
- ❌ Skip research before writing ADR → Missing alternatives, weak decision
194
- ❌ Create ADR with <2 alternatives → Insufficient due diligence
195
- ❌ Use non-sequential numbers → Breaks chronology
196
- ❌ Delete old ADRs → Lose historical context
197
- ❌ Write vague context → Future teams can't understand why
198
- ❌ Skip consequences section → Miss impact analysis
199
-
200
- ### Correct Patterns (DO)
201
- ✅ Research first (invoke /agileflow:research:ask if needed)
202
- ✅ Include 2-5 alternatives with full trade-off analysis
203
- ✅ Number sequentially (check latest ADR-#### before creating)
204
- ✅ Keep old ADRs, mark Deprecated or Superseded
205
- ✅ Write specific context (forces, timeline, constraints)
206
- ✅ List both positive + negative consequences
207
-
208
- ### Key Files
209
- - ADRs: docs/03-decisions/adr-<NUMBER>-<slug>.md
210
- - Index: docs/03-decisions/README.md (table of all ADRs)
211
- - Research: docs/10-research/ (supporting research)
212
- - Expertise: packages/cli/src/core/experts/adr-writer/expertise.yaml
213
-
214
- ### REMEMBER AFTER COMPACTION
215
- 1. Read expertise.yaml first (learn from past decisions)
216
- 2. Research alternatives (web or ChatGPT prompt)
217
- 3. Include 2-5 alternatives with pros/cons
218
- 4. Number sequentially (0001, 0002, etc.)
219
- 5. Write full context (why now, not just what)
220
- 6. Update README.md + bus/log.jsonl
221
- 7. Keep old ADRs (mark Deprecated/Superseded)
222
-
223
- <!-- COMPACT_SUMMARY_END -->
224
-
225
- You are the AgileFlow ADR Writer, a specialist in documenting architecture decisions.
226
-
227
- ROLE & IDENTITY
228
- - Agent ID: ADR-WRITER
229
- - Specialization: Architecture Decision Records (ADRs), technical documentation, decision analysis
230
- - Part of the AgileFlow docs-as-code system
231
-
232
- AGILEFLOW CONTEXT
233
-
234
- **Key Directories**:
235
- - `docs/03-decisions/` → ADR storage (adr-####-slug.md)
236
- - `docs/10-research/` → Research notes (check before writing ADR)
237
- - `docs/05-epics/` and `docs/06-stories/` → Link ADRs to related work
238
- - `docs/02-practices/` → Development practices influenced by ADRs
239
-
240
- SHARED VOCABULARY
241
-
242
- **Use these terms consistently**:
243
- - **ADR** = Architecture Decision Record (documents why a choice was made)
244
- - **Context** = Forces at play (technical, business, team, timeline)
245
- - **Decision** = What was chosen (stated clearly)
246
- - **Alternatives** = Options considered but rejected (with pros/cons)
247
- - **Consequences** = Positive, negative, and neutral outcomes
248
- - **Status** = Proposed | Accepted | Deprecated | Superseded
249
-
250
- **ADR Statuses**:
251
- - **Proposed**: Under review, not yet approved
252
- - **Accepted**: Approved and should be followed
253
- - **Deprecated**: No longer recommended (but kept for history)
254
- - **Superseded**: Replaced by a newer ADR (link to replacement)
255
-
256
- **Bus Message Formats for ADR-WRITER**:
257
- ```jsonl
258
- {"ts":"2025-10-21T10:00:00Z","from":"ADR-WRITER","type":"status","text":"Created ADR-0005: Use PostgreSQL for data persistence"}
259
- ```
260
-
261
- SCOPE
262
- - Creating ADRs in docs/03-decisions/
263
- - Documenting technical choices and trade-offs
264
- - Recording alternatives considered (2-5 options with pros/cons)
265
- - Linking related decisions
266
- - Updating ADR status (Proposed, Accepted, Deprecated, Superseded)
267
- - Coordinating with RESEARCH agent for supporting research
268
-
269
- PURPOSE
270
- ADRs prevent re-debating decisions by:
271
- - Recording context at decision time
272
- - Documenting why a choice was made (not just what)
273
- - Listing alternatives considered and why they were rejected
274
- - Tracking consequences (positive, negative, neutral)
275
- - Providing a historical record for future teams and agents
276
-
277
- WHEN TO CREATE AN ADR
278
- Create an ADR when deciding:
279
- - Technology choices (framework, database, language, library)
280
- - Architecture patterns (monolith vs microservices, REST vs GraphQL)
281
- - Data modeling (schema design, normalization, caching strategy)
282
- - Security approaches (auth mechanism, encryption, secrets management)
283
- - Infrastructure (hosting, CI/CD, monitoring)
284
- - Development practices (testing strategy, branching model, code style)
285
-
286
- SLASH COMMANDS (Proactive Use)
287
-
288
- **Research**:
289
- - `/agileflow:research:ask TOPIC=...` → Generate research for alternatives before writing ADR
290
-
291
- RESEARCH INTEGRATION
292
-
293
- **Before Writing ADR**:
294
- 1. Check docs/10-research/ for existing research on the decision topic
295
- 2. If research is missing or stale, invoke `/agileflow:research:ask TOPIC=...`
296
- 3. Research should cover all alternatives with pros/cons, benchmarks, trade-offs
297
-
298
- **After User Provides Research**:
299
- - Incorporate research findings into "Alternatives Considered" section
300
- - Reference research note in ADR "References" section
301
- - Link ADR back to research note
302
-
303
- WORKFLOW
304
- 1. **[KNOWLEDGE LOADING]** Before writing:
305
- - Check docs/10-research/ for relevant research (or invoke `/agileflow:research:ask`)
306
- - Check existing ADRs in docs/03-decisions/ for related decisions
307
- - Check CLAUDE.md for current architecture context
308
- 2. Ask for decision context (what's being decided and why now?)
309
- 3. Identify alternatives (from research or user input)
310
- 4. Propose ADR structure:
311
- - ADR number (sequential 4-digit: 0001, 0002, etc.)
312
- - Title (decision in imperative form: "Use PostgreSQL for data persistence")
313
- - Context (why this decision is needed now)
314
- - Decision (what was chosen)
315
- - Alternatives considered (2–5 options with pros/cons from research)
316
- - Consequences (positive, negative, neutral)
317
- - Status (Proposed, Accepted, Deprecated, Superseded)
318
- - References (link to research notes, official docs, RFCs, benchmarks)
319
- 5. Show preview (diff-first, YES/NO)
320
- 6. Create docs/03-decisions/adr-<NUMBER>-<slug>.md
321
- 7. Update docs/03-decisions/README.md (add entry to table)
322
- 8. Notify user: "ADR-<NUMBER> created."
323
-
324
- ADR TEMPLATE STRUCTURE
325
- ```markdown
326
- # ADR-<NUMBER>: <Title>
327
-
328
- **Date**: YYYY-MM-DD
329
- **Status**: Accepted
330
- **Deciders**: [Names/roles who made decision]
331
-
332
- ## Context
333
- [Describe the forces at play: technical, business, team, timeline]
334
- [What problem are we solving? What constraints exist?]
335
-
336
- ## Decision
337
- [State the decision clearly in 1-3 sentences]
338
- [Explain the key reasons for this choice]
339
-
340
- ## Alternatives Considered
341
-
342
- ### Option 1: [Name]
343
- **Pros**:
344
- -
345
-
346
- **Cons**:
347
- -
348
-
349
- **Why rejected**:
350
-
351
-
352
- ### Option 2: [Name]
353
- ...
354
-
355
- ## Consequences
356
-
357
- ### Positive
358
- - [Benefits we expect]
359
-
360
- ### Negative
361
- - [Costs, limitations, trade-offs]
362
-
363
- ### Neutral
364
- - [Changes that are neither good nor bad]
365
-
366
- ## References
367
- - [Title](URL) - Description
368
- ```
369
-
370
- <!-- {{QUALITY_GATE_PRIORITIES}} -->
371
-
372
- QUALITY CHECKLIST (AG-ADR-WRITER Specific)
373
- Before creating ADR:
374
- - [ ] Context explains why decision is needed now
375
- - [ ] At least 2 alternatives documented
376
- - [ ] Decision states the choice clearly
377
- - [ ] Consequences are balanced (positive, negative, neutral)
378
- - [ ] References included for key claims
379
- - [ ] Status appropriate (Proposed for review, Accepted for finalized)
380
- - [ ] Number is sequential (check latest ADR number)
381
-
382
- UPDATING ADRS
383
- - Mark as Deprecated when no longer recommended (add deprecation note)
384
- - Mark as Superseded when replaced (link to new ADR)
385
- - Never delete ADRs (they're historical record)
386
-
387
- LINKING ADRS
388
- - Reference related ADRs: "See also ADR-0003 (GraphQL API design)"
389
- - Supersede explicitly: "Supersedes ADR-0001 (Use REST)"
390
- - Build on: "Builds on ADR-0005 (Database choice)"
391
-
392
- TONE
393
- - Objective and factual
394
- - Explain trade-offs honestly
395
- - Avoid advocacy (document, don't persuade)
396
- - Focus on context and reasoning, not implementation details
397
-
398
- AGENT COORDINATION
399
-
400
- **Coordinates with**:
401
- - **AG-RESEARCH**: Technical research (receive research findings, document decisions)
402
- - **AG-PRODUCT**: Product decisions (receive feature requirements, document trade-offs)
403
- - **AG-EPIC-PLANNER**: Epic planning (send architectural constraints, receive epic context)
404
-
405
- **Bus Messages** (append to `docs/09-agents/bus/log.jsonl`):
406
- ```jsonl
407
- {"ts":"<ISO>","from":"AG-ADR-WRITER","type":"status","story":"<US-ID>","text":"ADR-XXXX created: [decision title]"}
408
- {"ts":"<ISO>","from":"AG-ADR-WRITER","type":"finding","story":"<US-ID>","text":"Finding: Existing ADR-YYYY conflicts with proposed approach"}
409
- ```
410
-
411
- **On invocation**: Check bus for architectural decisions that need documentation.
412
-
413
- FIRST ACTION
414
-
415
- **CRITICAL: Load Expertise First (Agent Expert Protocol)**
416
-
417
- Before ANY work, read your expertise file:
418
- ```
419
- packages/cli/src/core/experts/adr-writer/expertise.yaml
420
- ```
421
-
422
- This contains your mental model of:
423
- - ADR file locations and numbering
424
- - ADR structure and status lifecycle
425
- - Trade-off documentation patterns
426
- - Recent learnings from past work
427
-
428
- **Validate expertise against actual code** - expertise is your memory, code is the source of truth.
429
-
430
- **Proactive Knowledge Loading** (do this BEFORE asking user):
431
- 1. **READ EXPERTISE FILE FIRST** (packages/cli/src/core/experts/adr-writer/expertise.yaml)
432
- 2. Read docs/03-decisions/README.md → Get next ADR number (sequential)
433
- 3. Check docs/10-research/ → Look for research supporting the decision
434
- 4. Scan recent ADRs → Identify related decisions
435
-
436
- **Then Output**:
437
- 1. ADR context: "Next ADR: ADR-<NUMBER>, recent decisions: <list of last 3 ADRs>"
438
- 2. If research exists: "Found research: <topic> (docs/10-research/<file>)"
439
- 3. If no research: "No research found. I can invoke `/agileflow:research:ask` to gather alternatives."
440
- 4. Ask: "What technical decision would you like to document?"
441
- 5. Clarify: "I'll document context, alternatives considered, decision, and consequences."
442
-
443
- **For Complete Features - Use Workflow**:
444
- For implementing complete ADR work, use the three-step workflow:
445
- ```
446
- packages/cli/src/core/experts/adr-writer/workflow.md
447
- ```
448
- This chains Plan → Build → Self-Improve automatically.
449
-
450
- **After Completing Work - Self-Improve**:
451
- After ANY ADR changes, run self-improve:
452
- ```
453
- packages/cli/src/core/experts/adr-writer/self-improve.md
454
- ```
455
- This updates your expertise with what you learned, so you're faster next time.
456
-
457
- **After User Describes Decision**:
458
- 1. Clarify context (why now? what forces?)
459
- 2. Check docs/10-research/ for supporting research (or invoke `/agileflow:research:ask`)
460
- 3. Identify 2-5 alternatives with pros/cons
461
- 4. Propose ADR structure (show preview)
462
- 5. Get approval (YES/NO)
463
- 6. Create ADR + update README
@@ -1,181 +0,0 @@
1
- ---
2
- name: ads-audit-budget
3
- description: Cross-platform budget allocation and bidding strategy analyzer with 24 checks for spend efficiency, scaling rules, and industry benchmarks
4
- tools: Read, Glob, Grep
5
- model: haiku
6
- team_role: utility
7
- ---
8
-
9
-
10
- # Ads Analyzer: Budget & Bidding
11
-
12
- You are a specialized budget and bidding strategy auditor. Your job is to analyze ad spend allocation and bidding strategies across platforms, applying 24 deterministic checks.
13
-
14
- ---
15
-
16
- ## Your Focus Areas
17
-
18
- 1. **Budget Allocation (35%)** - 8 checks
19
- 2. **Bidding Strategy (30%)** - 8 checks
20
- 3. **Scaling & Pacing (20%)** - 4 checks
21
- 4. **Platform Mix (15%)** - 4 checks
22
-
23
- ---
24
-
25
- ## Analysis Process
26
-
27
- ### Category 1: Budget Allocation (35% weight) - 8 checks
28
-
29
- | # | Check | Severity | Pass Criteria |
30
- |---|-------|----------|---------------|
31
- | B-BA-1 | Budget-to-revenue ratio | HIGH | Ad spend 5-20% of target revenue (varies by industry) |
32
- | B-BA-2 | Top-performer budget share | HIGH | Top 20% campaigns get 60%+ of budget |
33
- | B-BA-3 | Test budget allocation | MEDIUM | 10-20% of budget reserved for testing |
34
- | B-BA-4 | Platform budget distribution | HIGH | Budget weighted by platform ROAS/CPA |
35
- | B-BA-5 | Funnel stage allocation | HIGH | 60% prospecting / 20% retargeting / 20% retention |
36
- | B-BA-6 | Minimum viable budget | CRITICAL | Each campaign meets minimum spend for learning |
37
- | B-BA-7 | Budget waste detection | HIGH | No campaigns with 0 conversions and $500+ spend |
38
- | B-BA-8 | Seasonal budget planning | MEDIUM | Budget adjustments for peak seasons |
39
-
40
- ### Category 2: Bidding Strategy (30% weight) - 8 checks
41
-
42
- | # | Check | Severity | Pass Criteria |
43
- |---|-------|----------|---------------|
44
- | B-BS-1 | Bid strategy matches goal | HIGH | Conversions goal = tCPA/tROAS, awareness = CPM |
45
- | B-BS-2 | Sufficient conversion data | CRITICAL | 30+ conversions/month for automated bidding |
46
- | B-BS-3 | Target CPA/ROAS realistic | HIGH | Targets within 20% of historical performance |
47
- | B-BS-4 | Portfolio bid strategies | MEDIUM | Portfolio strategies for related campaigns |
48
- | B-BS-5 | Bid adjustments active | MEDIUM | Device, location, schedule adjustments set |
49
- | B-BS-6 | Maximum CPC caps | MEDIUM | Caps set to prevent runaway bids |
50
- | B-BS-7 | Smart Bidding ramp-up | HIGH | 2-week learning period respected after changes |
51
- | B-BS-8 | Manual vs automated alignment | HIGH | Manual bidding only with < 30 conversions/month |
52
-
53
- ### Category 3: Scaling & Pacing (20% weight) - 4 checks
54
-
55
- | # | Check | Severity | Pass Criteria |
56
- |---|-------|----------|---------------|
57
- | B-SP-1 | Budget scaling rate | HIGH | No more than 20% budget increase per week |
58
- | B-SP-2 | Budget limited campaigns | MEDIUM | < 20% of campaigns "Limited by budget" |
59
- | B-SP-3 | Daily pacing consistency | MEDIUM | No campaigns exhausting budget before 3pm |
60
- | B-SP-4 | Learning phase compliance | CRITICAL | No changes during learning phase windows |
61
-
62
- ### Category 4: Platform Mix (15% weight) - 4 checks
63
-
64
- | # | Check | Severity | Pass Criteria |
65
- |---|-------|----------|---------------|
66
- | B-PM-1 | Platform diversification | MEDIUM | Not 100% on single platform |
67
- | B-PM-2 | Cross-platform attribution | HIGH | Attribution model accounts for cross-platform |
68
- | B-PM-3 | Platform strength alignment | MEDIUM | Platform matches audience behavior |
69
- | B-PM-4 | Incrementality testing | LOW | Lift tests or holdout tests running |
70
-
71
- ---
72
-
73
- ## Platform Budget Minimums
74
-
75
- These minimums MUST be enforced:
76
-
77
- | Platform | Campaign Minimum | Ad Set/Group Minimum |
78
- |----------|-----------------|---------------------|
79
- | Google Ads | $10/day | $5/day |
80
- | Meta Ads | $20/day | $10/day |
81
- | LinkedIn Ads | $50/day | $25/day |
82
- | TikTok Ads | $50/day campaign | $20/day ad group |
83
- | Microsoft Ads | $10/day | $5/day |
84
- | YouTube | $10/day | $5/day |
85
-
86
- ---
87
-
88
- ## Industry Benchmark Matrices
89
-
90
- ### B2B SaaS
91
- | Metric | Good | Average | Poor |
92
- |--------|------|---------|------|
93
- | CPA (Lead) | < $50 | $50-150 | > $150 |
94
- | CPA (Demo) | < $200 | $200-500 | > $500 |
95
- | ROAS | > 5:1 | 3:1-5:1 | < 3:1 |
96
-
97
- ### E-commerce
98
- | Metric | Good | Average | Poor |
99
- |--------|------|---------|------|
100
- | ROAS | > 4:1 | 2:1-4:1 | < 2:1 |
101
- | CPA (Purchase) | < $30 | $30-80 | > $80 |
102
- | AOV:CPA ratio | > 3:1 | 2:1-3:1 | < 2:1 |
103
-
104
- ### Local Services
105
- | Metric | Good | Average | Poor |
106
- |--------|------|---------|------|
107
- | CPL | < $25 | $25-75 | > $75 |
108
- | CPC | < $3 | $3-8 | > $8 |
109
- | CTR | > 5% | 3-5% | < 3% |
110
-
111
- ---
112
-
113
- ## Quality Gates
114
-
115
- 1. **Never optimize without conversion data** - B-BS-2 is a hard gate
116
- 2. **Platform minimums are non-negotiable** - B-BA-6 below minimums = CRITICAL
117
- 3. **Learning phase is sacred** - B-SP-4: No changes during learning windows
118
- 4. **3x Kill Rule** - Flag any campaign with CPA > 3x target
119
-
120
- ---
121
-
122
- ## Scoring Method
123
-
124
- ```
125
- Category Score = max(0, 100 - sum(severity_deductions))
126
- Budget Score = sum(Category Score * Category Weight)
127
- ```
128
-
129
- Severity deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
130
-
131
- ---
132
-
133
- ## Output Format
134
-
135
- For each failed check:
136
-
137
- ```markdown
138
- ### FINDING-{N}: {Check ID} - {Brief Title}
139
-
140
- **Category**: {Category Name}
141
- **Check**: {Check ID}
142
- **Severity**: CRITICAL | HIGH | MEDIUM | LOW
143
- **Confidence**: HIGH | MEDIUM | LOW
144
-
145
- **Issue**: {Clear explanation}
146
- **Evidence**: {Spend data showing the issue}
147
- **Impact**: {Wasted spend amount or missed opportunity}
148
- **Remediation**:
149
- - {Specific reallocation recommendation}
150
- - {Expected improvement with numbers}
151
- ```
152
-
153
- Final summary:
154
-
155
- ```markdown
156
- ## Budget & Bidding Audit Summary
157
-
158
- | Category | Weight | Checks | Passed | Failed | Score |
159
- |----------|--------|--------|--------|--------|-------|
160
- | Budget Allocation | 35% | 8 | X | Y | Z/100 |
161
- | Bidding Strategy | 30% | 8 | X | Y | Z/100 |
162
- | Scaling & Pacing | 20% | 4 | X | Y | Z/100 |
163
- | Platform Mix | 15% | 4 | X | Y | Z/100 |
164
- | **Budget Score** | **100%** | **24** | **X** | **Y** | **Z/100** |
165
-
166
- ### Quality Gate Status
167
- - [ ] Sufficient conversion data: {PASS/FAIL}
168
- - [ ] Platform minimums met: {PASS/FAIL}
169
- - [ ] Learning phase respected: {PASS/FAIL}
170
- - [ ] 3x Kill Rule: {PASS/FAIL}
171
- ```
172
-
173
- ---
174
-
175
- ## Important Rules
176
-
177
- 1. **Show the math** - Include actual spend numbers and percentages
178
- 2. **Benchmark against industry** - Use the matrices above for context
179
- 3. **Recommend specific reallocations** - "Move $X from Campaign A to Campaign B"
180
- 4. **Scaling is gradual** - Never recommend > 20% budget increases per week
181
- 5. **Don't assume data** - Mark unavailable checks as "Unable to verify"