From cdcf52046a61b1a3c8e7fb81ad8a83d3cfd39199 Mon Sep 17 00:00:00 2001 From: Kiet Ho Date: Sun, 23 Nov 2025 17:46:45 -0800 Subject: [PATCH 1/3] add incomplete cookbook --- README.md | 4 ++++ docs/README.md | 2 ++ docs/cookbook/README.md | 37 +++++++++++++++++++++++++++++++++++++ 3 files changed, 43 insertions(+) create mode 100644 docs/README.md create mode 100644 docs/cookbook/README.md diff --git a/README.md b/README.md index 45708db13cb..af413f29c8d 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,10 @@ Superset helps you run 100 CLI coding agents on your machine without losing your mind. +## Docs + +See the Markdown wiki in `docs/`: [docs/README.md](docs/README.md). + ## What you can do with Superset: diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 00000000000..9490a2c83fb --- /dev/null +++ b/docs/README.md @@ -0,0 +1,2 @@ +# Superset Wiki +A collection of docs for Superset \ No newline at end of file diff --git a/docs/cookbook/README.md b/docs/cookbook/README.md new file mode 100644 index 00000000000..16b4095e596 --- /dev/null +++ b/docs/cookbook/README.md @@ -0,0 +1,37 @@ +# Parallel Coding Agent cookbook + +How to run 100 agents in parallel without losing your mind, a practical guide. + +## Table of Contents + +1. [Why would I want to do this?](#whywould-i-want-to-do-this) +2. [Coding environment]() +3. [Handling conflicts](#handling-merge-conflicts) +4. [What agents should I use]() + +## Why...would I want to do this? +- Coding has changed, old man. You need to level up and drive a team of junior engineers instead. + +- Time == money. Instead of hiring 1-2 more engineers, you can increase your output at the same rate for $100-$200 / month. + +## Not all agents are created equal +- Some CLI agents and configs are good at certain things. Use them accordingly. +- Codex (high) is good at planning and reviewing +- Sonnet 4.5 is good at coding +- Composer-1 is good at refactoring and making quick changes + +### Handling Conflicts +- Keep PRs per feature +- Prefer merging main into the PR instead of the PR into main, have an agent look at the current PR and the merge conflicts and plan before coding. Treat merging as its own feature work. + +### Unorganized Notes: +1. Use worktrees. But automate the setup. +- https://git-scm.com/docs/git-worktree +- https://github.com/coderabbitai/git-worktree-runner +2. Use hooks to notify when agent is done +- https://code.claude.com/docs/en/hooks-guide +- https://github.com/openai/codex/discussions/2150 +3. Color/name code your workspace +- https://marketplace.visualstudio.com/items?itemName=johnpapa.vscode-peacock +4. Plan as a separate step +- Explore codebase and write/refine a plan as MD. Commit it for a different/fresh agent to pick up. From e9b50f519afeac56cbd98d0a9c25e12612400202 Mon Sep 17 00:00:00 2001 From: Kiet Ho Date: Sun, 23 Nov 2025 18:22:50 -0800 Subject: [PATCH 2/3] update cookbook --- docs/cookbook/README.md | 40 +++++++++++++++++++++++++++++++--------- 1 file changed, 31 insertions(+), 9 deletions(-) diff --git a/docs/cookbook/README.md b/docs/cookbook/README.md index 16b4095e596..0db95cfc799 100644 --- a/docs/cookbook/README.md +++ b/docs/cookbook/README.md @@ -1,4 +1,4 @@ -# Parallel Coding Agent cookbook +# WIP - Parallel Coding Agent cookbook How to run 100 agents in parallel without losing your mind, a practical guide. @@ -9,22 +9,42 @@ How to run 100 agents in parallel without losing your mind, a practical guide. 3. [Handling conflicts](#handling-merge-conflicts) 4. [What agents should I use]() -## Why...would I want to do this? +## Why would I want to do this? - Coding has changed, old man. You need to level up and drive a team of junior engineers instead. - Time == money. Instead of hiring 1-2 more engineers, you can increase your output at the same rate for $100-$200 / month. -## Not all agents are created equal -- Some CLI agents and configs are good at certain things. Use them accordingly. -- Codex (high) is good at planning and reviewing -- Sonnet 4.5 is good at coding -- Composer-1 is good at refactoring and making quick changes +## Which agents should I use? + +Some CLI agents and configs are good at certain things. Use them accordingly. +- Codex (high) is good at planning and reviewing - https://github.com/openai/codex +- Sonnet 4.5 is good at coding - https://www.claude.com/product/claude-code +- Composer-1 is good at refactoring and making quick changes - https://cursor.com/cli +- CodeRabbit CLI is also good at reviewing + +### Coding environment +It's untenable to develop more than 2-3 features on the same codebase. Git Worktrees can help keep each change in a separate branch that can avoid overwriting each other. It's still best to develop the same feature on 1 worktree. + +Tips: +1. Use tooling for worktree creation and setup https://github.com/coderabbitai/git-worktree-runner +2. Instrument your codebase with environment variable-based port mapping so ports don't conflict ### Handling Conflicts - Keep PRs per feature - Prefer merging main into the PR instead of the PR into main, have an agent look at the current PR and the merge conflicts and plan before coding. Treat merging as its own feature work. -### Unorganized Notes: +### Workflow +1. Plan with a high reasoning agent/model. I prefer Codex (high) at the time of writing +2. Refine the plan until you're happy with it +3. Record the plan in and MD or copy and past to a coding agent directly +4. Pass over to Claude Code or other coding agent for implementation +5. Use a reasoning (Codex) or review agent (CodeRabbit) to review the work and spot bug +6. Pass the feedback (if you agree with them) to the coding agent +7. Repeat until monkey brain happy +8. Bonus: Have CI/CD for review tool like CodeRabbit for PR review +9. Bonus 1: Have the coding model write unit tests for edge cases. + +### Unorganized Tips: 1. Use worktrees. But automate the setup. - https://git-scm.com/docs/git-worktree - https://github.com/coderabbitai/git-worktree-runner @@ -34,4 +54,6 @@ How to run 100 agents in parallel without losing your mind, a practical guide. 3. Color/name code your workspace - https://marketplace.visualstudio.com/items?itemName=johnpapa.vscode-peacock 4. Plan as a separate step -- Explore codebase and write/refine a plan as MD. Commit it for a different/fresh agent to pick up. +- Explore codebase and write/refine a plan as MD. +- Commit it for a different/fresh agent to pick up. +5. Linter, Unit Tests, and Type-safety can be huge help. This gives valuable feedback to agents. \ No newline at end of file From 2c31bc0e8a7c7982391232c07e306b9e39209347 Mon Sep 17 00:00:00 2001 From: Kiet Ho Date: Sun, 23 Nov 2025 18:25:30 -0800 Subject: [PATCH 3/3] update cookbook --- docs/cookbook/README.md | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/docs/cookbook/README.md b/docs/cookbook/README.md index 0db95cfc799..7faaac95a18 100644 --- a/docs/cookbook/README.md +++ b/docs/cookbook/README.md @@ -4,15 +4,18 @@ How to run 100 agents in parallel without losing your mind, a practical guide. ## Table of Contents -1. [Why would I want to do this?](#whywould-i-want-to-do-this) -2. [Coding environment]() -3. [Handling conflicts](#handling-merge-conflicts) -4. [What agents should I use]() +1. [Why would I want to do this?](#why-would-i-want-to-do-this) +2. [Which agents should I use?](#which-agents-should-i-use) + - [Coding environment](#coding-environment) +3. [Handling Conflicts](#handling-conflicts) +4. [Workflow](#workflow) +5. [Unorganized Tips](#unorganized-tips) ## Why would I want to do this? -- Coding has changed, old man. You need to level up and drive a team of junior engineers instead. -- Time == money. Instead of hiring 1-2 more engineers, you can increase your output at the same rate for $100-$200 / month. +Time === money. Instead of hiring 1-2 more engineers, you can increase your output at the same rate for $100-$200 / month. + +You can realistically ship 1-3 features in an hour that would take 1-3 days pre-LLM. Just develop them in parallel. ## Which agents should I use? @@ -41,8 +44,11 @@ Tips: 5. Use a reasoning (Codex) or review agent (CodeRabbit) to review the work and spot bug 6. Pass the feedback (if you agree with them) to the coding agent 7. Repeat until monkey brain happy -8. Bonus: Have CI/CD for review tool like CodeRabbit for PR review -9. Bonus 1: Have the coding model write unit tests for edge cases. + +Bonus: +1. Have CI/CD for review tool like CodeRabbit for PR review. +2. Have the coding model write unit tests for edge cases. +3. Use fast agent like composer to clean up comments and refactor code. ### Unorganized Tips: 1. Use worktrees. But automate the setup.