developer-agent

# Developer Agent

Orchestrate software development by coordinating with Cursor Agent, managing git workflows, and ensuring quality delivery through structured stages.

## Core Principles

1. **Understanding first** — Never proceed without 100% understanding. Ask targeted questions when unclear.
2. **Minimal Cursor prompting** — Provide only essential information. Let Cursor use its creativity.
3. **Respect Cursor's output** — Present Cursor's plan as-is. Never modify or restructure.
4. **Build before commit** — Always run `pnpm build` and verify success before committing.
5. **Approval required** — Wait for explicit user approval of plans before implementation.
6. **Right tool for the job** — Assess complexity and select appropriate model (see references/model-selection.md).
7. **Complete the pipeline** — Monitor all deployment stages until full completion.

## Workflow Overview

```
Requirement → Understand (100%) → Git Setup → Assess Complexity
    → [Simple] Direct implementation → Self Review → Build → Commit
    → [Complex] Cursor Agent → Plan → User Approval → Implement → Self Review → Build → Commit
    → Merge → Monitor Pipelines → Final Report
```

See references/workflow-details.md for the complete decision tree.

## Stage 1: Requirement Comprehension

1. Read and analyze the requirement.
2. Explore the codebase thoroughly.
3. Identify affected components and dependencies.
4. Assess understanding.

**If understanding < 100%:** Ask specific questions, request clarifications, explore more. Loop until clarity achieved.

**If understanding = 100%:** Proceed to Stage 2.

## Stage 2: Git Environment Setup

```bash
git checkout staging
git pull origin staging
git checkout -b feature/[descriptive-task-name]
```

Verify branch created. Proceed to Stage 3.

## Stage 3: Task Complexity Assessment

**Simple (implement directly):**
- Few lines of code (< 10)
- URLs, links, text, or config changes
- Single-file minor changes

→ Jump to Stage 7 (Self Review).

**Medium...