callout-dev

Instructions

Implementation Reference

• src/handlers/meta.ts:13-76 (handler)

  The 'callout_help' tool implementation - registered with server.tool() and contains the async handler function that returns comprehensive help documentation about all available Callout tools and their usage examples. The tool takes no parameters (empty schema {}) and returns formatted markdown text with tool descriptions and example commands.

    server.tool(
      'callout_help',
      'Show what Callout can do and how to use it. Call this when a user first connects or asks about Callout.',
      {},
      async () => {
        return {
          content: [{
            type: 'text' as const,
            text: `# Callout — Your AI Co-founder for 0→1 Builds
  
  ## Core Tools
  
  ### review — "Get expert opinions on my project"
  9 perspectives in 3 groups: Technical (CTO, Security, DevOps), Business (Product, Customer, Strategy), Founder (Investor, Unicorn Founder, Solo Entrepreneur). Use \`focus\` to zoom in, \`perspective_group\` to select a group.
  
  **Try:**
  - "Review this project" — full 9-perspective review
  - "Review with founder group" — investor + unicorn founder + solo entrepreneur
  - "Review focus: should I use Supabase or Firebase?" — technology decision
  - "Review focus: user login page" — focused feature review
  - "Review security + CTO only" — selected perspectives
  
  ### coach — "Am I working with AI the right way?"
  Analyzes your project setup, development habits, and knowledge blind spots. Reveals what you don't know you're doing wrong when working with AI coding tools.
  
  **Try:** "Coach me" / "How am I doing with AI?" / "Check my collaboration habits"
  
  ### test_translate — "What do my tests actually cover?"
  Translates test results into plain language. Shows what's tested, what failed, and produces a manual test script.
  
  **Try:** "Translate my test results" / "What do these tests mean?"
  
  ### idea_score — "Is this idea worth building?"
  Scores your idea across 10 dimensions (market size, feasibility, moat, revenue, etc.) with a skeptical default stance. Returns a verdict: CONTINUE, SIMPLIFY, PAUSE, or DELETE.
  
  **Try:** "Score this idea" / "Is this worth building?" / "Rate my project"
  
  ## Supporting Tools
  
  ### recommend — "What tools should I use for this?"
  Detects what your project needs (auth, database, payments, etc.) and recommends the best tool.
  
  **Try:** "What should I use for auth?" / "I need to add payments"
  
  ### Todo List — Your central command
  All findings from review and coach flow into your todo list.
  Tools: todo_add, todo_update, todo_list, todo_summary
  
  **Try:** "Show my todos" / "What's my top priority?"
  
  ### portfolio — "What should I work on across all my projects?"
  Scans all your projects, shows health status, and gives resource allocation advice.
  
  **Try:** "Show my portfolio"
  
  ### Other: set_target_user, save_review_findings, recommend_dismiss, recommend_reset, init
  
  ---
  
  **Start here:** Say "Coach me" to check your AI collaboration setup, or "Review this project" for a full expert review.`,
          }],
        };
      },
    );