Comet Classic

Comet Classic — OpenSpec + Superpowers

Classic has five phases: Open → Design → Build → Verify → Archive. OpenSpec manages specifications and archiving. Superpowers provides design methods and the planning, execution, and review methods selected by the user. The full workflow requires brainstorming and design confirmation; hotfix/tweak follow their preset steps.

1. Resolve the Target and Workspace

Before starting or recovering, use comet-classic/reference/classic-layout.md to resolve logical artifact paths, and read “CLI Bootstrap” in comet-classic/reference/scripts.md. Call the public Comet CLI and use its OpenSpec adapter for OpenSpec commands. Read only the reference sections needed for the current action. Reuse instructions already in context that remain valid; a reference to one section does not require reading the rest of the file.

• When Classic was not explicitly invoked and existing work may need to resume: read Ambient Resume in comet-classic/reference/context-recovery.md and follow comet resume-probe . --stdin --json. Only auto_resume enters automatically; for ask_user ask by reason using the Ambient Resume table's question and options; out_of_scope/none does not enter.
• When starting a new request or the target change is unclear: read the minimal example and target-selection rules in comet-classic/reference/intent-frame.md. List active changes, fill a CometIntentFrame, and run comet classic intent route --stdin. The Agent extracts intent fields from evidence; Runtime computes the route. Follow its result without inventing a separate set of prose scoring rules.
• When the target change is explicit and already initialized (.comet.yaml exists): bind its workspace below. Do not bind early when several active changes exist and none has been selected. A new change (not yet initialized) goes straight to /comet-open or the matching preset Skill, which prepares the workspace before initializing; workspace resolve reports not-found for an uninitialized change.

comet classic workspace resolve <change-name> --json
# Enter the returned projectRoot before selecting the change
comet state select <change-name>
comet state next <name> --json

Continue from the returned phase, configuration, and next route. Send a new full change to /comet-open, which prepares the workspace and creates OpenSpec artifacts and .comet.yaml. Send confirmed hotfix/tweak choices to /comet-hotfix or /comet-tweak for their own initialization steps. Do not call /opsx:new directly. If an existing change has no state file, follow “Entry Errors and Recovery” in context-recovery.md to establish its workflow and recover. Report malformed state rather than guessing a phase from existing artifacts.

A new full change must have its workspace selected before Open creates artifacts. Full-workflow isolation may be current, branch, or worktree; prepare a Worktree for explicit parallel-work requests, and otherwise follow comet-classic/reference/workspace.md. Hotfix/tweak confirm and bind workspaces during their own initialization. Resume in the bound workspace. If branch ownership has changed, rebind according to the user's confirmed choice; ask only when valid authorization is missing.

2. Load the Current Phase

While working on the same set of tasks, reuse state returned by the current commands and context already read. When a state update returns the latest state and agent.continuation, continue directly. Query again only when those fields are missing, the workspace changes, session recovery lacks context, or external state changes. Select checks according to the risk of the current changes; Verify still owns one final integrated review of the completed implementation.

After binding the workspace and obtaining phase, read and follow Task Context and Artifact Language, and run comet task. Use the configured artifact language. Start from Context Manifest summaries and expand only information still missing for the current step. Report outcomes truthfully after actually using an item, and save a checkpoint at task end.

Memory learning submits only reusable user information; never save task summaries, progress, command output, or test results as Personal Memory. Complete the learning check in the task context reference before task completion and record submitted, no-observation, or not-run.

Project experience and personal preferences are stored separately: before task completion, write project-validated and reusable experience to Project Memory with comet knowledge remember; only user preferences and stable collaboration habits go to Personal Memory. See Task Context and Artifact Language for the commands and filtering rules.

Recommend a lightweight workflow only for a new request. Enter directly when its risk fits the preset and the user has explicitly selected it. When the Agent makes the recommendation, explain why, present hotfix/tweak and full with their effects, and wait for confirmation. Never silently downgrade an existing full change. Assess public APIs, data migrations, security, concurrency, and cross-module design by their actual risks; a small file count does not waive necessary steps.

When running hotfix/tweak, read the chosen preset's escalation rules. If a listed condition occurs or the changed-file count exceeds the advisory threshold, present the choice to continue the preset or upgrade to full, and wait for an answer. Run comet state transition <name> preset-escalate only after the user chooses to upgrade. verify_mode determines verification depth; it does not select the workflow or replace escalation confirmation.

On session recovery, external changes, or discrepancies between actual work and plan, task, review, or delivery records, read comet-classic/reference/context-recovery.md. Use nextAction from the current phase entry to identify unfinished steps. Reuse valid configuration and work; an unchecked task is not proof that implementation is missing. Follow that reference for the recovery procedure.