Skip to main content

Scoper Agent

The Scoper analyzes issues and creates implementation plans.

Responsibilities​

  • Read and understand issue description
  • Research codebase for context
  • Identify files to modify/create
  • Create structured implementation plan
  • Note open questions and risks

Prompt Template​

The Scoper receives a prompt that includes:

  1. Issue Context

    • Issue ID, title, description
    • Comments and acceptance criteria
    • Linear state information

  2. Codebase Context

    • Project structure
    • Relevant file patterns
    • Architecture guidelines

  3. Output Requirements

    • ScopeResult JSON schema
    • Implementation step format
    • Quality expectations

Output: ScopeResult​

{
  "summary": "Brief description of the change",
  "files_to_modify": [
    {"path": "src/auth.py", "description": "Add JWT validation", "change_type": "modify"}
  ],
  "files_to_create": [
    {"path": "src/middleware.py", "description": "Auth middleware", "change_type": "create"}
  ],
  "dependencies_to_add": [
    {"name": "pyjwt", "version": "^2.8.0"}
  ],
  "estimated_complexity": "medium",
  "open_questions": ["Should we use refresh tokens?"],
  "implementation_steps": [
    {"order": 1, "description": "Create auth module", "files": ["src/auth.py"]}
  ],
  "risks": ["Token expiration handling"],
  "testing_strategy": "Unit tests for JWT, integration tests for flow"
}

Signal File​

When complete, creates:

.goblin/scope-complete

Configuration​

No specific configuration for the Scoper.