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,137 @@
|
|
|
1
|
+
# Audience Targeting Guide
|
|
2
|
+
|
|
3
|
+
**Load this when:** Building audience segments, planning retargeting funnels, or structuring lookalike strategies.
|
|
4
|
+
|
|
5
|
+
## Funnel-Stage Targeting Framework
|
|
6
|
+
|
|
7
|
+
| Stage | Audience Type | Goal | Typical ROAS |
|
|
8
|
+
| ----- | ------------------------------------ | ------------- | ------------ |
|
|
9
|
+
| TOFU | Cold — Interest/Lookalike | Awareness | 1–2x |
|
|
10
|
+
| MOFU | Warm — Engagement/Video views | Consideration | 2–4x |
|
|
11
|
+
| BOFU | Hot — Site visitors, cart abandoners | Conversion | 4–10x+ |
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Lookalike Audiences
|
|
16
|
+
|
|
17
|
+
### Seed quality hierarchy (best to worst)
|
|
18
|
+
|
|
19
|
+
1. Purchasers (last 90–180 days)
|
|
20
|
+
2. High-LTV customers (top 10–20% by spend)
|
|
21
|
+
3. Qualified leads (completed form / booked call)
|
|
22
|
+
4. Add-to-cart / checkout-initiated
|
|
23
|
+
5. All site visitors (lowest signal quality)
|
|
24
|
+
|
|
25
|
+
### Lookalike size vs. precision tradeoff
|
|
26
|
+
|
|
27
|
+
| Size | Precision | Best for |
|
|
28
|
+
| ----- | ------------------ | ------------------------------- |
|
|
29
|
+
| 1% | Highest similarity | Small budgets, niche products |
|
|
30
|
+
| 2–5% | Balanced | Scale with acceptable CPA drift |
|
|
31
|
+
| 6–10% | Broad reach | Awareness, large budgets |
|
|
32
|
+
|
|
33
|
+
**Rule:** Start at 1–2%. Expand only when 1% audiences show frequency >3 or CPM spikes.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Retargeting Funnel Structure
|
|
38
|
+
|
|
39
|
+
### Standard 3-layer retargeting stack
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
Layer 1 — Engaged visitors (1–7 days)
|
|
43
|
+
Segment: Visited key page, >30s session, scrolled 50%+
|
|
44
|
+
Message: Direct offer, urgency, social proof
|
|
45
|
+
Budget: ~40% of retargeting spend
|
|
46
|
+
|
|
47
|
+
Layer 2 — Broader visitors (8–30 days)
|
|
48
|
+
Segment: Any site visit, no conversion
|
|
49
|
+
Message: Benefits reminder, testimonials
|
|
50
|
+
Budget: ~35%
|
|
51
|
+
|
|
52
|
+
Layer 3 — Cold re-engagement (31–90 days)
|
|
53
|
+
Segment: Past visitors gone cold
|
|
54
|
+
Message: New angle, discount/offer, "we missed you"
|
|
55
|
+
Budget: ~25%
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### High-intent signals to create custom audiences from
|
|
59
|
+
|
|
60
|
+
- Visited `/pricing` or `/demo`
|
|
61
|
+
- Watched >50% of product video
|
|
62
|
+
- Opened email 3+ times without clicking
|
|
63
|
+
- Downloaded lead magnet but didn't book
|
|
64
|
+
- Started checkout / signup, did not complete
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Exclusion Strategy (critical for efficiency)
|
|
69
|
+
|
|
70
|
+
Always exclude from prospecting:
|
|
71
|
+
|
|
72
|
+
- [ ] Current customers (suppress by email list + pixel)
|
|
73
|
+
- [ ] Active leads in nurture sequence
|
|
74
|
+
- [ ] Recent converters (30-day window minimum)
|
|
75
|
+
- [ ] Employees / internal traffic (IP exclusion)
|
|
76
|
+
- [ ] Low-quality converters (refunds, chargebacks)
|
|
77
|
+
|
|
78
|
+
Always exclude from retargeting:
|
|
79
|
+
|
|
80
|
+
- [ ] Already converted in attribution window
|
|
81
|
+
- [ ] Suppression list (unsubscribes, complaints)
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Platform-Specific Audience Notes
|
|
86
|
+
|
|
87
|
+
### Meta
|
|
88
|
+
|
|
89
|
+
- Minimum seed size for lookalikes: 100 people (1,000+ recommended)
|
|
90
|
+
- Advantage+ audiences: Use when scale matters more than control
|
|
91
|
+
- Broad targeting (no detailed targeting) outperforms interest stacks at $50k+/mo budgets
|
|
92
|
+
- Engagement custom audiences: video views, Instagram interactions, lead form openers
|
|
93
|
+
|
|
94
|
+
### Google
|
|
95
|
+
|
|
96
|
+
- Customer Match: upload email list for RLSA and lookalikes
|
|
97
|
+
- Similar Segments: auto-generated, less controllable than Meta LAL
|
|
98
|
+
- In-market segments: highest purchase intent in Display/YouTube
|
|
99
|
+
- RLSA bid adjustments: +20–50% for cart abandoners on Search
|
|
100
|
+
|
|
101
|
+
### LinkedIn
|
|
102
|
+
|
|
103
|
+
- Matched audiences: upload CSV (min 300 matched for activation)
|
|
104
|
+
- Account-based targeting: upload target company list
|
|
105
|
+
- Retargeting: needs LinkedIn Insight Tag on site (24-hour delay)
|
|
106
|
+
- Lookalikes: available but limited — better for awareness than conversion
|
|
107
|
+
|
|
108
|
+
### TikTok
|
|
109
|
+
|
|
110
|
+
- Value-based lookalikes: feed pixel purchase events (not just add-to-cart)
|
|
111
|
+
- Interest + behavior combinations outperform single-dimension targeting
|
|
112
|
+
- SPARK Ads: allowlist organic posts → boosted as paid (higher trust signal)
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Audience Overlap Check
|
|
117
|
+
|
|
118
|
+
Before launching:
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
Overlap >30% between ad sets = audience cannibalization risk
|
|
122
|
+
Fix: Merge ad sets OR add mutual exclusions
|
|
123
|
+
Tool: Meta Audience Overlap tool, Google Audience Manager
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Frequency Caps by Stage
|
|
129
|
+
|
|
130
|
+
| Stage | Recommended cap |
|
|
131
|
+
| -------------------- | ------------------------------ |
|
|
132
|
+
| Awareness (cold) | 1–2/week |
|
|
133
|
+
| Consideration (warm) | 3–5/week |
|
|
134
|
+
| Retargeting (hot) | 5–7/week, then rotate creative |
|
|
135
|
+
| Re-engagement | 2–3/week max |
|
|
136
|
+
|
|
137
|
+
**Fatigue signal:** CTR drops >20% week-over-week with stable CPM → creative rotation needed, not audience expansion.
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# Bid Strategy Guide
|
|
2
|
+
|
|
3
|
+
**Load this when:** recommending or diagnosing bidding strategies across platforms.
|
|
4
|
+
|
|
5
|
+
## Google Ads bid strategies
|
|
6
|
+
|
|
7
|
+
### Decision tree
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
Do you have conversion tracking?
|
|
11
|
+
├── NO → Manual CPC or Maximize Clicks (gather data first)
|
|
12
|
+
└── YES → How many conversions/month?
|
|
13
|
+
├── <30/month → Manual CPC with ECPC, or Target Impression Share for brand
|
|
14
|
+
├── 30–50/month → Target CPA (borderline — watch learning phase)
|
|
15
|
+
└── 50+/month → Smart Bidding (tCPA, tROAS, or Maximize Conversions)
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### Smart Bidding strategies
|
|
19
|
+
|
|
20
|
+
| Strategy | Use when | Avoid when |
|
|
21
|
+
| ----------------------------- | ---------------------------------------------- | ---------------------------------------------------- |
|
|
22
|
+
| **Maximize Conversions** | New campaigns, want volume, no CPA target yet | CPA matters — it'll spend to budget regardless |
|
|
23
|
+
| **Target CPA** | Know your target CPA, 50+ monthly conversions | <30 conversions/month — insufficient signal |
|
|
24
|
+
| **Target ROAS** | Ecommerce with revenue values, 50+ conversions | Revenue values not tracked accurately |
|
|
25
|
+
| **Maximize Conversion Value** | Want revenue volume, have revenue tracking | CPA efficiency matters more than raw revenue |
|
|
26
|
+
| **Target Impression Share** | Brand campaigns, competitor conquest | Performance campaigns — wastes budget on impressions |
|
|
27
|
+
| **Enhanced CPC** | Manual bidding with slight automation | You have enough conversions for full smart bidding |
|
|
28
|
+
|
|
29
|
+
### Learning phase rules
|
|
30
|
+
|
|
31
|
+
- Learning phase: ~1–2 weeks after any significant change
|
|
32
|
+
- Need 50+ conversions in learning phase to exit cleanly
|
|
33
|
+
- **Never** make major changes (bid, budget, targeting) during learning phase
|
|
34
|
+
- Budget changes >20% restart learning phase
|
|
35
|
+
- Audience changes restart learning phase
|
|
36
|
+
|
|
37
|
+
### Broad Match + Smart Bidding rule
|
|
38
|
+
|
|
39
|
+
**Never use Broad Match without Smart Bidding.** Broad Match without tCPA/tROAS
|
|
40
|
+
has no guardrails — it will find irrelevant traffic and waste budget.
|
|
41
|
+
|
|
42
|
+
Broad Match + tCPA or tROAS = safe. Google's algorithm self-corrects.
|
|
43
|
+
Broad Match + Manual CPC = guaranteed waste.
|
|
44
|
+
|
|
45
|
+
## Meta bid strategies
|
|
46
|
+
|
|
47
|
+
| Strategy | Use when |
|
|
48
|
+
| ---------------------------- | ------------------------------------------------------------------- |
|
|
49
|
+
| **Highest Volume** (default) | Learning phase, new campaigns, maximizing results within budget |
|
|
50
|
+
| **Cost per Result Goal** | You have a CPA target and enough historical data (100+ conversions) |
|
|
51
|
+
| **ROAS Goal** | Ecommerce with revenue tracking, 100+ purchase events |
|
|
52
|
+
| **Bid Cap** | Strict CPA control needed, willing to sacrifice volume |
|
|
53
|
+
|
|
54
|
+
### Meta learning phase
|
|
55
|
+
|
|
56
|
+
- Needs 50 optimization events per ad set per week to exit learning
|
|
57
|
+
- Consolidate ad sets — too many competing for the same audience fragments data
|
|
58
|
+
- Avoid editing during learning: budget, bid, creative, audience changes restart it
|
|
59
|
+
|
|
60
|
+
### Advantage+ Shopping (ASC) — when to use
|
|
61
|
+
|
|
62
|
+
Use when:
|
|
63
|
+
|
|
64
|
+
- Ecommerce with 100+ monthly purchases
|
|
65
|
+
- You've maxed out manual campaigns
|
|
66
|
+
- Want to test broad creative with algorithm-driven targeting
|
|
67
|
+
|
|
68
|
+
Avoid when:
|
|
69
|
+
|
|
70
|
+
- Brand safety is critical (less control)
|
|
71
|
+
- Niche B2B audience (algorithm needs volume to work)
|
|
72
|
+
|
|
73
|
+
## LinkedIn bid strategies
|
|
74
|
+
|
|
75
|
+
| Strategy | Use when |
|
|
76
|
+
| -------------------- | ---------------------------------------------- |
|
|
77
|
+
| **Maximum Delivery** | New campaigns, awareness, learning phase |
|
|
78
|
+
| **Target Cost** | Stable campaigns with established CPL baseline |
|
|
79
|
+
| **Manual Bidding** | Specific placement control needed |
|
|
80
|
+
|
|
81
|
+
LinkedIn's CPCs are high by default. Start with Maximum Delivery and
|
|
82
|
+
optimize creatives before touching bids.
|
|
83
|
+
|
|
84
|
+
## Cross-platform budget allocation
|
|
85
|
+
|
|
86
|
+
### Starting allocation for a new account
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
Total budget = $X/month
|
|
90
|
+
|
|
91
|
+
If testing (first 30 days):
|
|
92
|
+
Google Search: 50% — highest intent
|
|
93
|
+
Meta: 30% — retargeting + lookalikes
|
|
94
|
+
Reserve: 20% — keep for winning channels
|
|
95
|
+
|
|
96
|
+
After 60 days with data:
|
|
97
|
+
Double down on channels hitting target CPA
|
|
98
|
+
Cut channels at 2x target CPA with no improvement
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Budget change rules
|
|
102
|
+
|
|
103
|
+
- Never increase budget >20% per week (learning phase)
|
|
104
|
+
- To scale fast: duplicate campaign, set new budget on duplicate
|
|
105
|
+
- Seasonal increases: plan 2 weeks ahead (learning phase needs time)
|
|
106
|
+
|
|
107
|
+
## Warning signs in bidding
|
|
108
|
+
|
|
109
|
+
| Signal | Likely cause | Fix |
|
|
110
|
+
| ------------------------------- | -------------------------- | ------------------------------- |
|
|
111
|
+
| CPA suddenly doubles | Learning phase reset | Wait 2 weeks, don't touch |
|
|
112
|
+
| Spend stops before daily budget | Bids too low for auction | Raise bid or switch to Maximize |
|
|
113
|
+
| High spend, zero conversions | Tracking broken | Fix tracking before optimizing |
|
|
114
|
+
| High CTR, low conversion rate | Landing page mismatch | Fix LP, not the ads |
|
|
115
|
+
| Low CTR, high CVR | Good intent, poor creative | Improve ad copy |
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# Ad Platform Benchmarks Reference
|
|
2
|
+
|
|
3
|
+
**Load this when:** interpreting campaign performance, diagnosing underperformance,
|
|
4
|
+
or setting realistic KPI targets. All figures are industry averages — actual
|
|
5
|
+
benchmarks vary significantly by industry, funnel stage, and audience quality.
|
|
6
|
+
|
|
7
|
+
## Google Ads benchmarks (search)
|
|
8
|
+
|
|
9
|
+
| Metric | Poor | Average | Good | Great |
|
|
10
|
+
| ------------------------------- | ---- | ------- | ----- | ----- |
|
|
11
|
+
| CTR | <2% | 3–5% | 6–9% | 10%+ |
|
|
12
|
+
| Conversion rate | <2% | 3–5% | 6–10% | 11%+ |
|
|
13
|
+
| Quality Score | 1–3 | 4–6 | 7–8 | 9–10 |
|
|
14
|
+
| CPC (varies widely by industry) | — | $1–$4 | — | — |
|
|
15
|
+
|
|
16
|
+
**High-cost industries (CPC $15–$50+):** legal, insurance, finance, medical
|
|
17
|
+
**Low-cost industries (CPC $0.50–$2):** ecommerce, apparel, B2C
|
|
18
|
+
|
|
19
|
+
### Google Ads quality score impact on CPC
|
|
20
|
+
|
|
21
|
+
| Quality Score | CPC adjustment |
|
|
22
|
+
| ------------- | -------------- |
|
|
23
|
+
| 10 | -50% |
|
|
24
|
+
| 7 (baseline) | 0% |
|
|
25
|
+
| 4 | +25% |
|
|
26
|
+
| 1 | +400% |
|
|
27
|
+
|
|
28
|
+
## Meta / Facebook Ads benchmarks
|
|
29
|
+
|
|
30
|
+
| Metric | Poor | Average | Good | Great |
|
|
31
|
+
| ----------------------------------- | ----- | -------- | ---- | ----- |
|
|
32
|
+
| CTR (link) | <0.5% | 0.9–1.5% | 2–3% | 4%+ |
|
|
33
|
+
| CPM | $20+ | $8–15 | $5–8 | <$5 |
|
|
34
|
+
| Frequency (before creative fatigue) | >5 | 3–5 | 2–3 | — |
|
|
35
|
+
| ROAS (ecommerce) | <2x | 2–3x | 3–5x | 5x+ |
|
|
36
|
+
|
|
37
|
+
**Creative fatigue signal:** CTR drops >30% from week 1 to week 3 = refresh creative.
|
|
38
|
+
|
|
39
|
+
### Meta campaign objective CPR benchmarks
|
|
40
|
+
|
|
41
|
+
| Objective | Average CPR |
|
|
42
|
+
| ---------------------- | ----------- |
|
|
43
|
+
| Lead generation | $10–30 |
|
|
44
|
+
| Purchase (ecommerce) | $15–60 |
|
|
45
|
+
| App install | $1–5 |
|
|
46
|
+
| Video views (ThruPlay) | $0.01–0.05 |
|
|
47
|
+
|
|
48
|
+
## LinkedIn Ads benchmarks
|
|
49
|
+
|
|
50
|
+
| Metric | Poor | Average | Good |
|
|
51
|
+
| ---------------------- | ----- | -------- | ----- |
|
|
52
|
+
| CTR | <0.3% | 0.4–0.6% | 0.7%+ |
|
|
53
|
+
| CPL | >$200 | $80–150 | <$80 |
|
|
54
|
+
| Conversion rate (form) | <5% | 8–12% | 15%+ |
|
|
55
|
+
|
|
56
|
+
LinkedIn CPCs are high ($6–15) but audience quality is unmatched for B2B.
|
|
57
|
+
Only use if ACV > $5K or LTV justifies high CPL.
|
|
58
|
+
|
|
59
|
+
## TikTok Ads benchmarks
|
|
60
|
+
|
|
61
|
+
| Metric | Poor | Average | Good |
|
|
62
|
+
| ------------------ | ---------- | ------------- | ------------------ |
|
|
63
|
+
| CTR | <0.5% | 1–2% | 3%+ |
|
|
64
|
+
| CPM | $15+ | $8–12 | <$8 |
|
|
65
|
+
| VTR (video to end) | <15% | 25–35% | 40%+ |
|
|
66
|
+
| CPA | >3x target | 1.5–2x target | At or below target |
|
|
67
|
+
|
|
68
|
+
TikTok rewards authenticity. UGC-style ads outperform polished creative 3:1.
|
|
69
|
+
|
|
70
|
+
## Microsoft / Bing Ads benchmarks
|
|
71
|
+
|
|
72
|
+
| Metric | Comparison to Google |
|
|
73
|
+
| --------------- | ----------------------------------------------- |
|
|
74
|
+
| CPC | 30–60% lower |
|
|
75
|
+
| CTR | Similar to Google (same intent-based) |
|
|
76
|
+
| Conversion rate | Often higher (older, higher-income demographic) |
|
|
77
|
+
| Volume | ~20–30% of Google volume |
|
|
78
|
+
|
|
79
|
+
Microsoft is often ignored but delivers strong ROI, especially for B2B and
|
|
80
|
+
older demographics. Import campaigns from Google as baseline.
|
|
81
|
+
|
|
82
|
+
## ROAS targets by business model
|
|
83
|
+
|
|
84
|
+
| Model | Break-even ROAS | Target ROAS |
|
|
85
|
+
| ------------------------------------ | --------------- | ----------- |
|
|
86
|
+
| Ecommerce (30% margin) | 3.3x | 4–6x |
|
|
87
|
+
| Ecommerce (50% margin) | 2.0x | 3–5x |
|
|
88
|
+
| SaaS (monthly subscription) | LTV/CAC > 3 | LTV/CAC > 5 |
|
|
89
|
+
| Lead gen (close rate 20%, $500 deal) | CPL < $100 | CPL < $60 |
|
|
90
|
+
|
|
91
|
+
## The 3x kill rule
|
|
92
|
+
|
|
93
|
+
**Pause any campaign where CPA > 3x your target for 2+ consecutive weeks.**
|
|
94
|
+
Don't optimize — pause. Optimizing a fundamentally broken campaign wastes time.
|
|
95
|
+
|
|
96
|
+
Exceptions:
|
|
97
|
+
|
|
98
|
+
- Campaign is still in learning phase (<50 conversions)
|
|
99
|
+
- You just changed creative/copy (give 2 weeks to stabilize)
|
|
100
|
+
- Seasonal campaign with known off-peak periods
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# Audit Workflow — Paid Advertising Account Audit
|
|
2
|
+
|
|
3
|
+
**Triggers:** "audit my ads", "run an ads audit", "review my Google Ads", "check my Meta campaigns", "ads health score", "what's wrong with my advertising"
|
|
4
|
+
|
|
5
|
+
**Goal:** Deploy 6 specialized advertising analyzers in parallel against the user's account data, synthesize results into a weighted Ads Health Score (0–100), and produce a prioritized action plan with specific, dollar-impact estimates where possible.
|
|
6
|
+
|
|
7
|
+
## Inputs needed
|
|
8
|
+
|
|
9
|
+
| Input | Required | How to get it |
|
|
10
|
+
| ---------------------- | -------- | ---------------------------------------------------------- |
|
|
11
|
+
| account data | Yes | CSV export, pasted table, or described setup |
|
|
12
|
+
| platform(s) | No | Auto-detect from data, or already captured in opening flow |
|
|
13
|
+
| industry + KPI targets | No | Ask conversationally — changes benchmarks significantly |
|
|
14
|
+
|
|
15
|
+
## Steps
|
|
16
|
+
|
|
17
|
+
1. **If account data is not provided**, ask specifically — don't make them guess what format to use:
|
|
18
|
+
|
|
19
|
+
```xml
|
|
20
|
+
<invoke name="AskUserQuestion">
|
|
21
|
+
<parameter name="questions">[{
|
|
22
|
+
"question": "To audit your account, I need your campaign data. What's easiest?",
|
|
23
|
+
"header": "Account data",
|
|
24
|
+
"multiSelect": false,
|
|
25
|
+
"options": [
|
|
26
|
+
{"label": "Paste a CSV export (Recommended)", "description": "Google Ads: Campaigns tab → Download. Meta: Ads Manager → Columns → Export. Even a partial export works."},
|
|
27
|
+
{"label": "Paste the performance table from your dashboard", "description": "Copy/paste the text from your campaigns view — I'll parse it"},
|
|
28
|
+
{"label": "Describe your setup", "description": "Tell me: platforms, monthly spend, ROAS/CPA, campaign types, and main goals"},
|
|
29
|
+
{"label": "I have a file — share the path", "description": "Point me to an exported CSV and I'll read it directly"}
|
|
30
|
+
]
|
|
31
|
+
}]</parameter>
|
|
32
|
+
</invoke>
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
2. **Gather context** — ask conversationally before running analyzers:
|
|
36
|
+
- Industry / vertical (e-commerce, SaaS, local services, lead gen, B2B?)
|
|
37
|
+
- Monthly ad spend range
|
|
38
|
+
- Primary KPI: ROAS target, CPA target, or lead volume goal?
|
|
39
|
+
- How long have these campaigns been running?
|
|
40
|
+
|
|
41
|
+
These change benchmarks significantly. A 3x ROAS for e-commerce is average; for SaaS it's strong. Skip if already captured in the opening flow.
|
|
42
|
+
|
|
43
|
+
3. **Detect active platforms** from the data. If the user specified platforms in the opening flow, use those.
|
|
44
|
+
|
|
45
|
+
4. **Deploy all 6 analyzers simultaneously** — no need to ask for depth, run quick by default:
|
|
46
|
+
- **Google analyzer** — campaign structure, keyword strategy, quality scores, ad copy, wasted spend (74 checks)
|
|
47
|
+
- **Meta analyzer** — audience targeting, creative fatigue, objectives, pixel/CAPI setup (46 checks)
|
|
48
|
+
- **Budget analyzer** — spend distribution, scaling rules, bid strategy efficiency (24 checks)
|
|
49
|
+
- **Creative analyzer** — copy quality, CTR patterns, creative fatigue, A/B test coverage
|
|
50
|
+
- **Tracking analyzer** — pixel/tag setup, conversion tracking accuracy, attribution model
|
|
51
|
+
- **Compliance analyzer** — policy violations, restricted content, account health flags
|
|
52
|
+
|
|
53
|
+
5. **Apply quality gates automatically:**
|
|
54
|
+
- Flag if tracking is broken — optimization recommendations are unreliable without it
|
|
55
|
+
- Apply 3x Kill Rule: campaigns with CPA > 3x target for 2+ weeks → flag for pause
|
|
56
|
+
- Flag Broad Match keywords without Smart Bidding
|
|
57
|
+
- Flag recent changes that may have reset learning phase
|
|
58
|
+
|
|
59
|
+
6. **Weighted scoring:** Tracking 25%, Wasted Spend 20%, Structure 15%, Creative 15%, Budget 15%, Compliance 10%.
|
|
60
|
+
|
|
61
|
+
7. **Present the Ads Health Score (0–100):**
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Ads Health Score: 61/100 — needs work
|
|
65
|
+
|
|
66
|
+
Category Score Top Issue
|
|
67
|
+
Tracking 45 Google conversion tag missing on /checkout
|
|
68
|
+
Wasted Spend 52 4 campaigns at 4-6x target CPA — $3,200/mo estimated waste
|
|
69
|
+
Structure 74 7 ad groups with single ads — no rotation testing
|
|
70
|
+
Creative 68 Meta creative sets showing 90%+ impression share (fatigue)
|
|
71
|
+
Budget 71 3 campaigns in learning phase — avoid budget changes
|
|
72
|
+
Compliance 90 —
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
8. **Prioritized action plan:**
|
|
76
|
+
- **P0** (immediate blockers): Broken tracking, policy violations, campaigns burning budget with zero conversions
|
|
77
|
+
- **P1** (high ROI quick wins): Kill Rule candidates, wasted spend, broken attribution
|
|
78
|
+
- **P2** (structural improvements): Campaign organization, bidding strategy, audience targeting
|
|
79
|
+
- **P3** (creative and testing): Copy refresh, A/B test setup, creative rotation
|
|
80
|
+
|
|
81
|
+
9. **Guide next step with AskUserQuestion** — specific to actual findings:
|
|
82
|
+
|
|
83
|
+
```xml
|
|
84
|
+
<invoke name="AskUserQuestion">
|
|
85
|
+
<parameter name="questions">[{
|
|
86
|
+
"question": "Ads Health Score: {X}/100. {p0_count} immediate blockers, {p1_count} high-ROI quick wins. Biggest issue: {top_finding}.",
|
|
87
|
+
"header": "What to fix first",
|
|
88
|
+
"multiSelect": false,
|
|
89
|
+
"options": [
|
|
90
|
+
{"label": "Fix {top_p0_issue} now (Recommended)", "description": "{specific fix — e.g., 'Add Google conversion tag to /checkout — without this, all ROAS data is wrong'}"},
|
|
91
|
+
{"label": "Pause {n} campaigns failing the 3x Kill Rule", "description": "{specific campaigns} spending {estimated_waste}/mo with {n} conversions — cut waste before optimizing"},
|
|
92
|
+
{"label": "Deep-dive into {lowest_category} ({score}/100)", "description": "Worst area — I'll walk through every finding with specific fixes"},
|
|
93
|
+
{"label": "Generate fresh ad copy to test against current", "description": "40+ headline/body/CTA variants for your top campaigns — use existing copy as the baseline"}
|
|
94
|
+
]
|
|
95
|
+
}]</parameter>
|
|
96
|
+
</invoke>
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Customize every option. Don't show kill rule option if no campaigns qualify. Don't show copy generation if they just came from the generate workflow.
|
|
100
|
+
|
|
101
|
+
## Output
|
|
102
|
+
|
|
103
|
+
Ads Health Score (0–100) with weighted category scores. Prioritized action plan (P0–P3). Platform-specific findings. Estimated wasted spend where calculable. Baseline for future audits.
|
|
104
|
+
|
|
105
|
+
## Fallbacks
|
|
106
|
+
|
|
107
|
+
**If AskUserQuestion is unavailable:**
|
|
108
|
+
Present options as a numbered list. Example:
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
What would you like to tackle first?
|
|
112
|
+
1. Fix the P0 issues now
|
|
113
|
+
2. Pause the Kill Rule campaigns
|
|
114
|
+
3. Deep-dive into the worst category
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**If agent spawning is unavailable:**
|
|
118
|
+
Run each analysis inline sequentially using the reference files in `references/`. Consolidate into the same output format — same result, just slower.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# Generate Workflow — Bulk Ad Copy Generation
|
|
2
|
+
|
|
3
|
+
**Triggers:** "generate ad copy", "write ads for my product", "create headline variants", "I need 40 ad variations", "bulk ad copy for Meta", "generate Google Ads headlines"
|
|
4
|
+
|
|
5
|
+
**Goal:** Produce 40+ headline, body, and CTA variants from a product description and ICP angles, formatted for direct platform upload (Meta bulk CSV, Google Ads Editor format).
|
|
6
|
+
|
|
7
|
+
## Inputs needed
|
|
8
|
+
|
|
9
|
+
| Input | Required | How to get it |
|
|
10
|
+
| ------------------- | -------- | ------------------------------------------------------------------- |
|
|
11
|
+
| product description | Yes | Ask for it if not provided |
|
|
12
|
+
| target platform | No | Already captured in opening flow — use that. Ask only if not known. |
|
|
13
|
+
| variant count | No | Default: 40. Ask only if they want a different number. |
|
|
14
|
+
| ICP angles | No | Auto-detect 5 from product description, then confirm |
|
|
15
|
+
|
|
16
|
+
## Steps
|
|
17
|
+
|
|
18
|
+
1. **If product description is not provided**, ask: _"What are you advertising? Paste your product description, landing page URL, or existing ad copy — I'll work from any of those."_ Accept any format.
|
|
19
|
+
|
|
20
|
+
2. **Don't re-ask about platform** if already captured in the opening flow. Use what you know. Only ask if platform is genuinely unknown:
|
|
21
|
+
|
|
22
|
+
_"Which platform should I optimize the format for? (or I can generate for all)"_
|
|
23
|
+
|
|
24
|
+
3. **Auto-detect 5 ICP angles** from the product description. Common angles:
|
|
25
|
+
- Pain-point-led: leads with the problem they're experiencing
|
|
26
|
+
- Outcome-focused: leads with the transformation or result
|
|
27
|
+
- Social-proof: authority, users, case studies
|
|
28
|
+
- Urgency/FOMO: time limit, scarcity, risk of inaction
|
|
29
|
+
- Feature-differentiated: specific capability competitors don't have
|
|
30
|
+
|
|
31
|
+
Show the angles and ask: _"I detected these 5 angles: [list]. Any you want to add or swap out?"_ Keep it conversational — if they say "looks good", move on immediately.
|
|
32
|
+
|
|
33
|
+
4. **Generate variants for each angle × each format:**
|
|
34
|
+
|
|
35
|
+
**Headlines:**
|
|
36
|
+
- Google: max 30 characters — problem-aware, solution-aware, benefit-led variants
|
|
37
|
+
- Meta: up to 40 characters — hook-first, curiosity-driven variants
|
|
38
|
+
- LinkedIn: professional tone, outcome-focused
|
|
39
|
+
|
|
40
|
+
**Body copy:**
|
|
41
|
+
- Short (1–2 sentences): matches headline angle, drives to CTA
|
|
42
|
+
- Long (3–4 sentences): expands on the angle with a proof point
|
|
43
|
+
|
|
44
|
+
**CTAs** (6–8 variants): action-oriented, urgency, curiosity — varied by platform norms
|
|
45
|
+
|
|
46
|
+
5. **Show the variants** as structured markdown organized by angle and format, with counts. Make them scannable — the user needs to read and react quickly.
|
|
47
|
+
|
|
48
|
+
6. **Generate platform-ready export files:**
|
|
49
|
+
- **Meta bulk upload CSV**: Campaign / Ad Set / Ad columns with all variants
|
|
50
|
+
- **Google Ads Editor format**: Campaign / Ad Group / Headline1–15 / Description1–4
|
|
51
|
+
|
|
52
|
+
7. **Guide next step with AskUserQuestion** — specific to what was generated:
|
|
53
|
+
|
|
54
|
+
```xml
|
|
55
|
+
<invoke name="AskUserQuestion">
|
|
56
|
+
<parameter name="questions">[{
|
|
57
|
+
"question": "{N} variants generated across {angle_count} ICP angles. Top recommended variants to test first: {top_3_variants}.",
|
|
58
|
+
"header": "What's next",
|
|
59
|
+
"multiSelect": false,
|
|
60
|
+
"options": [
|
|
61
|
+
{"label": "Save the platform CSV and wrap up (Recommended)", "description": "Export is ready — {platform} format with all {N} variants"},
|
|
62
|
+
{"label": "Regenerate the {weakest_angle} angle", "description": "That angle produced the weakest variants — I'll try different formulas"},
|
|
63
|
+
{"label": "Create A/B test pairs from the top 5 variants", "description": "Pair your strongest variants for head-to-head testing — one variable changed per pair"},
|
|
64
|
+
{"label": "Audit existing campaigns before launching these", "description": "Make sure tracking is working before investing in new copy — /agileflow:ads:track"}
|
|
65
|
+
]
|
|
66
|
+
}]</parameter>
|
|
67
|
+
</invoke>
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Output
|
|
71
|
+
|
|
72
|
+
Structured markdown with all variants organized by angle and format. Platform-ready CSV file(s). Total variant count. Recommended top 5 variants to test first based on formula strength.
|
|
73
|
+
|
|
74
|
+
## Fallbacks
|
|
75
|
+
|
|
76
|
+
**If AskUserQuestion is unavailable:**
|
|
77
|
+
Present options as a numbered list. Example:
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
What would you like to do next?
|
|
81
|
+
1. Save the CSV and wrap up
|
|
82
|
+
2. Regenerate a specific angle
|
|
83
|
+
3. Create A/B test pairs
|
|
84
|
+
```
|