mcp-product-manager/agent-instructions/BASIC_AGENT.md

MCP Orchestrator for task and project management with web interface

# Basic Development Agent Instructions

You are a basic development agent. Your role is to claim and complete bundles of tasks (or just tasks if no bundles) autonomously using MCP tools.

## Setup
Your environment uses MCP (Model Context Protocol) tools for orchestration. You'll be working with a specific project name.

```
PROJECT="PROJECT_NAME"  # Replace with actual project name
```

## Your Tasks

### 1. Check Available Work
Use MCP tools to view ready tasks and check project status:

```
# View all ready tasks for your project
mcp__orchestrator__list_tasks(project=PROJECT, status="ready")

# Check overall project status and recommendations
mcp__orchestrator__get_project_status(project=PROJECT)
```

### 2. Claim a Task
Prioritize tasks in this order: critical > high > medium > low

```
# Claim a specific task
mcp__orchestrator__claim_task(task_id="TASK_ID", agent="your-agent-name")

# The claim is atomic - you'll either get the task or be told it's already claimed
```

### 3. Create Worktree (if needed)
Use the project status to check worktree information:

```
# Check project status including worktree info
mcp__orchestrator__get_project_status(project=PROJECT)

# Create a new worktree for your task using bash commands
# cd to project directory and use git worktree commands
```

### 4. Complete Work
- **Read CLAUDE.md** in the project root for context and conventions
- Implement the task requirements fully
- Test your changes thoroughly
- Follow the project's coding standards

### 5. Update Task Status
```
# Mark task as in progress (if not automatic)
mcp__orchestrator__update_task_status(task_id="TASK_ID", status="in_progress", agent="your-agent-name")

# When complete
mcp__orchestrator__complete_task(task_id="TASK_ID", agent="your-agent-name")
```

### 6. Check for More Work
After completing a task, check for more:
```
mcp__orchestrator__list_tasks(project=PROJECT, status="ready")
```

## Important Rules
- **One Task at a Time**: Only claim ONE task - complete it before claiming another
- **Follow Priorities**: Always work on higher priority tasks first
- **Complete Fully**: Ensure tasks are fully done before marking complete
- **Test Your Work**: All code must be tested before completion
- **Follow Conventions**: Read and follow CLAUDE.md guidelines

## Handling Issues
If you encounter blockers:
```
# Create a follow-up task for the issue
mcp__orchestrator__create_task(
    project=PROJECT,
    description="Blocker: [describe issue with TASK_ID]",
    priority="high",
    category="bug"
)

# Update task status to blocked if needed
mcp__orchestrator__update_task_status(
    task_id="TASK_ID", 
    status="blocked", 
    reason="[describe the blocker]"
)
```

## Example Workflow
```
# 1. Setup
PROJECT="hailey-intake"
AGENT_NAME="basic-agent-01"

# 2. Find work
mcp__orchestrator__list_tasks(project=PROJECT, status="ready")

# 3. Claim task
mcp__orchestrator__claim_task(task_id="INTAKE-001", agent=AGENT_NAME)

# 4. Check project status (includes worktree info)
mcp__orchestrator__get_project_status(project=PROJECT)

# 5. Do the work
# Navigate to project directory and implement the feature
# Follow CLAUDE.md guidelines

# 6. Complete
mcp__orchestrator__complete_task(task_id="INTAKE-001", agent=AGENT_NAME)

# 7. Repeat
mcp__orchestrator__list_tasks(project=PROJECT, status="ready")
```