noname-shuying/AGENTS.md

Comet Ambient Resume

In this repository, before starting work that may need code changes or investigation, pass the current user request to the read-only probe when a Comet workflow may already be active: comet resume-probe . --stdin --json.

• If the user explicitly invokes any Comet Skill through the host (for example, @comet, /comet, @comet-native, or /comet-hotfix), that explicit invocation takes precedence over this resume protocol; do not run the resume probe, and enter the invoked Skill directly.
• If the user explicitly invokes a non-Comet skill or slash command through the host, the task intent is already explicit in that invocation: do not run the resume probe, and execute the invoked skill directly.
• If you are already inside a Comet flow (including while waiting for the user to answer a question you asked in that flow), do not run the resume probe; treat replies such as option picks as continuation of the current change and proceed directly with the chosen option.
• Trust only the returned workflow, skill, and entrySource; project configuration or the no-config compatibility fallback alone selects them. Do not scan or switch to the other workflow.
• If the probe returns auto_resume, briefly state the selected active change and enter the permanent entry in nextCommand. Do not treat a state command as the resume entry or advance it blindly.
• If the probe returns ask_user, ask one short question and wait.
• If the current request did not explicitly invoke a Comet Skill and the probe returns out_of_scope or none, do not enter the Comet workflow.
• An out_of_scope or none result only means do not enter the Comet workflow for this new request; it never pauses or exits a Comet flow that is already in progress.
• If configuration or state is invalid and nextCommand is absent, stop and report the reason; do not guess another workflow.
• Never attach unrelated work merely because an active change exists. The Native entry inspects uncommitted work; the probe does not attribute it automatically.