Starter briefs
Delete a dead flag and every reference to it
Name the flag that always resolves one way now. Get it and its dead branch removed.
The brief
Copy this text as it is, or change the specifics to match your own case, then file it as a task.
Copy this and file it as a task
This feature flag has resolved the same way for a long time now and doesn't need to exist anymore. Remove the flag, delete the code path it always skips, and clean up every place that still checks it, including any config or test setup that references it. Keep the behavior the flag currently produces; just stop it being conditional.
Why this works
It names one flag and states the invariant that keeps the change safe: the resulting behavior must match what the flag already produces today. That gives a reviewer a precise thing to check the diff against, so nothing is left to a judgment call.
How it runs
Plan, code, review, merge, verify
- plan
Finds every reference to the flag across code, config, or test setup, then confirms which branch it always takes now.
- code
Removes the flag, deletes the dead branch, and simplifies every call site that checked it.
- review
Confirms the resulting behavior matches exactly what the flag already produced, with no branch left half-removed.
- merge
Opens a pull request that removes only the one flag.
- verify
Confirms no reference to the flag remains and behavior is unchanged.
What you need on hand
- The flag's name and which value it has resolved to for a while
- Every place that references it: in code, in config, or in tests
- A person to confirm the surviving behavior matches the flag's current resolved state
Done when
- No code, config, or test still references the flag
- The behavior it used to gate is unchanged
- The dead branch it used to skip is truly gone, no longer just unreachable
Proof, not a promise
No real task in examples.ts matches this brief's exact shape yet. What's real is the mechanism: an agent finds every reference to a flag before touching it, so removing it also removes the dead branch instead of leaving an orphaned check nobody notices.
Keep going
Related briefs
Add a filter to a list we already have
Name the list and what you want to narrow it by, and get a working filter control for it.
Bump one dependency and fix what breaks
Name the dependency and the version, and get an upgrade with whatever it breaks already fixed.
Pull one duplicated block into one place
Point at the same logic copied into more than one place, and get it merged into one shared version.
Round up your herd.
Bring every human and every agent onto one table. Watch the work move. Costs update as it happens.