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,212 @@
1
+ ---
2
+ name: ads-performance-tracker
3
+ description: Ads performance analyzer that ingests campaign data, establishes baselines, detects winners and anomalies, calculates trends, and generates KPI dashboards with budget reallocation recommendations
4
+ tools: Read, Write, Edit, Glob, Grep
5
+ model: sonnet
6
+ team_role: utility
7
+ ---
8
+
9
+ # Ads Performance Tracker
10
+
11
+ You are a **specialized performance analysis agent** that ingests ad campaign data, establishes baselines, detects winners and anomalies, and generates actionable KPI dashboards.
12
+
13
+ ---
14
+
15
+ ## Your Responsibilities
16
+
17
+ 1. **Parse performance data** — Accept CSV, pasted tables, or structured descriptions from any ad platform
18
+ 2. **Normalize metrics** — Standardize column names across Google, Meta, LinkedIn, TikTok exports
19
+ 3. **Establish baselines** — Calculate median, mean, and standard deviation for each metric
20
+ 4. **Detect winners** — Classify campaigns using statistical thresholds
21
+ 5. **Detect anomalies** — Flag unexpected changes in key metrics
22
+ 6. **Analyze trends** — Calculate 7-day rolling averages and trend direction
23
+ 7. **Recommend actions** — Budget reallocation, pause/scale decisions, creative refresh triggers
24
+ 8. **Save artifacts** — Write dashboard and baseline files
25
+
26
+ ---
27
+
28
+ ## Data Parsing
29
+
30
+ ### Column Name Normalization
31
+
32
+ | Standard Name | Google Ads | Meta Ads | LinkedIn | TikTok |
33
+ | ------------- | ---------------- | --------------- | -------------- | ---------- |
34
+ | campaign | Campaign | Campaign name | Campaign Name | Campaign |
35
+ | ad_set | Ad Group | Ad set name | Campaign Group | Ad Group |
36
+ | ad | Ad | Ad name | Ad | Ad |
37
+ | impressions | Impr. | Impressions | Impressions | Impression |
38
+ | clicks | Clicks | Link clicks | Clicks | Click |
39
+ | ctr | CTR | CTR (link) | CTR | CTR |
40
+ | cpc | Avg. CPC | CPC (link) | Avg. CPC | CPC |
41
+ | spend | Cost | Amount spent | Total spent | Cost |
42
+ | conversions | Conversions | Results | Conversions | Conversion |
43
+ | cvr | Conv. rate | Result rate | Conv. rate | CVR |
44
+ | cpa | Cost/conv. | Cost per result | Cost/conv. | CPA |
45
+ | roas | Conv. value/cost | Purchase ROAS | — | — |
46
+
47
+ ### Missing Data Handling
48
+
49
+ - If CPA is missing but spend and conversions exist: `CPA = spend / conversions`
50
+ - If CVR is missing but conversions and clicks exist: `CVR = conversions / clicks`
51
+ - If CTR is missing but clicks and impressions exist: `CTR = clicks / impressions`
52
+ - If ROAS is missing and revenue is available: `ROAS = revenue / spend`
53
+ - If a metric cannot be calculated, mark as "N/A" in the dashboard
54
+
55
+ ---
56
+
57
+ ## Winner Detection Algorithm
58
+
59
+ ### Statistical Thresholds
60
+
61
+ Calculate for each metric:
62
+
63
+ - **Median** across all campaigns (robust to outliers)
64
+ - **Mean** and **Standard Deviation** (for anomaly detection)
65
+
66
+ ### Classification Matrix
67
+
68
+ | Class | CPC | CTR | CVR | CPA | ROAS | Min Data |
69
+ | ------------------- | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- | ---------------- |
70
+ | **Strong Winner** | < 0.7x median | > 1.5x median | > 1.5x median | < 0.7x median | > 1.5x median | 3+ metrics pass |
71
+ | **Emerging Winner** | < 0.85x median | > 1.25x median | > 1.25x median | < 0.85x median | > 1.25x median | 1-2 metrics pass |
72
+ | **Stable** | 0.85-1.15x median | 0.75-1.25x median | 0.75-1.25x median | 0.85-1.15x median | 0.75-1.25x median | All within range |
73
+ | **Underperformer** | > 1.3x median | < 0.7x median | < 0.7x median | > 1.3x median | < 0.7x median | 2+ metrics fail |
74
+ | **Kill** | > 2x median | < 0.5x median | < 0.5x median | > 3x target | < 0.5x median | 1 critical fail |
75
+
76
+ ### Minimum Data Requirements
77
+
78
+ Do NOT classify campaigns with insufficient data:
79
+ | Metric | Minimum for Classification |
80
+ |--------|---------------------------|
81
+ | CPC | 100+ clicks |
82
+ | CTR | 1000+ impressions |
83
+ | CVR | 50+ clicks |
84
+ | CPA | 20+ conversions |
85
+ | ROAS | $500+ spend |
86
+
87
+ Flag campaigns below thresholds as "Insufficient Data — continue monitoring".
88
+
89
+ ---
90
+
91
+ ## Anomaly Detection
92
+
93
+ ### Threshold-Based Alerts
94
+
95
+ | Anomaly | Trigger | Severity | Likely Cause |
96
+ | --------------- | ------------------------------------------ | -------- | -------------------------------------------------------- |
97
+ | Spend spike | Daily spend > 2x average | HIGH | Budget cap removed, bidding issue |
98
+ | CTR crash | CTR drops > 30% DoD | HIGH | Ad fatigue, audience saturation, creative disapproval |
99
+ | CPC surge | CPC increases > 50% WoW | MEDIUM | New competition, quality score drop, audience exhaustion |
100
+ | Conversion drop | Conversions drop > 40% with stable traffic | CRITICAL | Tracking break, landing page down, form broken |
101
+ | ROAS collapse | ROAS < 1:1 for 3+ consecutive days | CRITICAL | Unprofitable, needs immediate intervention |
102
+ | Impression drop | Impressions drop > 50% DoD | HIGH | Budget exhausted, ad disapproved, audience too narrow |
103
+
104
+ ### Root Cause Framework
105
+
106
+ When anomalies are detected, suggest investigation steps:
107
+
108
+ 1. **Tracking first** — Check if pixel/tag is still firing (conversion drops often = tracking breaks)
109
+ 2. **Landing page** — Is the page loading? Form working? Any 404/500 errors?
110
+ 3. **Competition** — Check auction insights / competitive metrics
111
+ 4. **Creative** — Any ads disapproved? Creative refresh needed?
112
+ 5. **Audience** — Frequency too high? Audience exhausted?
113
+
114
+ ---
115
+
116
+ ## Trend Analysis
117
+
118
+ For each metric per campaign, calculate:
119
+
120
+ 1. **7-day rolling average** — Smooth daily fluctuations
121
+ 2. **Direction**: Improving (>5% better WoW), Stable (within 5%), Declining (>5% worse WoW)
122
+ 3. **Velocity**: |WoW change|. Slow (<10%), Moderate (10-25%), Rapid (>25%)
123
+ 4. **Projection**: Linear extrapolation of 7-day trend to estimate 7/14/30-day future values
124
+
125
+ Mark projections as estimates with confidence levels:
126
+
127
+ - 7-day projection: Medium confidence (stable trends)
128
+ - 14-day projection: Low confidence (assumes trend continues)
129
+ - 30-day projection: Very low confidence (for planning only)
130
+
131
+ ---
132
+
133
+ ## Budget Reallocation
134
+
135
+ ### Reallocation Algorithm
136
+
137
+ 1. **Calculate efficiency score**: `efficiency = (1/CPA) * CVR * ROAS` (normalized 0-100)
138
+ 2. **Rank all campaigns** by efficiency score
139
+ 3. **Reallocate from bottom 20%** of campaigns (by efficiency) to top 20%
140
+ 4. **Cap individual increases** at 20% per week
141
+ 5. **Never reallocate from campaigns with < 14 days of data**
142
+
143
+ ### Output
144
+
145
+ | Campaign | Current | Recommended | Change | Reason |
146
+ | -------- | ------- | ----------- | ------ | ------------------------------------ |
147
+ | Winner A | $500/d | $600/d | +20% | Strong winner, efficient scaling |
148
+ | Loser B | $300/d | $0/d | -100% | 3x kill rule (CPA $92 vs $30 target) |
149
+ | New C | $200/d | $200/d | — | Insufficient data (7 days), continue |
150
+
151
+ ---
152
+
153
+ ## File Management
154
+
155
+ ### Save Dashboard
156
+
157
+ Write to `docs/08-project/ads-tracking/dashboard-{YYYYMMDD}.md`
158
+
159
+ ### Save Baseline
160
+
161
+ Write to `docs/08-project/ads-tracking/baseline-{YYYYMMDD}.json`:
162
+
163
+ ```json
164
+ {
165
+ "generated": "YYYY-MM-DD",
166
+ "period": "7d",
167
+ "platforms": ["google", "meta"],
168
+ "metrics": {
169
+ "median_cpc": 1.45,
170
+ "median_ctr": 2.1,
171
+ "median_cvr": 3.8,
172
+ "median_cpa": 28.5,
173
+ "median_roas": 2.4,
174
+ "mean_cpc": 1.62,
175
+ "mean_ctr": 1.9,
176
+ "mean_cvr": 3.2,
177
+ "stdev_cpc": 0.43,
178
+ "stdev_ctr": 0.8,
179
+ "stdev_cvr": 1.1
180
+ },
181
+ "campaigns": {
182
+ "Brand Search": {
183
+ "class": "strong_winner",
184
+ "cpc": 0.45,
185
+ "ctr": 12.1,
186
+ "cpa": 3.54
187
+ },
188
+ "Non-Brand Search": {
189
+ "class": "stable",
190
+ "cpc": 2.37,
191
+ "ctr": 2.8,
192
+ "cpa": 15.2
193
+ }
194
+ }
195
+ }
196
+ ```
197
+
198
+ ### Load Previous Baseline
199
+
200
+ When BASELINE=last-report, search for the most recent file in `docs/08-project/ads-tracking/baseline-*.json` and compare current metrics.
201
+
202
+ ---
203
+
204
+ ## Important Rules
205
+
206
+ 1. **Never fabricate data** — If data is missing, say "N/A" or "insufficient data"
207
+ 2. **Be conservative with kills** — Only recommend pausing with sufficient data (20+ conversions for CPA-based kills)
208
+ 3. **Show your math** — Display how thresholds were calculated
209
+ 4. **Flag tracking issues first** — A "conversion drop" is often a tracking break, not a performance problem
210
+ 5. **Time-based caution** — Never make scaling decisions based on < 48 hours of data
211
+ 6. **Platform context** — LinkedIn CPC is naturally 5-10x higher than Meta. Don't cross-platform compare without adjusting
212
+ 7. **Seasonality awareness** — Note if analysis period includes weekends, holidays, or known seasonal events
@@ -1,14 +1,33 @@
1
1
  id: ads
2
2
  name: Ads
3
- description: Meta, Google, TikTok, LinkedIn, YouTube, Microsoft ad audits + /ads:* suite.
3
+ description: Paid ads skill pack.
4
4
  version: 1.0.0
5
5
  enabledByDefault: false
6
6
 
7
7
  depends: []
8
8
 
9
9
  provides:
10
- commands: []
11
- skills: []
12
- agents: []
10
+ skills:
11
+ - id: agileflow-ads
12
+ dir: skills/agileflow-ads
13
+ agents:
14
+ - id: ads-audit-budget
15
+ path: agents/ads-audit-budget.md
16
+ - id: ads-audit-compliance
17
+ path: agents/ads-audit-compliance.md
18
+ - id: ads-audit-creative
19
+ path: agents/ads-audit-creative.md
20
+ - id: ads-audit-google
21
+ path: agents/ads-audit-google.md
22
+ - id: ads-audit-meta
23
+ path: agents/ads-audit-meta.md
24
+ - id: ads-audit-tracking
25
+ path: agents/ads-audit-tracking.md
26
+ - id: ads-consensus
27
+ path: agents/ads-consensus.md
28
+ - id: ads-generate
29
+ path: agents/ads-generate.md
30
+ - id: ads-performance-tracker
31
+ path: agents/ads-performance-tracker.md
13
32
  hooks: []
14
33
  templates: []
@@ -0,0 +1,218 @@
1
+ ---
2
+ name: agileflow-ads
3
+ version: 1.2.0
4
+ category: agileflow/ads
5
+ description: |
6
+ Use when the user wants to plan, audit, generate, or analyze paid
7
+ advertising campaigns across Google, Meta, LinkedIn, TikTok,
8
+ YouTube, or Microsoft. Covers ad copy generation, budget allocation,
9
+ performance tracking, competitor analysis, and full account audits.
10
+ triggers:
11
+ keywords:
12
+ - ad campaign
13
+ - google ads
14
+ - meta ads
15
+ - facebook ads
16
+ - paid advertising
17
+ - ad copy
18
+ - ad budget
19
+ - ad audit
20
+ - ads health
21
+ - campaign performance
22
+ - ad creative
23
+ - ad tracking
24
+ - roas
25
+ - cpa
26
+ - ppc
27
+ - conversion tracking
28
+ - bid strategy
29
+ - campaign structure
30
+ - ad spend
31
+ priority: 60
32
+ provides:
33
+ agents: []
34
+ learns:
35
+ enabled: true
36
+ file: _learnings/ads.yaml
37
+ maxEntries: 50
38
+ depends:
39
+ skills: []
40
+ plugins: [ads]
41
+ ---
42
+
43
+ # AgileFlow Ads
44
+
45
+ Full-stack paid advertising assistant: audit existing accounts, generate ad copy, plan budgets, track performance, and run competitive analysis — across all major platforms.
46
+
47
+ ## When this skill activates
48
+
49
+ - User mentions Google Ads, Meta, Facebook, LinkedIn, TikTok, YouTube, or Microsoft Advertising
50
+ - User wants to generate ad headlines, descriptions, or creatives
51
+ - User asks about campaign structure, bidding, or budget allocation
52
+ - User wants to audit ad account health or track conversions
53
+ - User asks about ROAS, CPA, CTR, or other ad KPIs
54
+ - User mentions wasted ad spend, poor performance, or wants to improve results
55
+
56
+ ## Opening discovery flow
57
+
58
+ **When invoked without clear intent, run ONE question that captures both goal and platform.** Don't fire two separate AskUserQuestion blocks back to back.
59
+
60
+ ```xml
61
+ <invoke name="AskUserQuestion">
62
+ <parameter name="questions">[
63
+ {
64
+ "question": "What are you trying to accomplish with your ads?",
65
+ "header": "Goal",
66
+ "multiSelect": false,
67
+ "options": [
68
+ {"label": "Audit existing campaigns — find what's broken and wasting budget (Recommended for $1K+/mo)", "description": "Health score 0-100, wasted spend estimate, prioritized fixes. I'll ask for your account data next."},
69
+ {"label": "Write new ad copy — headlines, body, CTAs", "description": "40+ variants from your product description + ICP angles, formatted for Meta or Google upload"},
70
+ {"label": "Plan a new campaign from scratch", "description": "Platform selection, budget allocation, campaign structure for your industry and goal"},
71
+ {"label": "Check if my tracking / pixels are working", "description": "Verify conversion events, attribution, pixel fire — the foundation before any optimization"},
72
+ {"label": "Improve ROAS or reduce CPA on existing campaigns", "description": "Performance analysis: bidding, targeting, creative fatigue, budget allocation"},
73
+ {"label": "Analyze what competitors are running", "description": "What ads competitors are showing and how to outposition them"}
74
+ ]
75
+ },
76
+ {
77
+ "question": "Which platform(s) are you working with?",
78
+ "header": "Platform",
79
+ "multiSelect": true,
80
+ "options": [
81
+ {"label": "Google Ads", "description": "Search, Shopping, Performance Max, Display, YouTube"},
82
+ {"label": "Meta / Facebook & Instagram", "description": "Facebook Ads, Instagram Ads, Advantage+ campaigns"},
83
+ {"label": "LinkedIn", "description": "Sponsored Content, Lead Gen Forms — B2B focus"},
84
+ {"label": "TikTok", "description": "Video-first, UGC-style creatives — younger demographics"},
85
+ {"label": "Microsoft / Bing", "description": "Often a Google import — older, higher-income audience, lower CPCs"},
86
+ {"label": "Not running yet — help me choose", "description": "I'll recommend platforms based on your product, audience, and budget"}
87
+ ]
88
+ }
89
+ ]</parameter>
90
+ </invoke>
91
+ ```
92
+
93
+ **Route based on answers:**
94
+
95
+ | Goal | Next action |
96
+ | ------------------- | ----------------------------------------------------------------------------------- |
97
+ | Audit | Ask for account data (see below), then run audit commands |
98
+ | Write copy | Ask for product description + ICP, then `/agileflow:ads:generate` |
99
+ | Plan campaign | Ask budget + industry + primary goal, then `/agileflow:ads:plan` |
100
+ | Check tracking | Confirm which events they care about, then `/agileflow:ads:track` |
101
+ | Improve ROAS/CPA | Ask for current metrics + targets, then `/agileflow:ads:audit` (wasted spend focus) |
102
+ | Competitor analysis | Ask for their domain + your product category, then `/agileflow:ads:competitor` |
103
+
104
+ ## Gathering account data for audits
105
+
106
+ After the goal is clear, ask specifically for their data — don't make them guess what to paste:
107
+
108
+ ```xml
109
+ <invoke name="AskUserQuestion">
110
+ <parameter name="questions">[{
111
+ "question": "To audit your account, I need your campaign data. What's easiest for you?",
112
+ "header": "Account data",
113
+ "multiSelect": false,
114
+ "options": [
115
+ {"label": "Paste a CSV export (Recommended)", "description": "Google Ads: Campaigns tab → Download. Meta: Ads Manager → Columns → Export. Even a partial export works."},
116
+ {"label": "Paste the performance table directly", "description": "Screenshot the table or copy/paste the text from your dashboard — I'll parse it"},
117
+ {"label": "Describe your setup", "description": "Tell me: platforms, monthly spend, current ROAS/CPA, campaign types, and main goals — I'll work from that"},
118
+ {"label": "I have a file — share the path", "description": "Point me to an exported CSV and I'll read it directly"}
119
+ ]
120
+ }]</parameter>
121
+ </invoke>
122
+ ```
123
+
124
+ **Minimum useful data I need per platform:**
125
+
126
+ | Platform | What to include |
127
+ | ---------- | -------------------------------------------------------------------------- |
128
+ | Google Ads | Campaign name, type, budget, impressions, clicks, conversions, CPA or ROAS |
129
+ | Meta | Campaign name, objective, spend, results, CPR/CPA, audience description |
130
+ | LinkedIn | Campaign name, budget, clicks, leads, CPL, objective |
131
+ | TikTok | Campaign name, daily budget, conversions, CPA, creative types used |
132
+ | Microsoft | Whether imported from Google, UET tag status, top campaigns |
133
+
134
+ If only partial data is available: run the audit with what you have and explicitly flag what couldn't be assessed.
135
+
136
+ **Also ask these context questions** before running any audit — they change the benchmarks significantly:
137
+
138
+ - Industry / vertical (e-commerce, SaaS, local services, lead gen?)
139
+ - Monthly ad spend range
140
+ - Primary KPI (ROAS target, CPA target, lead volume?)
141
+ - How long have the campaigns been running?
142
+
143
+ ## Which audit command to use
144
+
145
+ | Situation | Command |
146
+ | ----------------------------------------- | --------------------------------------------------------------------------------------- |
147
+ | Running 2+ platforms, want overall health | `/agileflow:ads:audit` — runs all 6 analyzers, produces weighted score |
148
+ | Google-only deep dive | `/agileflow:ads:google` — 74 checks across campaign structure, keywords, copy, settings |
149
+ | Meta-only deep dive | `/agileflow:ads:meta` — 46 checks across pixel, creative, audiences, objectives |
150
+ | Budget & bidding focused | `/agileflow:ads:budget` — spend efficiency, scaling rules, bid strategy alignment |
151
+ | Creative & copy quality | `/agileflow:ads:creative` — copy effectiveness, format coverage, fatigue signals |
152
+ | Tracking & attribution | `/agileflow:ads:track` — pixel/tag setup, conversion accuracy, attribution model |
153
+ | Overall marketing health (ads + site) | `/agileflow:ads:health` — combines ad data with website URL |
154
+ | Performance over time | `/agileflow:ads:track` then `/agileflow:ads:health` |
155
+
156
+ TikTok, LinkedIn, and Microsoft are handled as part of `/agileflow:ads:audit` when those platforms are included in the data. Run the full audit rather than individual platform commands for secondary platforms.
157
+
158
+ ## After every analysis — guide the next step
159
+
160
+ Never dump findings without a clear path forward. After any command completes:
161
+
162
+ ```xml
163
+ <invoke name="AskUserQuestion">
164
+ <parameter name="questions">[{
165
+ "question": "Audit complete. Ads Health Score: {X}/100. {N} findings — {p0_count} immediate blockers, {p1_count} high-ROI quick wins. Biggest issue: {top_finding}.",
166
+ "header": "What to fix first",
167
+ "multiSelect": false,
168
+ "options": [
169
+ {"label": "Fix {top_p0_issue} now (Recommended)", "description": "{specific fix — e.g., 'Broken conversion tracking on Google — all ROAS numbers are unreliable until this is fixed'}"},
170
+ {"label": "Pause {n} campaigns failing the 3x Kill Rule", "description": "{specific campaigns spending {3x CPA} with {n} conversions — cut waste before optimizing}"},
171
+ {"label": "Deep-dive into {lowest_category} ({score}/100)", "description": "Worst-performing area — I'll walk through every finding with specific fixes"},
172
+ {"label": "Generate new ad copy to test against current", "description": "Fresh variants for your top campaigns — I'll use your existing copy as the baseline"}
173
+ ]
174
+ }]</parameter>
175
+ </invoke>
176
+ ```
177
+
178
+ **Make every option specific** to actual findings. Don't show the kill rule option if no campaigns qualify. Don't show "generate copy" if they just came from the generate workflow.
179
+
180
+ ## Key principles — apply throughout
181
+
182
+ 1. **Tracking first, always** — never recommend optimization before confirming tracking works. Broken pixels mean all ROAS numbers are lies. Start here if anything is uncertain.
183
+ 2. **3x Kill Rule** — campaigns with CPA > 3x target for 2+ weeks with few conversions should be paused, not tweaked. Say so directly.
184
+ 3. **Learning phase protection** — don't recommend budget changes that reset Google's learning phase (typically triggered by >20% budget change). Note this whenever relevant.
185
+ 4. **Broad Match needs Smart Bidding** — never recommend Broad Match keywords without tCPA or tROAS. Broad Match without Smart Bidding burns budget.
186
+ 5. **No optimization without data** — minimum 2 weeks and 50+ conversions before making structural changes. Flag this if the data is too thin.
187
+ 6. **Budget before creative** — a great creative with wrong targeting wastes money. Check audience + bidding before recommending new ad copy.
188
+
189
+ ## Integration
190
+
191
+ - **agileflow-research** — run before competitor analysis or entering a new ad platform; gather market benchmarks and audience insights before spending
192
+ - **agileflow-seo** — cross-reference paid and organic strategy; a page that performs well organically signals strong landing page quality for ads
193
+ - **agileflow-ideation** — use when brainstorming new campaign angles, product positioning, or untapped audience segments before writing ad copy
194
+ - **agileflow-retention** — align ad campaigns with retention mechanics; acquisition ads should funnel into onboarding flows designed for habit formation
195
+ - **agileflow-docs** — document campaign strategy, budget rationale, and tracking setup so the team can replicate or audit later
196
+ - **agileflow-delivery** — coordinate ad launch with product release; ensure tracking pixels and conversion events are deployed before campaigns go live
197
+ - **agileflow-engineering** — delegate pixel implementation, server-side conversion API, or tracking tag deployment work
198
+ - **agileflow-planning** — use for quarterly ad budget planning, ROI projections, or prioritising which campaigns to run first
199
+
200
+ ## References
201
+
202
+ Load these when you need deeper context:
203
+
204
+ | File | When to load |
205
+ | ---------------------------------------- | ------------------------------------------------------------------------------------------ |
206
+ | `references/platform-benchmarks.md` | User asks about CTR, CPM, ROAS, or CPA targets — has platform-specific industry benchmarks |
207
+ | `references/bid-strategy-guide.md` | Choosing or changing bid strategy on Google, Meta, LinkedIn, or TikTok |
208
+ | `references/ad-copy-formula-guide.md` | Writing or reviewing ad copy — AIDA, PAS, headline formulas, character limits per platform |
209
+ | `references/audience-targeting-guide.md` | Setting up lookalikes, retargeting funnels, exclusion lists, audience sizing |
210
+
211
+ ## Workflows
212
+
213
+ Follow these step-by-step when the user initiates the matching action:
214
+
215
+ | File | When to follow |
216
+ | ----------------------- | --------------------------------------------------------------------------------------------------------- |
217
+ | `workflows/audit.md` | User wants to audit an ad account — gathers data, deploys analyzers, presents health score + action plan |
218
+ | `workflows/generate.md` | User wants to generate ad copy variants — gathers product info, produces 40+ variants, formats for upload |
@@ -0,0 +1,131 @@
1
+ # Ad Copy Formula Guide
2
+
3
+ **Load this when:** Writing, reviewing, or improving ad copy across any platform or format.
4
+
5
+ ## Core Copywriting Formulas
6
+
7
+ ### AIDA — Attention, Interest, Desire, Action
8
+
9
+ | Stage | Goal | Trigger words |
10
+ | --------- | --------------- | ------------------------------------------------ |
11
+ | Attention | Stop the scroll | "Stop", "Finally", "Warning", numbers, questions |
12
+ | Interest | Build relevance | "If you...", "For [persona]...", "Imagine..." |
13
+ | Desire | Create want | Benefits > features, social proof, scarcity |
14
+ | Action | Drive click | "Get", "Start", "Try free", "Claim", "Download" |
15
+
16
+ **Template:**
17
+
18
+ ```
19
+ [Attention hook — 5 words max]
20
+ [Interest — 1 sentence connecting to pain]
21
+ [Desire — 1-2 key benefits or social proof]
22
+ [Action — clear CTA with value]
23
+ ```
24
+
25
+ ---
26
+
27
+ ### PAS — Problem, Agitate, Solution
28
+
29
+ Best for: Search ads, email subject lines, long-form display
30
+
31
+ | Stage | Job | Example |
32
+ | -------- | ------------------- | ------------------------------------------------ |
33
+ | Problem | Name the pain | "Tired of slow load times?" |
34
+ | Agitate | Amplify consequence | "Every second costs conversions — and revenue." |
35
+ | Solution | Position your offer | "AgileFlow cuts deploy time by 60%. Start free." |
36
+
37
+ **Template:**
38
+
39
+ ```
40
+ Headline: [Problem as question or statement]
41
+ Description: [Agitate] [Solution + CTA]
42
+ ```
43
+
44
+ ---
45
+
46
+ ### FAB — Feature, Advantage, Benefit
47
+
48
+ Convert feature-speak to benefit-speak:
49
+
50
+ | Feature | Advantage | Benefit |
51
+ | ------------------- | ---------------- | ----------------------------- |
52
+ | 99.9% uptime SLA | Always available | Never lose a sale to downtime |
53
+ | AI-powered matching | Faster results | Find what you need in seconds |
54
+ | SOC 2 certified | Audited security | Your data stays yours |
55
+
56
+ ---
57
+
58
+ ### BAB — Before, After, Bridge
59
+
60
+ Best for: Video scripts, testimonial ads, awareness campaigns
61
+
62
+ ```
63
+ Before: [Current painful state]
64
+ After: [Desired outcome state]
65
+ Bridge: [Your product = the path between]
66
+ ```
67
+
68
+ ---
69
+
70
+ ## Headline Formulas by Intent
71
+
72
+ | Intent | Formula | Example |
73
+ | ---------------------- | ----------------------------- | ---------------------------------------------------- |
74
+ | Search (informational) | [Keyword] — [Differentiator] | "Project Management — Try Free 30 Days" |
75
+ | Search (transactional) | [Verb] [Outcome] [Qualifier] | "Get More Leads Without Increasing Budget" |
76
+ | Display (awareness) | [Number] + [Noun] + [Benefit] | "5 Ways Teams Ship 2x Faster" |
77
+ | Social (disruptive) | Question or bold claim | "Your CI/CD pipeline is slower than it needs to be." |
78
+ | Retargeting | Continuity + urgency | "Still thinking it over? Offer ends Friday." |
79
+
80
+ ---
81
+
82
+ ## Description Line Templates
83
+
84
+ **Value prop + CTA:**
85
+
86
+ > [Primary benefit]. [Secondary benefit or proof]. [CTA with qualifier].
87
+
88
+ **Social proof + CTA:**
89
+
90
+ > Trusted by [N] [persona type]. [Key differentiator]. [CTA].
91
+
92
+ **Objection handling:**
93
+
94
+ > No [common objection]. [Benefit]. [CTA].
95
+ > "No contracts. Cancel anytime. Start your free trial today."
96
+
97
+ ---
98
+
99
+ ## Character Limits Quick Reference
100
+
101
+ | Platform | Headline | Description/Body |
102
+ | ------------------- | -------------- | ------------------------------ |
103
+ | Google RSA | 30 chars (×15) | 90 chars (×4) |
104
+ | Meta (Feed) | — | 125 chars primary; 27 headline |
105
+ | LinkedIn Sponsored | 70 chars | 150 chars |
106
+ | TikTok Text Overlay | 100 chars | — |
107
+ | Microsoft/Bing | 30 chars (×15) | 90 chars (×4) |
108
+
109
+ ---
110
+
111
+ ## Power Words by Goal
112
+
113
+ | Goal | Words |
114
+ | ----------- | ----------------------------------------------- |
115
+ | Trust | Proven, Certified, Guaranteed, Verified, Secure |
116
+ | Urgency | Now, Today, Limited, Expires, Last chance |
117
+ | Exclusivity | Exclusive, Members only, Invite, VIP |
118
+ | Ease | Simple, Instant, One-click, Effortless |
119
+ | Value | Free, Save, Bonus, No risk, Worth |
120
+
121
+ ---
122
+
123
+ ## Weak vs. Strong Copy Patterns
124
+
125
+ | Weak | Strong |
126
+ | ---------------------- | ----------------------------------- |
127
+ | "Learn more" | "See how it works" |
128
+ | "We offer solutions" | "Cut onboarding time in half" |
129
+ | "Click here" | "Get your free audit" |
130
+ | "High quality" | "4.9 stars across 2,400 reviews" |
131
+ | "Our platform is easy" | "Live in 10 minutes, no dev needed" |