Comet Preset Path: Tweak
Tweak is a preset workflow for Comet's five-stage capabilities, not an independent parallel process. It reuses the open, build, verify, and archive capabilities, only skipping brainstorming and the full plan.
It applies to small-scale non-bug changes, such as copy adjustments, configuration tweaks, partial optimizations of documents or prompts.
Applicable Conditions (must meet all):
- No new capability added
- No architecture changes
- No interface changes involved
- Usually no more than 3 tasks and 4 files
Inapplicable Scenarios: If it's found during the change that capability, architecture or interface adjustments are needed, upgrade to the full
process.
Workflow (preset workflow, 4 phases)
Execution chain: open → lightweight build → light verify → archive. Tweak provides default decisions for each phase: streamlined initiation, lightweight build, lightweight verification, and archiving after verification passes.
Locate the Comet scripts first:
bash
COMET_SEARCH_ROOTS=("." "$HOME/.claude/skills" "$HOME/.codex/skills" "$HOME/.cursor/skills")
COMET_STATE="${COMET_STATE:-$(find "${COMET_SEARCH_ROOTS[@]}" -path '*/comet/scripts/comet-state.sh' -type f -print -quit 2>/dev/null)}"
COMET_GUARD="${COMET_GUARD:-$(find "${COMET_SEARCH_ROOTS[@]}" -path '*/comet/scripts/comet-guard.sh' -type f -print -quit 2>/dev/null)}"
COMET_ARCHIVE="${COMET_ARCHIVE:-$(find "${COMET_SEARCH_ROOTS[@]}" -path '*/comet/scripts/comet-archive.sh' -type f -print -quit 2>/dev/null)}"
1. Streamlined Initiation (preset open)
Reuse Comet's open capability to create a change, but use tweak defaults: skip the
long exploration and directly enter streamlined change creation.
Execute Immediately: Use the Skill tool to load the
skill. Skipping this step is prohibited.
After loading the skill, follow its guidance to create streamlined deliverables:
- — Change motivation + objectives + scope
- — Brief implementation description (no need for solution comparison)
- — No more than 3 tasks
- No delta spec required (unless the change modifies the acceptance scenarios of existing specs; once delta spec is needed, upgrade to full )
Initialize the Comet state file:
bash
bash "$COMET_STATE" init <name> tweak
Verify the state after initialization:
bash
bash "$COMET_STATE" check <name> open
Phase guard completes the open → build transition:
bash
bash "$COMET_GUARD" <change-name> open --apply
2. Lightweight Build (preset build)
Use tweak defaults:
. Skip
superpowers:brainstorming
and
superpowers:writing-plans
.
Before continuing or starting modifications, handle uncommitted changes according to the
comet/reference/dirty-worktree.md
protocol. If the scope exceeds tweak after attribution, follow the "Upgrade Conditions" in this document.
Execute Immediately: Execute tasks one by one as per tasks.md:
- Read
openspec/changes/<name>/tasks.md
- For each unfinished task:
- Modify the target file according to the task description
- Run the project formatting command (e.g., , , etc.)
- Run relevant tests to confirm pass
- Check the corresponding in tasks.md to
- Commit the code with the commit message format:
tweak: <brief change description>
- After all tasks are completed, explicitly run the project's relevant tests and build commands
- Run the phase guard to complete the build → verify transition:
bash
bash "$COMET_GUARD" <change-name> build --apply
The state file will be automatically updated to
,
, then enter verification.
3. Lightweight Verification (preset verify)
Reuse
. Tweak must maintain lightweight verification conditions: ≤ 3 tasks, ≤ 4 files, no delta spec, no new capability.
Execute Immediately: Use the Skill tool to load the
skill. Skipping this step is prohibited.
If the scale assessment enters the full verification path, stop tweak and upgrade to full
.
After verification passes, record
as
in
according to the
rules; this state cannot be skipped before archiving.
4. Archiving (preset archive)
Reuse
. Before archiving,
must satisfy
.
Execute Immediately: Use the Skill tool to load the
skill for archiving. Skipping this step is prohibited.
Continuous Execution Mode
<IMPORTANT>
The Tweak process is **one-time continuous execution**. After calling `/comet-tweak`, the agent must automatically complete all 4 phases without pausing to wait for user input (unless upgrade conditions are met and user confirmation is required).
Execution sequence: Streamlined Initiation → Lightweight Build → Lightweight Verification → Archiving → Completion
Immediately proceed to the next phase after completing each phase, no need for user re-input. The corresponding Comet/OpenSpec/Superpowers skills must still be called as required above within each phase.
</IMPORTANT>
Upgrade Conditions
Stop the tweak process and upgrade to full
when
any of the following conditions are met:
| Condition | Description |
|---|
| Changes involve 5+ files | Exceeds the scope of minor tweaks |
| Cross-module coordinated modifications | Requires cross-component coordination |
| Need to add 5+ test cases | Change complexity increases |
| Addition or deletion of configuration items | Configuration changes beyond value modification |
| Need to add new capability | Exceeds partial optimization |
| Need delta spec | Affects existing specifications |
Upgrade method: Supplement the Design Doc based on the current change (execute
), then follow the full process normally.
Exit Conditions
- Minor changes completed and tests passed
- Change archived
- No new capability added, no architecture adjustment or interface change
- Phase Guard: Run
bash "$COMET_GUARD" <change-name> build --apply
bash "$COMET_GUARD" <change-name> verify --apply