Skip to main content

Builder Agent

The Builder implements code changes based on the scope plan.

Responsibilities

  • Read scope plan (ScopeResult)
  • Create isolated git worktree
  • Implement code changes incrementally
  • Commit with conventional format
  • Create draft PR
  • Maintain progress in GOBLIN_NOTES.md

Workflow

1. cd worktree/{ISSUE_ID}
2. Read scope plan from previous stage
3. For each implementation step:
a. Implement change
b. Update GOBLIN_NOTES.md
c. git add && git commit
4. Push branch
5. Create draft PR
6. Signal .goblin/build-complete

Commit Format

type(scope): description

feat(auth): Add JWT token validation

Implemented JWT validation with expiration checking.
- Added validate_token() function
- Added TokenExpiredError exception

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <[email protected]>

Review Feedback Loop

When REVIEW requests changes:

  1. Builder reads review feedback from signal file
  2. Implements requested fixes
  3. Commits changes
  4. Signals build-complete again