Agentic Coding Harness

Don't just vibe. Produce.

The Four Phases

A systemic approach to building software with agents.

Phase 01

IMAGINE 🌱

Dream it. Before writing code, we explore, research, and design. Instead of jumping into implementation, we ask the agent to create a detailed plan.

The Protocol

Ask Claude to "make a plan for [feature]". It creates a markdown file in _PLANS/ detailing the approach, files to modify, and risks.

# _PLANS/AUTH.md
## Technical Approach
Use NextAuth with GitHub provider...

## Steps
1. [ ] Install dependencies
2. [ ] Configure provider
Phase 02

PLANT 🥕

Seed it. Turn the plan into trackable work items. We break the large plan into small, manageable seeds (issues) that can be tracked.

The Protocol

Use the bd tool to create issues from the plan steps. This commits the work to your git history.

bd create "Implement OAuth provider" -t task
# Created seed #42
Phase 03

GROW 🌿

Build it. This is where the work happens. Agents pick up seeds and implement them. We use specialized sub-agents for specific tasks like review, security, and performance.

The Protocol

Agents work in parallel. While you implement, a code-reviewer agent can check your work instantly.

# Specialized Agents
.claude/agents/code-reviewer.md
.claude/agents/security-auditor.md
.claude/agents/performance-auditor.md
Phase 04

HARVEST 🍊

Ship it. The harvest is the final quality gate. We run a standardized sequence of checks to ensure the code is ripe for production.

The Protocol

The /push command runs: Clean → Lint → Test → Build → Commit → Push. You can't skip steps.

/push
> Running harvest sequence...
> Linting... OK
> Testing... OK
> Building... OK
> Shipped! 🚀

The Soil Specifications

Defines the environment where intelligence grows.

📋

CLAUDE.md

The Almanac

Your project's brain. Agents read this first, every time.

  • Architecture & Patterns
  • Phrase Triggers
  • Conventions
# My App
> Build fast, ship clean

## Triggers
| "wash produce" | lint |
🤖

.claude/agents/

Farm Hands

Specialized workers for specific tasks.

  • code-reviewer
  • security-auditor
  • performance-auditor
  • code-smell-auditor
# code-reviewer.md
- [ ] No console.logs
- [ ] Complexity < 10
📝

_PLANS/

Seed Catalog

Think before you code. Detailed specs before implementation.

  • Overview & Goal
  • Technical Approach
  • Implementation Steps
# FEATURE_auth.md
Status: Ready

## Steps
- [ ] Create Context
- [ ] Add Login UI
📊

_AUDIT/

Crop Reports

Living health scores. Always know your project's vitals.

  • SECURITY.md
  • PERFORMANCE.md
  • TESTS.md
  • CODE_QUALITY.md
# SECURITY.md
Score: 8.5/10

- [ ] Update JWT
- [ ] Review RLS
🚜

Commands & Justfile

The Tractor

Automate everything. One command does the work of ten.

  • /push – Ship it
  • /navigate – Jump around
  • just dev – Start dev
# justfile
push:
    just lint && just test
    git push
🌰

.beads/

Autonomous

Agents manage issues. You don't touch Jira. Learn more →

  • Git-native issues
  • Auto open/close
  • Zero friction
bd create "Fix auth"
> Created bead #42

How it Works in Real Life 🛠️

This isn't theory. This is the daily workflow of an agentic developer.

01

🌱 Imagine & Plan

I don't just start coding. I ask Claude to "make a plan for [feature]". It explores the codebase and creates a detailed _PLANS/FEATURE.md spec.

02

🥕 Plant Seeds

I review the plan, then the AI Agent will convert the plan into Beads (local issues). Can then safely clear context window and focus on the Epic of task issues.

Convert the plan into an epic of issues
03

🌿 Grow

They read the plan, write the code, and mark the bead as done. This can be done in parallel with multiple agents. With compounding effect of subagents and the PRODUCE harness for quick project discovery, letting the AI work at the highest quality for your project.

Implement from highest to lowest priority
04

📊 Audit

Before shipping, I run the "wash the produce" or for me, "run it selectah!" command. Agents run a battle-tested workflow testing errors, linting, etc and update the _AUDIT/ reports.

/wash
05

🍊 Deploy

Finally, I run the harvest sequence. It builds, tests, cleans up, audits and pushes to Github with confidence.

/push

Ready to Start Producing?

Copy this prompt into Claude Code to instantly prepare your soil.

Setup Prompt
I want to implement the **PRODUCE Harness** for this project. Please execute the following "Bootstrap Sequence" to build the entire Soil infrastructure: ### 1. Create Directory Structure Run: `mkdir -p .claude/agents .claude/commands _PLANS _AUDIT .beads` ### 2. Establish The Almanac (CLAUDE.md) Create `CLAUDE.md` containing project context and these **Phrase Triggers**: **Phase Triggers:** - "make a plan for [feature]" → Explore codebase, create `_PLANS/*.md` - "let's implement [feature]" → Read plan, create Beads issues, confirm start - "time to harvest" → Execute full `/push` sequence **Quality Triggers:** - "wash the produce" → Run `code-reviewer` + `unused-code-cleaner` - "pest control" → Run `security-auditor` (OWASP) - "weigh the harvest" → Run `performance-auditor` - "sniff test" → Run `code-smell-auditor` (DRY, complexity) - "prune the tree" → Run `unused-code-cleaner` - "to market" → Run `i18n-locale-translator` - "check the roots" → Run `performance-auditor` (memory, re-renders) ### 3. Install & Configure Tools 1. **Justfile**: Create a `justfile` with commands: `dev`, `lint`, `test`, `build`, `clean`, and a `push` recipe that chains them. 2. **Storybook**: Initialize Storybook (`npx storybook@latest init`) for UI component development. 3. **Beads**: Initialize `.beads/issues.jsonl`. Agents will **autonomously** create and close issues here as they work. (See: [github.com/steveyegge/beads](https://github.com/steveyegge/beads)) 4. **Settings**: Create `.claude/settings.json` for Claude Code configuration. ### 4. Deploy Sub-Agents (.claude/agents/) Create these specialized agent files with detailed roles: - `code-reviewer.md`: Quality/Security checks (complexity < 10, no console.logs). - `security-auditor.md`: OWASP vulnerabilities check. - `performance-auditor.md`: Memory leak & bundle size check. - `code-smell-auditor.md`: DRY & naming convention check. - `unused-code-cleaner.md`: Dead code removal instructions. - `i18n-locale-translator.md`: Localization manager. - `storybook-maintainer.md`: Component story generator/updater. ### 5. Setup Commands (.claude/commands/) - `push.md`: The "Harvest" sequence (Clean → Lint → Test → Build → Commit → Push). - `navigate.md`: Context switching helper for justfile paths. - `run-task.md`: Execute justfile commands. ### 6. Initialize Audits (_AUDIT/) Create these living metric files (start at Score: 0.0/10): - `SECURITY.md` - `PERFORMANCE.md` - `TESTS.md` - `CODE_QUALITY.md` ### 7. Create PRODUCE.md (Optional) Copy this framework guide to the project root for reference. **Goal**: When finished, I should have a fully structured agentic environment. Explain how I can start the "Imagine" phase for my first feature.