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.
- package/CHANGELOG.md +51 -0
- package/content/plugins/accessibility/plugin.yaml +14 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/SKILL.md +392 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/references/aria-patterns.md +528 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/references/testing-checklist.md +457 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/references/wcag-guide.md +683 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/audit-page.md +310 -0
- package/content/plugins/accessibility/skills/agileflow-accessibility/workflows/implement-accessible-component.md +479 -0
- package/content/plugins/ads/agents/ads-audit-budget.md +185 -0
- package/content/plugins/ads/agents/ads-audit-compliance.md +171 -0
- package/content/plugins/ads/agents/ads-audit-creative.md +168 -0
- package/content/plugins/ads/agents/ads-audit-google.md +227 -0
- package/content/plugins/ads/agents/ads-audit-meta.md +184 -0
- package/content/plugins/ads/agents/ads-audit-tracking.md +205 -0
- package/content/plugins/ads/agents/ads-consensus.md +410 -0
- package/content/plugins/ads/agents/ads-generate.md +152 -0
- package/content/plugins/ads/agents/ads-performance-tracker.md +212 -0
- package/content/plugins/ads/plugin.yaml +23 -4
- package/content/plugins/ads/skills/agileflow-ads/SKILL.md +218 -0
- package/content/plugins/ads/skills/agileflow-ads/references/ad-copy-formula-guide.md +131 -0
- package/content/plugins/ads/skills/agileflow-ads/references/audience-targeting-guide.md +137 -0
- package/content/plugins/ads/skills/agileflow-ads/references/bid-strategy-guide.md +115 -0
- package/content/plugins/ads/skills/agileflow-ads/references/platform-benchmarks.md +100 -0
- package/content/plugins/ads/skills/agileflow-ads/workflows/audit.md +118 -0
- package/content/plugins/ads/skills/agileflow-ads/workflows/generate.md +84 -0
- package/content/plugins/audit/agents/a11y-analyzer-aria.md +173 -0
- package/content/plugins/audit/agents/a11y-analyzer-forms.md +173 -0
- package/content/plugins/audit/agents/a11y-analyzer-keyboard.md +183 -0
- package/content/plugins/audit/agents/a11y-analyzer-semantic.md +169 -0
- package/content/plugins/audit/agents/a11y-analyzer-visual.md +172 -0
- package/content/plugins/audit/agents/a11y-consensus.md +249 -0
- package/content/plugins/audit/agents/accessibility.md +558 -0
- package/content/plugins/audit/agents/api-quality-analyzer-conventions.md +156 -0
- package/content/plugins/audit/agents/api-quality-analyzer-docs.md +184 -0
- package/content/plugins/audit/agents/api-quality-analyzer-errors.md +191 -0
- package/content/plugins/audit/agents/api-quality-analyzer-pagination.md +179 -0
- package/content/plugins/audit/agents/api-quality-analyzer-versioning.md +150 -0
- package/content/plugins/audit/agents/api-quality-consensus.md +217 -0
- package/content/plugins/audit/agents/api-validator.md +191 -0
- package/content/plugins/audit/agents/arch-analyzer-circular.md +156 -0
- package/content/plugins/audit/agents/arch-analyzer-complexity.md +193 -0
- package/content/plugins/audit/agents/arch-analyzer-coupling.md +152 -0
- package/content/plugins/audit/agents/arch-analyzer-layering.md +160 -0
- package/content/plugins/audit/agents/arch-analyzer-patterns.md +210 -0
- package/content/plugins/audit/agents/arch-consensus.md +228 -0
- package/content/plugins/audit/agents/browser-qa.md +342 -0
- package/content/plugins/audit/agents/code-reviewer.md +298 -0
- package/content/plugins/audit/agents/completeness-analyzer-api.md +199 -0
- package/content/plugins/audit/agents/completeness-analyzer-conditional.md +211 -0
- package/content/plugins/audit/agents/completeness-analyzer-handlers.md +166 -0
- package/content/plugins/audit/agents/completeness-analyzer-imports.md +165 -0
- package/content/plugins/audit/agents/completeness-analyzer-routes.md +190 -0
- package/content/plugins/audit/agents/completeness-analyzer-state.md +196 -0
- package/content/plugins/audit/agents/completeness-analyzer-stubs.md +206 -0
- package/content/plugins/audit/agents/completeness-consensus.md +295 -0
- package/content/plugins/audit/agents/error-analyzer.md +213 -0
- package/content/plugins/audit/agents/flow-analyzer-authorization.md +182 -0
- package/content/plugins/audit/agents/flow-analyzer-discovery.md +174 -0
- package/content/plugins/audit/agents/flow-analyzer-errors.md +186 -0
- package/content/plugins/audit/agents/flow-analyzer-feedback.md +185 -0
- package/content/plugins/audit/agents/flow-analyzer-navigation.md +177 -0
- package/content/plugins/audit/agents/flow-analyzer-persistence.md +193 -0
- package/content/plugins/audit/agents/flow-analyzer-wiring.md +169 -0
- package/content/plugins/audit/agents/flow-consensus.md +237 -0
- package/content/plugins/audit/agents/legal-analyzer-a11y.md +114 -0
- package/content/plugins/audit/agents/legal-analyzer-ai.md +121 -0
- package/content/plugins/audit/agents/legal-analyzer-consumer.md +114 -0
- package/content/plugins/audit/agents/legal-analyzer-content.md +117 -0
- package/content/plugins/audit/agents/legal-analyzer-international.md +119 -0
- package/content/plugins/audit/agents/legal-analyzer-licensing.md +119 -0
- package/content/plugins/audit/agents/legal-analyzer-privacy.md +112 -0
- package/content/plugins/audit/agents/legal-analyzer-security.md +116 -0
- package/content/plugins/audit/agents/legal-analyzer-terms.md +115 -0
- package/content/plugins/audit/agents/legal-consensus.md +250 -0
- package/content/plugins/audit/agents/logic-analyzer-edge.md +179 -0
- package/content/plugins/audit/agents/logic-analyzer-flow.md +264 -0
- package/content/plugins/audit/agents/logic-analyzer-invariant.md +215 -0
- package/content/plugins/audit/agents/logic-analyzer-race.md +280 -0
- package/content/plugins/audit/agents/logic-analyzer-type.md +227 -0
- package/content/plugins/audit/agents/logic-consensus.md +259 -0
- package/content/plugins/audit/agents/perf-analyzer-assets.md +182 -0
- package/content/plugins/audit/agents/perf-analyzer-bundle.md +173 -0
- package/content/plugins/audit/agents/perf-analyzer-caching.md +170 -0
- package/content/plugins/audit/agents/perf-analyzer-compute.md +173 -0
- package/content/plugins/audit/agents/perf-analyzer-memory.md +193 -0
- package/content/plugins/audit/agents/perf-analyzer-network.md +165 -0
- package/content/plugins/audit/agents/perf-analyzer-queries.md +162 -0
- package/content/plugins/audit/agents/perf-analyzer-rendering.md +168 -0
- package/content/plugins/audit/agents/perf-consensus.md +287 -0
- package/content/plugins/audit/agents/qa.md +820 -0
- package/content/plugins/audit/agents/quality-analyzer-comments.md +159 -0
- package/content/plugins/audit/agents/quality-analyzer-duplication.md +184 -0
- package/content/plugins/audit/agents/quality-analyzer-naming.md +160 -0
- package/content/plugins/audit/agents/quality-consensus.md +241 -0
- package/content/plugins/audit/agents/schema-validator.md +473 -0
- package/content/plugins/audit/agents/security-analyzer-api.md +210 -0
- package/content/plugins/audit/agents/security-analyzer-auth.md +169 -0
- package/content/plugins/audit/agents/security-analyzer-authz.md +180 -0
- package/content/plugins/audit/agents/security-analyzer-deps.md +153 -0
- package/content/plugins/audit/agents/security-analyzer-infra.md +184 -0
- package/content/plugins/audit/agents/security-analyzer-injection.md +155 -0
- package/content/plugins/audit/agents/security-analyzer-input.md +201 -0
- package/content/plugins/audit/agents/security-analyzer-secrets.md +183 -0
- package/content/plugins/audit/agents/security-consensus.md +283 -0
- package/content/plugins/audit/agents/test-analyzer-assertions.md +188 -0
- package/content/plugins/audit/agents/test-analyzer-coverage.md +189 -0
- package/content/plugins/audit/agents/test-analyzer-fragility.md +193 -0
- package/content/plugins/audit/agents/test-analyzer-integration.md +161 -0
- package/content/plugins/audit/agents/test-analyzer-maintenance.md +180 -0
- package/content/plugins/audit/agents/test-analyzer-mocking.md +188 -0
- package/content/plugins/audit/agents/test-analyzer-patterns.md +196 -0
- package/content/plugins/audit/agents/test-analyzer-structure.md +184 -0
- package/content/plugins/audit/agents/test-consensus.md +301 -0
- package/content/plugins/audit/agents/testing.md +561 -0
- package/content/plugins/audit/agents/ui-validator.md +344 -0
- package/content/plugins/audit/plugin.yaml +186 -5
- package/content/plugins/audit/skills/agileflow-audit/SKILL.md +113 -0
- package/content/plugins/audit/skills/agileflow-audit/references/audit-depth-guide.md +151 -0
- package/content/plugins/audit/skills/agileflow-audit/references/dependency-risk-guide.md +139 -0
- package/content/plugins/audit/skills/agileflow-audit/references/owasp-top10.md +120 -0
- package/content/plugins/audit/skills/agileflow-audit/references/performance-budget-guide.md +143 -0
- package/content/plugins/audit/skills/agileflow-audit/references/wcag-criteria.md +117 -0
- package/content/plugins/audit/skills/agileflow-audit/workflows/run-audit.md +52 -0
- package/content/plugins/audit/skills/agileflow-audit/workflows/tdd.md +66 -0
- package/content/plugins/core/agents/adr-writer.md +521 -0
- package/content/plugins/core/agents/epic-planner.md +520 -0
- package/content/plugins/core/agents/mentor.md +709 -0
- package/content/plugins/core/agents/orchestrator.md +776 -0
- package/content/plugins/core/agents/team-coordinator.md +334 -0
- package/content/plugins/core/agents/team-lead.md +181 -0
- package/content/plugins/core/agents/workspace-orchestrator.md +146 -0
- package/content/plugins/core/hooks/context-loader.js +31 -4
- package/content/plugins/core/hooks/damage-control-bash.js +10 -2
- package/content/plugins/core/hooks/damage-control-edit.js +4 -1
- package/content/plugins/core/hooks/damage-control-patterns.yaml +1 -1
- package/content/plugins/core/hooks/damage-control-write.js +4 -1
- package/content/plugins/core/hooks/{pre-compact-state.js → post-compact-state.js} +25 -8
- package/content/plugins/core/hooks/preferences-injector.js +352 -0
- package/content/plugins/core/plugin.yaml +24 -28
- package/content/plugins/core/skills/agileflow-adr/SKILL.md +34 -8
- package/content/plugins/core/skills/agileflow-adr/references/madr-format-guide.md +86 -0
- package/content/plugins/core/skills/agileflow-adr/workflows/write-adr.md +57 -0
- package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +94 -27
- package/content/plugins/core/skills/agileflow-babysit-mentor/references/mentor-decision-guide.md +81 -0
- package/content/plugins/core/skills/agileflow-babysit-mentor/workflows/mentor-session.md +79 -0
- package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +37 -7
- package/content/plugins/core/skills/agileflow-epic-planner/references/epic-sizing-guide.md +81 -0
- package/content/plugins/core/skills/agileflow-epic-planner/workflows/plan-epic.md +55 -0
- package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +36 -20
- package/content/plugins/core/skills/agileflow-status-updater/references/status-transitions.md +89 -0
- package/content/plugins/core/skills/agileflow-status-updater/workflows/update-status.md +56 -0
- package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +39 -114
- package/content/plugins/core/skills/agileflow-story-writer/references/estimation-reference.md +36 -0
- package/content/plugins/core/skills/agileflow-story-writer/references/story-template.md +92 -0
- package/content/plugins/core/skills/agileflow-story-writer/workflows/write-story.md +138 -0
- package/content/plugins/council/agents/council-advocate.md +223 -0
- package/content/plugins/council/agents/council-analyst.md +278 -0
- package/content/plugins/council/agents/council-compounder.md +204 -0
- package/content/plugins/council/agents/council-contrarian.md +217 -0
- package/content/plugins/council/agents/council-moonshot.md +217 -0
- package/content/plugins/council/agents/council-optimist.md +185 -0
- package/content/plugins/council/agents/council-revenue.md +200 -0
- package/content/plugins/council/agents/council-technical.md +218 -0
- package/content/plugins/council/agents/multi-expert.md +334 -0
- package/content/plugins/council/plugin.yaml +23 -4
- package/content/plugins/council/skills/agileflow-council/SKILL.md +102 -0
- package/content/plugins/council/skills/agileflow-council/references/decision-log-template.md +109 -0
- package/content/plugins/council/skills/agileflow-council/references/perspective-guide.md +104 -0
- package/content/plugins/council/skills/agileflow-council/references/when-to-convene-guide.md +112 -0
- package/content/plugins/council/skills/agileflow-council/workflows/convene.md +73 -0
- package/content/plugins/council/skills/agileflow-council/workflows/multi-expert.md +75 -0
- package/content/plugins/database/plugin.yaml +14 -0
- package/content/plugins/database/skills/agileflow-database/SKILL.md +284 -0
- package/content/plugins/database/skills/agileflow-database/references/indexing-guide.md +313 -0
- package/content/plugins/database/skills/agileflow-database/references/migration-guide.md +328 -0
- package/content/plugins/database/skills/agileflow-database/references/schema-design-guide.md +467 -0
- package/content/plugins/database/skills/agileflow-database/workflows/design-schema.md +213 -0
- package/content/plugins/database/skills/agileflow-database/workflows/optimize-query.md +253 -0
- package/content/plugins/debugging/plugin.yaml +14 -0
- package/content/plugins/debugging/skills/agileflow-debug/SKILL.md +236 -0
- package/content/plugins/debugging/skills/agileflow-debug/references/common-patterns.md +350 -0
- package/content/plugins/debugging/skills/agileflow-debug/references/debugging-strategies.md +328 -0
- package/content/plugins/debugging/skills/agileflow-debug/workflows/debug-issue.md +187 -0
- package/content/plugins/debugging/skills/agileflow-debug/workflows/reproduce-bug.md +194 -0
- package/content/plugins/delivery/agents/ci.md +547 -0
- package/content/plugins/delivery/agents/devops.md +789 -0
- package/content/plugins/delivery/plugin.yaml +19 -0
- package/content/plugins/delivery/skills/agileflow-delivery/SKILL.md +111 -0
- package/content/plugins/delivery/skills/agileflow-delivery/references/changelog-format-guide.md +133 -0
- package/content/plugins/delivery/skills/agileflow-delivery/references/ci-pipeline-guide.md +158 -0
- package/content/plugins/delivery/skills/agileflow-delivery/references/pr-checklist-guide.md +133 -0
- package/content/plugins/delivery/skills/agileflow-delivery/references/release-checklist.md +142 -0
- package/content/plugins/delivery/skills/agileflow-delivery/workflows/changelog.md +72 -0
- package/content/plugins/delivery/skills/agileflow-delivery/workflows/deploy.md +74 -0
- package/content/plugins/delivery/skills/agileflow-delivery/workflows/pr.md +75 -0
- package/content/plugins/docs/agents/documentation.md +544 -0
- package/content/plugins/docs/agents/readme-updater.md +640 -0
- package/content/plugins/docs/plugin.yaml +19 -0
- package/content/plugins/docs/skills/agileflow-docs/SKILL.md +106 -0
- package/content/plugins/docs/skills/agileflow-docs/references/api-doc-template.md +167 -0
- package/content/plugins/docs/skills/agileflow-docs/references/doc-types-guide.md +141 -0
- package/content/plugins/docs/skills/agileflow-docs/references/readme-template.md +156 -0
- package/content/plugins/docs/skills/agileflow-docs/workflows/readme-sync.md +57 -0
- package/content/plugins/docs/skills/agileflow-docs/workflows/sync.md +64 -0
- package/content/plugins/engineering/agents/api.md +718 -0
- package/content/plugins/engineering/agents/codebase-query.md +285 -0
- package/content/plugins/engineering/agents/compliance.md +559 -0
- package/content/plugins/engineering/agents/database.md +644 -0
- package/content/plugins/engineering/agents/integrations.md +644 -0
- package/content/plugins/engineering/agents/mobile.md +552 -0
- package/content/plugins/engineering/agents/monitoring.md +585 -0
- package/content/plugins/engineering/agents/performance.md +529 -0
- package/content/plugins/engineering/agents/refactor.md +592 -0
- package/content/plugins/engineering/agents/security.md +524 -0
- package/content/plugins/engineering/agents/ui.md +1336 -0
- package/content/plugins/engineering/plugin.yaml +37 -0
- package/content/plugins/engineering/skills/agileflow-engineering/SKILL.md +127 -0
- package/content/plugins/engineering/skills/agileflow-engineering/references/code-review-guide.md +126 -0
- package/content/plugins/engineering/skills/agileflow-engineering/references/domain-routing-guide.md +89 -0
- package/content/plugins/engineering/skills/agileflow-engineering/references/refactoring-guide.md +136 -0
- package/content/plugins/engineering/skills/agileflow-engineering/workflows/diagnose.md +63 -0
- package/content/plugins/engineering/skills/agileflow-engineering/workflows/impact.md +60 -0
- package/content/plugins/ideation/agents/brainstorm-analyzer-features.md +179 -0
- package/content/plugins/ideation/agents/brainstorm-analyzer-growth.md +169 -0
- package/content/plugins/ideation/agents/brainstorm-analyzer-integration.md +181 -0
- package/content/plugins/ideation/agents/brainstorm-analyzer-market.md +150 -0
- package/content/plugins/ideation/agents/brainstorm-analyzer-ux.md +180 -0
- package/content/plugins/ideation/agents/brainstorm-consensus.md +245 -0
- package/content/plugins/ideation/agents/design.md +568 -0
- package/content/plugins/ideation/agents/product.md +582 -0
- package/content/plugins/ideation/plugin.yaml +31 -0
- package/content/plugins/ideation/skills/agileflow-ideation/SKILL.md +109 -0
- package/content/plugins/ideation/skills/agileflow-ideation/references/brainstorm-techniques.md +138 -0
- package/content/plugins/ideation/skills/agileflow-ideation/references/competitive-analysis-template.md +148 -0
- package/content/plugins/ideation/skills/agileflow-ideation/references/feature-prioritization-guide.md +147 -0
- package/content/plugins/ideation/skills/agileflow-ideation/references/user-story-patterns.md +152 -0
- package/content/plugins/ideation/skills/agileflow-ideation/workflows/features.md +65 -0
- package/content/plugins/ideation/skills/agileflow-ideation/workflows/ideate.md +54 -0
- package/content/plugins/migration/agents/datamigration.md +757 -0
- package/content/plugins/migration/plugin.yaml +17 -0
- package/content/plugins/migration/skills/agileflow-migration/SKILL.md +106 -0
- package/content/plugins/migration/skills/agileflow-migration/references/data-validation-checklist.md +154 -0
- package/content/plugins/migration/skills/agileflow-migration/references/migration-patterns.md +209 -0
- package/content/plugins/migration/skills/agileflow-migration/references/rollback-playbook.md +171 -0
- package/content/plugins/migration/skills/agileflow-migration/references/version-compatibility-matrix.md +155 -0
- package/content/plugins/migration/skills/agileflow-migration/workflows/plan.md +73 -0
- package/content/plugins/migration/skills/agileflow-migration/workflows/validate.md +71 -0
- package/content/plugins/performance/plugin.yaml +14 -0
- package/content/plugins/performance/skills/agileflow-performance/SKILL.md +224 -0
- package/content/plugins/performance/skills/agileflow-performance/references/optimization-patterns.md +554 -0
- package/content/plugins/performance/skills/agileflow-performance/references/profiling-guide.md +383 -0
- package/content/plugins/performance/skills/agileflow-performance/references/web-vitals-guide.md +360 -0
- package/content/plugins/performance/skills/agileflow-performance/workflows/improve-web-vitals.md +344 -0
- package/content/plugins/performance/skills/agileflow-performance/workflows/profile-and-fix.md +254 -0
- package/content/plugins/planning/agents/analytics.md +670 -0
- package/content/plugins/planning/agents/rlm-subcore.md +215 -0
- package/content/plugins/planning/plugin.yaml +19 -0
- package/content/plugins/planning/skills/agileflow-planning/SKILL.md +111 -0
- package/content/plugins/planning/skills/agileflow-planning/references/estimation-guide.md +114 -0
- package/content/plugins/planning/skills/agileflow-planning/references/rpi-workflow.md +119 -0
- package/content/plugins/planning/skills/agileflow-planning/references/sprint-planning-guide.md +145 -0
- package/content/plugins/planning/skills/agileflow-planning/workflows/impact.md +63 -0
- package/content/plugins/planning/skills/agileflow-planning/workflows/rpi.md +104 -0
- package/content/plugins/psychology/plugin.yaml +14 -0
- package/content/plugins/psychology/skills/agileflow-retention/SKILL.md +252 -0
- package/content/plugins/psychology/skills/agileflow-retention/references/competitor-analysis.md +240 -0
- package/content/plugins/psychology/skills/agileflow-retention/references/psychology-models.md +349 -0
- package/content/plugins/psychology/skills/agileflow-retention/references/retention-patterns.md +279 -0
- package/content/plugins/psychology/skills/agileflow-retention/workflows/design-retention-feature.md +287 -0
- package/content/plugins/psychology/skills/agileflow-retention/workflows/retention-audit.md +259 -0
- package/content/plugins/refactoring/plugin.yaml +14 -0
- package/content/plugins/refactoring/skills/agileflow-refactor/SKILL.md +235 -0
- package/content/plugins/refactoring/skills/agileflow-refactor/references/refactoring-patterns.md +405 -0
- package/content/plugins/refactoring/skills/agileflow-refactor/references/safety-checks.md +177 -0
- package/content/plugins/refactoring/skills/agileflow-refactor/workflows/extract-module.md +226 -0
- package/content/plugins/refactoring/skills/agileflow-refactor/workflows/safe-refactor.md +169 -0
- package/content/plugins/research/agents/research.md +503 -0
- package/content/plugins/research/plugin.yaml +17 -0
- package/content/plugins/research/skills/agileflow-research/SKILL.md +110 -0
- package/content/plugins/research/skills/agileflow-research/references/knowledge-decay-guide.md +121 -0
- package/content/plugins/research/skills/agileflow-research/references/research-prompt-guide.md +141 -0
- package/content/plugins/research/skills/agileflow-research/references/synthesis-template.md +154 -0
- package/content/plugins/research/skills/agileflow-research/workflows/analyze.md +60 -0
- package/content/plugins/research/skills/agileflow-research/workflows/ask.md +64 -0
- package/content/plugins/research/skills/agileflow-research/workflows/import.md +66 -0
- package/content/plugins/research/skills/agileflow-research/workflows/synthesize.md +66 -0
- package/content/plugins/reviews/plugin.yaml +14 -0
- package/content/plugins/reviews/skills/agileflow-pr-reviewer/SKILL.md +241 -0
- package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/review-checklist.md +200 -0
- package/content/plugins/reviews/skills/agileflow-pr-reviewer/references/security-patterns.md +328 -0
- package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/review-pr.md +153 -0
- package/content/plugins/reviews/skills/agileflow-pr-reviewer/workflows/security-review.md +177 -0
- package/content/plugins/seo/agents/seo-analyzer-content.md +169 -0
- package/content/plugins/seo/agents/seo-analyzer-images.md +198 -0
- package/content/plugins/seo/agents/seo-analyzer-performance.md +217 -0
- package/content/plugins/seo/agents/seo-analyzer-schema.md +184 -0
- package/content/plugins/seo/agents/seo-analyzer-sitemap.md +177 -0
- package/content/plugins/seo/agents/seo-analyzer-technical.md +151 -0
- package/content/plugins/seo/agents/seo-consensus.md +304 -0
- package/content/plugins/seo/plugin.yaml +19 -4
- package/content/plugins/seo/skills/agileflow-seo/SKILL.md +188 -0
- package/content/plugins/seo/skills/agileflow-seo/references/cwv-thresholds.md +110 -0
- package/content/plugins/seo/skills/agileflow-seo/references/eeat-framework.md +144 -0
- package/content/plugins/seo/skills/agileflow-seo/references/keyword-research-guide.md +125 -0
- package/content/plugins/seo/skills/agileflow-seo/references/schema-types.md +139 -0
- package/content/plugins/seo/skills/agileflow-seo/references/technical-seo-checklist.md +139 -0
- package/content/plugins/seo/skills/agileflow-seo/workflows/audit.md +98 -0
- package/content/plugins/seo/skills/agileflow-seo/workflows/page.md +118 -0
- package/content/plugins/testing/plugin.yaml +16 -0
- package/content/plugins/testing/skills/agileflow-test-writer/SKILL.md +260 -0
- package/content/plugins/testing/skills/agileflow-test-writer/references/coverage-targets.md +239 -0
- package/content/plugins/testing/skills/agileflow-test-writer/references/test-patterns.md +420 -0
- package/content/plugins/testing/skills/agileflow-test-writer/workflows/add-coverage.md +154 -0
- package/content/plugins/testing/skills/agileflow-test-writer/workflows/write-tests-from-ac.md +225 -0
- package/package.json +2 -2
- package/src/cli/commands/doctor.js +818 -30
- package/src/cli/commands/hook.js +17 -14
- package/src/cli/commands/launch.js +1454 -0
- package/src/cli/commands/learn.js +149 -0
- package/src/cli/commands/plugins.js +113 -0
- package/src/cli/commands/setup.js +455 -110
- package/src/cli/commands/skills.js +324 -0
- package/src/cli/commands/status.js +8 -10
- package/src/cli/commands/update.js +76 -15
- package/src/cli/index.js +90 -26
- package/src/cli/wizard/babysit-mode-picker.js +192 -0
- package/src/cli/wizard/behaviors-picker.js +208 -54
- package/src/cli/wizard/ide-picker.js +40 -28
- package/src/cli/wizard/install-scope-picker.js +57 -0
- package/src/cli/wizard/launch-alias-picker.js +50 -0
- package/src/cli/wizard/launch-cli-picker.js +129 -0
- package/src/cli/wizard/launch-tmux-picker.js +133 -0
- package/src/cli/wizard/learnings-picker.js +40 -0
- package/src/cli/wizard/plugin-picker.js +47 -16
- package/src/lib/brand.js +116 -0
- package/src/lib/errors.js +120 -0
- package/src/lib/path-check.js +39 -0
- package/src/runtime/config/defaults.js +22 -17
- package/src/runtime/config/loader.js +77 -8
- package/src/runtime/config/schema.json +43 -16
- package/src/runtime/config/writer.js +3 -1
- package/src/runtime/ide/babysit-skill.js +202 -0
- package/src/runtime/ide/capabilities.js +84 -29
- package/src/runtime/ide/claude-code-content.js +177 -0
- package/src/runtime/ide/claude-code-settings.js +67 -29
- package/src/runtime/ide/claude-code-skills.js +47 -32
- package/src/runtime/ide/codex-config.js +295 -0
- package/src/runtime/installer/install.js +252 -24
- package/src/runtime/launch/alias-installer.js +191 -0
- package/src/runtime/launch/cli-resume.js +244 -0
- package/src/runtime/launch/closed-windows.js +338 -0
- package/src/runtime/launch/defaults.js +66 -0
- package/src/runtime/launch/detect-clis.js +69 -0
- package/src/runtime/launch/doctor.js +464 -0
- package/src/runtime/launch/exec-wrapper.js +114 -0
- package/src/runtime/launch/parallel-session.js +247 -0
- package/src/runtime/launch/prefs.js +211 -0
- package/src/runtime/launch/project-prefs.js +234 -0
- package/src/runtime/launch/resolve-cli.js +56 -0
- package/src/runtime/launch/restore.js +152 -0
- package/src/runtime/launch/schema.json +75 -0
- package/src/runtime/launch/session-lifecycle.js +313 -0
- package/src/runtime/launch/session-registry.js +401 -0
- package/src/runtime/launch/spawn.js +103 -0
- package/src/runtime/launch/tabs.js +350 -0
- package/src/runtime/launch/tmux.js +764 -0
- package/src/runtime/launch/worktree.js +260 -0
- package/src/runtime/plugins/registry.js +16 -11
- package/src/runtime/plugins/validator.js +57 -43
- package/src/runtime/skills/learnings.js +308 -0
- package/content/plugins/core/hooks/babysit-mentor-injector.js +0 -55
- 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:
|
|
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
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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" |
|