ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity

feat(docs): add initial discovery documents for growth marketing 

Adds the complete set of discovery documents that define the foundation for the new Growth Marketing Expansion Pack.

These documents include:
- The project brief and guiding principles.
- Definitions for agent personas, frameworks, and templates.
- A knowledge base for the expansion pack.
- A guide for creating new expansion packs using the BMAD method.
This commit is contained in:
_rl_22_ 2025-09-12 22:48:45 -07:00
parent f09e282d72
commit 44d6d3dd5d
9 changed files with 1058 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

123
discovery-docs/agents.md Normal file
View File

@ -0,0 +1,123 @@
# BMAD Growth Marketing Agent Personas
This document provides a comprehensive overview of all specialized agent personas within the BMAD Growth Marketing Expansion Pack. The agents are organized by their primary Agent Team and categorized by their core function within the "Thinkers, Makers, and Doers" collective.
## **Growth Intelligence Agent**
This team is the strategic and analytical core, responsible for market insights, data analysis, and client-facing strategy.
### `growth-strategist`
* **Category**: Thinker
* **Description**: Acts as the strategic brain, synthesizing data to plan the overall direction of marketing efforts.
* **Key Responsibilities**:
* Synthesizes market data to plan the overall direction and prove marketing's ROI.
* Develops high-level growth roadmaps and campaign strategies.
* Performs foundational keyword research and competitor analysis.
* Helps close the loop between lead generation and revenue for B2B clients and SaaS companies.
### `data-analyst`
* **Category**: Thinker
* **Description**: Dives deep into quantitative data to uncover insights, measure performance, and inform strategy.
* **Key Responsibilities**:
* Analyzes large CSV files of user data to identify and define high-value customer segments.
* Manages and interprets metrics for frameworks like **AARRR (Pirate Metrics)** to pinpoint specific bottlenecks in the user funnel.
* Builds and maintains performance projection models for new campaigns.
### `account-manager`
* **Category**: Doer
* **Description**: Serves as the primary point of contact for agency clients, ensuring satisfaction and clear communication.
* **Key Responsibilities**:
* Uses Custom Analytics Dashboards and Performance Reports to communicate campaign results and value to clients.
* Gathers client feedback to inform the `project-manager` and `growth-strategist`.
* Ensures service delivery aligns with client expectations to address the pain point of client churn for the agency user segment.
***
## **Product Experience Agent**
This team owns the user's journey with the product, from strategic planning to design and high-level development.
### `product-strategist`
* **Category**: Thinker
* **Description**: Focuses on user experience and product-led growth from a strategic level.
* **Key Responsibilities**:
* Applies the **HEART framework** (Happiness, Engagement, Adoption, Retention, Task Success) to measure and improve the user experience.
* Defines the product-led growth strategy, ensuring product features drive user activation and retention.
* Works with the `growth-strategist` to validate product-market fit.
### `experience-designer`
* **Category**: Maker
* **Description**: Builds the user-facing assets where customers interact with the brand, focusing on user flow and conversion.
* **Key Responsibilities**:
* Creates website and landing page wireframes (low and high fidelity).
* Generates front-end code for A/B testing elements like buttons and headlines.
* Designs user flow diagrams for key conversion paths.
### `sr-frontend-dev`
* **Category**: Maker
* **Description**: Handles complex front-end implementation, mission-critical debugging, and performance optimization.
* **Key Responsibilities**:
* Refactors specific modules in the codebase to improve performance.
* Specializes in debugging mission-critical, multi-file bugs in user-facing flows.
* Writes production-quality code for UI components and new features.
***
## **Content & Community Agent**
This team is the voice of the brand, responsible for creating all content, defining the brand strategy, and engaging with the audience.
### `brand-strategist`
* **Category**: Thinker
* **Description**: Serves as the strategic guardian of the brand's identity, voice, and emotional connection with its audience.
* **Key Responsibilities**:
* Uses the **STP (Segmentation, Targeting, Positioning)** model to define the brand's unique position in the market.
* Develops the strategy for **Vibe Marketing** to cultivate a distinct brand feel and build community.
* Ensures the "Building in Public" narrative is authentic and aligns with core brand strategy.
### `content-creator`
* **Category**: Maker
* **Description**: Creates all user-facing content designed to attract, engage, and convert the target audience.
* **Key Responsibilities**:
* Writes SEO-optimized blog posts and long-form articles.
* Drafts copy for email newsletters and automated nurturing sequences.
* Generates social media content calendars and post templates.
### `community-manager`
* **Category**: Doer
* **Description**: Actively engages with the audience to build relationships, foster conversation, and turn customers into advocates.
* **Key Responsibilities**:
* Executes the Community Engagement Playbook to grow the user base.
* Implements the "Engage" and "Delight" stages of the **Flywheel Model**.
* Identifies and nurtures user-generated content and community contributions to help meet business goals.
***
## **Performance Marketing Agent**
This team is focused on execution and results, responsible for launching, managing, and optimizing paid marketing campaigns.
### `performance-marketer`
* **Category**: Doer
* **Description**: Manages the entire paid acquisition funnel, from technical setup and launch to ongoing optimization.
* **Key Responsibilities**:
* Generates ad copy and creative variations for platforms like Google and Meta.
* Runs pre-launch QA checks to ensure proper tracking, budgeting, and targeting.
* Drafts the HTML and CSS for simple, conversion-optimized landing pages.
***
## **Technology Integration Agent**
This team is the technical and operational backbone, ensuring all systems—both technological and human—run smoothly.
### `project-manager`
* **Category**: Doer
* **Description**: Manages the operational workflow of the entire collective, ensuring seamless collaboration and prioritization.
* **Key Responsibilities**:
* Triages incoming tasks and assigns them to the appropriate agents.
* Facilitates daily scrum stand-ups and sprint planning.
* Ensures that the "Smarketing" (Sales & Marketing Alignment) practices are followed to prevent friction in the customer journey.
### `automation-specialist`
* **Category**: Doer
* **Description**: Connects the marketing stack and automates processes to improve efficiency and data flow.
* **Key Responsibilities**:
* Writes Python scripts to automate data transfer between two APIs.
* Creates no-code automation workflows in tools like Zapier or Make.
* Generates plans for new data pipelines based on diagrams or briefs.

142
discovery-docs/bmad-kb.md Normal file
View File

@ -0,0 +1,142 @@
id: bmad-growth-marketing
name: BMAD Growth Marketing Expansion Pack
description: An AI orchestration framework that transforms how solo entrepreneurs, digital agencies, and consultancies approach growth marketing by providing specialized AI agent teams, adaptive workflows, and intelligent automation for the entire marketing lifecycle.
# BMAD Growth Marketing Knowledge Base
## Overview
The BMAD Growth Marketing Expansion Pack adapts the BMAD-Method framework for solo entrepreneurs, digital agencies, and marketing consultants. This extension provides specialized AI agent teams, adaptive workflows, and intelligent automation for the entire marketing lifecycle.
### Key Features
- **5 Specialized Agent Teams**: Growth Intelligence, Product Experience, Content & Community, Performance Marketing, and Technology Integration teams that work together seamlessly.
- **Adaptive Organizational Design**: The framework scales from a solo entrepreneur to agency-level operations without requiring complete rebuilds.
- **Tool-Agnostic Integration**: Connect any marketing tools and platforms best suited for your business model rather than forcing platform lock-in.
- **Systematic Growth Workflows**: Utilize proven marketing frameworks for everything from market analysis to campaign execution.
- **Discovery-Driven Onboarding**: A comprehensive workflow captures your business model and configures the optimal agent team structure to meet your objectives.
### When to Use BMAD Growth Marketing
- **Systematize Marketing Operations**: Build repeatable growth systems to move beyond manual, inconsistent marketing efforts.
- **Scale Agency Service Delivery**: Standardize service offerings, increase client retention, and scale team operations efficiently.
- **Develop Repeatable Growth Systems**: For solo entrepreneurs looking to increase MRR by 3-5x and prepare for team expansion.
- **Automate Content & Campaign Creation**: Generate ad copy, blog posts, social media content, and email sequences at scale.
- **Perform In-Depth Market Analysis**: Conduct comprehensive SEO audits, competitor analysis, and customer journey mapping.
- **Productize Marketing Expertise**: For consultants looking to scale beyond the "time-for-money" trap by creating systematized methodologies.
## How BMAD Growth Marketing Works
### The Core Method
BMAD Growth Marketing transforms you into a "Growth Strategist"—orchestrating specialized AI agent teams through the entire marketing lifecycle:
1. **You Strategize, AI Executes**: You provide the creative vision and business goals; agents handle the data analysis, content creation, and tactical execution.
2. **Specialized Agent Teams**: Each team masters one core aspect of growth: Intelligence, Product Experience, Content, Performance, or Technology.
3. **Structured Workflows**: Proven marketing frameworks guide your strategic process, ensuring a systematic and coherent approach to growth.
4. **Data-Driven Iteration**: Agents continuously analyze performance data to provide insights and recommendations for iterative refinement and optimization.
### The Three-Phase Approach
#### Phase 1: Strategy & Foundation
- Perform in-depth market and competitor analysis.
- Develop detailed customer personas and journey maps.
- Conduct keyword research and SEO opportunity analysis.
- Create a comprehensive growth strategy and campaign roadmap.
#### Phase 2: Execution & Implementation
- Generate SEO-optimized blog posts, website copy, and social media content calendars.
- Produce ad copy and creative variations for paid campaigns.
- Build automated email nurturing sequences and no-code automation workflows.
- Develop landing page wireframes and UI components for key conversions.
#### Phase 3: Analysis & Optimization
- Monitor campaign performance with custom analytics dashboards.
- Analyze user data to identify high-value customer segments for targeting.
- Simulate A/B tests for ad copy and landing pages to improve conversion rates.
- Refine strategy and re-allocate resources based on data-driven insights.
agent_teams:
- name: Growth Intelligence Agent
description: Specializes in data analysis, strategic planning, and generating market insights to inform growth strategy.
core_skills:
- Strategic analysis of large documents and reports.
- Data analysis and pattern recognition in structured data (CSVs).
- Competitor analysis and executive summarization.
- SEO auditing and keyword opportunity analysis.
- Customer persona development and journey mapping.
- name: Product Experience Agent
description: Focuses on the user journey, product-led growth, brand identity, and conversion-focused design and code.
core_skills:
- UI/UX wireframing and conversion-optimized design.
- Front-end code generation for A/B testing and UI components.
- Multi-file code debugging and refactoring for user-facing features.
- Brand identity and design system development.
- User flow diagramming and analysis.
- name: Content & Community Agent
description: Masters content creation, brand storytelling, and audience engagement across various platforms.
core_skills:
- High-volume, creative content generation (social media posts).
- Structured, brand-aligned content creation (blog post outlines).
- Multimodal analysis for design and content feedback (image analysis).
- SEO-optimized long-form content writing.
- Email copywriting and template creation.
- name: Performance Marketing Agent
description: Manages paid acquisition, conversion rate optimization (CRO), and data-driven campaign execution.
core_skills:
- Ad copy and headline generation for paid campaigns.
- Customer segmentation from large user datasets.
- Landing page code generation (HTML/CSS).
- Marketing automation and email sequence development.
- Lead magnet and asset creation.
- name: Technology Integration Agent
description: Handles the technical backbone of the marketing stack, including API integrations, automation, and system implementation.
core_skills:
- Production-quality scriptwriting for API integrations (Python).
- System architecture and data pipeline planning from diagrams.
- No-code automation workflow creation (Zapier, Make).
- Technical SEO implementation.
- AI-powered chatbot script development.
Key Architectural Components:
1. **Agents** (`/expansion-packs/bmad-growth-marketing/agents/`)
* **Purpose**: Each markdown file defines a specialized AI agent for a specific growth marketing role (e.g., Market Analyst, Content Strategist, Performance Marketer).
* **Structure**: Contains YAML headers specifying the agent's persona, capabilities, and dependencies.
* **Dependencies**: Lists tasks, templates, checklists, and data files the agent can use.
* **Startup Instructions**: Can load project-specific documentation (e.g., brand guidelines, campaign briefs) for immediate context.
2. **Agent Teams** (`/expansion-packs/bmad-growth-marketing/agent-teams/`)
* **Purpose**: Define collections of agents bundled together for specific marketing objectives.
* **Examples**: `team-all.yaml` (comprehensive growth team), `team-content-engine.yaml` (content creation focus).
* **Usage**: Creates pre-packaged contexts for executing complex marketing strategies.
3. **Workflows** (`/expansion-packs/bmad-growth-marketing/workflows/`)
* **Purpose**: YAML files defining prescribed sequences of steps for specific marketing initiatives.
* **Types**: Workflows for market analysis, campaign launches, content strategy development, and performance reporting.
* **Structure**: Defines agent interactions, artifacts created (e.g., reports, ad copy), and transition conditions.
4. **Reusable Resources**
* **Templates** (`/expansion-packs/bmad-growth-marketing/templates/`): Markdown templates for market analysis briefs, SEO audits, and content calendars.
* **Tasks** (`/expansion-packs/bmad-growth-marketing/tasks/`): Instructions for specific repeatable actions like "generate-ad-variations" or "analyze-competitor-traffic".
* **Checklists** (`/expansion-packs/bmad-growth-marketing/checklists/`): Quality assurance checklists for campaign pre-launch, SEO implementation, and content publishing.
* **Data** (`/expansion-packs/bmad-growth-marketing/data/`): Core knowledge base (this file), marketing frameworks, and persona documents.
frameworks:
- A complete, curated list of digital marketing frameworks is available in the knowledge base.
- See file: `/expansion-packs/bmad-growth-marketing/data/frameworks.md`
templates:
- This expansion pack includes a library of pre-built templates for generating key marketing deliverables.
- See file: `/expansion-packs/bmad-growth-marketing/templates/templates.md`
tasks:
- This expansion pack includes a library of repeatable tasks that can be executed by the agent teams.
- See directory: `/expansion-packs/bmad-growth-marketing/tasks/`

237
discovery-docs/brief.md Normal file
View File

@ -0,0 +1,237 @@
# Project Brief: BMAD Growth Marketing Expansion Pack
## Executive Summary
The BMAD Growth Marketing Expansion Pack is a revolutionary AI orchestration framework that transforms how solo entrepreneurs, digital agencies, and consultancies approach growth marketing. Built using Claude Code and inspired by the BMAD Method, it provides specialized AI agent teams, adaptive workflows, and intelligent automation for the entire marketing lifecycle. Unlike existing tools built for developers, this framework specifically targets marketers, founders, and creators who need tool-agnostic, AI-powered growth strategies that adapt to their unique business models and scale from solo operations to agency-level implementations.
## Problem Statement
Growth-minded entrepreneurs and small agencies face critical challenges in the modern marketing landscape:
- **Fragmented Tool Ecosystem**: Marketers juggle 15+ disconnected tools (HubSpot, Canva, Google Ads, Airtable, Zapier) spending $1,000+ monthly without integrated workflows or strategic coherence
- **Strategic Inconsistency**: 70% of small businesses lack coherent marketing strategies, jumping between tactics without systematic approaches to growth
- **AI Implementation Gap**: While AI tools exist, there's no framework for orchestrating multiple AI models into cohesive marketing operations specifically designed for non-technical marketers
- **Scaling Bottlenecks**: Solo entrepreneurs hit growth walls because they lack systematic approaches to delegate and systematize marketing operations as they scale
- **Generic Solutions**: Existing marketing automation platforms are built for large enterprises or developers, not the unique needs of bootstrapped entrepreneurs and small agencies
The market desperately needs an AI-first marketing framework that's tool-agnostic, entrepreneur-focused, and systematically scalable from individual to agency operations.
## Proposed Solution
The BMAD Growth Marketing Expansion Pack provides a complete AI-orchestrated marketing operating system through:
- **5 Specialized Agent Teams**: Growth Intelligence, Product Experience, Content & Community, Performance Marketing, and Technology Integration teams that work together seamlessly
- **Adaptive Organizational Design**: Framework scales from solo entrepreneur to agency operations without requiring complete rebuilds
- **Tool-Agnostic Integration**: Connect any MCPs and integrations best suited for specific business models rather than forcing platform lock-in
- **Multi-LLM Orchestration**: Leverage Claude, GPT, and Gemini models for specialized tasks through unified workflows
- **Discovery-Driven Onboarding**: Comprehensive workflow that captures business models, identifies growth objectives, and configures optimal agent team structures
- **Community-First Development**: Open-source approach building with and for the indie hacker community
This solution succeeds by treating marketing as a systematic craft requiring specialized AI orchestration, not generic automation.
## Target Users
### Primary User Segment: Solo Entrepreneurs ($10K-$50K ARR)
- **Profile**: Bootstrapped founders, course creators, SaaS builders, content creators with proven product-market fit
- **Current Workflow**: Manual social media posting, basic email marketing, sporadic content creation, reactive customer acquisition
- **Pain Points**: Wearing too many hats, inconsistent marketing execution, difficulty scaling beyond personal capacity
- **Goals**: Systematize marketing operations, increase MRR by 3-5x, build repeatable growth systems, prepare for team expansion
### Secondary User Segment: Digital Agencies ($50K-$100K ARR)
- **Profile**: 2-5 person agencies serving local businesses, consultants scaling beyond personal delivery, fractional marketing teams
- **Current Workflow**: Client work delivery, basic project management, manual reporting, limited systematization
- **Pain Points**: Client churn, difficulty scaling team, inconsistent service delivery, pricing pressure
- **Goals**: Standardize service delivery, increase client retention, scale team operations, command premium pricing
### Tertiary User Segment: Marketing Consultancies ($25K-$75K ARR)
- **Profile**: Experienced marketers transitioning to consulting, former agency employees building independent practices
- **Current Workflow**: One-on-one client consulting, custom strategy development, manual implementation oversight
- **Pain Points**: Time-for-money trap, difficulty productizing expertise, limited scalability
- **Goals**: Create systematized methodologies, develop recurring revenue, scale beyond personal delivery
## Goals & Success Metrics
### Business Objectives
- Build and validate framework through creator's own agency growth (primary validation)
- Achieve 500 active community members within 6 months of launch
- Generate 50+ community contributions (workflows, templates, integrations) by month 12
- Establish BMAD as the leading AI orchestration framework for growth marketing
- Develop foundation for future commercial offerings while maintaining open-source core
### User Success Metrics
- Average user monthly revenue growth increases by 40% within 90 days of implementation
- Marketing system setup time reduced from 2-3 months to 2-3 weeks
- User-reported confidence in marketing strategy increases to 85% "confident or very confident"
- 60% of users successfully implement at least 3 agent teams within first month
### Key Performance Indicators (KPIs)
- **Monthly Active Marketers**: Users who complete at least one full workflow per month
- **Agent Team Utilization**: Average number of agent teams actively used per user
- **Workflow Completion Rate**: Percentage of started onboarding workflows that reach full implementation
- **Community Contribution Rate**: Number of user-generated workflows, templates, and integrations per month
- **Creator Agency Growth**: Primary validation through creator's own agency scaling metrics
## MVP Scope
### Core Features (Must Have)
- **Complete Agent Team System**: All 5 agent teams (Growth Intelligence, Product Experience, Content & Community, Performance Marketing, Technology Integration) fully operational
- **End-to-End Onboarding Workflow**: Complete discovery process from business model capture through agent team configuration
- **Claude Code Integration**: Seamless integration with Claude Code framework for workflow execution
- **Template System**: All 8 core templates (client discovery, growth strategy, market analysis, content strategy) operational
- **Configuration Management**: Save/restore agent team configurations and project states
### Out of Scope for MVP
- Multi-LLM orchestration (Claude, GPT, Gemini) - Phase 2 feature
- Visual workflow builders or drag-and-drop interfaces
- Direct integrations with specific marketing tools (maintaining tool-agnostic approach)
- Mobile applications or standalone web interfaces
- Advanced analytics dashboards
- Multi-user collaboration features
### MVP Success Criteria
The MVP succeeds if the creator can use it to grow their own agency by 50% within 6 months while 25 beta users report "significantly improved" marketing systematization compared to their previous approaches.
## Post-MVP Vision
### Phase 2 Features
- **Multi-LLM Orchestration**: Integration with GPT-4, Gemini, and other models for specialized tasks
- **Advanced Workflow Library**: Community-contributed workflows for specific industries and use cases
- **Integration Marketplace**: Pre-built connectors for popular marketing tools while maintaining tool-agnostic core
- **Performance Analytics**: Unified dashboard showing marketing performance across all agent teams
### Long-term Vision
Within 2 years, BMAD Growth Marketing becomes the standard framework for AI-orchestrated marketing operations, with specialized variants for:
- E-commerce growth operations
- SaaS customer acquisition
- Content creator monetization
- Agency service delivery systematization
### Expansion Opportunities
- **BMAD Marketing Certification**: Professional certification program for AI-orchestrated marketing
- **Enterprise Licensing**: White-label solutions for larger agencies and consultancies
- **Industry Specializations**: Vertical-specific agent teams and workflows
- **Commercial Platform**: Premium hosted version with advanced features while maintaining open-source core
## Technical Considerations
### Platform Requirements
- **Primary Platform**: Command-line interface via Claude Code framework
- **Target OS**: Cross-platform (Windows, macOS, Linux) via CLI
- **Performance Requirements**: Handle complex multi-agent workflows with <500ms response time per agent interaction
### Technology Preferences
- **Framework**: Claude Code as primary orchestration layer
- **Agent Architecture**: Modular agent system with clear interfaces and communication protocols
- **Data Management**: YAML/JSON configuration files for agent teams and workflows
- **Integration Layer**: MCP (Model Context Protocol) connectors for tool integrations
### Architecture Considerations
- **Repository Structure**: Monorepo with clear separation of agent teams, workflows, templates, and core framework
- **Service Architecture**: Distributed agent system with centralized orchestration
- **Integration Requirements**: Claude API as primary LLM, extensible to other models in Phase 2
- **Security/Compliance**: Local execution model, no user data transmitted to third parties by default
## Constraints & Assumptions
### Constraints
- **Budget**: $0 initial development budget (bootstrapped), $200/month operational for Claude API costs
- **Timeline**: MVP launch in 2 months, Phase 2 in 4 months
- **Resources**: Solo developer (creator) with community contributions
- **Technical**: Must work within Claude Code framework limitations, no custom infrastructure initially
### Key Assumptions
- Target users are comfortable with command-line interfaces or can learn quickly
- Solo entrepreneurs and small agencies are ready for AI-first marketing approaches
- The growth marketing community will contribute to open-source development
- Claude Code framework provides sufficient capabilities for complex agent orchestration
- Users value systematic approaches over point solutions
## Risks & Open Questions
### Key Risks
- **Market Education**: Target users may not understand AI orchestration benefits vs. individual AI tools
- **Technical Complexity**: Command-line interface may limit adoption among less technical marketers
- **Community Adoption**: Open-source model depends on community contributions for long-term success
- **Claude Dependency**: Heavy reliance on Claude API creates availability and cost risks
### Open Questions
- Should we prioritize GUI development over CLI-first approach for broader adoption?
- How do we balance tool-agnostic philosophy with user desire for specific integrations?
- What's the optimal balance between framework flexibility and opinionated workflows?
- Should agent teams have distinct "personalities" or remain functionally focused?
### Areas Needing Further Research
- Optimal prompt engineering for consistent agent team coordination
- Market segmentation between different entrepreneur types (e-commerce, SaaS, services)
- Integration architecture for maintaining tool-agnostic approach
- Community contribution models that scale without quality degradation
## Appendices
### A. Market Research Summary
Based on analysis of existing solutions:
- **HubSpot/Marketo**: Enterprise-focused, expensive, rigid workflows ($1000+/month)
- **Zapier/Make**: Automation without strategic intelligence ($50-200/month)
- **Individual AI Tools**: ChatGPT, Claude, etc. lack marketing-specific orchestration ($20-100/month)
- **Market Gap**: No AI orchestration framework specifically designed for growth-minded entrepreneurs
### B. Creator Validation Plan
Using creator's own agency as primary validation:
- Implement full framework for agency operations
- Document growth metrics and operational improvements
- Share journey publicly through indie hacker community
- Use real results to attract beta users and contributors
### C. Success Measurement Framework
**Creator Agency Metrics**:
- Monthly Recurring Revenue growth
- Client acquisition cost reduction
- Service delivery efficiency improvements
- Team productivity increases
**Community Metrics**:
- GitHub stars and forks
- Active community members
- Contributed workflows and templates
- User success stories and case studies
## Next Steps
### Immediate Actions
1. Complete agent team interface definitions and test with creator's agency workflows
2. Implement full onboarding/discovery workflow with real business scenarios
3. Set up GitHub repository with proper documentation and contribution guidelines
4. Create demo workflows showing complete marketing strategy development
5. Begin documenting creator's agency transformation as primary case study
### Community Launch Strategy
This Project Brief provides the foundation for BMAD Growth Marketing Expansion Pack development. The unique approach of validating through creator's own agency growth provides authentic proof-of-concept that will resonate with the target indie hacker community.
Primary validation comes from creator success, secondary validation from community adoption and contribution.

139
discovery-docs/creating-an-expansion-pack.md Normal file
View File

@ -0,0 +1,139 @@
# Guide: Creating a BMAD Expansion Pack with the BMAD Method
This guide walks you through using the BMAD (Build Me a Dream) method to create your own expansion pack. This process is a form of "dogfooding," where we use the tool to build the tool.
## Phase 1: Ideation & Planning (Using the Product Owner Agent)
The first step is to define the purpose and scope of your expansion pack. We will use the **Product Owner (`po`)** agent from `bmad-core` to facilitate this.
### Step 1.1: Activate the Product Owner Agent
In your terminal, activate the `po` agent:
```bash
# This command is hypothetical, adapt to your BMAD alias
bmad activate po
```
### Step 1.2: Define the Project Brief
Work with the `po` agent to create a `project-brief-tmpl.yaml`. This will define the "what" and "why" of your expansion pack.
**Your Goal:** Answer the agent's questions to fill out the brief. Key sections are:
- **`problem_statement`**: What problem does your expansion pack solve?
- **`solution_statement`**: How does it solve the problem?
- **`target_users`**: Who will use this pack?
- **`key_features`**: List the core features (e.g., new agents, workflows, tasks).
- **`success_metrics`**: How do you know if it's successful?
**Example Interaction:**
```
You: "I want to create a new expansion pack for generating marketing copy."
PO Agent: "Excellent. Let's start with the problem statement. What specific challenge are marketing teams facing that this pack will address?"
```
The output of this step should be a completed `project-brief.yaml` file for your new expansion pack.
## Phase 2: Architecture & Design (Using the Architect Agent)
Now that you have a brief, you need to design the components of your expansion pack. We'll use the **Architect (`architect`)** agent.
### Step 2.1: Activate the Architect Agent
```bash
bmad activate architect
```
### Step 2.2: Create the Architecture Document
Provide the `project-brief.yaml` to the `architect` agent. Its job is to translate the brief into a technical design.
**Your Goal:** Work with the agent to define:
- **New Agents**: What are their names, roles, and capabilities? (e.g., `seo-analyst`, `copywriter`, `social-media-strategist`).
- **New Tasks**: What specific, single-purpose tasks will these agents perform? (e.g., `generate-headline`, `analyze-keywords`, `draft-tweet`).
- **New Workflows**: What multi-step processes will you create? (e.g., `blog-post-workflow`, `ad-campaign-workflow`).
- **Templates & Checklists**: What reusable templates (`ad-copy-tmpl.yaml`) or checklists (`seo-checklist.md`) are needed?
The output of this phase is an `architecture.yaml` document that serves as the blueprint for your expansion pack.
## Phase 3: Implementation (Using the Dev Agent)
This is where you create the actual files for your expansion pack. We'll use the **Developer (`dev`)** agent.
### Step 3.1: Activate the Dev Agent
```bash
bmad activate dev
```
### Step 3.2: Scaffold the Directory Structure
First, create the folder structure for your new pack.
```bash
mkdir -p expansion-packs/bmad-your-new-pack/{agents,agent-teams,checklists,data,tasks,templates,workflows}
```
### Step 3.3: Create Each Component
Use the `dev` agent to generate the content for each file defined in your `architecture.yaml`.
**Your Goal:** For each component, instruct the `dev` agent to create the file.
**Example Interaction (Creating an Agent):**
```
You: "Create a new agent file named 'copywriter.md' in the 'agents' folder. The agent's purpose is to write compelling marketing copy based on a brief."
Dev Agent: "Understood. Here is the draft for 'copywriter.md'. Please review the prompt and let me know if it meets the requirements."
```
Repeat this process for all agents, tasks, workflows, templates, and checklists. The `dev` agent should write the YAML and Markdown files for you.
## Phase 4: Testing & Refinement (Using the QA Agent)
Once the files are created, you need to test them. We'll use the **QA (`qa`)** agent.
### Step 4.1: Activate the QA Agent
```bash
bmad activate qa
```
### Step 4.2: Run Through a Workflow
Choose one of the workflows you created and try to execute it with the BMAD system.
**Your Goal:** Follow the workflow from start to finish, using the new agents and tasks.
**Example Interaction:**
```
You: "I am starting the 'blog-post-workflow'. The first step is to use the 'seo-analyst' agent to run the 'analyze-keywords' task."
QA Agent: "Acknowledged. Please provide the inputs for the 'analyze-keywords' task. I will be monitoring the output against the expected results defined in our test plan."
```
As you go, the `qa` agent will help you identify bugs, inconsistencies, or areas for improvement in your prompts, templates, and agent instructions.
## Phase 5: Documentation & Packaging
The final step is to create the user-facing documentation and configuration.
### Step 5.1: Create `config.yaml`
Create a `config.yaml` file in the root of your expansion pack directory. Fill in the metadata:
```yaml
name: bmad-your-new-pack
version: 0.1.0
short-title: Your New Pack
description: >-
A brief but clear description of what your expansion pack does.
author: Your Name
slashPrefix: bmad-ynp
```
### Step 5.2: Write the `README.md`
This is the most important piece of documentation. It should include:
- An overview of the pack.
- A list of the included agents and workflows.
- Installation and usage instructions.
- Example use cases.
You can use the **`dev`** or **`po`** agent to help you write a clear and comprehensive `README.md` based on all the components you've built.
---
By following this guide, you have successfully used the BMAD method to define, design, build, test, and document a new, ready-to-use expansion pack.

57
discovery-docs/frameworks.md Normal file
View File

@ -0,0 +1,57 @@
This is a complete, curated list of digital marketing frameworks, categorized by their primary use case, tailored for your clients: entrepreneurs, boutique digital agencies, and SaaS companies.
***
### **1. Meta-Frameworks for Strategic Alignment**
These models provide a holistic view of the business and marketing, ensuring that day-to-day activities serve a larger purpose.
* **Building in Public:** A strategic philosophy that involves transparently sharing a company's journey—including wins, failures, and metrics—to build community and trust.
* **Use Case:** Ideal for **entrepreneurs** and early-stage **SaaS companies** as a foundational content strategy. It's a low-cost, high-leverage way to attract an audience, get real-time feedback, and validate product-market fit.
* **The Flywheel Model:** Replaces the traditional linear funnel with a circular, self-sustaining model where customers are the engine of growth. It focuses on the stages of **Attract**, **Engage**, and **Delight**.
* **Use Case:** The perfect model for **SaaS companies** and subscription-based businesses. It emphasizes customer success and retention, showing that a great product and customer experience can drive a powerful referral engine.
* **Marketing & Sales Alignment (Smarketing):** A set of practices to ensure marketing and sales teams share the same goals, Ideal Customer Profile (ICP), and messaging.
* **Use Case:** Crucial for **SaaS companies** and **B2B agencies**. It helps close the loop between lead generation and revenue, proving marketing's ROI and preventing friction in the customer journey.
* **The 7 Ps Marketing Mix:** An extended version of the 4 Ps (Product, Price, Place, Promotion) that adds **P**eople, **P**rocess, and **P**hysical Evidence.
* **Use Case:** An excellent tool for **boutique digital agencies** to perform a comprehensive marketing audit. It forces a holistic view, revealing how customer support, website user experience, or even internal workflows affect the marketing outcome.
* **The STP Model:** A fundamental model for strategic planning: **S**egmentation, **T**argeting, and **P**ositioning.
* **Use Case:** Essential for all three client types at the beginning of a project. It ensures that marketing efforts are laser-focused on the right audience with the right message, preventing wasted time and resources.
***
### **2. Frameworks for Growth & Funnel Optimization**
These are for clients who have an existing product or service and need to scale. They are often more data-intensive.
* **AARRR (Pirate Metrics):** A funnel-based framework that tracks key metrics across the customer journey: **A**cquisition, **A**ctivation, **R**etention, **R**evenue, and **R**eferral.
* **Use Case:** The go-to for **SaaS companies** and **tech entrepreneurs**. It provides a clear, measurable framework to track growth and identify bottlenecks in the user journey. A boutique agency can use this to show a client exactly where their efforts are having the most impact.
* **RACE Framework:** Developed by Smart Insights, this model focuses on the customer journey: **R**each, **A**ct, **C**onvert, and **E**ngage.
* **Use Case:** Very popular with **boutique agencies** and **SaaS companies**. It provides a structured way to plan, manage, and measure digital marketing activities across the entire customer lifecycle, from initial brand awareness to post-purchase loyalty.
* **Growth Loops:** A modern framework that replaces the linear funnel with a self-reinforcing system where the output of one cycle becomes the input for the next.
* **Use Case:** Crucial for **SaaS companies** and tech startups. It’s a more sustainable and scalable model than traditional funnels. An agency can help a client identify and build these loops (e.g., a viral loop, a content loop) to drive compounding growth.
***
### **3. Frameworks for Content & Messaging**
These frameworks help clients communicate their value effectively to their target audience.
* **AIDA Model:** A classic copywriting model that guides the customer through a linear path: **A**ttention, **I**nterest, **D**esire, and **A**ction.
* **Use Case:** A foundational framework for all clients, especially **boutique agencies** crafting campaign messaging, email sequences, or landing page copy. It's a simple but powerful way to ensure every piece of communication is persuasive and goal-oriented.
* **The Content Marketing Funnel (TOFU, MOFU, BOFU):** This framework organizes content based on the customer's stage in the buying journey: **T**op of **F**unnel (awareness), **M**iddle of **F**unnel (consideration), and **B**ottom of **F**unnel (decision).
* **Use Case:** Essential for **SaaS companies** and **agencies** managing their clients' content strategies. It ensures content isn't just a list of blog posts but a cohesive system that nurtures a user from a curious visitor to a paying customer.
* **Vibe Marketing:** A philosophy for building an emotional connection and a distinct brand identity, often leveraging authenticity and community.
* **Use Case:** Particularly valuable for **entrepreneurs** and **boutique agencies** working with consumer-facing or lifestyle brands. It's about developing a unique brand "feel" through aesthetics, tone, and community.
***
### **4. Frameworks for Execution & Prioritization**
Once the strategy is set, these frameworks help teams stay focused and efficient.
* **Agile Marketing:** A project management methodology that uses short "sprints" and iterations to adapt quickly to changing market conditions or competitor moves.
* **Use Case:** Perfect for **boutique agencies** who manage multiple clients and need to be nimble. It helps break down departmental silos and allows teams to quickly respond to feedback and new data.
* **ICE Prioritization:** A simple scoring model for ranking ideas by **I**mpact, **C**onfidence, and **E**ase.
* **Use Case:** A fantastic tool for **entrepreneurs** and **SaaS growth teams** who have a long list of ideas but limited resources. It forces a clear, objective discussion about what to work on next, preventing "shiny object syndrome."
* **HEART Framework:** A methodology for measuring the user experience of digital products. It stands for **H**appiness, **E**ngagement, **A**doption, **R**etention, and **T**ask Success.
* **Use Case:** Primarily for **SaaS companies** and product teams. It helps them set clear, measurable goals for a product or feature, ensuring that changes lead to a better user experience and inform the product roadmap.

49
discovery-docs/guiding-principles.md Normal file
View File

@ -0,0 +1,49 @@
# 1 - BMAD Growth Marketing Guiding Principles
This document outlines the core philosophies and practical guidelines for using and extending the BMAD Growth Marketing Expansion Pack.
## 2 - Core Principles
These are the foundational beliefs that shape the strategic approach of this expansion pack.
### 3 - 1. We are Architects, Not Just Builders.
* **Why**: The most common failure in marketing is executing flawless tactics against a flawed strategy. True, sustainable growth is not accidental; it is architected.
* **How**: We embody this principle by leading with a "thinker-first" agent structure. Before a single piece of content is created or a campaign is launched, agents like the `growth-strategist` and `brand-strategist` are deployed to build a strategic blueprint using foundational frameworks.
### 3 - 2. We Build Systems, Not Just Campaigns.
* **Why**: A successful campaign produces a temporary lift; a successful system produces perpetual growth. Relying on isolated marketing efforts is a trap that limits scale and makes success impossible to replicate.
* **How**: This principle is the core of the Expansion Pack's design as a "marketing operating system". We create repeatable, scalable growth through structured workflows that connect specialized agents, turning marketing into a predictable and manageable function.
### 3 - 3. The Funnel is a Flywheel, Not a Pipeline.
* **Why**: The traditional linear funnel is a transactional model that ignores the immense growth potential of a happy, engaged customer base. A flywheel is a self-sustaining model where delighted customers become your most powerful marketing channel.
* **How**: We reject the linear funnel in favor of the **Flywheel Model (Attract, Engage, Delight)**. Our agent collective is built to manage this entire lifecycle, with agents like the `community-manager` dedicated to delighting users and turning them into advocates.
### 3 - 4. Data is Our Compass, Not Our Destination.
* **Why**: The goal of data is not to produce reports; it is to produce better decisions. Data's true purpose is to provide clear, actionable direction on the path to growth.
* **How**: We implement this principle by pairing a dedicated `data-analyst` with goal-oriented frameworks like **AARRR (Pirate Metrics)** and **HEART**. This ensures that data is always a tool for strategic navigation, guiding the entire collective toward measurable business outcomes.
### 3 - 5. We Are Conductors of an AI Orchestra, Not Soloists.
* **Why**: The power of AI is not in any single agent, but in the orchestration of many specialists. The human user's highest leverage is not in doing the work, but in conducting the orchestra.
* **How**: The user acts as the "Growth Strategist," providing the vision and strategic intent. The `project-manager` agent translates that vision into a coordinated plan for the entire ensemble of specialized "thinker," "maker," and "doer" agents, creating a powerful human-AI partnership.
## 2 - Practical Guidelines
These are the rules for designing and using the components of the Growth Marketing Expansion Pack.
### 3 - Agent Design Rules
* **Specialize by Team**: Every agent persona must belong to one of the five core teams (e.g., Growth Intelligence, Product Experience) to ensure clear lines of responsibility.
* **Categorize by Function**: Each agent should be categorized as a "Thinker" (strategy/analysis), "Maker" (creation), or "Doer" (implementation/optimization) to clarify their role in the workflow.
* **Promote Lean Operations**: Consolidate responsibilities into multi-functional personas to maintain an agile and efficient collective.
### 3 - Task Writing Rules
* **Be Atomic**: Each task must represent a single, granular action (e.g., `generate-ad-headlines`) that can be easily chained into larger workflows.
* **Define Inputs & Outputs**: Every task must have clearly defined inputs (what it needs to run) and outputs (what it produces).
* **Use Command-like Naming**: Task names should be verb-based to clearly communicate their action (e.g., `analyze-competitors`).
### 3 - Template Rules
* **Represent Key Deliverables**: Templates should correspond to the major, repeatable strategic documents and assets of the marketing process (e.g., `Quarterly Growth Strategy & Campaign Roadmap`).
* **Assign to a Primary Agent**: Each template must be owned by a primary agent team responsible for its generation and quality.
## 2 - Remember
The goal of these principles is to provide a systematic, strategic, and scalable approach to marketing. By adhering to them, you transform marketing from a series of disconnected tactics into a cohesive growth engine.

144
discovery-docs/kb/research001-sept11.md Normal file
View File

@ -0,0 +1,144 @@
# Strategic Summary: Market Position & Service Offering
**Date:** September 12, 2025
**Doc ID:** kb/research001-sept11.md
## Introduction
This document provides a strategic overview of the market landscape and defines a clear path forward by synthesizing competitive analysis with a detailed profile of our ideal customers. The insights gathered from analyzing inspirational competitors—who also represent our target market—serve to validate and enrich our understanding of the core problems we solve. The objective is to solidify our market position, refine our service offerings, and align our capabilities with the explicit needs of our target users.
---
## Market Landscape: Competitor & Inspiration Analysis
Our niche is populated by a mix of specialized agencies, talented freelancers, and founder-led studios. A common thread is a focus on serving tech-forward businesses with an emphasis on speed, design excellence, and increasingly, AI-driven efficiency.
[tool_call: write_file for absolute_path '/path/to/file.json' content='```json
[
{
"Company": "Noco Agency",
"ICP": "SaaS & tech companies",
"USP": "Design-first, no-code (Webflow) agency focused on performance & conversion.",
"Team Structure": "Full-stack, collaborative team."
},
{
"Company": "Late Checkout Agency",
"ICP": "Founders & executives at leading brands.",
"USP": "A design firm for the \"AI Age,\" specializing in AI-powered products that drive retention and word-of-mouth marketing.",
"Team Structure": "Founder-led, agile team."
},
{
"Company": "Boring Marketing",
"ICP": "Businesses looking to acquire profitable customers.",
"USP": "\"AI-Assisted SEO\" (SEO 2.0) approach that combines top-tier marketers with AI to drive growth.",
"Team Structure": "N/A"
},
{
"Company": "Edgar Allan",
"ICP": "Companies that want to move faster and market with confidence.",
"USP": "A collaborative Webflow agency that emphasizes storytelling to connect with customers.",
"Team Structure": "Collaborative, flat studio."
},
{
"Company": "Supafast",
"ICP": "SaaS and tech startups.",
"USP": "A focus on speed in branding, product, and web development to help startups seize opportunities and scale quickly.",
"Team Structure": "Founder-led, remote team."
},
{
"Company": "Drew Eastmead",
"ICP": "Mid-sized SaaS and healthcare companies.",
"USP": "A fast and reliable freelance Webflow partner with over 15 years of experience in digital marketing, analytics, SEO, content, and UX.",
"Team Structure": "Solo freelancer."
},
{
"Company": "Sergey Gavriluk",
"ICP": "Businesses in need of a high-quality Webflow site.",
"USP": "A certified Webflow expert with over 500 successful projects, offering top-notch services at reasonable prices.",
"Team Structure": "N/A"
},
{
"Company": "Macu Studio",
"ICP": "Small, ambitious teams and companies looking to scale.",
"USP": "An intentionally small, founder-led Webflow partner agency focused on making a big impact.",
"Team Structure": "Founder-led, small team."
},
{
"Company": "ShapesBySons",
"ICP": "Small businesses.",
"USP": "A web design and development team from Reykjavik, Iceland, dedicated to empowering small businesses.",
"Team Structure": "Two-person partnership."
},
{
"Company": "ProGeekTech",
"ICP": "Businesses that value their brand and are looking to undergo a strategic digital transformation.",
"USP": "Shaping \"tomorrow's digital experiences\" through AI-powered solutions, leading-edge design, and innovative marketing.",
"Team Structure": "Team-oriented, collaborative."
}
]
```
### Key Insights from the Landscape:
* **Platform Dominance:** Webflow is the clear platform of choice for modern, scalable websites.
* **Target Focus:** SaaS, tech startups, and small businesses are the primary clients.
* **Value Proposition:** Speed, high-quality design, and measurable results (conversions, growth) are key selling points.
* **Emerging Trend:** AI is moving from a buzzword to a core service offering (e.g., Late Checkout, Boring Marketing), validating the market\'s readiness for AI-driven marketing solutions.
* **Lean Structures:** Many successful players are small, founder-led, or freelance, confirming the viability and appeal of agile, expert-driven models.
---
## Target Audience Deep Dive
Our focus is on founders, solopreneurs, and agencies who are both our customers and our peers. They are technically adept and appreciate a product-led approach to growth.
**Ideal Customer Profile (ICP):** Founders, solopreneurs, and agencies serving entrepreneurs, small businesses, and growth-stage tech companies.
### Primary User Segment: Technical Founders with Marketing Experience
**Profile:** Solo entrepreneurs and small agency owners ($0-100K revenue) with a strong technical background and a design/product thinking ethos.
**Current Workflow:** Manually orchestrating 10+ marketing platforms, spending over $1,000 monthly on a fragmented and inefficient tool stack.
**Pain Points:**
* High cognitive load from constant context switching.
* Difficulty maintaining brand consistency across disparate channels.
* Inability to scale their authentic marketing voice as operations grow.
**Goals:**
* Build agentic marketing capabilities that operate semi-autonomously.
* Reduce tool management overhead by 70%.
* Maintain an authentic brand vibe while scaling growth operations.
### Secondary User Segment: Digital Agencies & Consultancies
**Profile:** Marketing agencies serving 5-20 clients and consultancies with growth marketing projects in the $1K-$15K range.
**Current Workflow:** Managing client-specific tool stacks, creating manual reports and strategies, and relying heavily on a network of freelance specialists.
**Pain Points:**
* Difficulty standardizing processes and service delivery across a diverse client base.
* High costs and unreliability associated with hiring freelance specialists.
* Inconsistent quality in strategic outputs.
**Goals:**
* Standardize service delivery to create a scalable, repeatable product.
* Reduce project delivery time by 40%.
* Increase client retention by providing consistent, high-value strategic insights.
---
## Strategic Synthesis & Opportunity
The market analysis directly validates the pain points and aspirations of our target users. The offerings of competitors like Noco and Supafast confirm the demand from tech founders for fast, high-quality web development and branding. However, their primary focus is on the delivery of assets, not the orchestration of the underlying growth engine.
This reveals our key opportunity. While competitors build the car, we are building the autonomous driver.
For Technical Founders: Our value proposition perfectly matches their pain points. Their frustration with "fragmented solutions" and "context switching" is the central problem our agentic marketing model solves. We are not just another tool; we are the integration layer that unifies their stack and scales their authentic voice, directly addressing their primary goals.
For Digital Agencies: The success of specialized, process-driven services like Boring Marketing's "30-day sprint" shows that agencies desire standardization. Our "Specialized Agent Teams" framework provides a clear structure for agencies to productize their services, reduce reliance on one-off freelancers, and deliver consistent strategic value—hitting all three of their stated goals.
Our unique position is not just in offering AI-powered services, but in providing a cohesive, agent-based system that reduces overhead, ensures consistency, and empowers our users to scale.

101
discovery-docs/mmao-research.md Normal file
View File

@ -0,0 +1,101 @@
Multi-Model Agent Orchestration Research
This document outlines a strategic approach for the BMAD Growth Marketing Expansion Pack's intelligent model routing. The goal is to optimize token usage and enhance agent performance by selecting the best model for a given task, based on a careful analysis of each provider's strengths and weaknesses.
1. Growth Intelligence Agent
This agent is responsible for high-level strategy, research, and analysis. Its tasks are often complex and involve large amounts of data, making models with large context windows and strong reasoning skills the best choice.
Task: Analyze a 50-page market research report to identify key trends and opportunities.
Recommended Model: Gemini 2.5 Pro
Rationale: This model's vast context window (up to 1M tokens) is uniquely suited for ingesting and processing large documents like PDFs without losing critical information. Its advanced reasoning ensures the output is a high-quality strategic analysis, not just a simple summary.
Task: Generate a concise executive summary of a competitor's quarterly earnings report.
Recommended Model: Claude Sonnet
Rationale: Sonnet provides a great balance of quality and speed. For a moderately complex summarization task, it delivers a high-quality, polished output much faster and more cost-effectively than Opus.
Task: Identify the top 10 questions customers ask about a product by analyzing a CSV file of customer support tickets.
Recommended Model: Gemini 2.5 Pro
Rationale: This task requires analyzing a structured dataset and identifying patterns. Gemini Pro's advanced reasoning and large context window are ideal for handling and making sense of a large, messy CSV file.
2. Product Experience Agent
This agent focuses on the user journey, product-led growth, and code-related tasks that enhance the user experience.
Task: Write boilerplate code for an A/B test implementation for a button in a new feature.
Recommended Model: Codex CLI with GPT-5 Mini
Rationale: This is a small, well-defined coding task. The most cost-effective and fastest model in the Codex family is the best choice here, as it can generate the required code snippet quickly without needing a deep understanding of the entire codebase.
Task: Debug a multi-file bug that is causing a user onboarding flow to fail.
Recommended Model: Claude Opus
Rationale: This is a mission-critical, complex task that requires precise debugging and a deep understanding of a codebase. Opus is the most capable model for this, as it is renowned for its ability to follow complex instructions and perform accurate, multi-file edits.
Task: Refactor a specific module in the codebase to improve performance.
Recommended Model: Codex CLI with GPT-5
Rationale: The full GPT-5 model is a top-tier coding model that provides high-quality, reliable code. It is an excellent choice for a focused task like refactoring where precision is key but a full-project analysis isn't needed.
3. Content & Community Agent
This agent handles tasks related to content creation and maintaining brand voice, often requiring a blend of creativity and consistency.
Task: Draft five social media post variations for a new blog article.
Recommended Model: Claude Haiku or Gemini 2.5 Flash-Lite
Rationale: This is a creative but low-complexity task. The fastest, most cost-effective models are perfect for this, allowing for quick, high-volume generation of content variations.
Task: Write a detailed blog post outline based on a brief, ensuring the output has a specific brand tone.
Recommended Model: Claude Sonnet
Rationale: Sonnet provides a good balance of creativity, intelligence, and speed. Its strong language capabilities make it an excellent choice for tasks that require a nuanced, well-structured output, such as content outlines.
Task: Analyze a screenshot of a draft social media ad and provide feedback on how to improve the design.
Recommended Model: Gemini 2.5 Pro
Rationale: This is a multimodal task that requires image analysis and nuanced feedback. Gemini Pro’s multimodal capabilities are best-in-class for this type of complex visual reasoning.
4. Performance Marketing Agent
This agent is focused on paid advertising, conversion rate optimization, and data-driven insights.
Task: Generate five different ad copy headlines for a Google Ads campaign based on a list of keywords.
Recommended Model: Codex CLI with GPT-5 Mini
Rationale: Ad copy generation is a high-volume, low-latency task. GPT-5 Mini's speed and low cost make it ideal for quickly generating many variations for A/B testing.
Task: Analyze a large CSV file of user data to identify a high-value customer segment.
Recommended Model: Gemini 2.5 Pro
Rationale: As with the Growth Intelligence agent, this task is data-intensive and requires advanced reasoning to find meaningful patterns. Gemini Pro's ability to handle large datasets and perform complex analysis is the best fit.
Task: Draft HTML and CSS for a simple landing page based on a design brief.
Recommended Model: Claude Sonnet or Codex CLI with GPT-5
Rationale: Both models are strong coders. Sonnet provides excellent output quality, while GPT-5 is a highly capable and precise coding model. The choice depends on whether you prefer Claude's more verbose, conversational output or GPT-5's direct, clean code.
5. Technology Integration Agent
This agent is focused on the technical backbone of the marketing stack, including API integrations and automation.
Task: Write a Python script to automate data transfer between two APIs.
Recommended Model: Claude Opus
Rationale: This task is complex and requires writing production-quality, reliable code. Opus is known for its precision and ability to deliver high-quality, bug-free code, which is critical for system integrations.
Task: Generate a plan for a new data pipeline based on a diagram.
Recommended Model: Claude Sonnet or Gemini 2.5 Pro
Rationale: Both models have strong vision and reasoning capabilities for analyzing a diagram. Sonnet is a great choice for balancing quality and cost, while Gemini Pro would provide the deepest analysis for the most complex scenarios.

66
discovery-docs/templates.md Normal file
View File

@ -0,0 +1,66 @@
# BMAD Growth Marketing Templates
This file contains a complete list of the pre-built deliverable templates available in the BMAD Growth Marketing Expansion Pack, organized by the primary agent team responsible for their execution.
## Growth Intelligence Agent
- **Comprehensive SEO Audit Report**
- **Description**: Generates a detailed report covering technical, on-page, and off-page SEO factors to identify areas for improvement.
- **Keyword Research & Content Opportunity Analysis**
- **Description**: Identifies high-value keywords and analyzes content gaps to create a data-driven content strategy.
- **Market & Competitor Analysis Brief**
- **Description**: Produces a concise brief summarizing the competitive landscape, market trends, and strategic opportunities.
- **Customer Persona & Journey Mapping Document**
- **Description**: Creates detailed customer personas and maps out their journey to identify key touchpoints and motivations.
- **Quarterly Growth Strategy & Campaign Roadmap**
- **Description**: Develops a strategic roadmap outlining key growth initiatives, campaigns, and KPIs for the upcoming quarter.
- **Custom Analytics Dashboard & Performance Report**
- **Description**: Designs and populates a custom dashboard to track key marketing metrics and generate performance reports.
## Product Experience Agent
- **Website & Landing Page Wireframes**
- **Description**: Creates low and high-fidelity wireframes focused on user experience and conversion optimization.
- **Conversion-Optimized Landing Page Template**
- **Description**: Generates a reusable landing page template with a strong focus on clear calls-to-action and CRO best practices.
- **Brand Identity Kit**
- **Description**: Develops a complete brand kit including logo concepts, color palette, and typography guidelines.
- **UI Component Kit for Web Development**
- **Description**: Creates a set of standardized UI components (buttons, forms, etc.) to ensure design consistency and speed up development.
- **User Flow Diagram for Key Conversions**
- **Description**: Maps out the step-by-step user journey for critical actions like sign-up, checkout, or onboarding.
## Content & Community Agent
- **Website Copy**
- **Description**: Writes persuasive and brand-aligned copy for key website pages like the homepage, about us, and services.
- **SEO-Optimized Blog Post & Long-Form Article**
- **Description**: Produces well-researched, long-form content optimized for search engines and audience engagement.
- **Social Media Content Calendar & Post Templates**
- **Description**: Plans and creates a schedule of social media content with reusable templates for various platforms.
- **Email Newsletter Template & Copy**
- **Description**: Designs and writes engaging email newsletters to nurture an audience and drive action.
- **Community Engagement Playbook**
- **Description**: Creates a strategic guide for building and engaging an online community around a brand or product.
## Performance Marketing Agent
- **Ad Copy & Creative Variations**
- **Description**: Generates multiple versions of ad copy and creative concepts for A/B testing on platforms like Google, Meta, and LinkedIn.
- **Automated Email Nurturing Sequence**
- **Description**: Builds multi-step email sequences for user onboarding, lead nurturing, or re-engagement campaigns.
- **Lead Magnet Asset Outline**
- **Description**: Creates the structure and outline for a valuable lead magnet, such as an ebook, checklist, or webinar.
- **Campaign Performance Projection Model**
- **Description**: Develops a model to forecast the potential performance and ROI of a marketing campaign based on key inputs.
## Technology Integration Agent
- **AI-Powered Chatbot Script**
- **Description**: Writes conversational scripts for chatbots to handle lead capture, customer support, and user qualification.
- **Personalized User Experience Flow**
- **Description**: Designs a system for delivering dynamic content or personalized experiences to website visitors based on their behavior.
- **No-Code Automation Workflow**
- **Description**: Creates automated workflows using tools like Zapier or Make to connect different apps and streamline processes.
- **Technical SEO Implementation Checklist**
- **Description**: Generates a detailed, actionable checklist for implementing technical SEO fixes and improvements on a website.