tweak is Comet’s lightweight OpenSpec path. It runs open -> build -> verify -> archive, skips brainstorming and full planning, but treats delta spec as a first-class artifact and builds through OpenSpec apply.
tweak is not a casual edit path; it uses delta spec and OpenSpec apply for bounded medium changes.
Use tweak for configuration changes, documentation or prompt improvements, behavior tuning, and brownfield changes that need a delta spec but do not require full deep design.When to use it
Use tweak when all of these are true:- The work fits one OpenSpec change.
- You do not need a Superpowers Design Doc or full implementation plan.
- There is no cross-module architectural coordination.
- Scope is predictable.
Relationship to full and hotfix
Flow
OpenSpec apply build
The apply path belongs to tweak. The agent must readopenspec instructions apply --change <name> --json, consume listed context files, complete tasks, run relevant tests, and commit focused changes. Full workflow must not reuse this path.
init <name> tweak writes the same lightweight execution defaults as hotfix (build_mode: direct, tdd_mode: direct, review_mode: off, verify_mode: light) but leaves isolation as null. At entry, tweak asks you to explicitly keep the current branch, create a branch, or create a worktree. The confirmed isolation and bound_branch describe the real execution workspace, and later accidental branch switches are blocked. tdd_mode: direct skips Red-Green-Refactor but still requires relevant tests and regression evidence.
Verification
If a tweak has a delta spec, verification is forced to full so OpenSpec consistency is checked. Without a delta spec, light verification is usually enough.Upgrade signals
Tweak pauses for qualitative signals such as cross-module coordination, need to split into multiple OpenSpec changes, schema change, public API change, or deep architecture issue. File count is a tripwire for user choice, not an automatic upgrade. Upgrade through:Recovery
Tweak is idempotent. After interruption, run/comet. When configuration selects Classic, the internal /comet-classic router reads .comet.yaml and returns to /comet-tweak when needed.