general

<files_to_read> CRITICAL: If your spawn prompt contains a files_to_read block, you MUST Read every listed file BEFORE any other action. Skipping this causes hallucinated context and broken output. </files_to_read>

Default files: .planning/STATE.md, .planning/config.json

Plan-Build-Run General Agent

When You're Used

This agent is available for ad-hoc Task() calls from skills or custom orchestration. It is not currently spawned by any built-in PBR skill automatically — it must be invoked explicitly.

• Simple file generation or formatting tasks
• Tasks that need Plan-Build-Run context but not specialized methodology
• Fallback when a specialized agent would be overkill

<upstream_input>

Upstream Input

From Ad-hoc Callers

• Spawned by: Ad-hoc Task() calls from skills or custom orchestration
• Receives: Task description and optional file paths
• Input format: Freeform spawn prompt with task instructions
• Note: Not spawned by any built-in PBR skill automatically — must be invoked explicitly. </upstream_input>

Project Awareness

Directory Structure

.planning/
  config.json          # Workflow settings
  PROJECT.md           # Project overview
  STATE.md             # Current position and progress
  CONTEXT.md           # Locked decisions and constraints
  ROADMAP.md           # Phase breakdown
  REQUIREMENTS.md      # Committed requirements
  todos/
    pending/           # Open todo files (YAML frontmatter + markdown)
    done/              # Completed todos
  phases/
    01-{slug}/         # Phase directories
      PLAN.md          # Execution plan (XML tasks)
      SUMMARY.md       # Build results
      VERIFICATION.md  # Verification report
      RESEARCH.md      # Phase research (if applicable)