# Comet

## Docs

- [comet doctor — Diagnose Your Comet Installation](https://docs.comet.rpamis.com/cli/doctor.md): comet doctor checks installation health — working dirs, installed skills, bundled scripts, and .comet.yaml files. Each result is pass, warn, or fail.
- [comet init — Initialize Comet in Your Project](https://docs.comet.rpamis.com/cli/init.md): Set up Comet by installing OpenSpec, Superpowers, and Comet skills to AI coding platforms. Flags: --yes, --scope, --skip-existing, --overwrite, --json.
- [comet status — View Active Changes and Next Command](https://docs.comet.rpamis.com/cli/status.md): comet status displays active OpenSpec changes, task progress, and the recommended next workflow command. Use --json for machine-readable output.
- [comet update — Update Comet Package and Skills](https://docs.comet.rpamis.com/cli/update.md): comet update upgrades the npm package and refreshes Comet skill files across all detected targets. Flags: --json, --language (en|zh), --scope (global|project).
- [Comet Skills: Workflow Instruction Files Explained](https://docs.comet.rpamis.com/concepts/skills.md): Three skill groups installed by comet init: Comet orchestration, OpenSpec spec lifecycle, and Superpowers methodology — powering the five-phase workflow.
- [Comet .comet.yaml State Management Field Reference](https://docs.comet.rpamis.com/concepts/state-management.md): Reference for .comet.yaml: field definitions, state machine constraints, and bash transition commands for Comet's resumable five-phase workflow state.
- [The Comet Five-Phase Development Workflow Explained](https://docs.comet.rpamis.com/concepts/workflow.md): How Comet chains OpenSpec and Superpowers into five phases — open, design, build, verify, archive — with auto phase detection and resumable state.
- [Comet Project Structure: Skills, OpenSpec, and State Files](https://docs.comet.rpamis.com/guides/project-structure.md): Learn how Comet organizes skills, OpenSpec change artifacts, Superpowers design documents, and state files within your project directory.
- [Resuming an Interrupted Comet Workflow Mid-Session](https://docs.comet.rpamis.com/guides/resuming-workflow.md): When your AI coding session closes mid-workflow, run /comet to automatically detect the current phase and continue from exactly where you left off.
- [Recover from Comet State Errors and Inconsistencies](https://docs.comet.rpamis.com/guides/state-recovery.md): Learn how to diagnose and fix .comet.yaml state inconsistencies using comet doctor, comet status, and the comet-state.sh check --recover command.
- [Comet — OpenSpec + Superpowers Dual-Star AI Workflow](https://docs.comet.rpamis.com/introduction.md): Comet combines OpenSpec's spec lifecycle management with Superpowers' TDD-driven development into a five-phase AI-assisted workflow for software projects.
- [Phase 5: Archive — Sync Specs and Close the Change](https://docs.comet.rpamis.com/phases/archive.md): The Archive phase syncs delta specs to main specs, annotates design doc and plan frontmatter, moves the change to archive, and marks the workflow complete.
- [Phase 3: Plan and Build — Plan, Isolate, and Execute](https://docs.comet.rpamis.com/phases/build.md): The Build phase creates an implementation plan, then executes it through your chosen isolation method and build mode — committing one task at a time.
- [Phase 2: Deep Design — Brainstorming and Design Doc](https://docs.comet.rpamis.com/phases/design.md): The Design phase uses Superpowers brainstorming to create a Design Doc and delta specs — a mandatory deep-design step for every full-workflow change.
- [Phase 1: Open — Explore Ideas and Create Your Change](https://docs.comet.rpamis.com/phases/open.md): The Open phase explores your idea through OpenSpec, creates a change with proposal.md, design.md, and tasks.md, and pauses for your explicit confirmation.
- [Phase 4: Verify and Finish — Test and Close the Branch](https://docs.comet.rpamis.com/phases/verify.md): The Verify phase runs tests, saves a verification report, and handles the branch — the guard blocks archive until both conditions are met and confirmed.
- [AI Coding Platform Support — All 28 Platforms for Comet](https://docs.comet.rpamis.com/platforms.md): Comet installs Skills to 28 AI coding platforms including Claude Code, Cursor, Windsurf, GitHub Copilot, and more. See which directory each platform uses.
- [Comet Hotfix Preset: Quick Bug Fixes Without Brainstorming](https://docs.comet.rpamis.com/presets/hotfix.md): The hotfix preset skips brainstorming and deep design, going straight from open to build, verify, and archive — for small, well-understood bug fixes.
- [Comet Tweak Preset: Small Changes Without Full Planning](https://docs.comet.rpamis.com/presets/tweak.md): The tweak preset skips brainstorming and the full plan, using a lightweight build and verification — ideal for copy, config, docs, and prompt edits.
- [Comet Quickstart: Install and Run Your First AI Workflow](https://docs.comet.rpamis.com/quickstart.md): Install Comet, run comet init in your project, and invoke your first /comet workflow in an AI coding tool — all in under five minutes.
- [comet-archive.sh — Automated Change Archive for Comet](https://docs.comet.rpamis.com/scripts/comet-archive.md): comet-archive.sh completes the Comet workflow in one command — validating state, syncing specs, annotating docs, moving the change, and setting archived: true.
- [comet-guard.sh — Phase Transition Guard for Comet](https://docs.comet.rpamis.com/scripts/comet-guard.md): comet-guard.sh validates exit conditions for each workflow phase. Pass --apply to auto-update .comet.yaml when all checks pass, or get a BLOCKED report.
- [comet-handoff.sh — Design Context Handoff for Comet](https://docs.comet.rpamis.com/scripts/comet-handoff.md): comet-handoff.sh creates a SHA256-traced context package from OpenSpec artifacts and writes handoff_context and handoff_hash to .comet.yaml for guard validation.
- [comet-state.sh — Unified State Management for .comet.yaml](https://docs.comet.rpamis.com/scripts/comet-state.md): comet-state.sh is the sole interface for .comet.yaml — use it to init, get, set, transition, check entry conditions, or run a scale assessment.
- [Comet Automation Scripts: Guard, State, Handoff, Archive](https://docs.comet.rpamis.com/scripts/overview.md): Six shell scripts power Comet's workflow — guard enforces phase transitions, state manages .comet.yaml, handoff packages context, and archive closes changes.