AI workflow and Setup

I use AI like an engineering team around me.

One agent helps plan, others implement, others test, one tries to break the system, and I keep final control over review, git, and shipping.

ai-workflow.md

merge

planClaude Opus + Spec Kit

tasksBeads breakdown

buildCodex + Opus agents

verifySonnet + chaos pass

shipmanual git + CI/CD agents

01Master PRD
04+agents per feature
Manualgit control
CI/CDdeployment checks

Planning pipeline

The work starts before code.

I use AI most heavily at the beginning of a feature, when the architecture, acceptance criteria, and test cases need to become clear enough for multiple agents to work without losing the original intent.

01

Brainstorm the system

I start with Claude Opus for planning and architecture. The first pass is a brainstorming session around the problem, constraints, architecture options, goals, acceptance criteria, and test cases.

02

Shape the Master PRD

I use Spec Kit and Beads on top of the brainstorming work to turn the idea into a Master PRD. That document becomes the source of truth for what we are building, why it matters, and how it will be accepted.

03

Break work into tasks

For large projects and small features, I use Beads to split the work into clear tasks. It keeps features from turning into one vague brief and makes progress easier to review.

04

Run agents by role

Once the plan is ready, I run multiple agents over the feature. Two agents usually implement, other agents check tests, linting, edge cases, and documentation.

Multi-agent setup

Agents have roles, not unlimited control.

I split agent work by responsibility. That keeps each agent close to a domain while the PRD, Beads tasks, and acceptance criteria keep the overall system aligned.

Codex

Frontend agent

I use Codex especially for frontend work: building interfaces, refining layouts, checking responsive behavior, and keeping implementation close to the existing design system.

Opus terminal

Backend agent

For backend-heavy work, I use an Opus terminal where the agent can stay focused on architecture, APIs, data models, and service-level tradeoffs.

Sonnet

Testing agent

I use Sonnet for testing-focused passes: checking acceptance criteria, test coverage, linting, and edge cases that should be verified before the feature is considered done.

Docs pass

Documentation agent

One agent can focus on documentation so the implementation notes, handover files, and repo context stay readable after the coding pass is finished.

Chaos engineer

An agent built to break code.

The **chaos engineering agent** breaks the code intentionally and looks for broken assumptions, missing edge cases, weak recovery paths, bad states, race conditions, unclear user flows, and places where the system works only when everything goes perfectly.

I like this role because it adds pressure to the design before users do. It turns AI from only a builder into a reviewer that actively searches for failure.

Git and review

Manual control stays with me.

Agents can move quickly, but the final engineering decision should still be mine. I use AI to increase leverage, not to hand over the merge button.

  1. I do not like agents raising PRs and auto-merging code for me.
  2. I review uncommitted features manually before committing or merging.
  3. If I am not satisfied, I rerun the agent, make manual fixes, or code the missing parts directly.
  4. Cursor is my primary IDE for git review, small fixes, quick agents, and manual control.

Repo sync

Handover files keep parallel work aligned.

When a project spans multiple directories or repositories, I create handover markdown files.

The handover files explain what changed, what still needs to be done, and which assumptions are shared.

This keeps frontend, backend, tests, documentation, and parallel repo work from drifting apart.

Toolchain

A small system around planning, building, and review.

Planning

  • Claude Opus
  • Spec Kit
  • Beads
  • Master PRD

Implementation

  • Codex
  • Opus terminal
  • Cursor Auto Agent
  • manual coding

Review

  • Sonnet
  • ESLint
  • test cases
  • chaos engineering agent

Automation

  • GitHub Actions
  • CI/CD agents
  • Hermas agent
  • handover markdown

Automation

CI/CD and personal agents handle the background checks.

**GitHub Actions agents** tell me whether deployment is in process, failed, merged, or completed. For personal automation, I use a self-hosted **Hermas agent** for starting the day, checking emails, reviewing meetings, and handling small personal tasks.

Plan - build - verify - review - ship

The setup keeps fast feedback around the work while preserving manual review at the points that matter.

Working setup

The hardware stays simple and reliable.

Primary machine

MacBook Air M5 for development, AI-assisted coding, planning, review, and shipping work.

Secondary machine

MacBook M1 for personal work and a separate secondary environment.

Desk

BenQ 27-inch 2790Q monitor with a Logitech Pebble 2 for the everyday setup.

The setup keeps changing, but the direction is consistent.

Faster feedback, better thinking, fewer repetitive steps, and more time spent on the parts of software that need taste, judgment, and care.