Small flow
flowchart LR
A(["Small change"]) --> B{"You say it in one line"}
B --> C["Session starts"]
C --> D["Edit inline"]
D --> E["Focused tests"]
E --> F["One package reviewer"]
F --> G(["Finish"])
D -.->|"grows past a few files"| H["Switch to Feature"]
How it works
Section titled “How it works”A plan is worth its cost when the work is big enough to go wrong. A rename is not: renaming build to render touches a handful of files, and any mistake shows in the tests. So Small drops the plan, the review plan and the agent waves, and keeps two things: the session and the reviewer.
The session still opens before the first edit, so the change sits on its own branch and is easy to inspect or throw away. The change itself happens in a few tool calls, and superlite says that it is working inline.
The reviewer is the safety net you keep. One superlite:package-reviewer reads the diff before superlite claims done. For a change this size, this is the whole review.
If you use the human orchestrator, your yes in chat is the only approval. There is no review plan to read.
Example: rename build to render
Section titled “Example: rename build to render”Say a function name no longer fits and you want it changed everywhere.
-
You say it in one line.
Claude Code · ~/social ❯ /superlite:small Rename `build` to `render` everywhereYou named
small, so there is no menu to answer and no plan to read. superlite opens a session first, so the rename sits on its own branch and is easy to inspect or throw away. -
superlite edits inline. It says so, then changes the function, its callers and the tests.
src/pages.py from site import buildfrom site import renderhtml = build(page)html = render(page)An edit this size takes a few tool calls. A plan document would cost more than the change.
-
Focused tests run.
Claude Code · ~/social tests/test_pages.py tests/test_site.py passedOnly the tests for the files it changed run. The full suite defaults to no and superlite does not ask.
-
One reviewer reads the diff. This is the
superlite:package-revieweragent. It fixes what it finds and adds a regression test for each fix, and it is the whole review for a change this size. -
superlite says it is done.
Claude Code · ~/social done: 6 files changed, tests pass, reviewer found nothing to fixYou decide: keep it, adjust it or throw the branch away.
superlite-cli finishmarks the session finished and leaves your work where it is.
What you end up with: the rename, uncommitted on the session branch, with passing tests and a review behind it.
Good to know
Section titled “Good to know”- The full suite defaults to no, and superlite asks nothing about it: only the affected tests run.
- If the change spans more than a few files or several chains, superlite says so and switches to the Feature flow.
- Start with
/superlite:smallwhen you know the change is small. Otherwise superlite suggests a flow from the words “rename”, “typo” or “bump”, or from a request that names one file.