Boost Your Productivity: Slice 1 Bootstrap MVP

by Jule 47 views
Boost Your Productivity: Slice 1 Bootstrap MVP

Introduction

Hey guys, let's dive into the world of software development productivity with our latest slice, the Bootstrap MVP for single-agent end-to-end processes. This baby is designed to run bob build against a GitHub Project and produce a PR for one Todo issue. It's hand-built (HITL) per the PRD's Development Approach, so let's get our hands dirty and see what it's all about.

What's Under the Hood

Our little slice here introduces some nifty modules to make your life easier:

  • ConfigLoader: This guy loads and validates your bob.yaml file. If it's missing the project field, he'll fail fast and let you know.
  • GitHubProvider: He's the bridge between your code and GitHub, using the gh CLI to fetch unblocked Todo issues.
  • WorktreeManager.getOrCreate: This module creates a git worktree at a determined path with a branch name derived from the issue identifier.
  • AgentRunner: He's the one who spawns claude --print -p inside the worktree with the full issue content as the prompt.
  • Orchestrator: This single-pass module ties everything together, making sure each step happens in the right order.

How It Works

Here's a step-by-step breakdown of what our slice does:

  1. Load and Validate bob.yaml: Our slice starts by loading and validating your bob.yaml file. If it's missing the project field, it'll fail fast and let you know.
  2. Fetch Unblocked Todo Issues: It then fetches unblocked Todo issues from the GitHub Project using our GitHubProvider.
  3. Transition Issue to In Progress: The first unblocked Todo issue is transitioned to In Progress.
  4. Create a git worktree: A git worktree is created at a determined path with a branch name derived from the issue identifier.
  5. Spawn Agent with Issue Content: The agent receives the full issue content (title, description, all comments) as its prompt inside the worktree.
  6. Open PR via gh pr create: The agent opens a PR via gh pr create from within its worktree.
  7. Transition Issue to In Review: Finally, the issue transitions to In Review after the PR is opened.

Acceptance Criteria

To make sure our slice is doing its job, we've got some acceptance criteria:

  • [ ] bob build runs in a repo with a valid bob.yaml and exits 0 after producing a PR
  • [ ] bob.yaml is loaded and validated; missing project fails fast with a clear error
  • [ ] One unblocked Todo issue is transitioned to In Progress before the agent starts
  • [ ] A git worktree is created at a deterministic path with branch name derived from the issue identifier
  • [ ] The agent receives the full issue content (title, description, all comments) as its prompt
  • [ ] The agent opens a PR via gh pr create from within its worktree
  • [ ] The issue transitions to In Review after the PR is opened
  • [ ] PR branch name follows GitHub's auto-link convention so the PR is linked to the issue

Wrapping Up

And that's our Bootstrap MVP slice! It's designed to be hand-built (HITL) per the PRD's Development Approach, so you can get started right away. Happy coding, and until next time!