Skill Tracer
Skills › Compound Engineering › ce-compound-refresh › modes.md

modes.md

27 lines · skills/ce-compound-refresh/references/modes.md at 3449230

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Interactive and non-interactive modes
2
3If the arguments contain `mode:non-interactive` (or its deprecated alias `mode:headless`), strip those tokens (the remainder is a scope hint) and run **non-interactive**; otherwise run **interactive**.
4
5**Interactive:** apply unambiguous actions directly; ask the user only on genuine judgment calls (the Decide section of `references/classify.md` lists them).
6
7**Non-interactive:** never pause for input, in any phase.
8
9- Apply all safe actions: Keep, Update, Consolidate, auto-Delete (only under the three-condition gate in `references/classify.md`), Replace (when evidence is sufficient). If a write succeeds, record it as **applied**; if it fails (e.g., permission denied), record it as **recommended** and continue — never stop to ask for permissions.
10- When classification is genuinely ambiguous or Replace evidence is insufficient, mark the doc stale instead: add `status: stale`, `stale_reason: [what you found]`, `stale_date: YYYY-MM-DD` to its frontmatter. Err toward stale-marking over incorrect action. If even that write fails, record it as recommended.
11- Relocations auto-apply only under the four-condition gate in `references/classify.md`; otherwise recommend. Splits are always recommend-only: fragment boundaries are a retrieval-value judgment with no ground truth.
12- With no scope hint, process everything — no scope-narrowing questions. With a scope hint that matches nothing, report the miss and exit; do not widen to all docs.
13- The report (see Report) is the primary deliverable.
14- A worth-lens intent in the arguments (SKILL.md, Worth lens) is read but never confirmed: read `references/worth-audit.md`, run its evidence gathering, and record every worth-based Delete or Update under **Recommended** with the quoted artifacts. Nothing is deleted or cut on inferred intent. Accuracy-based actions apply as above.

Interactive and non-interactive modes

If the arguments contain mode:non-interactive (or its deprecated alias mode:headless), strip those tokens (the remainder is a scope hint) and run non-interactive; otherwise run interactive.

Interactive: apply unambiguous actions directly; ask the user only on genuine judgment calls (the Decide section of references/classify.md lists them).

Non-interactive: never pause for input, in any phase.

  • Apply all safe actions: Keep, Update, Consolidate, auto-Delete (only under the three-condition gate in references/classify.md), Replace (when evidence is sufficient). If a write succeeds, record it as applied; if it fails (e.g., permission denied), record it as recommended and continue — never stop to ask for permissions.
  • When classification is genuinely ambiguous or Replace evidence is insufficient, mark the doc stale instead: add status: stale, stale_reason: [what you found], stale_date: YYYY-MM-DD to its frontmatter. Err toward stale-marking over incorrect action. If even that write fails, record it as recommended.
  • Relocations auto-apply only under the four-condition gate in references/classify.md; otherwise recommend. Splits are always recommend-only: fragment boundaries are a retrieval-value judgment with no ground truth.
  • With no scope hint, process everything — no scope-narrowing questions. With a scope hint that matches nothing, report the miss and exit; do not widen to all docs.
  • The report (see Report) is the primary deliverable.
  • A worth-lens intent in the arguments (SKILL.md, Worth lens) is read but never confirmed: read references/worth-audit.md, run its evidence gathering, and record every worth-based Delete or Update under Recommended with the quoted artifacts. Nothing is deleted or cut on inferred intent. Accuracy-based actions apply as above.
Raw lines 1 to 15
Involves a person ask the user :5
16## Blocking questions
18Wherever this skill asks the user something, use the host's blocking question tool already in the current tool list (match by capability, not by a host-specific name). Presence in the current tool list is proof the tool exists; never call a user-facing question tool to discover whether it exists. If a matching tool is listed but unloaded, use the host's tool-discovery primitive to load that capability — do not search for another host's tool name. Fall back to numbered options on the host's user-visible chat surface only when no such tool is in the list or a real question call errors. Never silently skip the question. Ask one question at a time, prefer multiple choice, lead with the recommended option and a one-sentence rationale.

Blocking questions

Wherever this skill asks the user something, use the host's blocking question tool already in the current tool list (match by capability, not by a host-specific name). Presence in the current tool list is proof the tool exists; never call a user-facing question tool to discover whether it exists. If a matching tool is listed but unloaded, use the host's tool-discovery primitive to load that capability — do not search for another host's tool name. Fall back to numbered options on the host's user-visible chat surface only when no such tool is in the list or a real question call errors. Never silently skip the question. Ask one question at a time, prefer multiple choice, lead with the recommended option and a one-sentence rationale.

Raw lines 16 to 19
20## CONCEPTS.md bootstrap requests
22If invoked specifically to create or bootstrap `CONCEPTS.md` ("create a CONCEPTS.md", "build the concept map"), the intent is ambiguous between two jobs — disambiguate with a blocking question:
241. **Create CONCEPTS.md (build the concept map)** — skip the `<root>/solutions/` classification work. Read `references/concepts-vocabulary.md` and follow its **Seed goal** and **Scope of a seed** (repo-wide) rules: seed the project's core domain nouns from the declared domain model, write the preamble (see Vocabulary Capture), cluster per the organization rules, run the Discoverability Check per `references/discoverability.md`, then commit per `references/commit.md` — do not leave the bootstrap uncommitted.
252. **Run a refresh cycle** — proceed normally; `CONCEPTS.md` is seeded (if absent) and reconciled during Vocabulary Capture.
27In non-interactive mode, default to the refresh cycle and note in the report that a standalone repo-wide bootstrap was not run.

CONCEPTS.md bootstrap requests

If invoked specifically to create or bootstrap CONCEPTS.md ("create a CONCEPTS.md", "build the concept map"), the intent is ambiguous between two jobs — disambiguate with a blocking question:

  1. Create CONCEPTS.md (build the concept map) — skip the <root>/solutions/ classification work. Read references/concepts-vocabulary.md and follow its Seed goal and Scope of a seed (repo-wide) rules: seed the project's core domain nouns from the declared domain model, write the preamble (see Vocabulary Capture), cluster per the organization rules, run the Discoverability Check per references/discoverability.md, then commit per references/commit.md — do not leave the bootstrap uncommitted.
  2. Run a refresh cycle — proceed normally; CONCEPTS.md is seeded (if absent) and reconciled during Vocabulary Capture.

In non-interactive mode, default to the refresh cycle and note in the report that a standalone repo-wide bootstrap was not run.

Raw lines 20 to 27