Framework Agent

The Framework Agent is a specialized AI expert trained on the complete Waymaker methodology library. It provides strategic guidance using 28+ proven business frameworks and Resolute Leadership principles.

Endpoint

POST /v1/framework

Overview

The Framework Agent acts as a strategic methodology expert, automatically:

• Analyzing business challenges to identify root issues
• Selecting optimal frameworks from the Waymaker library
• Providing implementation guidance with phase-by-phase instructions
• Integrating Resolute Leadership principles for effective execution

Request Format

Headers

Header	Required	Description
Authorization	Yes*	Bearer token from Waymaker authentication
apikey	Yes*	API key for external applications
Content-Type	Yes	Must be application/json

*Either Authorization or apikey is required

Request Body

Uses the same format as the Coordination Endpoint:

interface FrameworkRequest {
  messages: Array<{
    role: 'user' | 'assistant' | 'system';
    content: string;
  }>;
  userContext?: {
    industry?: string;
    businessStage?: 'startup' | 'growth' | 'enterprise';
    role?: string;
    previousWork?: any[];
  };
  preferences?: {
    responseStyle?: 'concise' | 'detailed' | 'tactical';
    maxCredits?: number;
  };
  sessionId?: string;
}

Response Format

Enhanced Response Structure

The Framework Agent provides additional metadata and structured outputs:

interface FrameworkResponse {
  content: string; // Formatted markdown response with framework guidance
  metadata: {
    sessionId: string;
    agent: 'one-framework-expert';
    primaryFramework: string;
    supportingFrameworks: string[];
    complexityLevel: 'basic' | 'intermediate' | 'advanced' | 'expert';
    confidenceScore: number; // 0-100
    resolutePrinciples: string[];
    creditsUsed: 5; // Premium rate for expert guidance
    processingTimeMs: number;
    businessContextAnalysis: {
      industryFocus: string;
      stageAlignment: string;
      keyChallenge: string;
      strategicPriority: string;
    };
  };
  structuredOutput: {
    frameworkAnalysis: {
      primaryFramework: string;
      supportingFrameworks: string[];
      resolutePrinciples: string[];
      strategicRationale: string;
      complexityAssessment: string;
      confidenceScore: number;
    };
    expertGuidance: {
      methodologyApplication: Array<{
        phase: string;
        strategicQuestions: string[];
        expectedInsights: string;
        deliverables: string[];
      }>;
      strategicActions: string[];
      businessOutcomes: string[];
      successMetrics: string[];
      implementationTimeline: string;
      integrationOpportunities: string[];
    };
  };
}

Waymaker Framework Library

Strategic Planning Frameworks

Core Strategy

• Strategy Canvas: Strategic positioning and competitive differentiation
• Vision Canvas: Long-term vision and purpose alignment
• One-Page Plan: Comprehensive strategic planning on a single page

Business Model Design

• Business Model Canvas: Business model innovation and validation
• Value Proposition Canvas: Value creation and customer alignment
• Revenue Model Canvas: Revenue stream optimization

Customer Experience Frameworks

Customer Intelligence

• Ideal Customer Canvas: Customer targeting and segmentation
• Customer Promise Canvas: Value delivery and brand positioning
• Customer Journey Canvas: End-to-end customer experience mapping

Market Analysis

• Competitive Analysis Canvas: Competitive positioning and differentiation
• Market Opportunity Canvas: Market size and opportunity assessment
• Brand Strategy Canvas: Brand positioning and messaging

Employee Experience Frameworks

Organizational Design

• Employee Journey Canvas: Employee experience optimization
• Employee Promise Canvas: Employer brand and value proposition
• Values/Principles/Behaviors: Culture design and implementation

Team Operations

• Roles Canvas: Role clarity and accountability
• Goals Canvas: Goal setting and performance management
• Meeting Canvas: Meeting effectiveness and productivity

Operational Excellence Frameworks

Financial Management

• Finance Plan Canvas: Financial planning and cash flow management
• P&L Canvas: Profit and loss optimization
• Pricing Canvas: Pricing strategy and optimization

Growth Operations

• Marketing Plan Canvas: Marketing strategy and execution
• Sales Plan Canvas: Sales process and pipeline management
• Growth Canvas: Growth strategy and scaling

Performance Management

• Data Canvas: Data strategy and analytics
• Process Canvas: Process improvement and automation
• Quality Canvas: Quality management and continuous improvement

Resolute Leadership Integration

The 7 Questions of Leadership

1. Vision: Where are we going?
2. Values: What do we stand for?
3. Strategy: How will we get there?
4. Structure: How will we organize?
5. Systems: What processes will support us?
6. Skills: What capabilities do we need?
7. Style: How will we lead?

The 5 Questions of Management

1. Planning: What needs to be done?
2. Organizing: How should we structure?
3. Staffing: Who should do what?
4. Directing: How do we guide execution?
5. Controlling: How do we measure progress?

Automatic Framework Selection

The agent uses advanced business intelligence to automatically select frameworks:

Selection Criteria

1. Business Context Analysis

   • Industry vertical and specific challenges
   • Business stage (startup, growth, enterprise)
   • Organizational role and responsibilities

2. Challenge Pattern Recognition

   • Strategic vs. operational issues
   • Customer vs. employee focus
   • Planning vs. execution needs

3. Framework Complexity Matching

   • User experience level
   • Available time and resources
   • Organizational readiness

4. Integration Opportunities

   • Complementary framework combinations
   • Sequential framework application
   • Cross-functional alignment needs

Usage Examples

Strategic Planning Request

const response = await fetch('https://api.waymakerone.com/v1/framework', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'Our startup needs help with strategic planning. We have a SaaS product but struggle with market positioning and competitive differentiation.'
    }],
    userContext: {
      industry: 'software',
      businessStage: 'startup',
      role: 'founder'
    },
    preferences: {
      responseStyle: 'detailed'
    }
  })
});

const result = await response.json();

Example Response

{
  "content": "# Strategic Planning Framework Recommendation\n\nBased on your SaaS startup's challenges with market positioning and competitive differentiation, I recommend starting with the **Strategy Canvas** as your primary framework...",
  "metadata": {
    "sessionId": "session_framework_123",
    "agent": "one-framework-expert",
    "primaryFramework": "Strategy Canvas",
    "supportingFrameworks": ["Competitive Analysis Canvas", "Value Proposition Canvas"],
    "complexityLevel": "intermediate",
    "confidenceScore": 92,
    "resolutePrinciples": ["Vision", "Strategy", "Values"],
    "creditsUsed": 5,
    "processingTimeMs": 2100,
    "businessContextAnalysis": {
      "industryFocus": "SaaS technology",
      "stageAlignment": "product-market fit",
      "keyChallenge": "competitive differentiation",
      "strategicPriority": "market positioning"
    }
  },
  "structuredOutput": {
    "frameworkAnalysis": {
      "primaryFramework": "Strategy Canvas",
      "supportingFrameworks": ["Competitive Analysis Canvas", "Value Proposition Canvas"],
      "resolutePrinciples": ["Vision", "Strategy", "Values"],
      "strategicRationale": "Strategy Canvas provides comprehensive competitive positioning analysis essential for SaaS differentiation",
      "complexityAssessment": "Intermediate complexity suitable for startup stage with clear deliverables",
      "confidenceScore": 92
    },
    "expertGuidance": {
      "methodologyApplication": [
        {
          "phase": "Current State Analysis",
          "strategicQuestions": [
            "What are our current strategic assumptions?",
            "How do customers currently perceive our value?",
            "What factors do we compete on today?"
          ],
          "expectedInsights": "Clear understanding of current competitive position",
          "deliverables": ["Current strategy canvas", "Competitive factor analysis"]
        }
      ],
      "strategicActions": [
        "Map your current strategic position",
        "Analyze competitor strategies",
        "Identify blue ocean opportunities"
      ],
      "businessOutcomes": [
        "Clear competitive differentiation",
        "Focused market positioning",
        "Strategic decision framework"
      ],
      "successMetrics": [
        "Market positioning clarity score",
        "Competitive differentiation index",
        "Strategic alignment percentage"
      ],
      "implementationTimeline": "2-3 weeks for comprehensive strategy canvas development",
      "integrationOpportunities": [
        "Follow with Value Proposition Canvas for customer alignment",
        "Use Competitive Analysis Canvas for deeper competitor insights"
      ]
    }
  }
}

Customer Experience Focus

const response = await fetch('https://api.waymakerone.com/v1/framework', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'We need to improve our customer onboarding process. Customers are churning early and we don\'t understand why.'
    }],
    userContext: {
      industry: 'technology',
      businessStage: 'growth',
      role: 'product_manager'
    }
  })
});

Organizational Design Request

const response = await fetch('https://api.waymakerone.com/v1/framework', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'Our team is growing rapidly but we have unclear roles and accountability issues. People don\'t know who\'s responsible for what.'
    }],
    userContext: {
      businessStage: 'growth',
      role: 'ceo'
    }
  })
});

Credit Usage

The Framework Agent uses 5 credits per request due to its advanced analysis capabilities:

• Business Context Analysis: Deep understanding of industry and stage
• Framework Selection Intelligence: AI-powered recommendation engine
• Implementation Guidance: Phase-by-phase methodology application
• Resolute Leadership Integration: Leadership principle alignment
• Structured Outputs: Comprehensive strategic deliverables

Best Practices

Request Optimization

1. Provide Business Context: Include industry, stage, and role for better framework selection
2. Be Specific About Challenges: Clear problem description improves framework matching
3. Specify Complexity Needs: Use preferences to indicate desired detail level
4. Build on Previous Work: Reference existing frameworks or strategic work

Framework Implementation

1. Start with Primary Framework: Focus on the recommended primary framework first
2. Use Supporting Frameworks: Integrate supporting frameworks for comprehensive coverage
3. Follow Implementation Phases: Work through the structured methodology phases
4. Apply Resolute Principles: Integrate leadership principles for effective execution

Advanced Usage

1. Multi-Framework Workflows: Combine frameworks for comprehensive strategic planning
2. Iterative Development: Use sessions to build complex strategic plans over time
3. Team Collaboration: Use structured outputs to align team understanding
4. Progress Tracking: Use success metrics to measure framework implementation

Error Handling

Framework Selection Confidence

The agent provides confidence scores for its recommendations:

• 90-100: High confidence, optimal framework match
• 80-89: Good confidence, strong framework alignment
• 70-79: Moderate confidence, may suggest alternatives
• 60-69: Lower confidence, recommends clarifying questions

Unsupported Requests

{
  "error": "unsupported_request",
  "message": "Request falls outside framework expertise",
  "code": "FRAMEWORK_OUT_OF_SCOPE",
  "suggestions": [
    "Try the Research Agent for market analysis",
    "Try the Data Agent for analytics questions"
  ]
}

Next Steps

• Explore coordination strategies
• Learn about other agents
• See framework examples