agileflow 3.4.3 → 4.0.0-alpha.10

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 (1093) hide show
  1. package/CHANGELOG.md +294 -478
  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/accessibility/plugin.yaml +14 -0
  11. package/content/plugins/accessibility/skills/agileflow-accessibility/SKILL.md +392 -0
  12. package/content/plugins/accessibility/skills/agileflow-accessibility/references/aria-patterns.md +528 -0
  13. package/content/plugins/accessibility/skills/agileflow-accessibility/references/testing-checklist.md +457 -0
  14. package/content/plugins/accessibility/skills/agileflow-accessibility/references/wcag-guide.md +683 -0
  15. package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/audit-page.md +310 -0
  16. package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/implement-accessible-component.md +479 -0
  17. package/content/plugins/ads/agents/ads-audit-budget.md +185 -0
  18. package/content/plugins/ads/agents/ads-audit-compliance.md +171 -0
  19. package/content/plugins/ads/agents/ads-audit-creative.md +168 -0
  20. package/content/plugins/ads/agents/ads-audit-google.md +227 -0
  21. package/content/plugins/ads/agents/ads-audit-meta.md +184 -0
  22. package/content/plugins/ads/agents/ads-audit-tracking.md +205 -0
  23. package/content/plugins/ads/agents/ads-consensus.md +410 -0
  24. package/content/plugins/ads/agents/ads-generate.md +152 -0
  25. package/content/plugins/ads/agents/ads-performance-tracker.md +212 -0
  26. package/content/plugins/ads/plugin.yaml +33 -0
  27. package/content/plugins/ads/skills/agileflow-ads/SKILL.md +218 -0
  28. package/content/plugins/ads/skills/agileflow-ads/references/ad-copy-formula-guide.md +131 -0
  29. package/content/plugins/ads/skills/agileflow-ads/references/audience-targeting-guide.md +137 -0
  30. package/content/plugins/ads/skills/agileflow-ads/references/bid-strategy-guide.md +115 -0
  31. package/content/plugins/ads/skills/agileflow-ads/references/platform-benchmarks.md +100 -0
  32. package/content/plugins/ads/skills/agileflow-ads/workflows/audit.md +118 -0
  33. package/content/plugins/ads/skills/agileflow-ads/workflows/generate.md +84 -0
  34. package/content/plugins/audit/agents/a11y-analyzer-aria.md +173 -0
  35. package/content/plugins/audit/agents/a11y-analyzer-forms.md +173 -0
  36. package/content/plugins/audit/agents/a11y-analyzer-keyboard.md +183 -0
  37. package/content/plugins/audit/agents/a11y-analyzer-semantic.md +169 -0
  38. package/content/plugins/audit/agents/a11y-analyzer-visual.md +172 -0
  39. package/content/plugins/audit/agents/a11y-consensus.md +249 -0
  40. package/content/plugins/audit/agents/accessibility.md +558 -0
  41. package/content/plugins/audit/agents/api-quality-analyzer-conventions.md +156 -0
  42. package/content/plugins/audit/agents/api-quality-analyzer-docs.md +184 -0
  43. package/content/plugins/audit/agents/api-quality-analyzer-errors.md +191 -0
  44. package/content/plugins/audit/agents/api-quality-analyzer-pagination.md +179 -0
  45. package/content/plugins/audit/agents/api-quality-analyzer-versioning.md +150 -0
  46. package/content/plugins/audit/agents/api-quality-consensus.md +217 -0
  47. package/content/plugins/audit/agents/api-validator.md +191 -0
  48. package/content/plugins/audit/agents/arch-analyzer-circular.md +156 -0
  49. package/content/plugins/audit/agents/arch-analyzer-complexity.md +193 -0
  50. package/content/plugins/audit/agents/arch-analyzer-coupling.md +152 -0
  51. package/content/plugins/audit/agents/arch-analyzer-layering.md +160 -0
  52. package/content/plugins/audit/agents/arch-analyzer-patterns.md +210 -0
  53. package/content/plugins/audit/agents/arch-consensus.md +228 -0
  54. package/content/plugins/audit/agents/browser-qa.md +342 -0
  55. package/content/plugins/audit/agents/code-reviewer.md +298 -0
  56. package/content/plugins/audit/agents/completeness-analyzer-api.md +199 -0
  57. package/content/plugins/audit/agents/completeness-analyzer-conditional.md +211 -0
  58. package/content/plugins/audit/agents/completeness-analyzer-handlers.md +166 -0
  59. package/content/plugins/audit/agents/completeness-analyzer-imports.md +165 -0
  60. package/content/plugins/audit/agents/completeness-analyzer-routes.md +190 -0
  61. package/content/plugins/audit/agents/completeness-analyzer-state.md +196 -0
  62. package/content/plugins/audit/agents/completeness-analyzer-stubs.md +206 -0
  63. package/content/plugins/audit/agents/completeness-consensus.md +295 -0
  64. package/content/plugins/audit/agents/error-analyzer.md +213 -0
  65. package/content/plugins/audit/agents/flow-analyzer-authorization.md +182 -0
  66. package/content/plugins/audit/agents/flow-analyzer-discovery.md +174 -0
  67. package/content/plugins/audit/agents/flow-analyzer-errors.md +186 -0
  68. package/content/plugins/audit/agents/flow-analyzer-feedback.md +185 -0
  69. package/content/plugins/audit/agents/flow-analyzer-navigation.md +177 -0
  70. package/content/plugins/audit/agents/flow-analyzer-persistence.md +193 -0
  71. package/content/plugins/audit/agents/flow-analyzer-wiring.md +169 -0
  72. package/content/plugins/audit/agents/flow-consensus.md +237 -0
  73. package/content/plugins/audit/agents/legal-analyzer-a11y.md +114 -0
  74. package/content/plugins/audit/agents/legal-analyzer-ai.md +121 -0
  75. package/content/plugins/audit/agents/legal-analyzer-consumer.md +114 -0
  76. package/content/plugins/audit/agents/legal-analyzer-content.md +117 -0
  77. package/content/plugins/audit/agents/legal-analyzer-international.md +119 -0
  78. package/content/plugins/audit/agents/legal-analyzer-licensing.md +119 -0
  79. package/content/plugins/audit/agents/legal-analyzer-privacy.md +112 -0
  80. package/content/plugins/audit/agents/legal-analyzer-security.md +116 -0
  81. package/content/plugins/audit/agents/legal-analyzer-terms.md +115 -0
  82. package/content/plugins/audit/agents/legal-consensus.md +250 -0
  83. package/content/plugins/audit/agents/logic-analyzer-edge.md +179 -0
  84. package/content/plugins/audit/agents/logic-analyzer-flow.md +264 -0
  85. package/content/plugins/audit/agents/logic-analyzer-invariant.md +215 -0
  86. package/content/plugins/audit/agents/logic-analyzer-race.md +280 -0
  87. package/content/plugins/audit/agents/logic-analyzer-type.md +227 -0
  88. package/content/plugins/audit/agents/logic-consensus.md +259 -0
  89. package/content/plugins/audit/agents/perf-analyzer-assets.md +182 -0
  90. package/content/plugins/audit/agents/perf-analyzer-bundle.md +173 -0
  91. package/content/plugins/audit/agents/perf-analyzer-caching.md +170 -0
  92. package/content/plugins/audit/agents/perf-analyzer-compute.md +173 -0
  93. package/content/plugins/audit/agents/perf-analyzer-memory.md +193 -0
  94. package/content/plugins/audit/agents/perf-analyzer-network.md +165 -0
  95. package/content/plugins/audit/agents/perf-analyzer-queries.md +162 -0
  96. package/content/plugins/audit/agents/perf-analyzer-rendering.md +168 -0
  97. package/content/plugins/audit/agents/perf-consensus.md +287 -0
  98. package/content/plugins/audit/agents/qa.md +820 -0
  99. package/content/plugins/audit/agents/quality-analyzer-comments.md +159 -0
  100. package/content/plugins/audit/agents/quality-analyzer-duplication.md +184 -0
  101. package/content/plugins/audit/agents/quality-analyzer-naming.md +160 -0
  102. package/content/plugins/audit/agents/quality-consensus.md +241 -0
  103. package/content/plugins/audit/agents/schema-validator.md +473 -0
  104. package/content/plugins/audit/agents/security-analyzer-api.md +210 -0
  105. package/content/plugins/audit/agents/security-analyzer-auth.md +169 -0
  106. package/content/plugins/audit/agents/security-analyzer-authz.md +180 -0
  107. package/content/plugins/audit/agents/security-analyzer-deps.md +153 -0
  108. package/content/plugins/audit/agents/security-analyzer-infra.md +184 -0
  109. package/content/plugins/audit/agents/security-analyzer-injection.md +155 -0
  110. package/content/plugins/audit/agents/security-analyzer-input.md +201 -0
  111. package/content/plugins/audit/agents/security-analyzer-secrets.md +183 -0
  112. package/content/plugins/audit/agents/security-consensus.md +283 -0
  113. package/content/plugins/audit/agents/test-analyzer-assertions.md +188 -0
  114. package/content/plugins/audit/agents/test-analyzer-coverage.md +189 -0
  115. package/content/plugins/audit/agents/test-analyzer-fragility.md +193 -0
  116. package/content/plugins/audit/agents/test-analyzer-integration.md +161 -0
  117. package/content/plugins/audit/agents/test-analyzer-maintenance.md +180 -0
  118. package/content/plugins/audit/agents/test-analyzer-mocking.md +188 -0
  119. package/content/plugins/audit/agents/test-analyzer-patterns.md +196 -0
  120. package/content/plugins/audit/agents/test-analyzer-structure.md +184 -0
  121. package/content/plugins/audit/agents/test-consensus.md +301 -0
  122. package/content/plugins/audit/agents/testing.md +561 -0
  123. package/content/plugins/audit/agents/ui-validator.md +344 -0
  124. package/content/plugins/audit/plugin.yaml +195 -0
  125. package/content/plugins/audit/skills/agileflow-audit/SKILL.md +113 -0
  126. package/content/plugins/audit/skills/agileflow-audit/references/audit-depth-guide.md +151 -0
  127. package/content/plugins/audit/skills/agileflow-audit/references/dependency-risk-guide.md +139 -0
  128. package/content/plugins/audit/skills/agileflow-audit/references/owasp-top10.md +120 -0
  129. package/content/plugins/audit/skills/agileflow-audit/references/performance-budget-guide.md +143 -0
  130. package/content/plugins/audit/skills/agileflow-audit/references/wcag-criteria.md +117 -0
  131. package/content/plugins/audit/skills/agileflow-audit/workflows/run-audit.md +52 -0
  132. package/content/plugins/audit/skills/agileflow-audit/workflows/tdd.md +66 -0
  133. package/content/plugins/core/agents/adr-writer.md +521 -0
  134. package/content/plugins/core/agents/epic-planner.md +520 -0
  135. package/content/plugins/core/agents/mentor.md +709 -0
  136. package/content/plugins/core/agents/orchestrator.md +776 -0
  137. package/content/plugins/core/agents/team-coordinator.md +334 -0
  138. package/content/plugins/core/agents/team-lead.md +181 -0
  139. package/content/plugins/core/agents/workspace-orchestrator.md +146 -0
  140. package/content/plugins/core/hooks/context-loader.js +196 -0
  141. package/content/plugins/core/hooks/damage-control-bash.js +86 -0
  142. package/content/plugins/core/hooks/damage-control-edit.js +79 -0
  143. package/content/plugins/core/hooks/damage-control-patterns.yaml +100 -0
  144. package/content/plugins/core/hooks/damage-control-write.js +75 -0
  145. package/content/plugins/core/hooks/post-compact-state.js +107 -0
  146. package/content/plugins/core/hooks/preferences-injector.js +352 -0
  147. package/content/plugins/core/hooks/session-welcome.js +19 -0
  148. package/content/plugins/core/plugin.yaml +78 -0
  149. package/content/plugins/core/skills/agileflow-adr/SKILL.md +205 -0
  150. package/content/plugins/core/skills/agileflow-adr/references/madr-format-guide.md +86 -0
  151. package/content/plugins/core/skills/agileflow-adr/workflows/write-adr.md +57 -0
  152. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +211 -0
  153. package/content/plugins/core/skills/agileflow-babysit-mentor/references/mentor-decision-guide.md +81 -0
  154. package/content/plugins/core/skills/agileflow-babysit-mentor/workflows/mentor-session.md +79 -0
  155. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +209 -0
  156. package/content/plugins/core/skills/agileflow-epic-planner/references/epic-sizing-guide.md +81 -0
  157. package/content/plugins/core/skills/agileflow-epic-planner/workflows/plan-epic.md +55 -0
  158. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +148 -0
  159. package/content/plugins/core/skills/agileflow-status-updater/references/status-transitions.md +89 -0
  160. package/content/plugins/core/skills/agileflow-status-updater/workflows/update-status.md +56 -0
  161. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +125 -0
  162. package/content/plugins/core/skills/agileflow-story-writer/references/estimation-reference.md +36 -0
  163. package/content/plugins/core/skills/agileflow-story-writer/references/story-template.md +92 -0
  164. package/content/plugins/core/skills/agileflow-story-writer/workflows/write-story.md +138 -0
  165. package/content/plugins/council/agents/council-advocate.md +223 -0
  166. package/content/plugins/council/agents/council-analyst.md +278 -0
  167. package/content/plugins/council/agents/council-compounder.md +204 -0
  168. package/content/plugins/council/agents/council-contrarian.md +217 -0
  169. package/content/plugins/council/agents/council-moonshot.md +217 -0
  170. package/content/plugins/council/agents/council-optimist.md +185 -0
  171. package/content/plugins/council/agents/council-revenue.md +200 -0
  172. package/content/plugins/council/agents/council-technical.md +218 -0
  173. package/content/plugins/council/agents/multi-expert.md +334 -0
  174. package/content/plugins/council/plugin.yaml +33 -0
  175. package/content/plugins/council/skills/agileflow-council/SKILL.md +102 -0
  176. package/content/plugins/council/skills/agileflow-council/references/decision-log-template.md +109 -0
  177. package/content/plugins/council/skills/agileflow-council/references/perspective-guide.md +104 -0
  178. package/content/plugins/council/skills/agileflow-council/references/when-to-convene-guide.md +112 -0
  179. package/content/plugins/council/skills/agileflow-council/workflows/convene.md +73 -0
  180. package/content/plugins/council/skills/agileflow-council/workflows/multi-expert.md +75 -0
  181. package/content/plugins/database/plugin.yaml +14 -0
  182. package/content/plugins/database/skills/agileflow-database/SKILL.md +284 -0
  183. package/content/plugins/database/skills/agileflow-database/references/indexing-guide.md +313 -0
  184. package/content/plugins/database/skills/agileflow-database/references/migration-guide.md +328 -0
  185. package/content/plugins/database/skills/agileflow-database/references/schema-design-guide.md +467 -0
  186. package/content/plugins/database/skills/agileflow-database/workflows/design-schema.md +213 -0
  187. package/content/plugins/database/skills/agileflow-database/workflows/optimize-query.md +253 -0
  188. package/content/plugins/debugging/plugin.yaml +14 -0
  189. package/content/plugins/debugging/skills/agileflow-debug/SKILL.md +236 -0
  190. package/content/plugins/debugging/skills/agileflow-debug/references/common-patterns.md +350 -0
  191. package/content/plugins/debugging/skills/agileflow-debug/references/debugging-strategies.md +328 -0
  192. package/content/plugins/debugging/skills/agileflow-debug/workflows/debug-issue.md +187 -0
  193. package/content/plugins/debugging/skills/agileflow-debug/workflows/reproduce-bug.md +194 -0
  194. package/content/plugins/delivery/agents/ci.md +547 -0
  195. package/content/plugins/delivery/agents/devops.md +789 -0
  196. package/content/plugins/delivery/plugin.yaml +19 -0
  197. package/content/plugins/delivery/skills/agileflow-delivery/SKILL.md +111 -0
  198. package/content/plugins/delivery/skills/agileflow-delivery/references/changelog-format-guide.md +133 -0
  199. package/content/plugins/delivery/skills/agileflow-delivery/references/ci-pipeline-guide.md +158 -0
  200. package/content/plugins/delivery/skills/agileflow-delivery/references/pr-checklist-guide.md +133 -0
  201. package/content/plugins/delivery/skills/agileflow-delivery/references/release-checklist.md +142 -0
  202. package/content/plugins/delivery/skills/agileflow-delivery/workflows/changelog.md +72 -0
  203. package/content/plugins/delivery/skills/agileflow-delivery/workflows/deploy.md +74 -0
  204. package/content/plugins/delivery/skills/agileflow-delivery/workflows/pr.md +75 -0
  205. package/content/plugins/docs/agents/documentation.md +544 -0
  206. package/content/plugins/docs/agents/readme-updater.md +640 -0
  207. package/content/plugins/docs/plugin.yaml +19 -0
  208. package/content/plugins/docs/skills/agileflow-docs/SKILL.md +106 -0
  209. package/content/plugins/docs/skills/agileflow-docs/references/api-doc-template.md +167 -0
  210. package/content/plugins/docs/skills/agileflow-docs/references/doc-types-guide.md +141 -0
  211. package/content/plugins/docs/skills/agileflow-docs/references/readme-template.md +156 -0
  212. package/content/plugins/docs/skills/agileflow-docs/workflows/readme-sync.md +57 -0
  213. package/content/plugins/docs/skills/agileflow-docs/workflows/sync.md +64 -0
  214. package/content/plugins/engineering/agents/api.md +718 -0
  215. package/content/plugins/engineering/agents/codebase-query.md +285 -0
  216. package/content/plugins/engineering/agents/compliance.md +559 -0
  217. package/content/plugins/engineering/agents/database.md +644 -0
  218. package/content/plugins/engineering/agents/integrations.md +644 -0
  219. package/content/plugins/engineering/agents/mobile.md +552 -0
  220. package/content/plugins/engineering/agents/monitoring.md +585 -0
  221. package/content/plugins/engineering/agents/performance.md +529 -0
  222. package/content/plugins/engineering/agents/refactor.md +592 -0
  223. package/content/plugins/engineering/agents/security.md +524 -0
  224. package/content/plugins/engineering/agents/ui.md +1336 -0
  225. package/content/plugins/engineering/plugin.yaml +37 -0
  226. package/content/plugins/engineering/skills/agileflow-engineering/SKILL.md +127 -0
  227. package/content/plugins/engineering/skills/agileflow-engineering/references/code-review-guide.md +126 -0
  228. package/content/plugins/engineering/skills/agileflow-engineering/references/domain-routing-guide.md +89 -0
  229. package/content/plugins/engineering/skills/agileflow-engineering/references/refactoring-guide.md +136 -0
  230. package/content/plugins/engineering/skills/agileflow-engineering/workflows/diagnose.md +63 -0
  231. package/content/plugins/engineering/skills/agileflow-engineering/workflows/impact.md +60 -0
  232. package/content/plugins/ideation/agents/brainstorm-analyzer-features.md +179 -0
  233. package/content/plugins/ideation/agents/brainstorm-analyzer-growth.md +169 -0
  234. package/content/plugins/ideation/agents/brainstorm-analyzer-integration.md +181 -0
  235. package/content/plugins/ideation/agents/brainstorm-analyzer-market.md +150 -0
  236. package/content/plugins/ideation/agents/brainstorm-analyzer-ux.md +180 -0
  237. package/content/plugins/ideation/agents/brainstorm-consensus.md +245 -0
  238. package/content/plugins/ideation/agents/design.md +568 -0
  239. package/content/plugins/ideation/agents/product.md +582 -0
  240. package/content/plugins/ideation/plugin.yaml +31 -0
  241. package/content/plugins/ideation/skills/agileflow-ideation/SKILL.md +109 -0
  242. package/content/plugins/ideation/skills/agileflow-ideation/references/brainstorm-techniques.md +138 -0
  243. package/content/plugins/ideation/skills/agileflow-ideation/references/competitive-analysis-template.md +148 -0
  244. package/content/plugins/ideation/skills/agileflow-ideation/references/feature-prioritization-guide.md +147 -0
  245. package/content/plugins/ideation/skills/agileflow-ideation/references/user-story-patterns.md +152 -0
  246. package/content/plugins/ideation/skills/agileflow-ideation/workflows/features.md +65 -0
  247. package/content/plugins/ideation/skills/agileflow-ideation/workflows/ideate.md +54 -0
  248. package/content/plugins/migration/agents/datamigration.md +757 -0
  249. package/content/plugins/migration/plugin.yaml +17 -0
  250. package/content/plugins/migration/skills/agileflow-migration/SKILL.md +106 -0
  251. package/content/plugins/migration/skills/agileflow-migration/references/data-validation-checklist.md +154 -0
  252. package/content/plugins/migration/skills/agileflow-migration/references/migration-patterns.md +209 -0
  253. package/content/plugins/migration/skills/agileflow-migration/references/rollback-playbook.md +171 -0
  254. package/content/plugins/migration/skills/agileflow-migration/references/version-compatibility-matrix.md +155 -0
  255. package/content/plugins/migration/skills/agileflow-migration/workflows/plan.md +73 -0
  256. package/content/plugins/migration/skills/agileflow-migration/workflows/validate.md +71 -0
  257. package/content/plugins/performance/plugin.yaml +14 -0
  258. package/content/plugins/performance/skills/agileflow-performance/SKILL.md +224 -0
  259. package/content/plugins/performance/skills/agileflow-performance/references/optimization-patterns.md +554 -0
  260. package/content/plugins/performance/skills/agileflow-performance/references/profiling-guide.md +383 -0
  261. package/content/plugins/performance/skills/agileflow-performance/references/web-vitals-guide.md +360 -0
  262. package/content/plugins/performance/skills/agileflow-performance/workflows/improve-web-vitals.md +344 -0
  263. package/content/plugins/performance/skills/agileflow-performance/workflows/profile-and-fix.md +254 -0
  264. package/content/plugins/planning/agents/analytics.md +670 -0
  265. package/content/plugins/planning/agents/rlm-subcore.md +215 -0
  266. package/content/plugins/planning/plugin.yaml +19 -0
  267. package/content/plugins/planning/skills/agileflow-planning/SKILL.md +111 -0
  268. package/content/plugins/planning/skills/agileflow-planning/references/estimation-guide.md +114 -0
  269. package/content/plugins/planning/skills/agileflow-planning/references/rpi-workflow.md +119 -0
  270. package/content/plugins/planning/skills/agileflow-planning/references/sprint-planning-guide.md +145 -0
  271. package/content/plugins/planning/skills/agileflow-planning/workflows/impact.md +63 -0
  272. package/content/plugins/planning/skills/agileflow-planning/workflows/rpi.md +104 -0
  273. package/content/plugins/psychology/plugin.yaml +14 -0
  274. package/content/plugins/psychology/skills/agileflow-retention/SKILL.md +252 -0
  275. package/content/plugins/psychology/skills/agileflow-retention/references/competitor-analysis.md +240 -0
  276. package/content/plugins/psychology/skills/agileflow-retention/references/psychology-models.md +349 -0
  277. package/content/plugins/psychology/skills/agileflow-retention/references/retention-patterns.md +279 -0
  278. package/content/plugins/psychology/skills/agileflow-retention/workflows/design-retention-feature.md +287 -0
  279. package/content/plugins/psychology/skills/agileflow-retention/workflows/retention-audit.md +259 -0
  280. package/content/plugins/refactoring/plugin.yaml +14 -0
  281. package/content/plugins/refactoring/skills/agileflow-refactor/SKILL.md +235 -0
  282. package/content/plugins/refactoring/skills/agileflow-refactor/references/refactoring-patterns.md +405 -0
  283. package/content/plugins/refactoring/skills/agileflow-refactor/references/safety-checks.md +177 -0
  284. package/content/plugins/refactoring/skills/agileflow-refactor/workflows/extract-module.md +226 -0
  285. package/content/plugins/refactoring/skills/agileflow-refactor/workflows/safe-refactor.md +169 -0
  286. package/content/plugins/research/agents/research.md +503 -0
  287. package/content/plugins/research/plugin.yaml +17 -0
  288. package/content/plugins/research/skills/agileflow-research/SKILL.md +110 -0
  289. package/content/plugins/research/skills/agileflow-research/references/knowledge-decay-guide.md +121 -0
  290. package/content/plugins/research/skills/agileflow-research/references/research-prompt-guide.md +141 -0
  291. package/content/plugins/research/skills/agileflow-research/references/synthesis-template.md +154 -0
  292. package/content/plugins/research/skills/agileflow-research/workflows/analyze.md +60 -0
  293. package/content/plugins/research/skills/agileflow-research/workflows/ask.md +64 -0
  294. package/content/plugins/research/skills/agileflow-research/workflows/import.md +66 -0
  295. package/content/plugins/research/skills/agileflow-research/workflows/synthesize.md +66 -0
  296. package/content/plugins/reviews/plugin.yaml +14 -0
  297. package/content/plugins/reviews/skills/agileflow-pr-reviewer/SKILL.md +241 -0
  298. package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/review-checklist.md +200 -0
  299. package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/security-patterns.md +328 -0
  300. package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/review-pr.md +153 -0
  301. package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/security-review.md +177 -0
  302. package/content/plugins/seo/agents/seo-analyzer-content.md +169 -0
  303. package/content/plugins/seo/agents/seo-analyzer-images.md +198 -0
  304. package/content/plugins/seo/agents/seo-analyzer-performance.md +217 -0
  305. package/content/plugins/seo/agents/seo-analyzer-schema.md +184 -0
  306. package/content/plugins/seo/agents/seo-analyzer-sitemap.md +177 -0
  307. package/content/plugins/seo/agents/seo-analyzer-technical.md +151 -0
  308. package/content/plugins/seo/agents/seo-consensus.md +304 -0
  309. package/content/plugins/seo/plugin.yaml +29 -0
  310. package/content/plugins/seo/skills/agileflow-seo/SKILL.md +188 -0
  311. package/content/plugins/seo/skills/agileflow-seo/references/cwv-thresholds.md +110 -0
  312. package/content/plugins/seo/skills/agileflow-seo/references/eeat-framework.md +144 -0
  313. package/content/plugins/seo/skills/agileflow-seo/references/keyword-research-guide.md +125 -0
  314. package/content/plugins/seo/skills/agileflow-seo/references/schema-types.md +139 -0
  315. package/content/plugins/seo/skills/agileflow-seo/references/technical-seo-checklist.md +139 -0
  316. package/content/plugins/seo/skills/agileflow-seo/workflows/audit.md +98 -0
  317. package/content/plugins/seo/skills/agileflow-seo/workflows/page.md +118 -0
  318. package/content/plugins/testing/plugin.yaml +16 -0
  319. package/content/plugins/testing/skills/agileflow-test-writer/SKILL.md +260 -0
  320. package/content/plugins/testing/skills/agileflow-test-writer/references/coverage-targets.md +239 -0
  321. package/content/plugins/testing/skills/agileflow-test-writer/references/test-patterns.md +420 -0
  322. package/content/plugins/testing/skills/agileflow-test-writer/workflows/add-coverage.md +154 -0
  323. package/content/plugins/testing/skills/agileflow-test-writer/workflows/write-tests-from-ac.md +225 -0
  324. package/package.json +30 -50
  325. package/src/cli/commands/doctor.js +947 -0
  326. package/src/cli/commands/hook.js +83 -0
  327. package/src/cli/commands/launch.js +1385 -0
  328. package/src/cli/commands/learn.js +149 -0
  329. package/src/cli/commands/plugins.js +113 -0
  330. package/src/cli/commands/setup.js +637 -0
  331. package/src/cli/commands/skills.js +324 -0
  332. package/src/cli/commands/status.js +45 -0
  333. package/src/cli/commands/update.js +144 -0
  334. package/src/cli/index.js +137 -0
  335. package/src/cli/wizard/babysit-mode-picker.js +192 -0
  336. package/src/cli/wizard/behaviors-picker.js +262 -0
  337. package/src/cli/wizard/ide-picker.js +69 -0
  338. package/src/cli/wizard/install-scope-picker.js +57 -0
  339. package/src/cli/wizard/launch-alias-picker.js +50 -0
  340. package/src/cli/wizard/launch-cli-picker.js +129 -0
  341. package/src/cli/wizard/launch-tmux-picker.js +133 -0
  342. package/src/cli/wizard/learnings-picker.js +40 -0
  343. package/src/cli/wizard/plugin-picker.js +137 -0
  344. package/src/lib/brand.js +116 -0
  345. package/src/lib/errors.js +120 -0
  346. package/src/lib/hash.js +41 -0
  347. package/src/lib/path-check.js +39 -0
  348. package/src/runtime/config/defaults.js +66 -0
  349. package/src/runtime/config/loader.js +186 -0
  350. package/src/runtime/config/schema.json +126 -0
  351. package/src/runtime/config/writer.js +57 -0
  352. package/src/runtime/hooks/aggregator.js +157 -0
  353. package/src/runtime/hooks/chain.js +93 -0
  354. package/src/runtime/hooks/logger.js +68 -0
  355. package/src/runtime/hooks/manifest-loader.js +228 -0
  356. package/src/runtime/hooks/orchestrator.js +322 -0
  357. package/src/runtime/ide/babysit-skill.js +202 -0
  358. package/src/runtime/ide/capabilities.js +166 -0
  359. package/src/runtime/ide/claude-code-content.js +177 -0
  360. package/src/runtime/ide/claude-code-settings.js +272 -0
  361. package/src/runtime/ide/claude-code-skills.js +217 -0
  362. package/src/runtime/ide/codex-config.js +295 -0
  363. package/src/runtime/installer/file-index.js +112 -0
  364. package/src/runtime/installer/install.js +557 -0
  365. package/src/runtime/installer/stash.js +61 -0
  366. package/src/runtime/installer/sync-engine.js +205 -0
  367. package/src/runtime/launch/alias-installer.js +191 -0
  368. package/src/runtime/launch/cli-resume.js +244 -0
  369. package/src/runtime/launch/closed-windows.js +338 -0
  370. package/src/runtime/launch/defaults.js +66 -0
  371. package/src/runtime/launch/detect-clis.js +69 -0
  372. package/src/runtime/launch/doctor.js +464 -0
  373. package/src/runtime/launch/exec-wrapper.js +114 -0
  374. package/src/runtime/launch/parallel-session.js +247 -0
  375. package/src/runtime/launch/prefs.js +211 -0
  376. package/src/runtime/launch/project-prefs.js +234 -0
  377. package/src/runtime/launch/resolve-cli.js +56 -0
  378. package/src/runtime/launch/restore.js +142 -0
  379. package/src/runtime/launch/schema.json +75 -0
  380. package/src/runtime/launch/session-lifecycle.js +313 -0
  381. package/src/runtime/launch/session-registry.js +401 -0
  382. package/src/runtime/launch/spawn.js +103 -0
  383. package/src/runtime/launch/tabs.js +315 -0
  384. package/src/runtime/launch/tmux.js +654 -0
  385. package/src/runtime/launch/worktree.js +260 -0
  386. package/src/runtime/plugins/registry.js +137 -0
  387. package/src/runtime/plugins/resolver.js +138 -0
  388. package/src/runtime/plugins/validator.js +210 -0
  389. package/src/runtime/skills/learnings.js +308 -0
  390. package/src/runtime/skills/validator.js +335 -0
  391. package/lib/README.md +0 -178
  392. package/lib/api-routes.js +0 -625
  393. package/lib/api-server.js +0 -278
  394. package/lib/cache-provider.js +0 -155
  395. package/lib/codebase-indexer.js +0 -819
  396. package/lib/colors.generated.js +0 -117
  397. package/lib/colors.js +0 -341
  398. package/lib/consent.js +0 -232
  399. package/lib/content-sanitizer.js +0 -464
  400. package/lib/correlation.js +0 -277
  401. package/lib/drivers/claude-driver.ts +0 -312
  402. package/lib/drivers/codex-driver.ts +0 -464
  403. package/lib/drivers/driver-manager.ts +0 -159
  404. package/lib/drivers/gemini-driver.ts +0 -498
  405. package/lib/drivers/index.ts +0 -17
  406. package/lib/error-codes.js +0 -590
  407. package/lib/errors.js +0 -670
  408. package/lib/feature-flags.js +0 -171
  409. package/lib/feedback.js +0 -595
  410. package/lib/file-cache.js +0 -541
  411. package/lib/flag-detection.js +0 -344
  412. package/lib/format-error.js +0 -156
  413. package/lib/gate-runner.js +0 -282
  414. package/lib/generator-factory.js +0 -333
  415. package/lib/git-operations.js +0 -266
  416. package/lib/lazy-require.js +0 -59
  417. package/lib/lock-file.js +0 -144
  418. package/lib/logger.js +0 -106
  419. package/lib/merge-operations.js +0 -1006
  420. package/lib/path-resolver.js +0 -544
  421. package/lib/path-utils.js +0 -49
  422. package/lib/paths.js +0 -291
  423. package/lib/placeholder-registry.js +0 -822
  424. package/lib/process-executor.js +0 -214
  425. package/lib/progress.js +0 -334
  426. package/lib/protocol/driver.ts +0 -354
  427. package/lib/protocol/index.ts +0 -12
  428. package/lib/protocol/ir.ts +0 -271
  429. package/lib/registry-cache.js +0 -80
  430. package/lib/registry-di.js +0 -358
  431. package/lib/result-schema.js +0 -363
  432. package/lib/result.js +0 -210
  433. package/lib/session-display.js +0 -331
  434. package/lib/session-operations.js +0 -611
  435. package/lib/session-registry.js +0 -484
  436. package/lib/session-state-machine.js +0 -465
  437. package/lib/session-switching.js +0 -191
  438. package/lib/skill-loader.js +0 -213
  439. package/lib/smart-json-file.js +0 -682
  440. package/lib/state-machine.js +0 -286
  441. package/lib/table-formatter.js +0 -519
  442. package/lib/template-loader.js +0 -143
  443. package/lib/transient-status.js +0 -374
  444. package/lib/ui-manager.js +0 -612
  445. package/lib/validate-args.js +0 -213
  446. package/lib/validate-commands.js +0 -308
  447. package/lib/validate-names.js +0 -143
  448. package/lib/validate-paths.js +0 -434
  449. package/lib/validate.js +0 -134
  450. package/lib/worktree-operations.js +0 -201
  451. package/lib/yaml-utils.js +0 -164
  452. package/scripts/README.md +0 -267
  453. package/scripts/af +0 -34
  454. package/scripts/agent-loop.js +0 -879
  455. package/scripts/agileflow-configure.js +0 -368
  456. package/scripts/agileflow-statusline.sh +0 -857
  457. package/scripts/agileflow-welcome.js +0 -2246
  458. package/scripts/api-server-runner.js +0 -177
  459. package/scripts/archive-completed-stories.sh +0 -308
  460. package/scripts/auto-self-improve.js +0 -326
  461. package/scripts/automation-run-due.js +0 -128
  462. package/scripts/babysit-clear-restore.js +0 -154
  463. package/scripts/babysit-context-restore.js +0 -89
  464. package/scripts/backfill-ideation-status.js +0 -128
  465. package/scripts/batch-pmap-loop.js +0 -551
  466. package/scripts/check-sessions.js +0 -116
  467. package/scripts/check-update.js +0 -282
  468. package/scripts/ci-summary.js +0 -294
  469. package/scripts/claude-smart.sh +0 -85
  470. package/scripts/claude-tmux.sh +0 -737
  471. package/scripts/claude-watchdog.sh +0 -225
  472. package/scripts/clear-active-command.js +0 -48
  473. package/scripts/compress-status.sh +0 -116
  474. package/scripts/context-loader.js +0 -310
  475. package/scripts/damage-control/bash-tool-damage-control.js +0 -22
  476. package/scripts/damage-control/edit-tool-damage-control.js +0 -19
  477. package/scripts/damage-control/patterns.yaml +0 -227
  478. package/scripts/damage-control/write-tool-damage-control.js +0 -19
  479. package/scripts/damage-control-bash.js +0 -51
  480. package/scripts/damage-control-edit.js +0 -48
  481. package/scripts/damage-control-multi-agent.js +0 -231
  482. package/scripts/damage-control-write.js +0 -48
  483. package/scripts/dependency-check.js +0 -311
  484. package/scripts/document-repl.js +0 -793
  485. package/scripts/expertise-metrics.sh +0 -264
  486. package/scripts/generate-all.sh +0 -77
  487. package/scripts/generate-colors.js +0 -314
  488. package/scripts/generators/agent-registry.js +0 -183
  489. package/scripts/generators/command-registry.js +0 -166
  490. package/scripts/generators/index.js +0 -85
  491. package/scripts/generators/inject-babysit.js +0 -191
  492. package/scripts/generators/inject-help.js +0 -125
  493. package/scripts/generators/inject-readme.js +0 -166
  494. package/scripts/generators/skill-registry.js +0 -188
  495. package/scripts/get-env.js +0 -225
  496. package/scripts/init.sh +0 -76
  497. package/scripts/lib/README-portable-tasks.md +0 -424
  498. package/scripts/lib/ac-test-matcher.js +0 -452
  499. package/scripts/lib/audit-cleanup.js +0 -250
  500. package/scripts/lib/audit-registry.js +0 -340
  501. package/scripts/lib/automation-registry.js +0 -544
  502. package/scripts/lib/automation-runner.js +0 -476
  503. package/scripts/lib/browser-qa-evidence.js +0 -409
  504. package/scripts/lib/browser-qa-status.js +0 -192
  505. package/scripts/lib/bus-utils.js +0 -473
  506. package/scripts/lib/colors.generated.sh +0 -82
  507. package/scripts/lib/colors.sh +0 -46
  508. package/scripts/lib/command-prereqs.js +0 -280
  509. package/scripts/lib/concurrency-limiter.js +0 -511
  510. package/scripts/lib/configure-detect.js +0 -596
  511. package/scripts/lib/configure-features.js +0 -1927
  512. package/scripts/lib/configure-repair.js +0 -327
  513. package/scripts/lib/configure-utils.js +0 -114
  514. package/scripts/lib/context-formatter.js +0 -1158
  515. package/scripts/lib/context-loader.js +0 -840
  516. package/scripts/lib/counter.js +0 -103
  517. package/scripts/lib/damage-control-utils.js +0 -619
  518. package/scripts/lib/feature-catalog.js +0 -332
  519. package/scripts/lib/file-lock.js +0 -392
  520. package/scripts/lib/file-tracking.js +0 -735
  521. package/scripts/lib/frontmatter-parser.js +0 -133
  522. package/scripts/lib/gate-enforcer.js +0 -295
  523. package/scripts/lib/hook-metrics.js +0 -324
  524. package/scripts/lib/ideation-index.js +0 -1205
  525. package/scripts/lib/json-utils.sh +0 -162
  526. package/scripts/lib/lifecycle-detector.js +0 -125
  527. package/scripts/lib/model-profiles.js +0 -118
  528. package/scripts/lib/portable-tasks-cli.js +0 -274
  529. package/scripts/lib/portable-tasks.js +0 -479
  530. package/scripts/lib/process-cleanup.js +0 -527
  531. package/scripts/lib/quality-gates.js +0 -788
  532. package/scripts/lib/scale-detector.js +0 -396
  533. package/scripts/lib/sessionRegistry.js +0 -678
  534. package/scripts/lib/signal-detectors.js +0 -867
  535. package/scripts/lib/skill-catalog.js +0 -557
  536. package/scripts/lib/skill-recommender.js +0 -311
  537. package/scripts/lib/state-migrator.js +0 -353
  538. package/scripts/lib/status-task-bridge.js +0 -522
  539. package/scripts/lib/status-writer.js +0 -255
  540. package/scripts/lib/story-claiming.js +0 -704
  541. package/scripts/lib/story-state-machine.js +0 -437
  542. package/scripts/lib/sync-ideation-status.js +0 -291
  543. package/scripts/lib/task-registry-cache.js +0 -490
  544. package/scripts/lib/task-registry.js +0 -1191
  545. package/scripts/lib/task-sync.js +0 -230
  546. package/scripts/lib/tdd-phase-manager.js +0 -455
  547. package/scripts/lib/team-events.js +0 -510
  548. package/scripts/lib/tmux-audit-monitor.js +0 -612
  549. package/scripts/lib/tmux-group-colors.js +0 -113
  550. package/scripts/lib/tool-registry.yaml +0 -241
  551. package/scripts/lib/tool-shed.js +0 -441
  552. package/scripts/lib/validation-registry.js +0 -177
  553. package/scripts/messaging-bridge.js +0 -561
  554. package/scripts/migrate-ideation-index.js +0 -553
  555. package/scripts/native-team-observer.js +0 -219
  556. package/scripts/obtain-context.js +0 -272
  557. package/scripts/pre-push-check.sh +0 -46
  558. package/scripts/precompact-context.sh +0 -306
  559. package/scripts/query-codebase.js +0 -543
  560. package/scripts/ralph-loop.js +0 -1278
  561. package/scripts/resume-session.sh +0 -121
  562. package/scripts/screenshot-verifier.js +0 -215
  563. package/scripts/session-boundary.js +0 -138
  564. package/scripts/session-coordinator.sh +0 -232
  565. package/scripts/session-manager.js +0 -546
  566. package/scripts/smart-detect.js +0 -449
  567. package/scripts/spawn-audit-sessions.js +0 -877
  568. package/scripts/spawn-parallel.js +0 -751
  569. package/scripts/strip-ai-attribution.js +0 -63
  570. package/scripts/task-completed-gate.js +0 -237
  571. package/scripts/team-manager.js +0 -596
  572. package/scripts/team-status-display.js +0 -200
  573. package/scripts/teammate-idle-gate.js +0 -237
  574. package/scripts/test-session-boundary.js +0 -80
  575. package/scripts/tmux-close-windows.sh +0 -180
  576. package/scripts/tmux-restore-window.sh +0 -67
  577. package/scripts/tmux-save-closed-window.sh +0 -35
  578. package/scripts/tui/App.js +0 -151
  579. package/scripts/tui/Dashboard.js +0 -277
  580. package/scripts/tui/blessed/data/watcher.js +0 -180
  581. package/scripts/tui/blessed/index.js +0 -244
  582. package/scripts/tui/blessed/panels/output.js +0 -101
  583. package/scripts/tui/blessed/panels/sessions.js +0 -150
  584. package/scripts/tui/blessed/panels/trace.js +0 -97
  585. package/scripts/tui/blessed/ui/help.js +0 -77
  586. package/scripts/tui/blessed/ui/screen.js +0 -52
  587. package/scripts/tui/blessed/ui/statusbar.js +0 -47
  588. package/scripts/tui/blessed/ui/tabbar.js +0 -99
  589. package/scripts/tui/index.js +0 -70
  590. package/scripts/tui/lib/crashRecovery.js +0 -304
  591. package/scripts/tui/lib/eventStream.js +0 -309
  592. package/scripts/tui/lib/keyboard.js +0 -261
  593. package/scripts/tui/lib/loopControl.js +0 -371
  594. package/scripts/tui/panels/OutputPanel.js +0 -240
  595. package/scripts/tui/panels/SessionPanel.js +0 -170
  596. package/scripts/tui/panels/TracePanel.js +0 -298
  597. package/scripts/tui/simple-tui.js +0 -510
  598. package/scripts/validate-expertise.sh +0 -263
  599. package/scripts/validate-tokens.sh +0 -73
  600. package/scripts/validators/README.md +0 -143
  601. package/scripts/validators/component-validator.js +0 -239
  602. package/scripts/validators/json-schema-validator.js +0 -186
  603. package/scripts/validators/markdown-validator.js +0 -152
  604. package/scripts/validators/migration-validator.js +0 -129
  605. package/scripts/validators/security-validator.js +0 -380
  606. package/scripts/validators/story-format-validator.js +0 -197
  607. package/scripts/validators/test-result-validator.js +0 -114
  608. package/scripts/validators/workflow-validator.js +0 -247
  609. package/scripts/welcome-deferred.js +0 -437
  610. package/scripts/worktree-create.sh +0 -111
  611. package/src/core/agents/a11y-analyzer-aria.md +0 -155
  612. package/src/core/agents/a11y-analyzer-forms.md +0 -162
  613. package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
  614. package/src/core/agents/a11y-analyzer-semantic.md +0 -153
  615. package/src/core/agents/a11y-analyzer-visual.md +0 -158
  616. package/src/core/agents/a11y-consensus.md +0 -248
  617. package/src/core/agents/accessibility.md +0 -515
  618. package/src/core/agents/adr-writer.md +0 -463
  619. package/src/core/agents/ads-audit-budget.md +0 -181
  620. package/src/core/agents/ads-audit-compliance.md +0 -169
  621. package/src/core/agents/ads-audit-creative.md +0 -164
  622. package/src/core/agents/ads-audit-google.md +0 -226
  623. package/src/core/agents/ads-audit-meta.md +0 -183
  624. package/src/core/agents/ads-audit-tracking.md +0 -197
  625. package/src/core/agents/ads-consensus.md +0 -396
  626. package/src/core/agents/ads-generate.md +0 -145
  627. package/src/core/agents/ads-performance-tracker.md +0 -197
  628. package/src/core/agents/analytics.md +0 -617
  629. package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
  630. package/src/core/agents/api-quality-analyzer-docs.md +0 -176
  631. package/src/core/agents/api-quality-analyzer-errors.md +0 -183
  632. package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
  633. package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
  634. package/src/core/agents/api-quality-consensus.md +0 -214
  635. package/src/core/agents/api-validator.md +0 -183
  636. package/src/core/agents/api.md +0 -665
  637. package/src/core/agents/arch-analyzer-circular.md +0 -148
  638. package/src/core/agents/arch-analyzer-complexity.md +0 -171
  639. package/src/core/agents/arch-analyzer-coupling.md +0 -146
  640. package/src/core/agents/arch-analyzer-layering.md +0 -151
  641. package/src/core/agents/arch-analyzer-patterns.md +0 -162
  642. package/src/core/agents/arch-consensus.md +0 -227
  643. package/src/core/agents/brainstorm-analyzer-features.md +0 -169
  644. package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
  645. package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
  646. package/src/core/agents/brainstorm-analyzer-market.md +0 -147
  647. package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
  648. package/src/core/agents/brainstorm-consensus.md +0 -237
  649. package/src/core/agents/browser-qa.md +0 -328
  650. package/src/core/agents/ci.md +0 -511
  651. package/src/core/agents/code-reviewer.md +0 -288
  652. package/src/core/agents/codebase-query.md +0 -266
  653. package/src/core/agents/completeness-analyzer-api.md +0 -190
  654. package/src/core/agents/completeness-analyzer-conditional.md +0 -201
  655. package/src/core/agents/completeness-analyzer-handlers.md +0 -159
  656. package/src/core/agents/completeness-analyzer-imports.md +0 -159
  657. package/src/core/agents/completeness-analyzer-routes.md +0 -182
  658. package/src/core/agents/completeness-analyzer-state.md +0 -188
  659. package/src/core/agents/completeness-analyzer-stubs.md +0 -198
  660. package/src/core/agents/completeness-consensus.md +0 -286
  661. package/src/core/agents/compliance.md +0 -509
  662. package/src/core/agents/council-advocate.md +0 -206
  663. package/src/core/agents/council-analyst.md +0 -252
  664. package/src/core/agents/council-optimist.md +0 -170
  665. package/src/core/agents/database.md +0 -601
  666. package/src/core/agents/datamigration.md +0 -699
  667. package/src/core/agents/design.md +0 -525
  668. package/src/core/agents/devops.md +0 -720
  669. package/src/core/agents/documentation.md +0 -504
  670. package/src/core/agents/epic-planner.md +0 -480
  671. package/src/core/agents/error-analyzer.md +0 -201
  672. package/src/core/agents/integrations.md +0 -603
  673. package/src/core/agents/legal-analyzer-a11y.md +0 -110
  674. package/src/core/agents/legal-analyzer-ai.md +0 -117
  675. package/src/core/agents/legal-analyzer-consumer.md +0 -108
  676. package/src/core/agents/legal-analyzer-content.md +0 -113
  677. package/src/core/agents/legal-analyzer-international.md +0 -115
  678. package/src/core/agents/legal-analyzer-licensing.md +0 -115
  679. package/src/core/agents/legal-analyzer-privacy.md +0 -108
  680. package/src/core/agents/legal-analyzer-security.md +0 -112
  681. package/src/core/agents/legal-analyzer-terms.md +0 -111
  682. package/src/core/agents/legal-consensus.md +0 -242
  683. package/src/core/agents/logic-analyzer-edge.md +0 -170
  684. package/src/core/agents/logic-analyzer-flow.md +0 -253
  685. package/src/core/agents/logic-analyzer-invariant.md +0 -206
  686. package/src/core/agents/logic-analyzer-race.md +0 -266
  687. package/src/core/agents/logic-analyzer-type.md +0 -217
  688. package/src/core/agents/logic-consensus.md +0 -253
  689. package/src/core/agents/mentor.md +0 -654
  690. package/src/core/agents/mobile.md +0 -501
  691. package/src/core/agents/monitoring.md +0 -537
  692. package/src/core/agents/multi-expert.md +0 -311
  693. package/src/core/agents/orchestrator.md +0 -749
  694. package/src/core/agents/perf-analyzer-assets.md +0 -174
  695. package/src/core/agents/perf-analyzer-bundle.md +0 -165
  696. package/src/core/agents/perf-analyzer-caching.md +0 -160
  697. package/src/core/agents/perf-analyzer-compute.md +0 -165
  698. package/src/core/agents/perf-analyzer-memory.md +0 -182
  699. package/src/core/agents/perf-analyzer-network.md +0 -157
  700. package/src/core/agents/perf-analyzer-queries.md +0 -155
  701. package/src/core/agents/perf-analyzer-rendering.md +0 -156
  702. package/src/core/agents/perf-consensus.md +0 -280
  703. package/src/core/agents/performance.md +0 -492
  704. package/src/core/agents/product.md +0 -535
  705. package/src/core/agents/qa.md +0 -765
  706. package/src/core/agents/readme-updater.md +0 -579
  707. package/src/core/agents/refactor.md +0 -558
  708. package/src/core/agents/research.md +0 -453
  709. package/src/core/agents/rlm-subcore.md +0 -207
  710. package/src/core/agents/schema-validator.md +0 -454
  711. package/src/core/agents/security-analyzer-api.md +0 -199
  712. package/src/core/agents/security-analyzer-auth.md +0 -160
  713. package/src/core/agents/security-analyzer-authz.md +0 -168
  714. package/src/core/agents/security-analyzer-deps.md +0 -147
  715. package/src/core/agents/security-analyzer-infra.md +0 -176
  716. package/src/core/agents/security-analyzer-injection.md +0 -148
  717. package/src/core/agents/security-analyzer-input.md +0 -191
  718. package/src/core/agents/security-analyzer-secrets.md +0 -175
  719. package/src/core/agents/security-consensus.md +0 -276
  720. package/src/core/agents/security.md +0 -486
  721. package/src/core/agents/seo-analyzer-content.md +0 -167
  722. package/src/core/agents/seo-analyzer-images.md +0 -187
  723. package/src/core/agents/seo-analyzer-performance.md +0 -206
  724. package/src/core/agents/seo-analyzer-schema.md +0 -176
  725. package/src/core/agents/seo-analyzer-sitemap.md +0 -172
  726. package/src/core/agents/seo-analyzer-technical.md +0 -144
  727. package/src/core/agents/seo-consensus.md +0 -289
  728. package/src/core/agents/team-coordinator.md +0 -333
  729. package/src/core/agents/team-lead.md +0 -171
  730. package/src/core/agents/test-analyzer-assertions.md +0 -181
  731. package/src/core/agents/test-analyzer-coverage.md +0 -183
  732. package/src/core/agents/test-analyzer-fragility.md +0 -185
  733. package/src/core/agents/test-analyzer-integration.md +0 -155
  734. package/src/core/agents/test-analyzer-maintenance.md +0 -173
  735. package/src/core/agents/test-analyzer-mocking.md +0 -178
  736. package/src/core/agents/test-analyzer-patterns.md +0 -189
  737. package/src/core/agents/test-analyzer-structure.md +0 -177
  738. package/src/core/agents/test-consensus.md +0 -294
  739. package/src/core/agents/testing.md +0 -527
  740. package/src/core/agents/ui-validator.md +0 -331
  741. package/src/core/agents/ui.md +0 -1227
  742. package/src/core/commands/adr/list.md +0 -191
  743. package/src/core/commands/adr/update.md +0 -258
  744. package/src/core/commands/adr/view.md +0 -274
  745. package/src/core/commands/adr.md +0 -394
  746. package/src/core/commands/ads/audit.md +0 -453
  747. package/src/core/commands/ads/budget.md +0 -97
  748. package/src/core/commands/ads/competitor.md +0 -112
  749. package/src/core/commands/ads/creative.md +0 -85
  750. package/src/core/commands/ads/generate.md +0 -238
  751. package/src/core/commands/ads/google.md +0 -112
  752. package/src/core/commands/ads/health.md +0 -327
  753. package/src/core/commands/ads/landing.md +0 -119
  754. package/src/core/commands/ads/linkedin.md +0 -112
  755. package/src/core/commands/ads/meta.md +0 -91
  756. package/src/core/commands/ads/microsoft.md +0 -115
  757. package/src/core/commands/ads/plan.md +0 -321
  758. package/src/core/commands/ads/test-plan.md +0 -317
  759. package/src/core/commands/ads/tiktok.md +0 -129
  760. package/src/core/commands/ads/track.md +0 -288
  761. package/src/core/commands/ads/youtube.md +0 -124
  762. package/src/core/commands/ads.md +0 -140
  763. package/src/core/commands/agent.md +0 -256
  764. package/src/core/commands/api.md +0 -267
  765. package/src/core/commands/assign.md +0 -369
  766. package/src/core/commands/audit.md +0 -531
  767. package/src/core/commands/auto.md +0 -556
  768. package/src/core/commands/automate.md +0 -415
  769. package/src/core/commands/babysit.md +0 -643
  770. package/src/core/commands/baseline.md +0 -743
  771. package/src/core/commands/batch.md +0 -551
  772. package/src/core/commands/blockers.md +0 -602
  773. package/src/core/commands/board.md +0 -509
  774. package/src/core/commands/browser-qa.md +0 -240
  775. package/src/core/commands/changelog.md +0 -582
  776. package/src/core/commands/choose.md +0 -430
  777. package/src/core/commands/ci.md +0 -330
  778. package/src/core/commands/code/accessibility.md +0 -363
  779. package/src/core/commands/code/api.md +0 -313
  780. package/src/core/commands/code/architecture.md +0 -313
  781. package/src/core/commands/code/completeness.md +0 -519
  782. package/src/core/commands/code/legal.md +0 -509
  783. package/src/core/commands/code/logic.md +0 -432
  784. package/src/core/commands/code/performance.md +0 -506
  785. package/src/core/commands/code/security.md +0 -509
  786. package/src/core/commands/code/test.md +0 -505
  787. package/src/core/commands/compress.md +0 -408
  788. package/src/core/commands/configure.md +0 -1159
  789. package/src/core/commands/context/export.md +0 -296
  790. package/src/core/commands/context/full.md +0 -353
  791. package/src/core/commands/context/note.md +0 -380
  792. package/src/core/commands/council.md +0 -592
  793. package/src/core/commands/debt.md +0 -491
  794. package/src/core/commands/deploy.md +0 -864
  795. package/src/core/commands/deps.md +0 -728
  796. package/src/core/commands/diagnose.md +0 -404
  797. package/src/core/commands/docs.md +0 -469
  798. package/src/core/commands/epic/edit.md +0 -213
  799. package/src/core/commands/epic/list.md +0 -190
  800. package/src/core/commands/epic/view.md +0 -267
  801. package/src/core/commands/epic.md +0 -477
  802. package/src/core/commands/export.md +0 -238
  803. package/src/core/commands/feedback.md +0 -603
  804. package/src/core/commands/handoff.md +0 -386
  805. package/src/core/commands/help.md +0 -194
  806. package/src/core/commands/ideate/brief.md +0 -363
  807. package/src/core/commands/ideate/discover.md +0 -399
  808. package/src/core/commands/ideate/features.md +0 -497
  809. package/src/core/commands/ideate/history.md +0 -403
  810. package/src/core/commands/ideate/new.md +0 -900
  811. package/src/core/commands/impact.md +0 -407
  812. package/src/core/commands/install.md +0 -529
  813. package/src/core/commands/learn/explain.md +0 -118
  814. package/src/core/commands/learn/glossary.md +0 -135
  815. package/src/core/commands/learn/patterns.md +0 -138
  816. package/src/core/commands/learn/tour.md +0 -126
  817. package/src/core/commands/maintain.md +0 -558
  818. package/src/core/commands/metrics.md +0 -844
  819. package/src/core/commands/migrate/codemods.md +0 -151
  820. package/src/core/commands/migrate/plan.md +0 -131
  821. package/src/core/commands/migrate/scan.md +0 -114
  822. package/src/core/commands/migrate/validate.md +0 -119
  823. package/src/core/commands/multi-expert.md +0 -447
  824. package/src/core/commands/packages.md +0 -535
  825. package/src/core/commands/pr.md +0 -337
  826. package/src/core/commands/readme-sync.md +0 -329
  827. package/src/core/commands/research/analyze.md +0 -798
  828. package/src/core/commands/research/ask.md +0 -864
  829. package/src/core/commands/research/import.md +0 -1025
  830. package/src/core/commands/research/list.md +0 -273
  831. package/src/core/commands/research/synthesize.md +0 -928
  832. package/src/core/commands/research/view.md +0 -323
  833. package/src/core/commands/retro.md +0 -795
  834. package/src/core/commands/review.md +0 -694
  835. package/src/core/commands/rlm.md +0 -446
  836. package/src/core/commands/roadmap/analyze.md +0 -400
  837. package/src/core/commands/rpi.md +0 -633
  838. package/src/core/commands/seo/audit.md +0 -444
  839. package/src/core/commands/seo/competitor.md +0 -174
  840. package/src/core/commands/seo/content.md +0 -107
  841. package/src/core/commands/seo/geo.md +0 -229
  842. package/src/core/commands/seo/hreflang.md +0 -140
  843. package/src/core/commands/seo/images.md +0 -96
  844. package/src/core/commands/seo/page.md +0 -198
  845. package/src/core/commands/seo/plan.md +0 -163
  846. package/src/core/commands/seo/programmatic.md +0 -131
  847. package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
  848. package/src/core/commands/seo/references/eeat-framework.md +0 -110
  849. package/src/core/commands/seo/references/quality-gates.md +0 -91
  850. package/src/core/commands/seo/references/schema-types.md +0 -102
  851. package/src/core/commands/seo/schema.md +0 -183
  852. package/src/core/commands/seo/sitemap.md +0 -97
  853. package/src/core/commands/seo/technical.md +0 -100
  854. package/src/core/commands/seo.md +0 -107
  855. package/src/core/commands/session/cleanup.md +0 -452
  856. package/src/core/commands/session/end.md +0 -865
  857. package/src/core/commands/session/history.md +0 -293
  858. package/src/core/commands/session/init.md +0 -210
  859. package/src/core/commands/session/new.md +0 -827
  860. package/src/core/commands/session/resume.md +0 -291
  861. package/src/core/commands/session/spawn.md +0 -205
  862. package/src/core/commands/session/status.md +0 -274
  863. package/src/core/commands/skill/list.md +0 -139
  864. package/src/core/commands/skill/recommend.md +0 -216
  865. package/src/core/commands/sprint.md +0 -714
  866. package/src/core/commands/status/undo.md +0 -191
  867. package/src/core/commands/status.md +0 -423
  868. package/src/core/commands/story/edit.md +0 -204
  869. package/src/core/commands/story/list.md +0 -199
  870. package/src/core/commands/story/view.md +0 -312
  871. package/src/core/commands/story-validate.md +0 -491
  872. package/src/core/commands/story.md +0 -465
  873. package/src/core/commands/tdd-next.md +0 -238
  874. package/src/core/commands/tdd.md +0 -211
  875. package/src/core/commands/team/guide.md +0 -688
  876. package/src/core/commands/team/list.md +0 -59
  877. package/src/core/commands/team/start.md +0 -130
  878. package/src/core/commands/team/status.md +0 -66
  879. package/src/core/commands/team/stop.md +0 -78
  880. package/src/core/commands/template.md +0 -644
  881. package/src/core/commands/tests.md +0 -731
  882. package/src/core/commands/update.md +0 -591
  883. package/src/core/commands/validate-expertise.md +0 -305
  884. package/src/core/commands/velocity.md +0 -630
  885. package/src/core/commands/verify.md +0 -534
  886. package/src/core/commands/whats-new.md +0 -201
  887. package/src/core/commands/workflow.md +0 -449
  888. package/src/core/council/sessions/.gitkeep +0 -0
  889. package/src/core/council/shared_reasoning.template.md +0 -106
  890. package/src/core/experts/README.md +0 -236
  891. package/src/core/experts/_core-expertise.yaml +0 -105
  892. package/src/core/experts/accessibility/expertise.yaml +0 -115
  893. package/src/core/experts/accessibility/question.md +0 -41
  894. package/src/core/experts/accessibility/self-improve.md +0 -45
  895. package/src/core/experts/accessibility/workflow.md +0 -59
  896. package/src/core/experts/adr-writer/expertise.yaml +0 -138
  897. package/src/core/experts/adr-writer/question.md +0 -56
  898. package/src/core/experts/adr-writer/self-improve.md +0 -106
  899. package/src/core/experts/adr-writer/workflow.md +0 -184
  900. package/src/core/experts/analytics/expertise.yaml +0 -119
  901. package/src/core/experts/analytics/question.md +0 -74
  902. package/src/core/experts/analytics/self-improve.md +0 -163
  903. package/src/core/experts/analytics/workflow.md +0 -272
  904. package/src/core/experts/api/expertise.yaml +0 -124
  905. package/src/core/experts/api/question.md +0 -74
  906. package/src/core/experts/api/self-improve.md +0 -122
  907. package/src/core/experts/api/workflow.md +0 -248
  908. package/src/core/experts/ci/expertise.yaml +0 -106
  909. package/src/core/experts/ci/question.md +0 -69
  910. package/src/core/experts/ci/self-improve.md +0 -100
  911. package/src/core/experts/ci/workflow.md +0 -145
  912. package/src/core/experts/codebase-query/expertise.yaml +0 -121
  913. package/src/core/experts/codebase-query/question.md +0 -73
  914. package/src/core/experts/codebase-query/self-improve.md +0 -105
  915. package/src/core/experts/compliance/expertise.yaml +0 -101
  916. package/src/core/experts/compliance/question.md +0 -56
  917. package/src/core/experts/compliance/self-improve.md +0 -106
  918. package/src/core/experts/compliance/workflow.md +0 -184
  919. package/src/core/experts/database/expertise.yaml +0 -109
  920. package/src/core/experts/database/question.md +0 -74
  921. package/src/core/experts/database/self-improve.md +0 -121
  922. package/src/core/experts/database/workflow.md +0 -234
  923. package/src/core/experts/datamigration/expertise.yaml +0 -141
  924. package/src/core/experts/datamigration/question.md +0 -56
  925. package/src/core/experts/datamigration/self-improve.md +0 -106
  926. package/src/core/experts/datamigration/workflow.md +0 -184
  927. package/src/core/experts/design/expertise.yaml +0 -116
  928. package/src/core/experts/design/question.md +0 -56
  929. package/src/core/experts/design/self-improve.md +0 -106
  930. package/src/core/experts/design/workflow.md +0 -184
  931. package/src/core/experts/devops/expertise.yaml +0 -116
  932. package/src/core/experts/devops/question.md +0 -68
  933. package/src/core/experts/devops/self-improve.md +0 -102
  934. package/src/core/experts/devops/workflow.md +0 -142
  935. package/src/core/experts/documentation/expertise.yaml +0 -126
  936. package/src/core/experts/documentation/question.md +0 -41
  937. package/src/core/experts/documentation/self-improve.md +0 -45
  938. package/src/core/experts/documentation/workflow.md +0 -55
  939. package/src/core/experts/epic-planner/expertise.yaml +0 -144
  940. package/src/core/experts/epic-planner/question.md +0 -56
  941. package/src/core/experts/epic-planner/self-improve.md +0 -106
  942. package/src/core/experts/epic-planner/workflow.md +0 -184
  943. package/src/core/experts/integrations/expertise.yaml +0 -113
  944. package/src/core/experts/integrations/question.md +0 -74
  945. package/src/core/experts/integrations/self-improve.md +0 -151
  946. package/src/core/experts/integrations/workflow.md +0 -246
  947. package/src/core/experts/mentor/expertise.yaml +0 -125
  948. package/src/core/experts/mentor/question.md +0 -56
  949. package/src/core/experts/mentor/self-improve.md +0 -106
  950. package/src/core/experts/mentor/workflow.md +0 -184
  951. package/src/core/experts/mobile/expertise.yaml +0 -136
  952. package/src/core/experts/mobile/question.md +0 -72
  953. package/src/core/experts/mobile/self-improve.md +0 -140
  954. package/src/core/experts/mobile/workflow.md +0 -240
  955. package/src/core/experts/monitoring/expertise.yaml +0 -132
  956. package/src/core/experts/monitoring/question.md +0 -76
  957. package/src/core/experts/monitoring/self-improve.md +0 -150
  958. package/src/core/experts/monitoring/workflow.md +0 -264
  959. package/src/core/experts/performance/expertise.yaml +0 -68
  960. package/src/core/experts/performance/question.md +0 -41
  961. package/src/core/experts/performance/self-improve.md +0 -45
  962. package/src/core/experts/performance/workflow.md +0 -61
  963. package/src/core/experts/product/expertise.yaml +0 -143
  964. package/src/core/experts/product/question.md +0 -56
  965. package/src/core/experts/product/self-improve.md +0 -106
  966. package/src/core/experts/product/workflow.md +0 -184
  967. package/src/core/experts/qa/expertise.yaml +0 -110
  968. package/src/core/experts/qa/question.md +0 -56
  969. package/src/core/experts/qa/self-improve.md +0 -106
  970. package/src/core/experts/qa/workflow.md +0 -184
  971. package/src/core/experts/readme-updater/expertise.yaml +0 -141
  972. package/src/core/experts/readme-updater/question.md +0 -56
  973. package/src/core/experts/readme-updater/self-improve.md +0 -106
  974. package/src/core/experts/readme-updater/workflow.md +0 -184
  975. package/src/core/experts/refactor/expertise.yaml +0 -135
  976. package/src/core/experts/refactor/question.md +0 -41
  977. package/src/core/experts/refactor/self-improve.md +0 -45
  978. package/src/core/experts/refactor/workflow.md +0 -57
  979. package/src/core/experts/research/expertise.yaml +0 -143
  980. package/src/core/experts/research/question.md +0 -56
  981. package/src/core/experts/research/self-improve.md +0 -106
  982. package/src/core/experts/research/workflow.md +0 -184
  983. package/src/core/experts/security/expertise.yaml +0 -117
  984. package/src/core/experts/security/question.md +0 -77
  985. package/src/core/experts/security/self-improve.md +0 -102
  986. package/src/core/experts/security/workflow.md +0 -152
  987. package/src/core/experts/templates/expertise-template.yaml +0 -67
  988. package/src/core/experts/templates/question-template.md +0 -56
  989. package/src/core/experts/templates/self-improve-template.md +0 -106
  990. package/src/core/experts/templates/workflow-template.md +0 -184
  991. package/src/core/experts/testing/expertise.yaml +0 -112
  992. package/src/core/experts/testing/question.md +0 -68
  993. package/src/core/experts/testing/self-improve.md +0 -102
  994. package/src/core/experts/testing/workflow.md +0 -143
  995. package/src/core/experts/ui/expertise.yaml +0 -133
  996. package/src/core/experts/ui/question.md +0 -74
  997. package/src/core/experts/ui/self-improve.md +0 -122
  998. package/src/core/experts/ui/workflow.md +0 -262
  999. package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
  1000. package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
  1001. package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
  1002. package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
  1003. package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
  1004. package/src/core/profiles/COMPARISON.md +0 -170
  1005. package/src/core/profiles/README.md +0 -178
  1006. package/src/core/profiles/claude-code.yaml +0 -111
  1007. package/src/core/profiles/codex.yaml +0 -103
  1008. package/src/core/profiles/cursor.yaml +0 -134
  1009. package/src/core/profiles/examples.js +0 -250
  1010. package/src/core/profiles/loader.js +0 -235
  1011. package/src/core/profiles/windsurf.yaml +0 -159
  1012. package/src/core/skills/_learnings/README.md +0 -91
  1013. package/src/core/skills/_learnings/_template.yaml +0 -106
  1014. package/src/core/skills/_learnings/code-review.yaml +0 -118
  1015. package/src/core/skills/_learnings/commit.yaml +0 -69
  1016. package/src/core/skills/_learnings/story-writer.yaml +0 -71
  1017. package/src/core/teams/backend.json +0 -41
  1018. package/src/core/teams/builder-validator.json +0 -51
  1019. package/src/core/teams/code-review.json +0 -41
  1020. package/src/core/teams/frontend.json +0 -41
  1021. package/src/core/teams/fullstack.json +0 -41
  1022. package/src/core/teams/logic-audit.json +0 -53
  1023. package/src/core/teams/perf-audit.json +0 -71
  1024. package/src/core/teams/qa.json +0 -41
  1025. package/src/core/teams/security-audit.json +0 -71
  1026. package/src/core/teams/solo.json +0 -35
  1027. package/src/core/teams/test-audit.json +0 -71
  1028. package/src/core/templates/CONTEXT.md.example +0 -49
  1029. package/src/core/templates/README-template.md +0 -16
  1030. package/src/core/templates/adr-template.md +0 -28
  1031. package/src/core/templates/agent-coordination-pattern.md +0 -38
  1032. package/src/core/templates/agent-profile-template.md +0 -51
  1033. package/src/core/templates/agileflow-metadata.json +0 -150
  1034. package/src/core/templates/browser-qa-spec.yaml +0 -94
  1035. package/src/core/templates/ci-workflow.yml +0 -74
  1036. package/src/core/templates/claude-settings.advanced.example.json +0 -75
  1037. package/src/core/templates/claude-settings.example.json +0 -26
  1038. package/src/core/templates/command-documentation.md +0 -187
  1039. package/src/core/templates/command-prerequisites.yaml +0 -169
  1040. package/src/core/templates/comms-note-template.md +0 -24
  1041. package/src/core/templates/damage-control-patterns.yaml +0 -243
  1042. package/src/core/templates/environment.json +0 -18
  1043. package/src/core/templates/epic-template.md +0 -27
  1044. package/src/core/templates/plan-template.md +0 -125
  1045. package/src/core/templates/preserve-rules-common.md +0 -107
  1046. package/src/core/templates/preserve-rules.json +0 -42
  1047. package/src/core/templates/proactive-action-spec.md +0 -29
  1048. package/src/core/templates/product-brief.md +0 -136
  1049. package/src/core/templates/quality-gate-priorities.md +0 -34
  1050. package/src/core/templates/research-template.md +0 -44
  1051. package/src/core/templates/session-harness-protocol.md +0 -128
  1052. package/src/core/templates/session-state.json +0 -56
  1053. package/src/core/templates/story-lifecycle.md +0 -213
  1054. package/src/core/templates/story-template.md +0 -92
  1055. package/src/core/templates/tdd-test-template.js +0 -241
  1056. package/src/core/templates/worktrees-guide.md +0 -231
  1057. package/tools/agileflow-npx.js +0 -52
  1058. package/tools/cli/agileflow-cli.js +0 -72
  1059. package/tools/cli/commands/config.js +0 -285
  1060. package/tools/cli/commands/doctor.js +0 -496
  1061. package/tools/cli/commands/list.js +0 -385
  1062. package/tools/cli/commands/session.js +0 -1176
  1063. package/tools/cli/commands/setup.js +0 -255
  1064. package/tools/cli/commands/status.js +0 -101
  1065. package/tools/cli/commands/tui.js +0 -56
  1066. package/tools/cli/commands/uninstall.js +0 -155
  1067. package/tools/cli/commands/update.js +0 -299
  1068. package/tools/cli/installers/core/installer.js +0 -892
  1069. package/tools/cli/installers/ide/_base-ide.js +0 -518
  1070. package/tools/cli/installers/ide/_interface.js +0 -238
  1071. package/tools/cli/installers/ide/claude-code.js +0 -432
  1072. package/tools/cli/installers/ide/codex.js +0 -426
  1073. package/tools/cli/installers/ide/cursor.js +0 -217
  1074. package/tools/cli/installers/ide/manager.js +0 -222
  1075. package/tools/cli/installers/ide/windsurf.js +0 -282
  1076. package/tools/cli/lib/command-context.js +0 -382
  1077. package/tools/cli/lib/config-manager.js +0 -446
  1078. package/tools/cli/lib/content-injector.js +0 -969
  1079. package/tools/cli/lib/content-transformer.js +0 -496
  1080. package/tools/cli/lib/docs-setup.js +0 -464
  1081. package/tools/cli/lib/error-handler.js +0 -165
  1082. package/tools/cli/lib/ide-error-factory.js +0 -421
  1083. package/tools/cli/lib/ide-errors.js +0 -367
  1084. package/tools/cli/lib/ide-generator.js +0 -357
  1085. package/tools/cli/lib/ide-health-monitor.js +0 -364
  1086. package/tools/cli/lib/ide-registry.js +0 -297
  1087. package/tools/cli/lib/npm-utils.js +0 -103
  1088. package/tools/cli/lib/self-update.js +0 -148
  1089. package/tools/cli/lib/ui.js +0 -211
  1090. package/tools/cli/lib/utils.js +0 -87
  1091. package/tools/cli/lib/validation-middleware.js +0 -491
  1092. package/tools/cli/lib/version-checker.js +0 -95
  1093. package/tools/postinstall.js +0 -190
@@ -1,590 +0,0 @@
1
- # Algorithmic Ad Optimization Protocol 2026: Technical Decision Architectures, Bidding Logic, and Capital Allocation Frameworks
2
-
3
- ---
4
-
5
- ## 1. Introduction: The Deterministic to Probabilistic Shift
6
-
7
- The digital advertising landscape of February 2026 operates on a fundamentally different substrate than the keyword-centric models of the previous decade. We have transitioned from a deterministic era -- characterized by cookie-based tracking, exact-match keyword reliance, and manual bid adjustments -- to a probabilistic, signal-based ecosystem governed by predictive artificial intelligence. The depreciation of third-party cookies, completed in late 2025, alongside the maturation of privacy-preserving frameworks like the Privacy Sandbox and Apple's SKAdNetwork 5.0, has necessitated a total architectural overhaul of advertising logic.<sup>1</sup>
8
-
9
- For automated optimization engines such as claude-ads, general marketing advice is operational noise. Success in 2026 requires rigid, conditional logic trees rooted in statistical significance and algorithmic behaviorism. Advertisers no longer purchase "clicks" or "impressions"; they purchase conversion probabilities calculated in real-time auctions. The decision engines driving Google's Smart Bidding and Meta's Andromeda algorithm optimize for outcomes based on thousands of data points -- device telemetry, semantic intent, user value prediction, and cross-platform journey mapping -- far beyond human processing capacity.
10
-
11
- This report serves as the technical specification for an automated decision engine. It rejects heuristic "best practices" in favor of numeric thresholds, failsafe protocols, and exact "IF/THEN" logic required to programmatically manage ad spend. It delineates the specific conditions under which bidding strategies must be deployed, the mathematical relationships governing budget allocation across ten distinct business verticals, and the server-side infrastructure required to feed these algorithms the "truth data" they require to function.
12
-
13
- ---
14
-
15
- ## 2. SECTION 1: GOOGLE ADS BIDDING DECISION ENGINE (2026)
16
-
17
- In the 2026 ecosystem, Google Ads bidding is strictly a function of data density and conversion confidence. The granularity of the 2010s -- where advertisers manually bid on individual keywords -- is obsolete. The "Simplified Aggregation" structure is now the gold standard, designed to consolidate data signals to feed Smart Bidding algorithms.<sup>2</sup> With the deprecation of Enhanced CPC (eCPC) in March 2025, the middle ground between manual control and full automation has vanished, forcing a binary choice: manual constraint or algorithmic freedom.<sup>3</sup>
18
-
19
- ### 2.1 Maximize Clicks
20
-
21
- **Strategy Name:** Maximize Clicks
22
-
23
- **Algorithmic Logic:**
24
-
25
- The algorithm utilizes a "lowest-cost-first" auction theory. It scans available inventory within the targeted parameters (keywords, audiences) and bids to secure the maximum volume of traffic that fits within the daily budget cap. It assigns a conversion probability of zero to all users; a user likely to bounce is valued identically to a user likely to purchase, provided the cost of the click is equal.
26
-
27
- **Minimum Requirements:**
28
-
29
- - **Conversion Volume:** 0 conversions required.
30
- - **Campaign Age:** 0 days (Day 1 viable).
31
- - **Data Volume:** None.
32
-
33
- **When to Use (Specific Conditions):**
34
-
35
- 1. **Cold Start Protocol:** New accounts with **< 15 conversions in the last 30 days**.<sup>4</sup> The algorithm builds traffic baselines required to populate remarketing lists (Minimum List Size: 1,000 active users).
36
- 2. **Low-Volume B2B Niche:** Keywords with search volume < 100/month where Smart Bidding effectively "throttles" impressions due to lack of conversion signal.
37
- 3. **Traffic Arbitrage:** Models relying on ad revenue or page views rather than transactional conversions.
38
-
39
- **When NOT to Use (Anti-Patterns):**
40
-
41
- - **Conversion Volume > 30/month:** Using Max Clicks here is mathematically inefficient; it ignores the purchase intent signal accrued by the pixel.
42
- - **Broad Match Keywords:** This combination is a "budget suicide" vector. Max Clicks will find the cheapest, lowest-intent queries (e.g., "free [product]") to fill the budget.
43
- - **Strict Profitability Goals:** If ROAS is the primary KPI, this strategy will fail as it does not discriminate between high-value and low-value users.
44
-
45
- **Expected Learning Phase:**
46
-
47
- - **Duration:** 3--5 Days.
48
- - **Exit Trigger:** Stabilization of CPC and Impression Share.
49
-
50
- **Ramp-Up Protocol:**
51
-
52
- - **Constraint:** ALWAYS set a "Maximum CPC Bid Limit." Calculation:
53
-
54
- $$\text{Max CPC} = \frac{\text{Target CPA}}{\text{Estimated CVR} \times 1.5}$$
55
-
56
- Without this, the algorithm may pay exorbitant amounts ($50+) for single clicks in thin auctions.
57
-
58
- **Danger Signals (Failure Thresholds):**
59
-
60
- - **Bounce Rate Spike:** > 80% bounce rate (or 20% higher than historical average).
61
- - **Conversion Rate (CVR) Crash:** CVR drops below 0.5% for > 7 consecutive days.
62
- - **Traffic Quality:** Search Term Report shows > 40% "Close Variant" matches that are irrelevant.
63
-
64
- ---
65
-
66
- ### 2.2 Maximize Conversions (No Target)
67
-
68
- **Strategy Name:** Maximize Conversions
69
-
70
- **Algorithmic Logic:**
71
-
72
- The algorithm operates on a "budget exhaustion" principle combined with "conversion probability." It aims to spend 100% of the daily budget. Within that constraint, it bids on users with the highest predicted CVR. It does *not* respect a cost cap; it will pay $500 for a conversion if it believes that conversion is the only one available to satisfy the "spend budget" directive.
73
-
74
- **Minimum Requirements:**
75
-
76
- - **Conversion Volume:** 15 conversions in the last 30 days (Recommended: 30+).<sup>5</sup>
77
- - **Campaign Age:** > 2 weeks.
78
-
79
- **When to Use (Specific Conditions):**
80
-
81
- 1. **Transition Phase:** Moving from Max Clicks/Manual CPC once 15+ conversions are recorded but data is too volatile for a specific tCPA.
82
- 2. **Budget Constrained:** Campaigns flagged as "Limited by Budget" (Impression Share Lost to Budget > 20%). The algorithm ensures efficiency within the scarcity of the cap.
83
- 3. **Volume Priority:** When volume is prioritized over efficiency, and the advertiser is willing to accept fluctuating CPAs to maximize lead flow.
84
-
85
- **When NOT to Use:**
86
-
87
- - **Uncapped Budgets:** If the daily budget is significantly higher than actual spend capability, the algorithm will aggressively raise bids to spend the money, driving CPA to unsustainable levels.
88
- - **Fixed Margin Models:** Lead generation with strict $50 margins cannot risk the volatility of "No Target" bidding.
89
-
90
- **Expected Learning Phase:**
91
-
92
- - **Duration:** 7--14 Days.
93
- - **Conversion Count:** Needs ~15-30 events to stabilize.<sup>4</sup>
94
-
95
- **Ramp-Up Protocol:**
96
-
97
- - **Transition:** Run for 14 days to establish a baseline CPA.
98
- - **Next Step:** Once CPA stabilizes (Standard Deviation < 20%), apply a Target CPA (tCPA) to cap costs.
99
-
100
- **Danger Signals:**
101
-
102
- - **CPA Inflation:** CPA exceeds historical average by > 30% for 3 consecutive days.
103
- - **CPC Decoupling:** CPC rises while CVR remains flat.
104
-
105
- ---
106
-
107
- ### 2.3 Target CPA (tCPA)
108
-
109
- **Strategy Name:** Target Cost Per Action (tCPA)
110
-
111
- **Algorithmic Logic:** This is a "portfolio-based" probability engine. It sets unique bids for every single auction based on the likelihood of conversion. The target is an *average* over 30 days. It will bid 3x the target for a high-probability user and 0.1x for a low-probability user, aiming to settle at the weighted average.<sup>4</sup>
112
-
113
- **Minimum Requirements:**
114
-
115
- - **Strict Threshold:** 30 conversions in the last 30 days at the campaign level.<sup>4</sup>
116
- - **Ideal Threshold:** 50+ conversions/month for stability.
117
-
118
- **When to Use:**
119
-
120
- - **Lead Generation:** The standard for service businesses, SaaS (Demo/Trial), and B2B where value is binary (Lead vs. No Lead).<sup>2</sup>
121
- - **Scale with Efficiency:** When the goal is to uncap the budget but maintain unit economics.
122
-
123
- **When NOT to Use:**
124
-
125
- - **Data Scarcity:** < 15 conversions/month (Algorithm enters "Guessing Mode," leading to 0 impressions).
126
- - **Low Budget:** If Daily Budget < 2x Target CPA. (The algorithm needs room to fail; a budget tighter than 2 conversions restricts learning).
127
-
128
- **Target Setting Protocol (Numeric):**
129
-
130
- - **Initial Target:** Set at **1.1x to 1.2x** of the *historical* 30-day average CPA.<sup>6</sup>
131
- - *Logic:* If historical CPA is $50, set tCPA to $55 or $60. Setting it to $40 (aspirational) will cause the algorithm to filter out 80% of auctions, killing volume.
132
- - **Adjustment Increments:** Change targets by max **10% every 14 days**.
133
-
134
- **Danger Signals:**
135
-
136
- - **Impression Crash:** Impressions drop > 20% week-over-week (Target is too low).
137
- - **Zero Conversion Days:** 3 consecutive days with 0 conversions (Signal loss or technical tracking failure).
138
-
139
- ---
140
-
141
- ### 2.4 Target ROAS (tROAS)
142
-
143
- **Strategy Name:** Target Return on Ad Spend
144
-
145
- **Algorithmic Logic:**
146
-
147
- The algorithm predicts two variables: Conversion Probability ($P(c)$) and Predicted Conversion Value ($V_p$).
148
-
149
- $$\text{Bid} = P(c) \times V_p \times \frac{1}{\text{Target ROAS}}$$
150
-
151
- It aggressively bids on users likely to spend *more* (High AOV) and ignores users likely to spend little, even if they convert.
152
-
153
- **Minimum Requirements:**
154
-
155
- - **Strict Threshold:** 50 conversions in the last 30 days.<sup>5</sup>
156
- - **Value Requirement:** Must pass dynamic conversion values (e.g., checkout total) or varied static values (Lead = $50, Call = $20).
157
-
158
- **When to Use:**
159
-
160
- - **E-commerce:** Standard for Shopping and Performance Max.
161
- - **B2B with Offline Data:** Uploading "Closed Won" deal values to optimize for revenue rather than leads.<sup>7</sup>
162
-
163
- **When NOT to Use:**
164
-
165
- - **Homogenous Value:** If every conversion is worth exactly $100, tROAS is mathematically identical to tCPA but with higher data requirements. Use tCPA instead.
166
-
167
- **Target Setting Protocol:**
168
-
169
- - **Initial Target:** Set at the **exact historical ROAS** of the last 30 days.<sup>4</sup>
170
- - *Example:* If Last 30 Day ROAS = 450%, Set Target = 450%.
171
- - **Scaling:** To scale volume, *lower* the ROAS target (e.g., 450% -> 420%). To increase efficiency, *raise* it (450% -> 480%).
172
-
173
- **Danger Signals:**
174
-
175
- - **Zero Spend:** If tROAS is set unrealistically high (e.g., 800% when historical is 400%), the campaign will cease spending immediately.
176
-
177
- ---
178
-
179
- ### 2.5 Target Impression Share
180
-
181
- **Strategy Name:** Target Impression Share
182
-
183
- **Algorithmic Logic:** A rule-based bidding system designed to achieve visibility, not performance. It ignores conversion data entirely. Bids are calculated solely to beat the Ad Rank of competitors for specific slots (Absolute Top, Top of Page, Anywhere).<sup>8</sup>
184
-
185
- **Minimum Requirements:**
186
-
187
- - None (Can be used Day 1).
188
-
189
- **When to Use:**
190
-
191
- 1. **Brand Protection:** Target "Absolute Top of Page" at 95-100% Share on Brand Keywords to block competitors.
192
- 2. **Local Dominance:** Local service businesses forcing visibility in a specific radius for "near me" terms.
193
- 3. **Conquesting:** Bidding on competitor brand names (Expect high CPCs/Low QS).
194
-
195
- **When NOT to Use:**
196
-
197
- - **Direct Response:** Never use for generic keywords if ROI is the goal. CPCs will often be 3-4x higher than necessary to convert.
198
-
199
- **Danger Signals:**
200
-
201
- - **CPC Spike:** Average CPC exceeds 300% of account average.
202
- - **IS Lost (Budget):** If budget runs out by 10 AM, the target % is too high for the daily cap.
203
-
204
- ---
205
-
206
- ### 2.6 Manual CPC
207
-
208
- **Strategy Name:** Manual CPC
209
-
210
- **Algorithmic Logic:**
211
-
212
- Deterministic bidding. The advertiser sets a static Max CPC. This bid is the ceiling. Auction eligibility is determined solely by Bid x Quality Score.
213
-
214
- **Status 2026:**
215
-
216
- - Enhanced CPC (eCPC) was deprecated in March 2025. Manual CPC is now "naked" -- no algorithmic adjustment for conversion probability.<sup>3</sup>
217
-
218
- **When to Use:**
219
-
220
- 1. **Data Poverty:** < 15 conversions/month where Smart Bidding fails.
221
- 2. **Portfolio Control:** Advertisers who require granular control over specific keyword profitability.
222
- 3. **Display/Video:** Controlling inventory costs on placements.
223
-
224
- **When NOT to Use:**
225
-
226
- - **Broad Match:** Manual CPC + Broad Match is dangerous because the bid is static while the query intent varies wildly.
227
-
228
- **Danger Signals:**
229
-
230
- - **Falling Impression Share:** Competitors using Smart Bidding will outbid Manual strategies for the *best* users, leaving Manual campaigns with "remnant" inventory (low-propensity users).
231
-
232
- ---
233
-
234
- ### 2.7 Portfolio Bid Strategies (The 2026 Control Layer)
235
-
236
- **Strategy Name:** Portfolio Strategies
237
-
238
- **Function:** A wrapper that applies a single bidding logic (tCPA, tROAS) across multiple campaigns.<sup>10</sup>
239
-
240
- **Critical 2026 Use Case:**
241
-
242
- - **The CPC Cap Hack:** In 2026, standard Smart Bidding strategies do *not* allow CPC caps. Portfolio Strategies are the **only** way to set a "Maximum Bid Limit" on tCPA or tROAS.<sup>4</sup>
243
- - **Logic:** IF (Using tCPA) AND (Fear of $50+ Clicks) THEN (Apply Portfolio Strategy with Max CPC Cap = $15).
244
-
245
- **When to Use:**
246
-
247
- - Aggregating data: Grouping 5 low-volume regional campaigns into one Portfolio allows them to share conversion data, hitting the 30-conversion threshold faster.
248
-
249
- ---
250
-
251
- ## 3. SECTION 2: META ADS BIDDING DECISION ENGINE
252
-
253
- Meta's "Andromeda" algorithm (2026) operates on a "Total Value" equation:
254
-
255
- $$\text{Total Value} = \text{Bid} \times \text{Estimated Action Rate (EAR)} + \text{User Value (Quality)}$$
256
-
257
- Success depends on maximizing EAR through creative freshness and server-side signal density.<sup>11</sup> The "Learning Phase" is strictly defined as **50 conversions per week per ad set**.<sup>12</sup>
258
-
259
- ### 3.1 Bidding Strategy Logic
260
-
261
- #### Lowest Cost (Highest Volume)
262
-
263
- - **Logic:** Automatic bidding to clear the budget. Meta enters every auction it can afford, starting with the cheapest users. As budget scales, it moves to more expensive (higher marginal cost) users.
264
- - **When to Use:**
265
- - **Baseline:** 90% of campaigns.
266
- - **Cold Start:** New Ad Accounts with no pixel history.
267
- - **Consistently Spending:** When daily full budget utilization is the priority over strict cost controls.
268
- - **Risk:** Cost instability. CPA will fluctuate daily based on auction competition (CPM).
269
-
270
- #### Cost Cap
271
-
272
- - **Logic:** "Get as many conversions as possible *without* exceeding an average cost of $X."
273
- - **Constraint:** Limits delivery. If the auction price for a user > Cost Cap, Meta will **not** bid.
274
- - **When to Use:**
275
- - **Profit Protection:** When margins are thin (e.g., Dropshipping, Low-margin SaaS).
276
- - **Scaling:** Setting a floor for efficiency while increasing budget.
277
- - **Threshold:** Set Cost Cap at **1.2x - 1.5x** of the target CPA initially. Setting it *at* the target often throttles delivery to zero because the algorithm includes a "pacing buffer".<sup>11</sup>
278
-
279
- #### Bid Cap
280
-
281
- - **Logic:** "Do not bid more than $Y in any single auction." This controls the *input* (Bid), whereas Cost Cap controls the *output* (CPA).
282
- - **When to Use:**
283
- - **Advanced Sniper:** Targeting specific high-value users in competitive niches (e.g., Q4 Black Friday).
284
- - **Retargeting:** Preventing overpaying for warm audiences.
285
- - **Threshold:** Start with Bid Cap **2x-3x** the target CPA. (You must bid high to win high-quality users; paying $50 for a click is fine if that user converts at 50%).
286
-
287
- #### ROAS Goal (Minimum ROAS)
288
-
289
- - **Logic:** "Only enter auctions where Predicted Value / Cost > X."
290
- - **When to Use:**
291
- - **Catalog Sales:** E-commerce with high SKU variance ($20 socks vs. $500 jackets).
292
- - **Requirement:** Accurate Value passing via CAPI.
293
-
294
- #### Highest Value
295
-
296
- - **Logic:** Spend budget to maximize total revenue (User Value). Does not guarantee a specific ROAS.
297
- - **When to Use:** Default for Advantage+ Shopping Campaigns (ASC).
298
-
299
- ### 3.2 Budget Architecture: CBO vs. ABO Logic
300
-
301
- The CBO (Advantage+ Campaign Budget) vs. ABO (Ad Set Budget Optimization) decision is purely a function of **budget density** and **testing stage**.<sup>13</sup>
302
-
303
- **Decision Tree:**
304
-
305
- 1. **Check Budget Level:**
306
- - **IF** Daily Budget < **$100**:
307
- - **THEN**: Use **ABO**.
308
- - **Reason:** CBO requires "fluidity." With <$100, CBO will identify one "early winner" (often a false positive) and starve other ad sets, preventing statistical significance.
309
- - **IF** Daily Budget > **$500**:
310
- - **THEN**: Use **CBO**.
311
- - **Reason:** At high volume, the algorithm's real-time liquidity allocation outperforms manual shifts.
312
- 2. **Check Campaign Phase:**
313
- - **IF** Goal = **Creative Testing**:
314
- - **THEN**: Use **ABO** (or CBO with Min/Max Spend Limits).
315
- - **Logic:** You must force spend to new creatives to prove them valid. CBO will ignore new creatives in favor of historical winners.
316
- - **IF** Goal = **Scaling**:
317
- - **THEN**: Use **CBO**.
318
- - **Logic:** Group 3-5 winning ad sets/creatives. Allow CBO to auto-allocate based on daily auction fluctuations.
319
-
320
- ### 3.3 Learning Phase Protocol
321
-
322
- - **Exact Count: 50 conversions per week per ad set** (approx. 7-8/day).<sup>12</sup>
323
- - **Implication:** If budget cannot support 50 conversions/week (e.g., CPA is $50, Weekly Budget is $1,000 = 20 conversions), you **must** consolidate ad sets. Running 5 ad sets with 4 conversions each keeps *all* of them in "Learning Limited," degrading performance by ~20-40%.
324
- - **Reset Triggers (The "Do Not Touch" List):**
325
- - **Budget:** Changing budget by > **20%** in 24 hours.<sup>14</sup>
326
- - **Targeting:** Any change to audience.
327
- - **Creative:** Editing any active ad (headline, image, text).
328
- - **Bid:** Changing Cost Cap/Bid Cap amounts.
329
-
330
- ---
331
-
332
- ## 4. SECTION 3: BUDGET ALLOCATION FRAMEWORKS
333
-
334
- Allocation in 2026 is governed by **Time-to-Profitability** (cash flow cycles) and **Unit Economics**.
335
-
336
- ### 4.1 Platform Selection Matrix (2026)
337
-
338
- | Business Type | Recommended Split (2026) | Min. Viable Budget | Primary KPI | Time to Profit |
339
- |---|---|---|---|---|
340
- | **SaaS (B2B)** | LinkedIn (40%), Google Search (30%), Meta (20%), Other (10%) | $5,000/mo | Pipeline Value / SQL Cost | 3--6 Months |
341
- | **E-commerce** | Meta (50%), Google PMax (30%), TikTok (15%), Email (5%) | $3,000/mo | MER / ROAS | 0--2 Months |
342
- | **Local Service** | Google LSA/Search (60%), Meta (30%), Bing (10%) | $1,500/mo | Cost Per Lead (CPL) | 1 Month |
343
- | **B2B Enterprise** | LinkedIn (60%), Google Search (20%), ABM Display (20%) | $10,000/mo | Cost Per Account | 6--12 Months |
344
- | **Info Products** | YouTube (40%), Meta (40%), Email (20%) | $2,000/mo | ROAS / Funnel ROI | 1--3 Months |
345
- | **Mobile App** | Apple Search Ads (30%), Google App (30%), Meta/TikTok (40%) | $5,000/mo | CPI / LTV | 3--6 Months |
346
- | **Real Estate** | Meta Lead Forms (50%), Google Search (40%), LinkedIn (10%) | $2,500/mo | CPL / Appt Set | 2--4 Months |
347
- | **Healthcare** | Google Search (70%), Meta Remarketing (30%) | $4,000/mo | CPL / Patient Value | 2--5 Months |
348
- | **Finance** | Google Search (50%), Affiliate/Native (30%), LinkedIn (20%) | $8,000/mo | CAC / Deposit Value | 4--8 Months |
349
- | **Agency** | LinkedIn (50%), Meta (30%), Google (20%) | $1,500/mo | CPL / MQL | 1--3 Months |
350
-
351
- Sources:<sup>15</sup>
352
-
353
- ### 4.2 Budget Scaling Decision Tree
354
-
355
- **Inputs:** Current\_CPA, Target\_CPA, Impression\_Share\_Lost, Frequency.
356
-
357
- 1. **Scaling Logic (The "20% Rule"):**
358
- - **IF** Current\_CPA < Target\_CPA (by > 10%) **AND** (Impression\_Share\_Lost\_to\_Budget > 10% [Google] OR Frequency < 2.0 [Meta]):
359
- - **THEN:** Increase Daily Budget by **20%**.
360
- - **WAIT:** 72 Hours (3 Days) to monitor CPA stability. Do not scale again until 72 hours pass.<sup>14</sup>
361
- - **IF** CPA remains stable: Repeat.
362
- 2. **Kill Logic (The "3x Rule"):**
363
- - **IF** Ad Spend > **3x Target CPA** AND Conversions = 0:
364
- - **THEN: KILL** (Pause Ad/Ad Set immediately).
365
- - **IF** Ad Spend > **1x Target CPA** AND Clicks = 0 (or CTR < 0.2%):
366
- - **THEN:** Check Creative/Technical (Broken Link?).
367
- 3. **Decreasing Logic:**
368
- - **IF** Current\_CPA > Target\_CPA (by > 20%) for 7 days:
369
- - **THEN:** Decrease Budget by 20% to force algorithm efficiency.
370
- 4. **Diversification Logic:**
371
- - **IF** Frequency > 4.0 (Meta) OR Impression\_Share > 80% (Google):
372
- - **THEN:** Channel is saturated. Allocate next marginal dollar to a *new* platform (e.g., Scale to TikTok or Bing).
373
-
374
- ### 4.3 Cross-Platform Logic: MER & Incrementality
375
-
376
- **MER (Marketing Efficiency Ratio):**
377
-
378
- $$\text{MER} = \frac{\text{Total Revenue (All Channels)}}{\text{Total Ad Spend (All Channels)}}$$
379
-
380
- - **Methodology:** See formula above.
381
- - **2026 Standard:** Use MER as the "North Star" for total budget. Use Platform ROAS for day-to-day bidding.
382
- - **Threshold:** A healthy E-com MER is **3.0 - 5.0**.<sup>19</sup> If MER < 3.0, stop scaling.
383
-
384
- **Incrementality Testing (Geo-Lift):**
385
-
386
- - **Protocol:** Select a "Holdout" region (e.g., exclude California, representing ~10% of market). Run ads everywhere else.
387
- - **Duration:** Minimum **2--4 weeks**.<sup>20</sup>
388
- - **Analysis:** Compare organic sales lift in "Ad-On" regions vs. "Holdout" region.
389
-
390
- $$\text{Incremental ROAS} = \frac{\text{Revenue(Test)} - \text{Revenue(Control)}}{\text{Ad Spend}}$$
391
-
392
- - **Diminishing Returns Signal:** If doubling spend in "Test" region yields 0% lift over "Control," the channel has hit saturation.
393
-
394
- **Seasonal Adjustments:**
395
-
396
- - **Q4 (BFCM):** Plan for CPM increases of 30-50%. Reduce "ROAS Targets" by 20% to maintain volume against higher competition.
397
- - **Q1 (Jan):** Reset MER targets. "Correction" period where efficiency often improves as CPMs drop.<sup>21</sup>
398
-
399
- ---
400
-
401
- ## 5. SECTION 4: CONVERSION TRACKING SETUP REQUIREMENTS
402
-
403
- In 2026, client-side pixels are "lossy" (capturing ~60-70% of data). Server-side tracking is the primary source of truth.
404
-
405
- ### 5.1 Google Ads Infrastructure
406
-
407
- - **Minimum (Must Have):**
408
- - **Google Tag (gtag.js)**: Base installation.
409
- - **Enhanced Conversions**: Enabled in Google Ads > Settings. **Requirement:** Capture hashed Email (SHA256), Phone, or Address on form submit/checkout.<sup>22</sup>
410
- - **Consent Mode v2**: Mandatory for EEA. Must pass ad\_user\_data and ad\_personalization signals ("granted/denied").<sup>23</sup>
411
- - **Ideal (Should Have):**
412
- - **Server-Side GTM**: Google Ads Conversion Tag firing from a server container (stape.io or Google Cloud) to bypass ITP.
413
-
414
- ### 5.2 Meta Ads Infrastructure
415
-
416
- - **Minimum (Must Have):**
417
- - **Meta Pixel**: Client-side base code.
418
- - **Conversions API (CAPI)**: Server-to-server. Use partner integration (Shopify/WooCommerce) or CAPI Gateway.<sup>24</sup>
419
- - **Event Deduplication**: **Critical.** Must send unique event\_id in both Pixel and CAPI payloads. If event\_id matches, Meta discards the Pixel event and keeps the Server event.
420
- - **Ideal (Should Have):**
421
- - **Event Match Quality (EMQ)** score > 6.0/10. Pass extended user parameters: Email, Phone, IP Address, User Agent, fbp (Browser ID), fbc (Click ID).<sup>14</sup>
422
- - **Domain Verification**: Required for Aggregated Event Measurement.
423
-
424
- ### 5.3 TikTok Ads Infrastructure
425
-
426
- - **Minimum (Must Have):**
427
- - **TikTok Pixel**.
428
- - **Events API**: Server-side tracking.
429
- - **Ideal (Should Have):**
430
- - **Advanced Matching**: Pass hashed email/phone.
431
- - **ttclid**: Ensure this click ID parameter is captured in the URL, stored in a cookie, and passed back via API.<sup>26</sup>
432
-
433
- ### 5.4 LinkedIn Ads Infrastructure
434
-
435
- - **Minimum (Must Have):**
436
- - **Insight Tag**: Client-side.
437
- - **Conversions API**: Essential for 2026 B2B attribution.<sup>27</sup>
438
- - **Ideal (Should Have):**
439
- - **Offline Conversions**: Upload "Deal Created" and "Closed Won" stages from CRM (HubSpot/Salesforce) via API to optimize for revenue, not just leads.
440
-
441
- ### 5.5 Microsoft Ads Infrastructure
442
-
443
- - **Minimum (Must Have):**
444
- - **UET Tag**: Universal Event Tracking.
445
- - **Enhanced Conversions**: Check "Turn on Enhanced Conversions" in goal settings. Requires hashed email/phone.<sup>28</sup>
446
- - **Ideal (Should Have):**
447
- - **Offline Conversion Import**: For reconciling lead quality.
448
-
449
- ---
450
-
451
- ## 6. SECTION 5: ATTRIBUTION MODELS
452
-
453
- ### 6.1 Default Models (2026)
454
-
455
- - **Google: Data-Driven Attribution (DDA)**. This is the default. It uses machine learning to assign credit based on how each touchpoint changed the *probability* of conversion. It is mandatory for efficient Smart Bidding.<sup>30</sup>
456
- - **Meta: 7-day click, 1-day view**. This is the optimization window. Meta optimizes for users who convert within this timeframe.
457
-
458
- ### 6.2 Cross-Platform Logic (Handling Disagreements)
459
-
460
- Attribution disagreements are mathematically guaranteed because platforms claim credit based on *their* touchpoints, ignoring others.
461
-
462
- **Handling Logic:**
463
-
464
- 1. **Hierarchy of Truth:**
465
- - **Tier 1 (Ultimate Truth):** Backend/CRM Sales Data (Cash in bank).
466
- - **Tier 2 (Macro View):** MER (Total Revenue / Total Spend).
467
- - **Tier 3 (Optimization View):** Platform Data (Google/Meta Dashboards).
468
- 2. **Decision Rule:**
469
- - **IF** Google reports 10 sales AND Meta reports 10 sales BUT CRM reports 15 total sales:
470
- - **THEN**: 5 sales were multi-touch (User clicked both).
471
- - **Action**: Do NOT reduce budgets based on "double counting." Use **MER** (3.0-5.0 target) to validate total spend. Use **Platform ROAS** to optimize *intra-platform* bids (e.g., Move budget from Meta Ad Set A to B).
472
-
473
- ### 6.3 Lookback Windows
474
-
475
- - **View-Through:**
476
- - **Meta**: 1-day view (Standard).
477
- - **Google Display/YouTube**: 3-day view. (Standard is often 30, but 30-day view-through claims too much organic credit. Reduce to 3 days for accuracy).
478
- - **Click-Through:**
479
- - **High Impulse (E-com < $50):** 7-day click.
480
- - **High Consideration (B2B/SaaS > $500):** 30-day or 90-day click.
481
-
482
- ---
483
-
484
- ## 7. Worked Examples
485
-
486
- ### Scenario A: $5,000/mo Budget (E-commerce)
487
-
488
- - **Goal:** Maximize ROAS (Target 3.0+).
489
- - **Platform Split:** Meta ($3,500 - 70%), Google PMax ($1,500 - 30%).
490
- - **Google Strategy:**
491
- - **Campaign:** 1 PMax (Feed Only).
492
- - **Bidding:** Maximize Conversion Value (No Target initially).
493
- - **Asset:** Product Feed + Merchant Center.
494
- - **Meta Strategy:**
495
- - **Campaign:** 1 CBO Campaign ("Scaling").
496
- - **Ad Sets:** 3 Ad Sets (Broad, Interest Stack, Lookalike 1%).
497
- - **Bidding:** Lowest Cost (Highest Volume).
498
- - **Scaling:** Increase Meta budget by 20% if MER > 4.0.
499
-
500
- ### Scenario B: $20,000/mo Budget (B2B SaaS)
501
-
502
- - **Goal:** SQLs at < $150.
503
- - **Platform Split:** LinkedIn ($8,000), Google Search ($8,000), Meta Retargeting ($4,000).
504
- - **Google Strategy:**
505
- - **Campaigns:** Brand Search (Manual CPC), Non-Brand "High Intent" (tCPA).
506
- - **Bidding:** Portfolio Strategy on Non-Brand to cap Max CPC at $15. Target CPA set to $150.
507
- - **LinkedIn Strategy:**
508
- - **Format:** Sponsored Content (Single Image/Video).
509
- - **Bidding:** Manual Bidding (Cost Per Click). Start low ($8) and inch up.
510
- - **Meta Strategy:**
511
- - **Type:** Retargeting (Website Visitors 30D).
512
- - **Bidding:** Cost Cap set to $100 (Aggressive efficiency).
513
-
514
- ### Scenario C: $100,000/mo Budget (Omni-Channel Brand)
515
-
516
- - **Goal:** Market Share & MER 4.0.
517
- - **Platform Split:** Meta (40%), Google (30%), TikTok (10%), YouTube (10%), TV/Audio (10%).
518
- - **Strategy:**
519
- - **Measurement:** MER is the primary gauge.
520
- - **Incrementality:** Quarterly Geo-Lift tests (Holdout 10% of geos) to validate TikTok/YouTube lift.
521
- - **Bidding:** tROAS on Google/Meta (Portfolio strategies). Bid Caps on TikTok to manage volatility.
522
- - **Data Stack:** Server-Side GTM + CAPI Gateway + Data Warehouse (Snowflake) for custom attribution modeling.
523
-
524
- ---
525
-
526
- **Report End.**
527
-
528
- ---
529
-
530
- ## Works Cited
531
-
532
- 1. In Google Ads automation, everything is a signal in 2026 - Search Engine Land, accessed February 10, 2026, [https://searchengineland.com/in-google-ads-automation-everything-is-a-signal-in-2026-468218](https://searchengineland.com/in-google-ads-automation-everything-is-a-signal-in-2026-468218)
533
-
534
- 2. Smart Bidding Secrets for Google Ads in 2026 India, accessed February 10, 2026, [https://mountwebtech.com/smart-bidding-strategies-that-win-in-google-ads-2026/](https://mountwebtech.com/smart-bidding-strategies-that-win-in-google-ads-2026/)
535
-
536
- 3. Your guide to Smart Bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/11095984?hl=en](https://support.google.com/google-ads/answer/11095984?hl=en)
537
-
538
- 4. Target CPA Bidding in Google Ads (2026) - Store Growers, accessed February 10, 2026, [https://www.storegrowers.com/target-cpa/](https://www.storegrowers.com/target-cpa/)
539
-
540
- 5. Automated vs Manual Bidding in Google Ads: 2026 Guide - YeezyPay Blog, accessed February 10, 2026, [https://yeezypay.io/blog/automated-vs-manual-bidding-in-google-ads-2026-gui](https://yeezypay.io/blog/automated-vs-manual-bidding-in-google-ads-2026-gui)
541
-
542
- 6. About Target ROAS bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/6268637?hl=en](https://support.google.com/google-ads/answer/6268637?hl=en)
543
-
544
- 7. It's 2026, what's one piece of Google ads advice you'd give if you had 26 seconds to think of it? : r/googleads - Reddit, accessed February 10, 2026, [https://www.reddit.com/r/googleads/comments/1gaoyec/its_2026_whats_one_piece_of_google_ads_advice/](https://www.reddit.com/r/googleads/comments/1gaoyec/its_2026_whats_one_piece_of_google_ads_advice/)
545
-
546
- 8. About Target impression share bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/9121108?hl=en](https://support.google.com/google-ads/answer/9121108?hl=en)
547
-
548
- 9. About Enhanced CPC (ECPC) - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/2464964?hl=en](https://support.google.com/google-ads/answer/2464964?hl=en)
549
-
550
- 10. Portfolio and Standard Bidding Strategies | Google Ads API, accessed February 10, 2026, [https://developers.google.com/google-ads/api/docs/campaigns/bidding/assign-strategies](https://developers.google.com/google-ads/api/docs/campaigns/bidding/assign-strategies)
551
-
552
- 11. Meta Ads Bidding Strategies 2026 | Maximize ROAS on Facebook & Instagram, accessed February 10, 2026, [https://spintadigital.com/blog/meta-ads-bidding-strategies-2026/](https://spintadigital.com/blog/meta-ads-bidding-strategies-2026/)
553
-
554
- 12. Conversion Count and First Conversion Optimization - Jon Loomer Digital, accessed February 10, 2026, [https://www.jonloomer.com/conversion-count-first-conversion-optimization/](https://www.jonloomer.com/conversion-count-first-conversion-optimization/)
555
-
556
- 13. I analyzed advertisers spending £45/day to $45K/month - here's when CBO vs ABO actually wins : r/FacebookAds - Reddit, accessed February 10, 2026, [https://www.reddit.com/r/FacebookAds/comments/1qhska5/i_analyzed_advertisers_spending_45day_to_45kmonth/](https://www.reddit.com/r/FacebookAds/comments/1qhska5/i_analyzed_advertisers_spending_45day_to_45kmonth/)
557
-
558
- 14. Meta Ads Checklist 2026 - Setup the Conversions API - PixelFlow, accessed February 10, 2026, [https://pixelflow.so/blog/meta-ads-checklist-2026](https://pixelflow.so/blog/meta-ads-checklist-2026)
559
-
560
- 15. B2B Marketing Budget Benchmarks for 2026 Planning - SpotOn Digital Media, accessed February 10, 2026, [https://www.spotondigitalmedia.com/blog/b2b-marketing-budget-benchmarks-for-2026-planning](https://www.spotondigitalmedia.com/blog/b2b-marketing-budget-benchmarks-for-2026-planning)
561
-
562
- 16. How to Allocate Your SaaS Marketing Budget for 2026 - Aimers Blog, accessed February 10, 2026, [https://aimers.io/blog/how-to-allocate-your-saas-marketing-budget](https://aimers.io/blog/how-to-allocate-your-saas-marketing-budget)
563
-
564
- 17. The 2026 Blueprint for Scalable B2B SaaS Marketing - Directive Consulting, accessed February 10, 2026, [https://directiveconsulting.com/blog/blog-b2b-saas-marketing-guide-2026/](https://directiveconsulting.com/blog/blog-b2b-saas-marketing-guide-2026/)
565
-
566
- 18. SaaS Marketing Budget & Allocation Guide (2026) - Roketto, accessed February 10, 2026, [https://www.helloroketto.com/articles/saas-marketing-budget](https://www.helloroketto.com/articles/saas-marketing-budget)
567
-
568
- 19. What is a good marketing efficiency ratio (MER)? - Keen Decision Systems, accessed February 10, 2026, [https://keends.com/blog/marketing-efficiency-ratio/](https://keends.com/blog/marketing-efficiency-ratio/)
569
-
570
- 20. What is Incrementality Testing? A Comprehensive Guide | Z2A Digital, accessed February 10, 2026, [https://www.z2adigital.com/blog-content/incrementality-testing-guide](https://www.z2adigital.com/blog-content/incrementality-testing-guide)
571
-
572
- 21. Marketing Efficiency Ratio (MER): Definition, Benchmarks, and How it Differs from ROAS, accessed February 10, 2026, [https://www.northbeam.io/blog/marketing-efficiency-ratio-mer-roas](https://www.northbeam.io/blog/marketing-efficiency-ratio-mer-roas)
573
-
574
- 22. Set up enhanced conversions for web using the Google tag, accessed February 10, 2026, [https://support.google.com/google-ads/answer/13258081?hl=en](https://support.google.com/google-ads/answer/13258081?hl=en)
575
-
576
- 23. How to set up Enhanced Conversions for Google Ads and GA4 - Stape, accessed February 10, 2026, [https://stape.io/blog/ga4-and-google-ads-enhanced-conversions-tracking-setup-guide](https://stape.io/blog/ga4-and-google-ads-enhanced-conversions-tracking-setup-guide)
577
-
578
- 24. Meta Conversions API Extension Overview | Adobe Data Collection - Experience League, accessed February 10, 2026, [https://experienceleague.adobe.com/en/docs/experience-platform/tags/extensions/server/meta/overview](https://experienceleague.adobe.com/en/docs/experience-platform/tags/extensions/server/meta/overview)
579
-
580
- 25. Conversion API Setup Guide: Track Ads Accurately 2026 - Cometly, accessed February 10, 2026, [https://www.cometly.com/post/conversion-api-setup-guide](https://www.cometly.com/post/conversion-api-setup-guide)
581
-
582
- 26. TikTok Events API -- a complete install guide for Shopify stores [2026] - OmegaTheme, accessed February 10, 2026, [https://www.omegatheme.com/blogs/set-up-tiktok-pixels-to-track-events-with-events-api-server-side-tracking-for-tiktok-ads](https://www.omegatheme.com/blogs/set-up-tiktok-pixels-to-track-events-with-events-api-server-side-tracking-for-tiktok-ads)
583
-
584
- 27. How to set up the LinkedIn Conversions API? - Hightouch, accessed February 10, 2026, [https://hightouch.com/blog/how-to-set-up-linkedin-conversions-api](https://hightouch.com/blog/how-to-set-up-linkedin-conversions-api)
585
-
586
- 28. Set up UET tags using Google Tag Manager - Microsoft Advertising Help Center, accessed February 10, 2026, [https://help.ads.microsoft.com/apex/index/3/en/56894](https://help.ads.microsoft.com/apex/index/3/en/56894)
587
-
588
- 29. Enhanced conversions and other updates for February - Microsoft Advertising, accessed February 10, 2026, [https://about.ads.microsoft.com/en/blog/post/february-2024/enhanced-conversions-and-other-updates-for-february](https://about.ads.microsoft.com/en/blog/post/february-2024/enhanced-conversions-and-other-updates-for-february)
589
-
590
- 30. GA4 vs Attribuly: Best Multi-Touch Models for Shopify (2026), accessed February 10, 2026, [https://attribuly.com/blogs/ga4-vs-attribuly-multi-touch-attribution-shopify-2026/](https://attribuly.com/blogs/ga4-vs-attribuly-multi-touch-attribution-shopify-2026/)