comet

Files (26)

• SKILL.md
• openai.yaml · agents/
• edit-review.md · reference/
• host-check.md · reference/
• task-learning.md · reference/
• comet-phase-guard.en.md · rules/
• comet-phase-guard.md · rules/
• comet-workflow-guard.en.md · rules/
• comet-workflow-guard.md · rules/
• checks.yaml · runtime/classic/
• guardrails.yaml · runtime/classic/
• skill.yaml · runtime/classic/
• comet-archive.mjs · scripts/
• comet-check.mjs · scripts/
• comet-entry-runtime.mjs · scripts/
• comet-env.mjs · scripts/
• comet-guard.mjs · scripts/
• comet-handoff.mjs · scripts/
• comet-hook-guard.mjs · scripts/
• comet-hook-router-guard.mjs · scripts/
• comet-hook-router.mjs · scripts/
• comet-intent.mjs · scripts/
• comet-resume-probe.mjs · scripts/
• comet-runtime.mjs · scripts/
• comet-state.mjs · scripts/
• comet-yaml-validate.mjs · scripts/

SKILL.md (first lines)

# Comet Entry

`/comet` selects Native or Classic from project configuration, then passes the request to that workflow's Skill.

Once this Skill is loaded, immediately follow the steps below. The user has already chosen Comet: continue their request without reconsidering whether to use it or merely explaining why you would not proceed.

1. Run the Comet CLI installed on PATH in the current project:

   ```text
   comet workflow resolve . --activate --json
   ```

   If the project has no `.comet/config.yaml`, this command saves the global defaults in the project and creates the configured artifact directories. Later changes to global defaults do not overwrite this project's saved configuration.

   On `command not found`, `executable not found`, or `ENOENT`, stop and report an incomplete Comet CLI installation. Do not search for Skill files, scan platform configuration directories, or invoke an internal bundle directly.

   If the CLI starts but exits nonzero, cannot parse the configuration, or returns invalid JSON or fields, preserve the original error and stop. Do not choose another entry yourself.

2. Parse the JSON. Only accept `schema: comet.workflow-resolution.v1` and one of the two `skill` values below.
3. Immediately use the Skill tool to load the entry named by `skill`. Load exactly one entry:
   - `/comet-native` → **Execute immediately:** Use the Skill tool to load the `comet-native` skill. Do not skip this step.
   - `/comet-classic` → **Execute immediately:** Use the Skill tool to load the `comet-classic` skill. Do not skip this step.

   Pass the user's original request unchanged to that Skill.

After workflow selection, the selected Skill locates the change's workspace and current phase, then loads task context, personal memory, and project knowledge; use `comet memory context` when needed.

Load context as needed. First use `comet task ... --json` to obtain a Context Manifest containing only summaries, reasons for recommending each item, and stable IDs. Add `--expand-context "<id>"` when the step needs the full text, source, or verification method.

After using an item and establishing its outcome, report the actual result with its returned application ID: `--application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure`. Do not report successful use of an item that was not used.

Do not switch workflows based on task size, file count, active changes, or model judgment. Native and Classic manage their own changes, state, and artifacts.

From rpamis/comet, MIT.

More from rpamis/comet