agileflow 4.0.0-alpha.2 → 4.0.0-alpha.21

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 (372) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/content/plugins/accessibility/plugin.yaml +14 -0
  3. package/content/plugins/accessibility/skills/agileflow-accessibility/SKILL.md +392 -0
  4. package/content/plugins/accessibility/skills/agileflow-accessibility/references/aria-patterns.md +528 -0
  5. package/content/plugins/accessibility/skills/agileflow-accessibility/references/testing-checklist.md +457 -0
  6. package/content/plugins/accessibility/skills/agileflow-accessibility/references/wcag-guide.md +683 -0
  7. package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/audit-page.md +310 -0
  8. package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/implement-accessible-component.md +479 -0
  9. package/content/plugins/ads/agents/ads-audit-budget.md +185 -0
  10. package/content/plugins/ads/agents/ads-audit-compliance.md +171 -0
  11. package/content/plugins/ads/agents/ads-audit-creative.md +168 -0
  12. package/content/plugins/ads/agents/ads-audit-google.md +227 -0
  13. package/content/plugins/ads/agents/ads-audit-meta.md +184 -0
  14. package/content/plugins/ads/agents/ads-audit-tracking.md +205 -0
  15. package/content/plugins/ads/agents/ads-consensus.md +410 -0
  16. package/content/plugins/ads/agents/ads-generate.md +152 -0
  17. package/content/plugins/ads/agents/ads-performance-tracker.md +212 -0
  18. package/content/plugins/ads/plugin.yaml +23 -4
  19. package/content/plugins/ads/skills/agileflow-ads/SKILL.md +218 -0
  20. package/content/plugins/ads/skills/agileflow-ads/references/ad-copy-formula-guide.md +131 -0
  21. package/content/plugins/ads/skills/agileflow-ads/references/audience-targeting-guide.md +137 -0
  22. package/content/plugins/ads/skills/agileflow-ads/references/bid-strategy-guide.md +115 -0
  23. package/content/plugins/ads/skills/agileflow-ads/references/platform-benchmarks.md +100 -0
  24. package/content/plugins/ads/skills/agileflow-ads/workflows/audit.md +118 -0
  25. package/content/plugins/ads/skills/agileflow-ads/workflows/generate.md +84 -0
  26. package/content/plugins/audit/agents/a11y-analyzer-aria.md +173 -0
  27. package/content/plugins/audit/agents/a11y-analyzer-forms.md +173 -0
  28. package/content/plugins/audit/agents/a11y-analyzer-keyboard.md +183 -0
  29. package/content/plugins/audit/agents/a11y-analyzer-semantic.md +169 -0
  30. package/content/plugins/audit/agents/a11y-analyzer-visual.md +172 -0
  31. package/content/plugins/audit/agents/a11y-consensus.md +249 -0
  32. package/content/plugins/audit/agents/accessibility.md +558 -0
  33. package/content/plugins/audit/agents/api-quality-analyzer-conventions.md +156 -0
  34. package/content/plugins/audit/agents/api-quality-analyzer-docs.md +184 -0
  35. package/content/plugins/audit/agents/api-quality-analyzer-errors.md +191 -0
  36. package/content/plugins/audit/agents/api-quality-analyzer-pagination.md +179 -0
  37. package/content/plugins/audit/agents/api-quality-analyzer-versioning.md +150 -0
  38. package/content/plugins/audit/agents/api-quality-consensus.md +217 -0
  39. package/content/plugins/audit/agents/api-validator.md +191 -0
  40. package/content/plugins/audit/agents/arch-analyzer-circular.md +156 -0
  41. package/content/plugins/audit/agents/arch-analyzer-complexity.md +193 -0
  42. package/content/plugins/audit/agents/arch-analyzer-coupling.md +152 -0
  43. package/content/plugins/audit/agents/arch-analyzer-layering.md +160 -0
  44. package/content/plugins/audit/agents/arch-analyzer-patterns.md +210 -0
  45. package/content/plugins/audit/agents/arch-consensus.md +228 -0
  46. package/content/plugins/audit/agents/browser-qa.md +342 -0
  47. package/content/plugins/audit/agents/code-reviewer.md +298 -0
  48. package/content/plugins/audit/agents/completeness-analyzer-api.md +199 -0
  49. package/content/plugins/audit/agents/completeness-analyzer-conditional.md +211 -0
  50. package/content/plugins/audit/agents/completeness-analyzer-handlers.md +166 -0
  51. package/content/plugins/audit/agents/completeness-analyzer-imports.md +165 -0
  52. package/content/plugins/audit/agents/completeness-analyzer-routes.md +190 -0
  53. package/content/plugins/audit/agents/completeness-analyzer-state.md +196 -0
  54. package/content/plugins/audit/agents/completeness-analyzer-stubs.md +206 -0
  55. package/content/plugins/audit/agents/completeness-consensus.md +295 -0
  56. package/content/plugins/audit/agents/error-analyzer.md +213 -0
  57. package/content/plugins/audit/agents/flow-analyzer-authorization.md +182 -0
  58. package/content/plugins/audit/agents/flow-analyzer-discovery.md +174 -0
  59. package/content/plugins/audit/agents/flow-analyzer-errors.md +186 -0
  60. package/content/plugins/audit/agents/flow-analyzer-feedback.md +185 -0
  61. package/content/plugins/audit/agents/flow-analyzer-navigation.md +177 -0
  62. package/content/plugins/audit/agents/flow-analyzer-persistence.md +193 -0
  63. package/content/plugins/audit/agents/flow-analyzer-wiring.md +169 -0
  64. package/content/plugins/audit/agents/flow-consensus.md +237 -0
  65. package/content/plugins/audit/agents/legal-analyzer-a11y.md +114 -0
  66. package/content/plugins/audit/agents/legal-analyzer-ai.md +121 -0
  67. package/content/plugins/audit/agents/legal-analyzer-consumer.md +114 -0
  68. package/content/plugins/audit/agents/legal-analyzer-content.md +117 -0
  69. package/content/plugins/audit/agents/legal-analyzer-international.md +119 -0
  70. package/content/plugins/audit/agents/legal-analyzer-licensing.md +119 -0
  71. package/content/plugins/audit/agents/legal-analyzer-privacy.md +112 -0
  72. package/content/plugins/audit/agents/legal-analyzer-security.md +116 -0
  73. package/content/plugins/audit/agents/legal-analyzer-terms.md +115 -0
  74. package/content/plugins/audit/agents/legal-consensus.md +250 -0
  75. package/content/plugins/audit/agents/logic-analyzer-edge.md +179 -0
  76. package/content/plugins/audit/agents/logic-analyzer-flow.md +264 -0
  77. package/content/plugins/audit/agents/logic-analyzer-invariant.md +215 -0
  78. package/content/plugins/audit/agents/logic-analyzer-race.md +280 -0
  79. package/content/plugins/audit/agents/logic-analyzer-type.md +227 -0
  80. package/content/plugins/audit/agents/logic-consensus.md +259 -0
  81. package/content/plugins/audit/agents/perf-analyzer-assets.md +182 -0
  82. package/content/plugins/audit/agents/perf-analyzer-bundle.md +173 -0
  83. package/content/plugins/audit/agents/perf-analyzer-caching.md +170 -0
  84. package/content/plugins/audit/agents/perf-analyzer-compute.md +173 -0
  85. package/content/plugins/audit/agents/perf-analyzer-memory.md +193 -0
  86. package/content/plugins/audit/agents/perf-analyzer-network.md +165 -0
  87. package/content/plugins/audit/agents/perf-analyzer-queries.md +162 -0
  88. package/content/plugins/audit/agents/perf-analyzer-rendering.md +168 -0
  89. package/content/plugins/audit/agents/perf-consensus.md +287 -0
  90. package/content/plugins/audit/agents/qa.md +820 -0
  91. package/content/plugins/audit/agents/quality-analyzer-comments.md +159 -0
  92. package/content/plugins/audit/agents/quality-analyzer-duplication.md +184 -0
  93. package/content/plugins/audit/agents/quality-analyzer-naming.md +160 -0
  94. package/content/plugins/audit/agents/quality-consensus.md +241 -0
  95. package/content/plugins/audit/agents/schema-validator.md +473 -0
  96. package/content/plugins/audit/agents/security-analyzer-api.md +210 -0
  97. package/content/plugins/audit/agents/security-analyzer-auth.md +169 -0
  98. package/content/plugins/audit/agents/security-analyzer-authz.md +180 -0
  99. package/content/plugins/audit/agents/security-analyzer-deps.md +153 -0
  100. package/content/plugins/audit/agents/security-analyzer-infra.md +184 -0
  101. package/content/plugins/audit/agents/security-analyzer-injection.md +155 -0
  102. package/content/plugins/audit/agents/security-analyzer-input.md +201 -0
  103. package/content/plugins/audit/agents/security-analyzer-secrets.md +183 -0
  104. package/content/plugins/audit/agents/security-consensus.md +283 -0
  105. package/content/plugins/audit/agents/test-analyzer-assertions.md +188 -0
  106. package/content/plugins/audit/agents/test-analyzer-coverage.md +189 -0
  107. package/content/plugins/audit/agents/test-analyzer-fragility.md +193 -0
  108. package/content/plugins/audit/agents/test-analyzer-integration.md +161 -0
  109. package/content/plugins/audit/agents/test-analyzer-maintenance.md +180 -0
  110. package/content/plugins/audit/agents/test-analyzer-mocking.md +188 -0
  111. package/content/plugins/audit/agents/test-analyzer-patterns.md +196 -0
  112. package/content/plugins/audit/agents/test-analyzer-structure.md +184 -0
  113. package/content/plugins/audit/agents/test-consensus.md +301 -0
  114. package/content/plugins/audit/agents/testing.md +561 -0
  115. package/content/plugins/audit/agents/ui-validator.md +344 -0
  116. package/content/plugins/audit/plugin.yaml +186 -5
  117. package/content/plugins/audit/skills/agileflow-audit/SKILL.md +113 -0
  118. package/content/plugins/audit/skills/agileflow-audit/references/audit-depth-guide.md +151 -0
  119. package/content/plugins/audit/skills/agileflow-audit/references/dependency-risk-guide.md +139 -0
  120. package/content/plugins/audit/skills/agileflow-audit/references/owasp-top10.md +120 -0
  121. package/content/plugins/audit/skills/agileflow-audit/references/performance-budget-guide.md +143 -0
  122. package/content/plugins/audit/skills/agileflow-audit/references/wcag-criteria.md +117 -0
  123. package/content/plugins/audit/skills/agileflow-audit/workflows/run-audit.md +52 -0
  124. package/content/plugins/audit/skills/agileflow-audit/workflows/tdd.md +66 -0
  125. package/content/plugins/core/agents/adr-writer.md +521 -0
  126. package/content/plugins/core/agents/epic-planner.md +520 -0
  127. package/content/plugins/core/agents/mentor.md +709 -0
  128. package/content/plugins/core/agents/orchestrator.md +776 -0
  129. package/content/plugins/core/agents/team-coordinator.md +334 -0
  130. package/content/plugins/core/agents/team-lead.md +181 -0
  131. package/content/plugins/core/agents/workspace-orchestrator.md +146 -0
  132. package/content/plugins/core/hooks/context-loader.js +31 -4
  133. package/content/plugins/core/hooks/damage-control-bash.js +10 -2
  134. package/content/plugins/core/hooks/damage-control-edit.js +4 -1
  135. package/content/plugins/core/hooks/damage-control-patterns.yaml +1 -1
  136. package/content/plugins/core/hooks/damage-control-write.js +4 -1
  137. package/content/plugins/core/hooks/{pre-compact-state.js → post-compact-state.js} +25 -8
  138. package/content/plugins/core/hooks/preferences-injector.js +352 -0
  139. package/content/plugins/core/plugin.yaml +24 -28
  140. package/content/plugins/core/skills/agileflow-adr/SKILL.md +34 -8
  141. package/content/plugins/core/skills/agileflow-adr/references/madr-format-guide.md +86 -0
  142. package/content/plugins/core/skills/agileflow-adr/workflows/write-adr.md +57 -0
  143. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +94 -27
  144. package/content/plugins/core/skills/agileflow-babysit-mentor/references/mentor-decision-guide.md +81 -0
  145. package/content/plugins/core/skills/agileflow-babysit-mentor/workflows/mentor-session.md +79 -0
  146. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +37 -7
  147. package/content/plugins/core/skills/agileflow-epic-planner/references/epic-sizing-guide.md +81 -0
  148. package/content/plugins/core/skills/agileflow-epic-planner/workflows/plan-epic.md +55 -0
  149. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +36 -20
  150. package/content/plugins/core/skills/agileflow-status-updater/references/status-transitions.md +89 -0
  151. package/content/plugins/core/skills/agileflow-status-updater/workflows/update-status.md +56 -0
  152. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +39 -114
  153. package/content/plugins/core/skills/agileflow-story-writer/references/estimation-reference.md +36 -0
  154. package/content/plugins/core/skills/agileflow-story-writer/references/story-template.md +92 -0
  155. package/content/plugins/core/skills/agileflow-story-writer/workflows/write-story.md +138 -0
  156. package/content/plugins/council/agents/council-advocate.md +223 -0
  157. package/content/plugins/council/agents/council-analyst.md +278 -0
  158. package/content/plugins/council/agents/council-compounder.md +204 -0
  159. package/content/plugins/council/agents/council-contrarian.md +217 -0
  160. package/content/plugins/council/agents/council-moonshot.md +217 -0
  161. package/content/plugins/council/agents/council-optimist.md +185 -0
  162. package/content/plugins/council/agents/council-revenue.md +200 -0
  163. package/content/plugins/council/agents/council-technical.md +218 -0
  164. package/content/plugins/council/agents/multi-expert.md +334 -0
  165. package/content/plugins/council/plugin.yaml +23 -4
  166. package/content/plugins/council/skills/agileflow-council/SKILL.md +102 -0
  167. package/content/plugins/council/skills/agileflow-council/references/decision-log-template.md +109 -0
  168. package/content/plugins/council/skills/agileflow-council/references/perspective-guide.md +104 -0
  169. package/content/plugins/council/skills/agileflow-council/references/when-to-convene-guide.md +112 -0
  170. package/content/plugins/council/skills/agileflow-council/workflows/convene.md +73 -0
  171. package/content/plugins/council/skills/agileflow-council/workflows/multi-expert.md +75 -0
  172. package/content/plugins/database/plugin.yaml +14 -0
  173. package/content/plugins/database/skills/agileflow-database/SKILL.md +284 -0
  174. package/content/plugins/database/skills/agileflow-database/references/indexing-guide.md +313 -0
  175. package/content/plugins/database/skills/agileflow-database/references/migration-guide.md +328 -0
  176. package/content/plugins/database/skills/agileflow-database/references/schema-design-guide.md +467 -0
  177. package/content/plugins/database/skills/agileflow-database/workflows/design-schema.md +213 -0
  178. package/content/plugins/database/skills/agileflow-database/workflows/optimize-query.md +253 -0
  179. package/content/plugins/debugging/plugin.yaml +14 -0
  180. package/content/plugins/debugging/skills/agileflow-debug/SKILL.md +236 -0
  181. package/content/plugins/debugging/skills/agileflow-debug/references/common-patterns.md +350 -0
  182. package/content/plugins/debugging/skills/agileflow-debug/references/debugging-strategies.md +328 -0
  183. package/content/plugins/debugging/skills/agileflow-debug/workflows/debug-issue.md +187 -0
  184. package/content/plugins/debugging/skills/agileflow-debug/workflows/reproduce-bug.md +194 -0
  185. package/content/plugins/delivery/agents/ci.md +547 -0
  186. package/content/plugins/delivery/agents/devops.md +789 -0
  187. package/content/plugins/delivery/plugin.yaml +19 -0
  188. package/content/plugins/delivery/skills/agileflow-delivery/SKILL.md +111 -0
  189. package/content/plugins/delivery/skills/agileflow-delivery/references/changelog-format-guide.md +133 -0
  190. package/content/plugins/delivery/skills/agileflow-delivery/references/ci-pipeline-guide.md +158 -0
  191. package/content/plugins/delivery/skills/agileflow-delivery/references/pr-checklist-guide.md +133 -0
  192. package/content/plugins/delivery/skills/agileflow-delivery/references/release-checklist.md +142 -0
  193. package/content/plugins/delivery/skills/agileflow-delivery/workflows/changelog.md +72 -0
  194. package/content/plugins/delivery/skills/agileflow-delivery/workflows/deploy.md +74 -0
  195. package/content/plugins/delivery/skills/agileflow-delivery/workflows/pr.md +75 -0
  196. package/content/plugins/docs/agents/documentation.md +544 -0
  197. package/content/plugins/docs/agents/readme-updater.md +640 -0
  198. package/content/plugins/docs/plugin.yaml +19 -0
  199. package/content/plugins/docs/skills/agileflow-docs/SKILL.md +106 -0
  200. package/content/plugins/docs/skills/agileflow-docs/references/api-doc-template.md +167 -0
  201. package/content/plugins/docs/skills/agileflow-docs/references/doc-types-guide.md +141 -0
  202. package/content/plugins/docs/skills/agileflow-docs/references/readme-template.md +156 -0
  203. package/content/plugins/docs/skills/agileflow-docs/workflows/readme-sync.md +57 -0
  204. package/content/plugins/docs/skills/agileflow-docs/workflows/sync.md +64 -0
  205. package/content/plugins/engineering/agents/api.md +718 -0
  206. package/content/plugins/engineering/agents/codebase-query.md +285 -0
  207. package/content/plugins/engineering/agents/compliance.md +559 -0
  208. package/content/plugins/engineering/agents/database.md +644 -0
  209. package/content/plugins/engineering/agents/integrations.md +644 -0
  210. package/content/plugins/engineering/agents/mobile.md +552 -0
  211. package/content/plugins/engineering/agents/monitoring.md +585 -0
  212. package/content/plugins/engineering/agents/performance.md +529 -0
  213. package/content/plugins/engineering/agents/refactor.md +592 -0
  214. package/content/plugins/engineering/agents/security.md +524 -0
  215. package/content/plugins/engineering/agents/ui.md +1336 -0
  216. package/content/plugins/engineering/plugin.yaml +37 -0
  217. package/content/plugins/engineering/skills/agileflow-engineering/SKILL.md +127 -0
  218. package/content/plugins/engineering/skills/agileflow-engineering/references/code-review-guide.md +126 -0
  219. package/content/plugins/engineering/skills/agileflow-engineering/references/domain-routing-guide.md +89 -0
  220. package/content/plugins/engineering/skills/agileflow-engineering/references/refactoring-guide.md +136 -0
  221. package/content/plugins/engineering/skills/agileflow-engineering/workflows/diagnose.md +63 -0
  222. package/content/plugins/engineering/skills/agileflow-engineering/workflows/impact.md +60 -0
  223. package/content/plugins/ideation/agents/brainstorm-analyzer-features.md +179 -0
  224. package/content/plugins/ideation/agents/brainstorm-analyzer-growth.md +169 -0
  225. package/content/plugins/ideation/agents/brainstorm-analyzer-integration.md +181 -0
  226. package/content/plugins/ideation/agents/brainstorm-analyzer-market.md +150 -0
  227. package/content/plugins/ideation/agents/brainstorm-analyzer-ux.md +180 -0
  228. package/content/plugins/ideation/agents/brainstorm-consensus.md +245 -0
  229. package/content/plugins/ideation/agents/design.md +568 -0
  230. package/content/plugins/ideation/agents/product.md +582 -0
  231. package/content/plugins/ideation/plugin.yaml +31 -0
  232. package/content/plugins/ideation/skills/agileflow-ideation/SKILL.md +109 -0
  233. package/content/plugins/ideation/skills/agileflow-ideation/references/brainstorm-techniques.md +138 -0
  234. package/content/plugins/ideation/skills/agileflow-ideation/references/competitive-analysis-template.md +148 -0
  235. package/content/plugins/ideation/skills/agileflow-ideation/references/feature-prioritization-guide.md +147 -0
  236. package/content/plugins/ideation/skills/agileflow-ideation/references/user-story-patterns.md +152 -0
  237. package/content/plugins/ideation/skills/agileflow-ideation/workflows/features.md +65 -0
  238. package/content/plugins/ideation/skills/agileflow-ideation/workflows/ideate.md +54 -0
  239. package/content/plugins/migration/agents/datamigration.md +757 -0
  240. package/content/plugins/migration/plugin.yaml +17 -0
  241. package/content/plugins/migration/skills/agileflow-migration/SKILL.md +106 -0
  242. package/content/plugins/migration/skills/agileflow-migration/references/data-validation-checklist.md +154 -0
  243. package/content/plugins/migration/skills/agileflow-migration/references/migration-patterns.md +209 -0
  244. package/content/plugins/migration/skills/agileflow-migration/references/rollback-playbook.md +171 -0
  245. package/content/plugins/migration/skills/agileflow-migration/references/version-compatibility-matrix.md +155 -0
  246. package/content/plugins/migration/skills/agileflow-migration/workflows/plan.md +73 -0
  247. package/content/plugins/migration/skills/agileflow-migration/workflows/validate.md +71 -0
  248. package/content/plugins/performance/plugin.yaml +14 -0
  249. package/content/plugins/performance/skills/agileflow-performance/SKILL.md +224 -0
  250. package/content/plugins/performance/skills/agileflow-performance/references/optimization-patterns.md +554 -0
  251. package/content/plugins/performance/skills/agileflow-performance/references/profiling-guide.md +383 -0
  252. package/content/plugins/performance/skills/agileflow-performance/references/web-vitals-guide.md +360 -0
  253. package/content/plugins/performance/skills/agileflow-performance/workflows/improve-web-vitals.md +344 -0
  254. package/content/plugins/performance/skills/agileflow-performance/workflows/profile-and-fix.md +254 -0
  255. package/content/plugins/planning/agents/analytics.md +670 -0
  256. package/content/plugins/planning/agents/rlm-subcore.md +215 -0
  257. package/content/plugins/planning/plugin.yaml +19 -0
  258. package/content/plugins/planning/skills/agileflow-planning/SKILL.md +111 -0
  259. package/content/plugins/planning/skills/agileflow-planning/references/estimation-guide.md +114 -0
  260. package/content/plugins/planning/skills/agileflow-planning/references/rpi-workflow.md +119 -0
  261. package/content/plugins/planning/skills/agileflow-planning/references/sprint-planning-guide.md +145 -0
  262. package/content/plugins/planning/skills/agileflow-planning/workflows/impact.md +63 -0
  263. package/content/plugins/planning/skills/agileflow-planning/workflows/rpi.md +104 -0
  264. package/content/plugins/psychology/plugin.yaml +14 -0
  265. package/content/plugins/psychology/skills/agileflow-retention/SKILL.md +252 -0
  266. package/content/plugins/psychology/skills/agileflow-retention/references/competitor-analysis.md +240 -0
  267. package/content/plugins/psychology/skills/agileflow-retention/references/psychology-models.md +349 -0
  268. package/content/plugins/psychology/skills/agileflow-retention/references/retention-patterns.md +279 -0
  269. package/content/plugins/psychology/skills/agileflow-retention/workflows/design-retention-feature.md +287 -0
  270. package/content/plugins/psychology/skills/agileflow-retention/workflows/retention-audit.md +259 -0
  271. package/content/plugins/refactoring/plugin.yaml +14 -0
  272. package/content/plugins/refactoring/skills/agileflow-refactor/SKILL.md +235 -0
  273. package/content/plugins/refactoring/skills/agileflow-refactor/references/refactoring-patterns.md +405 -0
  274. package/content/plugins/refactoring/skills/agileflow-refactor/references/safety-checks.md +177 -0
  275. package/content/plugins/refactoring/skills/agileflow-refactor/workflows/extract-module.md +226 -0
  276. package/content/plugins/refactoring/skills/agileflow-refactor/workflows/safe-refactor.md +169 -0
  277. package/content/plugins/research/agents/research.md +503 -0
  278. package/content/plugins/research/plugin.yaml +17 -0
  279. package/content/plugins/research/skills/agileflow-research/SKILL.md +110 -0
  280. package/content/plugins/research/skills/agileflow-research/references/knowledge-decay-guide.md +121 -0
  281. package/content/plugins/research/skills/agileflow-research/references/research-prompt-guide.md +141 -0
  282. package/content/plugins/research/skills/agileflow-research/references/synthesis-template.md +154 -0
  283. package/content/plugins/research/skills/agileflow-research/workflows/analyze.md +60 -0
  284. package/content/plugins/research/skills/agileflow-research/workflows/ask.md +64 -0
  285. package/content/plugins/research/skills/agileflow-research/workflows/import.md +66 -0
  286. package/content/plugins/research/skills/agileflow-research/workflows/synthesize.md +66 -0
  287. package/content/plugins/reviews/plugin.yaml +14 -0
  288. package/content/plugins/reviews/skills/agileflow-pr-reviewer/SKILL.md +241 -0
  289. package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/review-checklist.md +200 -0
  290. package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/security-patterns.md +328 -0
  291. package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/review-pr.md +153 -0
  292. package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/security-review.md +177 -0
  293. package/content/plugins/seo/agents/seo-analyzer-content.md +169 -0
  294. package/content/plugins/seo/agents/seo-analyzer-images.md +198 -0
  295. package/content/plugins/seo/agents/seo-analyzer-performance.md +217 -0
  296. package/content/plugins/seo/agents/seo-analyzer-schema.md +184 -0
  297. package/content/plugins/seo/agents/seo-analyzer-sitemap.md +177 -0
  298. package/content/plugins/seo/agents/seo-analyzer-technical.md +151 -0
  299. package/content/plugins/seo/agents/seo-consensus.md +304 -0
  300. package/content/plugins/seo/plugin.yaml +19 -4
  301. package/content/plugins/seo/skills/agileflow-seo/SKILL.md +188 -0
  302. package/content/plugins/seo/skills/agileflow-seo/references/cwv-thresholds.md +110 -0
  303. package/content/plugins/seo/skills/agileflow-seo/references/eeat-framework.md +144 -0
  304. package/content/plugins/seo/skills/agileflow-seo/references/keyword-research-guide.md +125 -0
  305. package/content/plugins/seo/skills/agileflow-seo/references/schema-types.md +139 -0
  306. package/content/plugins/seo/skills/agileflow-seo/references/technical-seo-checklist.md +139 -0
  307. package/content/plugins/seo/skills/agileflow-seo/workflows/audit.md +98 -0
  308. package/content/plugins/seo/skills/agileflow-seo/workflows/page.md +118 -0
  309. package/content/plugins/testing/plugin.yaml +16 -0
  310. package/content/plugins/testing/skills/agileflow-test-writer/SKILL.md +260 -0
  311. package/content/plugins/testing/skills/agileflow-test-writer/references/coverage-targets.md +239 -0
  312. package/content/plugins/testing/skills/agileflow-test-writer/references/test-patterns.md +420 -0
  313. package/content/plugins/testing/skills/agileflow-test-writer/workflows/add-coverage.md +154 -0
  314. package/content/plugins/testing/skills/agileflow-test-writer/workflows/write-tests-from-ac.md +225 -0
  315. package/package.json +2 -2
  316. package/src/cli/commands/doctor.js +818 -30
  317. package/src/cli/commands/hook.js +17 -14
  318. package/src/cli/commands/launch.js +1454 -0
  319. package/src/cli/commands/learn.js +149 -0
  320. package/src/cli/commands/plugins.js +113 -0
  321. package/src/cli/commands/setup.js +455 -110
  322. package/src/cli/commands/skills.js +324 -0
  323. package/src/cli/commands/status.js +8 -10
  324. package/src/cli/commands/update.js +76 -15
  325. package/src/cli/index.js +90 -26
  326. package/src/cli/wizard/babysit-mode-picker.js +192 -0
  327. package/src/cli/wizard/behaviors-picker.js +208 -54
  328. package/src/cli/wizard/ide-picker.js +40 -28
  329. package/src/cli/wizard/install-scope-picker.js +57 -0
  330. package/src/cli/wizard/launch-alias-picker.js +50 -0
  331. package/src/cli/wizard/launch-cli-picker.js +129 -0
  332. package/src/cli/wizard/launch-tmux-picker.js +133 -0
  333. package/src/cli/wizard/learnings-picker.js +40 -0
  334. package/src/cli/wizard/plugin-picker.js +47 -16
  335. package/src/lib/brand.js +116 -0
  336. package/src/lib/errors.js +120 -0
  337. package/src/lib/path-check.js +39 -0
  338. package/src/runtime/config/defaults.js +22 -17
  339. package/src/runtime/config/loader.js +77 -8
  340. package/src/runtime/config/schema.json +43 -16
  341. package/src/runtime/config/writer.js +3 -1
  342. package/src/runtime/ide/babysit-skill.js +202 -0
  343. package/src/runtime/ide/capabilities.js +84 -29
  344. package/src/runtime/ide/claude-code-content.js +177 -0
  345. package/src/runtime/ide/claude-code-settings.js +67 -29
  346. package/src/runtime/ide/claude-code-skills.js +47 -32
  347. package/src/runtime/ide/codex-config.js +295 -0
  348. package/src/runtime/installer/install.js +252 -24
  349. package/src/runtime/launch/alias-installer.js +191 -0
  350. package/src/runtime/launch/cli-resume.js +244 -0
  351. package/src/runtime/launch/closed-windows.js +338 -0
  352. package/src/runtime/launch/defaults.js +66 -0
  353. package/src/runtime/launch/detect-clis.js +69 -0
  354. package/src/runtime/launch/doctor.js +464 -0
  355. package/src/runtime/launch/exec-wrapper.js +114 -0
  356. package/src/runtime/launch/parallel-session.js +247 -0
  357. package/src/runtime/launch/prefs.js +211 -0
  358. package/src/runtime/launch/project-prefs.js +234 -0
  359. package/src/runtime/launch/resolve-cli.js +56 -0
  360. package/src/runtime/launch/restore.js +152 -0
  361. package/src/runtime/launch/schema.json +75 -0
  362. package/src/runtime/launch/session-lifecycle.js +313 -0
  363. package/src/runtime/launch/session-registry.js +401 -0
  364. package/src/runtime/launch/spawn.js +103 -0
  365. package/src/runtime/launch/tabs.js +350 -0
  366. package/src/runtime/launch/tmux.js +764 -0
  367. package/src/runtime/launch/worktree.js +260 -0
  368. package/src/runtime/plugins/registry.js +16 -11
  369. package/src/runtime/plugins/validator.js +57 -43
  370. package/src/runtime/skills/learnings.js +308 -0
  371. package/content/plugins/core/hooks/babysit-mentor-injector.js +0 -55
  372. package/src/cli/wizard/personalization.js +0 -64
@@ -0,0 +1,137 @@
1
+ # Audience Targeting Guide
2
+
3
+ **Load this when:** Building audience segments, planning retargeting funnels, or structuring lookalike strategies.
4
+
5
+ ## Funnel-Stage Targeting Framework
6
+
7
+ | Stage | Audience Type | Goal | Typical ROAS |
8
+ | ----- | ------------------------------------ | ------------- | ------------ |
9
+ | TOFU | Cold — Interest/Lookalike | Awareness | 1–2x |
10
+ | MOFU | Warm — Engagement/Video views | Consideration | 2–4x |
11
+ | BOFU | Hot — Site visitors, cart abandoners | Conversion | 4–10x+ |
12
+
13
+ ---
14
+
15
+ ## Lookalike Audiences
16
+
17
+ ### Seed quality hierarchy (best to worst)
18
+
19
+ 1. Purchasers (last 90–180 days)
20
+ 2. High-LTV customers (top 10–20% by spend)
21
+ 3. Qualified leads (completed form / booked call)
22
+ 4. Add-to-cart / checkout-initiated
23
+ 5. All site visitors (lowest signal quality)
24
+
25
+ ### Lookalike size vs. precision tradeoff
26
+
27
+ | Size | Precision | Best for |
28
+ | ----- | ------------------ | ------------------------------- |
29
+ | 1% | Highest similarity | Small budgets, niche products |
30
+ | 2–5% | Balanced | Scale with acceptable CPA drift |
31
+ | 6–10% | Broad reach | Awareness, large budgets |
32
+
33
+ **Rule:** Start at 1–2%. Expand only when 1% audiences show frequency >3 or CPM spikes.
34
+
35
+ ---
36
+
37
+ ## Retargeting Funnel Structure
38
+
39
+ ### Standard 3-layer retargeting stack
40
+
41
+ ```
42
+ Layer 1 — Engaged visitors (1–7 days)
43
+ Segment: Visited key page, >30s session, scrolled 50%+
44
+ Message: Direct offer, urgency, social proof
45
+ Budget: ~40% of retargeting spend
46
+
47
+ Layer 2 — Broader visitors (8–30 days)
48
+ Segment: Any site visit, no conversion
49
+ Message: Benefits reminder, testimonials
50
+ Budget: ~35%
51
+
52
+ Layer 3 — Cold re-engagement (31–90 days)
53
+ Segment: Past visitors gone cold
54
+ Message: New angle, discount/offer, "we missed you"
55
+ Budget: ~25%
56
+ ```
57
+
58
+ ### High-intent signals to create custom audiences from
59
+
60
+ - Visited `/pricing` or `/demo`
61
+ - Watched >50% of product video
62
+ - Opened email 3+ times without clicking
63
+ - Downloaded lead magnet but didn't book
64
+ - Started checkout / signup, did not complete
65
+
66
+ ---
67
+
68
+ ## Exclusion Strategy (critical for efficiency)
69
+
70
+ Always exclude from prospecting:
71
+
72
+ - [ ] Current customers (suppress by email list + pixel)
73
+ - [ ] Active leads in nurture sequence
74
+ - [ ] Recent converters (30-day window minimum)
75
+ - [ ] Employees / internal traffic (IP exclusion)
76
+ - [ ] Low-quality converters (refunds, chargebacks)
77
+
78
+ Always exclude from retargeting:
79
+
80
+ - [ ] Already converted in attribution window
81
+ - [ ] Suppression list (unsubscribes, complaints)
82
+
83
+ ---
84
+
85
+ ## Platform-Specific Audience Notes
86
+
87
+ ### Meta
88
+
89
+ - Minimum seed size for lookalikes: 100 people (1,000+ recommended)
90
+ - Advantage+ audiences: Use when scale matters more than control
91
+ - Broad targeting (no detailed targeting) outperforms interest stacks at $50k+/mo budgets
92
+ - Engagement custom audiences: video views, Instagram interactions, lead form openers
93
+
94
+ ### Google
95
+
96
+ - Customer Match: upload email list for RLSA and lookalikes
97
+ - Similar Segments: auto-generated, less controllable than Meta LAL
98
+ - In-market segments: highest purchase intent in Display/YouTube
99
+ - RLSA bid adjustments: +20–50% for cart abandoners on Search
100
+
101
+ ### LinkedIn
102
+
103
+ - Matched audiences: upload CSV (min 300 matched for activation)
104
+ - Account-based targeting: upload target company list
105
+ - Retargeting: needs LinkedIn Insight Tag on site (24-hour delay)
106
+ - Lookalikes: available but limited — better for awareness than conversion
107
+
108
+ ### TikTok
109
+
110
+ - Value-based lookalikes: feed pixel purchase events (not just add-to-cart)
111
+ - Interest + behavior combinations outperform single-dimension targeting
112
+ - SPARK Ads: allowlist organic posts → boosted as paid (higher trust signal)
113
+
114
+ ---
115
+
116
+ ## Audience Overlap Check
117
+
118
+ Before launching:
119
+
120
+ ```
121
+ Overlap >30% between ad sets = audience cannibalization risk
122
+ Fix: Merge ad sets OR add mutual exclusions
123
+ Tool: Meta Audience Overlap tool, Google Audience Manager
124
+ ```
125
+
126
+ ---
127
+
128
+ ## Frequency Caps by Stage
129
+
130
+ | Stage | Recommended cap |
131
+ | -------------------- | ------------------------------ |
132
+ | Awareness (cold) | 1–2/week |
133
+ | Consideration (warm) | 3–5/week |
134
+ | Retargeting (hot) | 5–7/week, then rotate creative |
135
+ | Re-engagement | 2–3/week max |
136
+
137
+ **Fatigue signal:** CTR drops >20% week-over-week with stable CPM → creative rotation needed, not audience expansion.
@@ -0,0 +1,115 @@
1
+ # Bid Strategy Guide
2
+
3
+ **Load this when:** recommending or diagnosing bidding strategies across platforms.
4
+
5
+ ## Google Ads bid strategies
6
+
7
+ ### Decision tree
8
+
9
+ ```
10
+ Do you have conversion tracking?
11
+ ├── NO → Manual CPC or Maximize Clicks (gather data first)
12
+ └── YES → How many conversions/month?
13
+ ├── <30/month → Manual CPC with ECPC, or Target Impression Share for brand
14
+ ├── 30–50/month → Target CPA (borderline — watch learning phase)
15
+ └── 50+/month → Smart Bidding (tCPA, tROAS, or Maximize Conversions)
16
+ ```
17
+
18
+ ### Smart Bidding strategies
19
+
20
+ | Strategy | Use when | Avoid when |
21
+ | ----------------------------- | ---------------------------------------------- | ---------------------------------------------------- |
22
+ | **Maximize Conversions** | New campaigns, want volume, no CPA target yet | CPA matters — it'll spend to budget regardless |
23
+ | **Target CPA** | Know your target CPA, 50+ monthly conversions | <30 conversions/month — insufficient signal |
24
+ | **Target ROAS** | Ecommerce with revenue values, 50+ conversions | Revenue values not tracked accurately |
25
+ | **Maximize Conversion Value** | Want revenue volume, have revenue tracking | CPA efficiency matters more than raw revenue |
26
+ | **Target Impression Share** | Brand campaigns, competitor conquest | Performance campaigns — wastes budget on impressions |
27
+ | **Enhanced CPC** | Manual bidding with slight automation | You have enough conversions for full smart bidding |
28
+
29
+ ### Learning phase rules
30
+
31
+ - Learning phase: ~1–2 weeks after any significant change
32
+ - Need 50+ conversions in learning phase to exit cleanly
33
+ - **Never** make major changes (bid, budget, targeting) during learning phase
34
+ - Budget changes >20% restart learning phase
35
+ - Audience changes restart learning phase
36
+
37
+ ### Broad Match + Smart Bidding rule
38
+
39
+ **Never use Broad Match without Smart Bidding.** Broad Match without tCPA/tROAS
40
+ has no guardrails — it will find irrelevant traffic and waste budget.
41
+
42
+ Broad Match + tCPA or tROAS = safe. Google's algorithm self-corrects.
43
+ Broad Match + Manual CPC = guaranteed waste.
44
+
45
+ ## Meta bid strategies
46
+
47
+ | Strategy | Use when |
48
+ | ---------------------------- | ------------------------------------------------------------------- |
49
+ | **Highest Volume** (default) | Learning phase, new campaigns, maximizing results within budget |
50
+ | **Cost per Result Goal** | You have a CPA target and enough historical data (100+ conversions) |
51
+ | **ROAS Goal** | Ecommerce with revenue tracking, 100+ purchase events |
52
+ | **Bid Cap** | Strict CPA control needed, willing to sacrifice volume |
53
+
54
+ ### Meta learning phase
55
+
56
+ - Needs 50 optimization events per ad set per week to exit learning
57
+ - Consolidate ad sets — too many competing for the same audience fragments data
58
+ - Avoid editing during learning: budget, bid, creative, audience changes restart it
59
+
60
+ ### Advantage+ Shopping (ASC) — when to use
61
+
62
+ Use when:
63
+
64
+ - Ecommerce with 100+ monthly purchases
65
+ - You've maxed out manual campaigns
66
+ - Want to test broad creative with algorithm-driven targeting
67
+
68
+ Avoid when:
69
+
70
+ - Brand safety is critical (less control)
71
+ - Niche B2B audience (algorithm needs volume to work)
72
+
73
+ ## LinkedIn bid strategies
74
+
75
+ | Strategy | Use when |
76
+ | -------------------- | ---------------------------------------------- |
77
+ | **Maximum Delivery** | New campaigns, awareness, learning phase |
78
+ | **Target Cost** | Stable campaigns with established CPL baseline |
79
+ | **Manual Bidding** | Specific placement control needed |
80
+
81
+ LinkedIn's CPCs are high by default. Start with Maximum Delivery and
82
+ optimize creatives before touching bids.
83
+
84
+ ## Cross-platform budget allocation
85
+
86
+ ### Starting allocation for a new account
87
+
88
+ ```
89
+ Total budget = $X/month
90
+
91
+ If testing (first 30 days):
92
+ Google Search: 50% — highest intent
93
+ Meta: 30% — retargeting + lookalikes
94
+ Reserve: 20% — keep for winning channels
95
+
96
+ After 60 days with data:
97
+ Double down on channels hitting target CPA
98
+ Cut channels at 2x target CPA with no improvement
99
+ ```
100
+
101
+ ### Budget change rules
102
+
103
+ - Never increase budget >20% per week (learning phase)
104
+ - To scale fast: duplicate campaign, set new budget on duplicate
105
+ - Seasonal increases: plan 2 weeks ahead (learning phase needs time)
106
+
107
+ ## Warning signs in bidding
108
+
109
+ | Signal | Likely cause | Fix |
110
+ | ------------------------------- | -------------------------- | ------------------------------- |
111
+ | CPA suddenly doubles | Learning phase reset | Wait 2 weeks, don't touch |
112
+ | Spend stops before daily budget | Bids too low for auction | Raise bid or switch to Maximize |
113
+ | High spend, zero conversions | Tracking broken | Fix tracking before optimizing |
114
+ | High CTR, low conversion rate | Landing page mismatch | Fix LP, not the ads |
115
+ | Low CTR, high CVR | Good intent, poor creative | Improve ad copy |
@@ -0,0 +1,100 @@
1
+ # Ad Platform Benchmarks Reference
2
+
3
+ **Load this when:** interpreting campaign performance, diagnosing underperformance,
4
+ or setting realistic KPI targets. All figures are industry averages — actual
5
+ benchmarks vary significantly by industry, funnel stage, and audience quality.
6
+
7
+ ## Google Ads benchmarks (search)
8
+
9
+ | Metric | Poor | Average | Good | Great |
10
+ | ------------------------------- | ---- | ------- | ----- | ----- |
11
+ | CTR | <2% | 3–5% | 6–9% | 10%+ |
12
+ | Conversion rate | <2% | 3–5% | 6–10% | 11%+ |
13
+ | Quality Score | 1–3 | 4–6 | 7–8 | 9–10 |
14
+ | CPC (varies widely by industry) | — | $1–$4 | — | — |
15
+
16
+ **High-cost industries (CPC $15–$50+):** legal, insurance, finance, medical
17
+ **Low-cost industries (CPC $0.50–$2):** ecommerce, apparel, B2C
18
+
19
+ ### Google Ads quality score impact on CPC
20
+
21
+ | Quality Score | CPC adjustment |
22
+ | ------------- | -------------- |
23
+ | 10 | -50% |
24
+ | 7 (baseline) | 0% |
25
+ | 4 | +25% |
26
+ | 1 | +400% |
27
+
28
+ ## Meta / Facebook Ads benchmarks
29
+
30
+ | Metric | Poor | Average | Good | Great |
31
+ | ----------------------------------- | ----- | -------- | ---- | ----- |
32
+ | CTR (link) | <0.5% | 0.9–1.5% | 2–3% | 4%+ |
33
+ | CPM | $20+ | $8–15 | $5–8 | <$5 |
34
+ | Frequency (before creative fatigue) | >5 | 3–5 | 2–3 | — |
35
+ | ROAS (ecommerce) | <2x | 2–3x | 3–5x | 5x+ |
36
+
37
+ **Creative fatigue signal:** CTR drops >30% from week 1 to week 3 = refresh creative.
38
+
39
+ ### Meta campaign objective CPR benchmarks
40
+
41
+ | Objective | Average CPR |
42
+ | ---------------------- | ----------- |
43
+ | Lead generation | $10–30 |
44
+ | Purchase (ecommerce) | $15–60 |
45
+ | App install | $1–5 |
46
+ | Video views (ThruPlay) | $0.01–0.05 |
47
+
48
+ ## LinkedIn Ads benchmarks
49
+
50
+ | Metric | Poor | Average | Good |
51
+ | ---------------------- | ----- | -------- | ----- |
52
+ | CTR | <0.3% | 0.4–0.6% | 0.7%+ |
53
+ | CPL | >$200 | $80–150 | <$80 |
54
+ | Conversion rate (form) | <5% | 8–12% | 15%+ |
55
+
56
+ LinkedIn CPCs are high ($6–15) but audience quality is unmatched for B2B.
57
+ Only use if ACV > $5K or LTV justifies high CPL.
58
+
59
+ ## TikTok Ads benchmarks
60
+
61
+ | Metric | Poor | Average | Good |
62
+ | ------------------ | ---------- | ------------- | ------------------ |
63
+ | CTR | <0.5% | 1–2% | 3%+ |
64
+ | CPM | $15+ | $8–12 | <$8 |
65
+ | VTR (video to end) | <15% | 25–35% | 40%+ |
66
+ | CPA | >3x target | 1.5–2x target | At or below target |
67
+
68
+ TikTok rewards authenticity. UGC-style ads outperform polished creative 3:1.
69
+
70
+ ## Microsoft / Bing Ads benchmarks
71
+
72
+ | Metric | Comparison to Google |
73
+ | --------------- | ----------------------------------------------- |
74
+ | CPC | 30–60% lower |
75
+ | CTR | Similar to Google (same intent-based) |
76
+ | Conversion rate | Often higher (older, higher-income demographic) |
77
+ | Volume | ~20–30% of Google volume |
78
+
79
+ Microsoft is often ignored but delivers strong ROI, especially for B2B and
80
+ older demographics. Import campaigns from Google as baseline.
81
+
82
+ ## ROAS targets by business model
83
+
84
+ | Model | Break-even ROAS | Target ROAS |
85
+ | ------------------------------------ | --------------- | ----------- |
86
+ | Ecommerce (30% margin) | 3.3x | 4–6x |
87
+ | Ecommerce (50% margin) | 2.0x | 3–5x |
88
+ | SaaS (monthly subscription) | LTV/CAC > 3 | LTV/CAC > 5 |
89
+ | Lead gen (close rate 20%, $500 deal) | CPL < $100 | CPL < $60 |
90
+
91
+ ## The 3x kill rule
92
+
93
+ **Pause any campaign where CPA > 3x your target for 2+ consecutive weeks.**
94
+ Don't optimize — pause. Optimizing a fundamentally broken campaign wastes time.
95
+
96
+ Exceptions:
97
+
98
+ - Campaign is still in learning phase (<50 conversions)
99
+ - You just changed creative/copy (give 2 weeks to stabilize)
100
+ - Seasonal campaign with known off-peak periods
@@ -0,0 +1,118 @@
1
+ # Audit Workflow — Paid Advertising Account Audit
2
+
3
+ **Triggers:** "audit my ads", "run an ads audit", "review my Google Ads", "check my Meta campaigns", "ads health score", "what's wrong with my advertising"
4
+
5
+ **Goal:** Deploy 6 specialized advertising analyzers in parallel against the user's account data, synthesize results into a weighted Ads Health Score (0–100), and produce a prioritized action plan with specific, dollar-impact estimates where possible.
6
+
7
+ ## Inputs needed
8
+
9
+ | Input | Required | How to get it |
10
+ | ---------------------- | -------- | ---------------------------------------------------------- |
11
+ | account data | Yes | CSV export, pasted table, or described setup |
12
+ | platform(s) | No | Auto-detect from data, or already captured in opening flow |
13
+ | industry + KPI targets | No | Ask conversationally — changes benchmarks significantly |
14
+
15
+ ## Steps
16
+
17
+ 1. **If account data is not provided**, ask specifically — don't make them guess what format to use:
18
+
19
+ ```xml
20
+ <invoke name="AskUserQuestion">
21
+ <parameter name="questions">[{
22
+ "question": "To audit your account, I need your campaign data. What's easiest?",
23
+ "header": "Account data",
24
+ "multiSelect": false,
25
+ "options": [
26
+ {"label": "Paste a CSV export (Recommended)", "description": "Google Ads: Campaigns tab → Download. Meta: Ads Manager → Columns → Export. Even a partial export works."},
27
+ {"label": "Paste the performance table from your dashboard", "description": "Copy/paste the text from your campaigns view — I'll parse it"},
28
+ {"label": "Describe your setup", "description": "Tell me: platforms, monthly spend, ROAS/CPA, campaign types, and main goals"},
29
+ {"label": "I have a file — share the path", "description": "Point me to an exported CSV and I'll read it directly"}
30
+ ]
31
+ }]</parameter>
32
+ </invoke>
33
+ ```
34
+
35
+ 2. **Gather context** — ask conversationally before running analyzers:
36
+ - Industry / vertical (e-commerce, SaaS, local services, lead gen, B2B?)
37
+ - Monthly ad spend range
38
+ - Primary KPI: ROAS target, CPA target, or lead volume goal?
39
+ - How long have these campaigns been running?
40
+
41
+ These change benchmarks significantly. A 3x ROAS for e-commerce is average; for SaaS it's strong. Skip if already captured in the opening flow.
42
+
43
+ 3. **Detect active platforms** from the data. If the user specified platforms in the opening flow, use those.
44
+
45
+ 4. **Deploy all 6 analyzers simultaneously** — no need to ask for depth, run quick by default:
46
+ - **Google analyzer** — campaign structure, keyword strategy, quality scores, ad copy, wasted spend (74 checks)
47
+ - **Meta analyzer** — audience targeting, creative fatigue, objectives, pixel/CAPI setup (46 checks)
48
+ - **Budget analyzer** — spend distribution, scaling rules, bid strategy efficiency (24 checks)
49
+ - **Creative analyzer** — copy quality, CTR patterns, creative fatigue, A/B test coverage
50
+ - **Tracking analyzer** — pixel/tag setup, conversion tracking accuracy, attribution model
51
+ - **Compliance analyzer** — policy violations, restricted content, account health flags
52
+
53
+ 5. **Apply quality gates automatically:**
54
+ - Flag if tracking is broken — optimization recommendations are unreliable without it
55
+ - Apply 3x Kill Rule: campaigns with CPA > 3x target for 2+ weeks → flag for pause
56
+ - Flag Broad Match keywords without Smart Bidding
57
+ - Flag recent changes that may have reset learning phase
58
+
59
+ 6. **Weighted scoring:** Tracking 25%, Wasted Spend 20%, Structure 15%, Creative 15%, Budget 15%, Compliance 10%.
60
+
61
+ 7. **Present the Ads Health Score (0–100):**
62
+
63
+ ```
64
+ Ads Health Score: 61/100 — needs work
65
+
66
+ Category Score Top Issue
67
+ Tracking 45 Google conversion tag missing on /checkout
68
+ Wasted Spend 52 4 campaigns at 4-6x target CPA — $3,200/mo estimated waste
69
+ Structure 74 7 ad groups with single ads — no rotation testing
70
+ Creative 68 Meta creative sets showing 90%+ impression share (fatigue)
71
+ Budget 71 3 campaigns in learning phase — avoid budget changes
72
+ Compliance 90 —
73
+ ```
74
+
75
+ 8. **Prioritized action plan:**
76
+ - **P0** (immediate blockers): Broken tracking, policy violations, campaigns burning budget with zero conversions
77
+ - **P1** (high ROI quick wins): Kill Rule candidates, wasted spend, broken attribution
78
+ - **P2** (structural improvements): Campaign organization, bidding strategy, audience targeting
79
+ - **P3** (creative and testing): Copy refresh, A/B test setup, creative rotation
80
+
81
+ 9. **Guide next step with AskUserQuestion** — specific to actual findings:
82
+
83
+ ```xml
84
+ <invoke name="AskUserQuestion">
85
+ <parameter name="questions">[{
86
+ "question": "Ads Health Score: {X}/100. {p0_count} immediate blockers, {p1_count} high-ROI quick wins. Biggest issue: {top_finding}.",
87
+ "header": "What to fix first",
88
+ "multiSelect": false,
89
+ "options": [
90
+ {"label": "Fix {top_p0_issue} now (Recommended)", "description": "{specific fix — e.g., 'Add Google conversion tag to /checkout — without this, all ROAS data is wrong'}"},
91
+ {"label": "Pause {n} campaigns failing the 3x Kill Rule", "description": "{specific campaigns} spending {estimated_waste}/mo with {n} conversions — cut waste before optimizing"},
92
+ {"label": "Deep-dive into {lowest_category} ({score}/100)", "description": "Worst area — I'll walk through every finding with specific fixes"},
93
+ {"label": "Generate fresh ad copy to test against current", "description": "40+ headline/body/CTA variants for your top campaigns — use existing copy as the baseline"}
94
+ ]
95
+ }]</parameter>
96
+ </invoke>
97
+ ```
98
+
99
+ Customize every option. Don't show kill rule option if no campaigns qualify. Don't show copy generation if they just came from the generate workflow.
100
+
101
+ ## Output
102
+
103
+ Ads Health Score (0–100) with weighted category scores. Prioritized action plan (P0–P3). Platform-specific findings. Estimated wasted spend where calculable. Baseline for future audits.
104
+
105
+ ## Fallbacks
106
+
107
+ **If AskUserQuestion is unavailable:**
108
+ Present options as a numbered list. Example:
109
+
110
+ ```
111
+ What would you like to tackle first?
112
+ 1. Fix the P0 issues now
113
+ 2. Pause the Kill Rule campaigns
114
+ 3. Deep-dive into the worst category
115
+ ```
116
+
117
+ **If agent spawning is unavailable:**
118
+ Run each analysis inline sequentially using the reference files in `references/`. Consolidate into the same output format — same result, just slower.
@@ -0,0 +1,84 @@
1
+ # Generate Workflow — Bulk Ad Copy Generation
2
+
3
+ **Triggers:** "generate ad copy", "write ads for my product", "create headline variants", "I need 40 ad variations", "bulk ad copy for Meta", "generate Google Ads headlines"
4
+
5
+ **Goal:** Produce 40+ headline, body, and CTA variants from a product description and ICP angles, formatted for direct platform upload (Meta bulk CSV, Google Ads Editor format).
6
+
7
+ ## Inputs needed
8
+
9
+ | Input | Required | How to get it |
10
+ | ------------------- | -------- | ------------------------------------------------------------------- |
11
+ | product description | Yes | Ask for it if not provided |
12
+ | target platform | No | Already captured in opening flow — use that. Ask only if not known. |
13
+ | variant count | No | Default: 40. Ask only if they want a different number. |
14
+ | ICP angles | No | Auto-detect 5 from product description, then confirm |
15
+
16
+ ## Steps
17
+
18
+ 1. **If product description is not provided**, ask: _"What are you advertising? Paste your product description, landing page URL, or existing ad copy — I'll work from any of those."_ Accept any format.
19
+
20
+ 2. **Don't re-ask about platform** if already captured in the opening flow. Use what you know. Only ask if platform is genuinely unknown:
21
+
22
+ _"Which platform should I optimize the format for? (or I can generate for all)"_
23
+
24
+ 3. **Auto-detect 5 ICP angles** from the product description. Common angles:
25
+ - Pain-point-led: leads with the problem they're experiencing
26
+ - Outcome-focused: leads with the transformation or result
27
+ - Social-proof: authority, users, case studies
28
+ - Urgency/FOMO: time limit, scarcity, risk of inaction
29
+ - Feature-differentiated: specific capability competitors don't have
30
+
31
+ Show the angles and ask: _"I detected these 5 angles: [list]. Any you want to add or swap out?"_ Keep it conversational — if they say "looks good", move on immediately.
32
+
33
+ 4. **Generate variants for each angle × each format:**
34
+
35
+ **Headlines:**
36
+ - Google: max 30 characters — problem-aware, solution-aware, benefit-led variants
37
+ - Meta: up to 40 characters — hook-first, curiosity-driven variants
38
+ - LinkedIn: professional tone, outcome-focused
39
+
40
+ **Body copy:**
41
+ - Short (1–2 sentences): matches headline angle, drives to CTA
42
+ - Long (3–4 sentences): expands on the angle with a proof point
43
+
44
+ **CTAs** (6–8 variants): action-oriented, urgency, curiosity — varied by platform norms
45
+
46
+ 5. **Show the variants** as structured markdown organized by angle and format, with counts. Make them scannable — the user needs to read and react quickly.
47
+
48
+ 6. **Generate platform-ready export files:**
49
+ - **Meta bulk upload CSV**: Campaign / Ad Set / Ad columns with all variants
50
+ - **Google Ads Editor format**: Campaign / Ad Group / Headline1–15 / Description1–4
51
+
52
+ 7. **Guide next step with AskUserQuestion** — specific to what was generated:
53
+
54
+ ```xml
55
+ <invoke name="AskUserQuestion">
56
+ <parameter name="questions">[{
57
+ "question": "{N} variants generated across {angle_count} ICP angles. Top recommended variants to test first: {top_3_variants}.",
58
+ "header": "What's next",
59
+ "multiSelect": false,
60
+ "options": [
61
+ {"label": "Save the platform CSV and wrap up (Recommended)", "description": "Export is ready — {platform} format with all {N} variants"},
62
+ {"label": "Regenerate the {weakest_angle} angle", "description": "That angle produced the weakest variants — I'll try different formulas"},
63
+ {"label": "Create A/B test pairs from the top 5 variants", "description": "Pair your strongest variants for head-to-head testing — one variable changed per pair"},
64
+ {"label": "Audit existing campaigns before launching these", "description": "Make sure tracking is working before investing in new copy — /agileflow:ads:track"}
65
+ ]
66
+ }]</parameter>
67
+ </invoke>
68
+ ```
69
+
70
+ ## Output
71
+
72
+ Structured markdown with all variants organized by angle and format. Platform-ready CSV file(s). Total variant count. Recommended top 5 variants to test first based on formula strength.
73
+
74
+ ## Fallbacks
75
+
76
+ **If AskUserQuestion is unavailable:**
77
+ Present options as a numbered list. Example:
78
+
79
+ ```
80
+ What would you like to do next?
81
+ 1. Save the CSV and wrap up
82
+ 2. Regenerate a specific angle
83
+ 3. Create A/B test pairs
84
+ ```