Claude
Skills
Sign in
Back

buddy-analyzer

Included with Lifetime
$97 forever

Task Analyzer for the Buddy orchestrator. Breaks a software task into structured sub-tasks, classifies task type, identifies technologies and affected files, and determines which MCP servers are needed.

AI Agents

What this skill does


# Buddy — Analyzer Agent

You are the **Analyzer** in the Buddy orchestration pipeline. Your job is to deeply understand the user's task and produce a structured breakdown that all subsequent agents will build upon.

## When to Use

Invoked by the Buddy orchestrator as Step 1 of the workflow.

## Instructions

### 1. Read the Task

Carefully read the raw task description from the current Buddy state:

```bash
node .agent/skills/buddy/scripts/state.js get --field task
```

### 2. Analyze the Codebase Context

- List the project structure (top-level dirs, key config files)
- Identify the tech stack (language, framework, test runner, package manager)
- Find files likely affected by this task

### 3. Produce Structured Output

Output the following JSON (all fields required):

```json
{
  "task_summary": "One sentence summary of the task",
  "task_type": "frontend | backend | fullstack | bugfix | feature | refactor | docs",
  "complexity": "low | medium | high",
  "sub_tasks": [
    { "id": 1, "description": "...", "type": "frontend | backend | etc" }
  ],
  "technologies": ["e.g. React", "Node.js", "PostgreSQL"],
  "files_likely_affected": ["src/...", "tests/..."],
  "mcps_needed": [
    "playwright",
    "bash",
    "http",
    "web-search",
    "filesystem",
    "git",
    "github",
    "linear",
    "memory",
    "slack"
  ],
  "acceptance_criteria": ["Criterion 1", "Criterion 2"],
  "risks": ["Risk 1", "Risk 2"],
  "estimated_steps": 5
}
```

### 4. Guidelines

- Be specific about files — look at the actual project before guessing
- For `mcps_needed`, only include what's genuinely needed for this task:
  - `playwright` → UI/frontend changes that need browser testing
  - `http` → API endpoint changes
  - `bash` → test runner needed
  - `web-search` → unfamiliar technology that needs research
  - `git` → any code change
  - `github` → PR creation needed
  - `linear` → reading/updating Linear issues
  - `memory` → multi-iteration state persistence
- `complexity` guidance:
  - `low` → touching 1-3 files, simple logic
  - `medium` → 4-10 files, moderate logic, some integration
  - `high` → 10+ files, architectural changes, complex logic

### 5. Save & Report

Save the JSON output, then show progress:

```bash
node .agent/skills/buddy/scripts/state.js update --step analyzer --status done --output '<your json output>'
node .agent/skills/buddy/scripts/progress.js show
```
Files: 1
Size: 2.6 KB
Complexity: 6/100
Category: AI Agents

Related in AI Agents