From a651737664ba593282f3fb6fac1e17f1a2eada4f Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Tue, 24 Feb 2026 00:04:20 +0000 Subject: [PATCH 1/2] Update README examples to reflect intended usage patterns Quick Start examples are now grounded in real test cases: ralph shows the TODO.md iteration pattern, interactive mode highlights Alt+Enter follow-ups, and orchestration references brief.md. The Orchestration section now includes a concrete brief.md example from the concurrent_workers test fixture. Co-Authored-By: Claude Opus 4.6 --- README.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index dbd0cb3..c499479 100644 --- a/README.md +++ b/README.md @@ -25,9 +25,9 @@ The native Claude Code TUI is resource-heavy, blocks on permission prompts, and ```bash coven "explain this codebase" # one-shot prompt -coven # interactive (type prompt at stdin) -coven ralph "fix lint warnings" # loop until done -coven init && coven worker # orchestration +coven # interactive — Alt+Enter to follow up +coven ralph "pick one task from TODO.md, do it, check it off" +coven init && coven worker # multi-agent orchestration from brief.md ``` ## Commands @@ -80,7 +80,15 @@ All session commands (`coven`, `ralph`, `worker`) accept: ## Orchestration -`coven init` + `coven worker` enable multi-agent orchestration. Workers run a generic agent loop: dispatch reads `brief.md` and picks tasks, then chains through main and review agents via `` transitions. See `.coven/system.md` after init for details. +`coven init` + `coven worker` enable multi-agent orchestration. Write tasks in `brief.md`, then start workers: + +```markdown +# Brief +- Fix the typo in README.md: change "Helo" to "Hello" +- Create a CONTRIBUTING.md with a "how to contribute" section +``` + +Workers run a generic agent loop: dispatch reads `brief.md` and picks tasks, then chains through main and review agents via `` transitions. Run multiple workers for parallel execution. See `.coven/system.md` after init for details. ## License From 7db01da74cfa127f3cf36038cbfd2496a749a715 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Tue, 24 Feb 2026 00:19:28 +0000 Subject: [PATCH 2/2] Address review feedback on README examples - Merge interactive/one-shot into single "single session" example - Replace fixed todo list with scalable inspect/fix orchestration pattern Co-Authored-By: Claude Opus 4.6 --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c499479..d35e3d9 100644 --- a/README.md +++ b/README.md @@ -24,8 +24,7 @@ The native Claude Code TUI is resource-heavy, blocks on permission prompts, and ## Quick Start ```bash -coven "explain this codebase" # one-shot prompt -coven # interactive — Alt+Enter to follow up +coven "explain this codebase" # single session — Alt+Enter to follow up coven ralph "pick one task from TODO.md, do it, check it off" coven init && coven worker # multi-agent orchestration from brief.md ``` @@ -84,8 +83,9 @@ All session commands (`coven`, `ralph`, `worker`) accept: ```markdown # Brief -- Fix the typo in README.md: change "Helo" to "Hello" -- Create a CONTRIBUTING.md with a "how to contribute" section +Choose between two activities: +- Inspect program output across test scenarios and document issues in issues.md +- Pick up an issue from issues.md and do it ``` Workers run a generic agent loop: dispatch reads `brief.md` and picks tasks, then chains through main and review agents via `` transitions. Run multiple workers for parallel execution. See `.coven/system.md` after init for details.