waterfall

Files (1)

• SKILL.md

SKILL.md (first lines)

# Waterfall

This skill is invoked with an argument that tells us what to implement.

You will respond to the user with a plan (focusing more on architecture-level than walls of text), who then approves it (unless they pre-approve). After they approve you must finalize the plan to remove all ambiguities using the question tool, along with asking the user these questions:

- Which harness to run (e.g.: omp, codex --yolo, etc.)
- Which model to use for the selected harness
- Whether to auto-merge on green CI at end

Then you open a new Kolu split terminal, and run the implementor agent (in the same $PWD worktree as you) to implement the plan opening PR[^pr] and then wait[^debrief] for the implementor to finish. Then, you review the PR per repo's guidelines (e.g.: [Cordis-perfection](https://github.com/juspay/olai/blob/master/docs/architecture/cordis.md), [/solidjs](https://github.com/juspay/skills/blob/main/skills/solidjs/SKILL.md)) posting it in the PR itself, and then ask the implementor to address it. Then you re-review. Once satisfied, you ask the implementor do a final refactor per https://kolu.dev/blog/hickey-lowy/ and then to run CI (to save time, we don't run full CI until reviews are fully done). Once the PR is green, our work is done (unless auto-merge is enabled).

**IMPORTANT**: 
- If you are Fable model, you must **NOT** use Fable for any subagents you spawn unless that subagent requires premium intelligence.
- Keep it cheap: the brief holds only what this skill and the repo rules require; tests run once per round and CI once at the end; mid-round asks wait for the next round; compact the implementor only when the context is large, or before a long new phase like CI

**BANS**:
- You are banned from doing any implementation yourself; that happens only through the implementor agent.
- You are banned from starting new agents or new PRs without human's approval.
- You are banned from terminating the implementor agent terminal *unless* the PR gets merged or closed.

[^debrief]: Use kolu debrief to wait on any kolu terminal running an agent to go idle.
[^pr]: PR ttle & body should be interesting to read to users, not boring.

From juspay/skills, MIT.

More from juspay/skills