@onion-architect-ai/cli 4.1.0-beta.1 → 4.1.0-beta.2

package/templates/.cursor/commands/common/templates/business_context_template.md

@@ -0,0 +1,748 @@
+# Template de Arquitetura de Contexto de Negócio
+*Framework estratégico para organizar conhecimento de negócio para habilitar desenvolvimento de produto e sucesso do cliente baseados em IA*
+
+---
+
+## Propósito Deste Template
+
+Este template ajuda times de produto a projetar sua **Arquitetura de Contexto de Negócio** - a abordagem sistemática para organizar, estruturar e manter todo o conhecimento de negócio para que a IA possa entender seus clientes, produto e mercado tão bem quanto seus melhores membros da equipe.
+
+**Use este template para:**
+- Criar inteligência de negócio acessível para IA
+- Permitir que IA tome decisões de produto contextualmente apropriadas
+- Escalar conhecimento institucional entre times
+- Melhorar experiência do cliente através de personalização por IA
+- Acelerar produtividade de novos membros da equipe
+
+---
+
+## Perfil de Contexto de Negócio
+
+### Fundação da Empresa e Produto
+
+**Visão Geral da Empresa:**
+- **Company Name:** `[Your Company]`
+- **Industry:** `__________`
+- **Company Stage:** 
+  - [ ] Startup (Pre-Product Market Fit)
+  - [ ] Growth (Post-PMF, Scaling)
+  - [ ] Enterprise (Mature, Multiple Products)
+  - [ ] Legacy (Established, Optimizing)
+
+**Product Information:**
+- **Primary Product:** `__________`
+- **Product Category:** `__________`
+- **Target Market Size:** `__________`
+- **Business Model:** 
+  - [ ] SaaS Subscription
+  - [ ] Marketplace
+  - [ ] E-commerce
+  - [ ] Freemium
+  - [ ] Enterprise Licensing
+  - [ ] Other: `__________`
+
+**Revenue and Scale:**
+- **Annual Revenue Range:** `$________`
+- **Customer Count:** `________`
+- **Team Size:** `____` people
+- **Primary Growth Metrics:** `__________`
+
+---
+
+## Business Context Architecture Design
+
+**IMPORTANT: Create a multi-file structure with an index.md that links to separate files for each layer. Do NOT create one large file.**
+
+**Implementation Approach:**
+1. **First**: Create `index.md` with the business profile and layer links
+2. **Then**: Create individual files for each layer as needed
+3. **Finally**: Ensure all links in the index work correctly
+
+**File Naming Convention:**
+- Use UPPERCASE for generic business documentation files (e.g., `CUSTOMER_PERSONAS.md`)
+- Use lowercase for business-specific files (e.g., `business_profile.md`) 
+- Keep filenames descriptive and business-focused
+
+### Create an Index File First
+
+**Create: `index.md` (or `business_context.md`)**
+```markdown
+## Business Context Profile
+
+### Company and Product Foundation
+[Include the business profile information here]
+
+---
+
+## Layer 1: Customer Context Architecture
+
+- [Customer Personas](CUSTOMER_PERSONAS.md)
+- [Customer Journey](CUSTOMER_JOURNEY.md)
+- [Voice of Customer](VOICE_OF_CUSTOMER.md)
+
+## Layer 2: Product Context Architecture
+
+- [Product Strategy](PRODUCT_STRATEGY.md)
+- [Feature Catalog](FEATURE_CATALOG.md)
+- [Product Metrics](PRODUCT_METRICS.md)
+
+## Layer 3: Market and Competitive Context
+
+- [Competitive Landscape](COMPETITIVE_LANDSCAPE.md)
+- [Industry Trends](INDUSTRY_TRENDS.md)
+
+## Layer 4: Operational Business Context
+
+- [Sales Process](SALES_PROCESS.md)
+- [Messaging Framework](MESSAGING_FRAMEWORK.md)
+- [Customer Communication Guidelines](CUSTOMER_COMMUNICATION.md)
+
+[Include remaining sections: Context Integration, Success Measurement, Implementation Strategy]
+```
+
+## Layer 1: Customer Context Architecture
+
+### Customer Intelligence Framework
+
+**Create: `CUSTOMER_PERSONAS.md`**
+```markdown
+# Customer Personas
+
+## Primary Persona: [Persona Name]
+### Demographics
+- Role/Title: [e.g., Marketing Manager]
+- Company Size: [e.g., 50-200 employees]
+- Industry: [e.g., SaaS, E-commerce]
+- Experience Level: [e.g., 2-5 years in role]
+
+### Goals and Motivations
+- Primary Goals: What are they trying to achieve?
+- Success Metrics: How do they measure success?
+- Career Aspirations: What drives them professionally?
+
+### Pain Points and Challenges
+- Current Process: How do they solve this today?
+- Friction Points: Where do they struggle?
+- Constraints: What limits their options?
+
+### Technology Context
+- Tools Used: Current software stack
+- Technical Comfort: How technical are they?
+- Decision Process: How do they evaluate solutions?
+
+### Communication Preferences
+- Preferred Channels: Email, Slack, phone, etc.
+- Language Style: Formal, casual, technical
+- Information Density: Brief summaries vs detailed analysis
+
+### AI Interaction Notes
+- How should AI communicate with this persona?
+- What level of detail do they prefer?
+- What topics should AI avoid or emphasize?
+```
+
+**Create: `CUSTOMER_JOURNEY.md`**
+```markdown
+# Customer Journey Map
+
+## Awareness Stage
+### Trigger Events
+What causes customers to start looking for solutions?
+
+### Information Sources
+Where do they research solutions?
+
+### Key Questions
+What are they trying to understand?
+
+### Success Criteria
+How do they evaluate if a solution might work?
+
+## Evaluation Stage
+### Evaluation Criteria
+What factors do they consider most important?
+
+### Decision Makers
+Who influences the purchase decision?
+
+### Common Objections
+What concerns typically arise?
+
+### Proof Points
+What evidence do they need to see?
+
+## Onboarding Stage
+### First Success Milestones
+What needs to happen for them to feel successful?
+
+### Common Confusion Points
+Where do new customers typically struggle?
+
+### Adoption Patterns
+How do successful customers typically use the product?
+
+## Growth Stage
+### Expansion Opportunities
+How do customers typically grow their usage?
+
+### Advanced Use Cases
+What sophisticated workflows do power users develop?
+
+### Success Indicators
+What behaviors indicate a thriving customer?
+
+## Retention/Churn Patterns
+### Churn Risk Indicators
+Early warning signs of customer dissatisfaction
+
+### Recovery Strategies
+How to re-engage at-risk customers
+
+### Renewal Drivers
+What motivates customers to continue/expand?
+```
+
+### Customer Feedback Intelligence
+
+**Create: `VOICE_OF_CUSTOMER.md`**
+```markdown
+# Voice of Customer Intelligence
+
+## Common Praise Themes
+What do customers consistently love about the product?
+
+## Frequent Complaints
+What issues come up repeatedly in support/feedback?
+
+## Feature Request Patterns
+What enhancements do customers request most often?
+
+## Competitive Comparisons
+How do customers compare us to alternatives?
+
+## Language and Terminology
+- How do customers describe our product?
+- What industry terms do they use?
+- What internal jargon should AI avoid?
+
+## Communication Patterns
+- Formal vs casual communication preferences
+- Response time expectations by customer type
+- Escalation triggers and preferences
+```
+
+---
+
+## Layer 2: Product Context Architecture
+
+### Product Intelligence Framework
+
+**Create: `PRODUCT_STRATEGY.md`**
+```markdown
+# Product Strategy
+
+## Vision and Mission
+### Product Vision
+Where is the product going in 2-3 years?
+
+### Mission Statement
+What problem does the product solve?
+
+### Success Definition
+How do you measure product success?
+
+## Market Position
+### Competitive Landscape
+- Direct Competitors: [List and brief description]
+- Indirect Competitors: [Alternative solutions]
+- Competitive Advantages: [What differentiates you]
+
+### Market Trends
+- Industry Evolution: How is the market changing?
+- Technology Trends: What tech trends affect the product?
+- Customer Behavior Changes: How are users evolving?
+
+## Strategic Priorities
+### Current Quarter Focus
+What are the top 3 product priorities?
+
+### Annual Objectives
+What must be achieved this year?
+
+### Future Roadmap Themes
+What major capabilities are planned?
+
+## Product Principles
+### Design Principles
+What guides product design decisions?
+
+### Trade-off Framework
+How do you prioritize competing demands?
+
+### Quality Standards
+What level of quality is required?
+```
+
+**Create: `FEATURE_CATALOG.md`**
+```markdown
+# Feature Catalog
+
+## Core Features
+### [Feature Name]
+**Purpose:** Why does this feature exist?
+**User Benefit:** What value does it provide?
+**Usage Patterns:** How do customers typically use it?
+**Success Metrics:** How do you measure feature success?
+**Limitations:** What can't it do?
+**Common Issues:** What problems do users face?
+**AI Considerations:** How should AI discuss this feature?
+
+## Advanced Features
+[Same template as above for sophisticated capabilities]
+
+## Experimental Features
+[Features in beta or testing phases]
+
+## Deprecated Features
+[Features being phased out or removed]
+
+## Integration Capabilities
+### Third-party Integrations
+What external tools does the product connect with?
+
+### API Capabilities
+What can developers build with your APIs?
+
+### Data Import/Export
+How do customers get data in and out?
+```
+
+### Product Performance Intelligence
+
+**Create: `PRODUCT_METRICS.md`**
+```markdown
+# Product Metrics Framework
+
+## User Engagement Metrics
+- Daily/Monthly Active Users
+- Feature Adoption Rates
+- User Session Patterns
+- Retention Curves
+
+## Business Performance Metrics
+- Revenue per Customer
+- Customer Acquisition Cost
+- Lifetime Value
+- Churn Rates
+
+## Product Quality Metrics
+- Bug Report Trends
+- Performance Benchmarks
+- User Satisfaction Scores
+- Support Ticket Volume
+
+## Feature Performance
+### High-Performing Features
+Which features drive the most engagement/value?
+
+### Underperforming Features
+Which features need attention or improvement?
+
+### Usage Correlation Patterns
+Which features are used together successfully?
+```
+
+---
+
+## Layer 3: Market and Competitive Context
+
+### Market Intelligence Framework
+
+**Create: `COMPETITIVE_LANDSCAPE.md` (CONDITIONAL)**
+```markdown
+Required if:
+- [ ] Competitive market with multiple players
+- [ ] Frequent competitive positioning needed
+- [ ] Sales team needs competitive talking points
+- [ ] Product decisions influenced by competitive moves
+
+# Competitive Landscape
+
+## Direct Competitors
+### [Competitor Name]
+**Strengths:** What do they do well?
+**Weaknesses:** Where do they fall short?
+**Positioning:** How do they market themselves?
+**Pricing:** How do they price their solution?
+**Customer Overlap:** Do you compete for the same customers?
+**Differentiation:** How are you different/better?
+
+## Competitive Positioning Framework
+### Win/Loss Analysis
+Why do you win deals? Why do you lose them?
+
+### Competitive Messaging
+How should AI position the product against competitors?
+
+### Objection Handling
+Common competitive objections and responses
+```
+
+**Create: `INDUSTRY_TRENDS.md`**
+```markdown
+# Industry and Market Trends
+
+## Industry Evolution
+### Current State
+How would you describe the industry today?
+
+### Emerging Trends
+What changes are happening in the market?
+
+### Future Predictions
+Where is the industry heading?
+
+## Technology Impact
+### Disruptive Technologies
+What technologies could change the landscape?
+
+### Adoption Patterns
+How quickly does the industry adopt new solutions?
+
+## Regulatory Environment
+### Current Regulations
+What rules govern the industry?
+
+### Compliance Requirements
+What standards must products meet?
+
+### Regulatory Trends
+How might regulations change?
+```
+
+---
+
+## Layer 4: Operational Business Context
+
+### Sales and Marketing Intelligence
+
+**Create: `SALES_PROCESS.md`**
+```markdown
+# Sales Process and Methodology
+
+## Sales Methodology
+### Sales Process Stages
+1. Lead Qualification
+2. Discovery Process
+3. Solution Presentation
+4. Negotiation
+5. Closing
+
+### Qualification Criteria
+What makes a good lead/prospect?
+
+### Common Sales Objections
+- Price/Budget Concerns
+- Feature/Capability Questions
+- Competitive Comparisons
+- Implementation Concerns
+
+### Sales Enablement Materials
+- Demo Scripts and Flows
+- ROI/Business Case Templates
+- Competitive Battle Cards
+- Implementation Timelines
+
+## Customer Success Patterns
+### Onboarding Best Practices
+How do successful customers get started?
+
+### Expansion Opportunities
+When and how do customers typically expand?
+
+### Renewal Strategy
+What ensures customers renew/continue?
+```
+
+**Create: `MESSAGING_FRAMEWORK.md`**
+```markdown
+# Messaging and Brand Framework
+
+## Brand Voice and Tone
+### Brand Personality
+How should the brand sound and feel?
+
+### Tone Guidelines
+- Professional vs Casual
+- Technical vs Accessible
+- Confident vs Humble
+- Formal vs Friendly
+
+### Voice Characteristics
+What makes your brand voice distinctive?
+
+## Core Messaging
+### Value Proposition
+What's the primary value you deliver?
+
+### Key Messages
+What are the 3-5 most important things to communicate?
+
+### Proof Points
+What evidence supports your claims?
+
+## Messaging by Audience
+### Enterprise Customers
+How do you message to large organizations?
+
+### SMB Customers
+How do you message to smaller businesses?
+
+### Technical Buyers
+How do you message to technical decision makers?
+
+### Business Buyers
+How do you message to business stakeholders?
+
+## Content Guidelines
+### Topics to Emphasize
+What subjects should AI prioritize in communications?
+
+### Topics to Avoid
+What subjects should AI be careful about?
+
+### Communication Style
+How formal/informal should AI communications be?
+```
+
+---
+
+## Context Integration and AI Optimization
+
+### AI Interaction Guidelines
+
+**Create: `CUSTOMER_COMMUNICATION.md`**
+```markdown
+# AI Customer Communication Guidelines
+
+## Communication Principles
+### Primary Objectives
+- Solve customer problems efficiently
+- Maintain brand voice and values
+- Create positive customer experiences
+- Escalate appropriately when needed
+
+### Tone and Style
+- Professional but approachable
+- Confident but not arrogant
+- Helpful and solution-oriented
+- Empathetic to customer concerns
+
+## Response Guidelines
+### Information Accuracy
+- Always provide accurate, up-to-date information
+- Acknowledge limitations and uncertainties
+- Direct to appropriate resources when needed
+
+### Escalation Triggers
+When should AI escalate to humans?
+- Complex technical problems
+- Billing or contract issues
+- Customer expressing frustration
+- Requests outside AI capabilities
+
+### Privacy and Security
+- What customer information can AI access?
+- How should AI handle sensitive data?
+- What topics require extra privacy consideration?
+
+## Personalization Strategy
+### Customer Segmentation
+How should AI adapt communication by customer type?
+
+### Context Utilization
+How should AI use customer history and preferences?
+
+### Relationship Building
+How should AI contribute to long-term customer relationships?
+```
+
+### Success Measurement Framework
+
+**Business Context Quality Metrics**
+```markdown
+File: `/business-context/measurement/QUALITY_METRICS.md`
+Purpose: Measuring business context effectiveness
+
+Template:
+# Business Context Quality Metrics
+
+## AI Performance Metrics
+### Customer Interaction Quality
+- Customer satisfaction with AI interactions
+- Resolution rate for AI-handled inquiries
+- Escalation rate to human agents
+- Response accuracy and relevance
+
+### Sales and Marketing Effectiveness
+- Lead qualification accuracy
+- Message consistency across channels
+- Conversion rate improvements
+- Customer feedback on AI interactions
+
+## Business Impact Metrics
+### Customer Success
+- Faster customer onboarding
+- Improved customer retention
+- Increased customer satisfaction scores
+- Reduced support ticket volume
+
+### Team Productivity
+- New team member ramp-up time
+- Cross-functional collaboration effectiveness
+- Consistent decision-making across teams
+- Reduced time spent explaining context
+
+## Context Health Metrics
+### Information Currency
+- How often is business context updated?
+- Are customer insights current and relevant?
+- Is competitive information up-to-date?
+
+### Usage and Adoption
+- How often do teams reference business context?
+- Are AI systems effectively using context?
+- Is context helping improve business outcomes?
+```
+
+---
+
+## Business Context File Organization
+
+### Recommended File Structure
+
+**Business context file structure for optimal AI consumption:**
+```
+/specs/business/                 # or /docs/business-context/
+  index.md                      # Main index with links to all layers
+  CUSTOMER_PERSONAS.md          # Layer 1: Customer intelligence
+  CUSTOMER_JOURNEY.md           # Layer 1: Customer lifecycle
+  VOICE_OF_CUSTOMER.md          # Layer 1: Customer feedback
+  PRODUCT_STRATEGY.md           # Layer 2: Product context
+  FEATURE_CATALOG.md            # Layer 2: Feature details
+  PRODUCT_METRICS.md            # Layer 2: Performance data
+  COMPETITIVE_LANDSCAPE.md      # Layer 3: Market intelligence
+  INDUSTRY_TRENDS.md            # Layer 3: Market evolution
+  SALES_PROCESS.md              # Layer 4: Sales methodology
+  MESSAGING_FRAMEWORK.md        # Layer 4: Brand guidelines
+  CUSTOMER_COMMUNICATION.md     # Layer 4: AI interaction guide
+```
+
+**Key Benefits of This Business Structure:**
+- **Customer-Centric**: Organizes information around customer understanding
+- **Scalable**: Easy to update specific business areas without affecting others
+- **AI-Accessible**: Clear naming and focused content for better AI comprehension
+- **Cross-Functional**: Different teams can maintain their domain expertise
+- **Actionable**: Provides concrete guidance for customer interactions and decisions
+
+### Integration with Technical Documentation
+
+**Cross-Reference Strategy:**
+- Business context informs technical priorities and decisions
+- Technical constraints influence business strategy and messaging
+- Customer feedback drives both product and technical roadmaps
+- AI systems can access both business and technical context for comprehensive understanding
+
+---
+
+## Implementation and Maintenance Strategy
+
+### Ownership and Governance
+
+**Context Ownership Matrix**
+- **Customer Personas:** Product/Marketing - Quarterly review
+- **Customer Journey:** Customer Success - As customer patterns evolve
+- **Product Strategy:** Product Leadership - Semi-annual strategic reviews
+- **Feature Catalog:** Product Management - Monthly updates
+- **Competitive Analysis:** Marketing/Sales - Quarterly updates
+- **Messaging Framework:** Marketing - As needed for campaigns
+
+### Update Triggers and Processes
+
+**When to Update Business Context:**
+- [ ] New customer segment discovered
+- [ ] Product feature launches or changes
+- [ ] Competitive landscape shifts
+- [ ] Customer feedback patterns change
+- [ ] Business model or strategy evolution
+- [ ] Market conditions or trends change
+- [ ] Regulatory environment changes
+
+### Quality Assurance Framework
+
+**Business Context Review Checklist:**
+- [ ] Information reflects current business reality
+- [ ] Customer insights are based on recent data
+- [ ] Competitive information is current and accurate
+- [ ] AI can understand and apply the context
+- [ ] Cross-functional teams can use effectively
+- [ ] Privacy and compliance requirements met
+
+---
+
+## Customization Guidelines
+
+### For Different Business Models
+
+**B2B SaaS:**
+- Emphasize enterprise sales processes and customer success
+- Include detailed feature adoption and expansion patterns
+- Focus on competitive differentiation and ROI messaging
+
+**B2C E-commerce:**
+- Emphasize customer behavior patterns and personalization
+- Include seasonal trends and promotional strategies
+- Focus on conversion optimization and customer lifetime value
+
+**Marketplace Platforms:**
+- Include both buyer and seller perspectives
+- Document network effects and growth patterns
+- Focus on trust, safety, and transaction optimization
+
+**Freemium Products:**
+- Document conversion paths from free to paid
+- Include usage patterns that predict conversion
+- Focus on value demonstration and upgrade triggers
+
+### For Different Company Stages
+
+**Early Stage (Pre-PMF):**
+- Focus on customer discovery and validation
+- Emphasize experimentation and learning
+- Keep documentation lightweight but systematic
+
+**Growth Stage (Post-PMF):**
+- Emphasize scaling and optimization
+- Include detailed customer segmentation
+- Focus on repeatable processes and playbooks
+
+**Enterprise Stage:**
+- Include comprehensive competitive analysis
+- Emphasize compliance and governance
+- Focus on cross-functional coordination
+
+---
+
+## Template Validation and Evolution
+
+This business context architecture should be regularly evaluated for:
+- **Relevance:** Does it reflect current business reality?
+- **Completeness:** Does it cover all critical business knowledge?
+- **Usability:** Can teams and AI effectively use this context?
+- **Impact:** Is it improving business outcomes?
+
+Regular template updates should incorporate:
+- **Customer feedback and behavior changes**
+- **Market evolution and competitive dynamics**
+- **Product development and strategic shifts**
+- **AI capability improvements and new use cases**