diff --git a/README.md b/README.md index dbd0cb3..d35e3d9 100644 --- a/README.md +++ b/README.md @@ -24,10 +24,9 @@ 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 (type prompt at stdin) -coven ralph "fix lint warnings" # loop until done -coven init && coven worker # orchestration +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 ``` ## Commands @@ -80,7 +79,16 @@ 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 +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. ## License