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

scope.md

18 lines · skills/ce-compound-refresh/references/scope.md at 3449230

Open on GitHub

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

1# Scope selection and triage
2
3Find all `.md` files under `<root>/solutions/`, excluding `README.md` files and anything under `_archived/` (if `_archived/` exists, flag it in the report as legacy to clean up). READMEs are excluded as review *candidates* only: whenever an action deletes, renames, moves, consolidates, or replaces a doc a catalog README lists, update that README's rows mechanically as part of the action's cleanup.
4
5Words that describe the run rather than name a doc, category, module, or keyword are not a scope hint: an operation word (`refresh`, `audit`, `check`), a worth-lens intent (SKILL.md, Worth lens), or a mode token. Remove them first; the remainder is the hint, and an empty remainder means the whole store.
6
7If a scope argument was provided, narrow with the first strategy that produces results: subdirectory name → frontmatter (`module`/`component`/`tags`) → filename → content keyword. No matches: ask the user to clarify (interactive) or report the miss and exit (non-interactive).
8
9If the store is empty, report:
11```text
12No candidate docs found in <root>/solutions/.
13Run /ce-compound after solving problems to start building your knowledge base.
14```
16For a broad sweep (9+ docs), triage before deep investigation: read all frontmatter, cluster by module/category, spot-check whether primary referenced files still exist, and start with the highest-impact cluster (interactive: confirm the starting area with the user; non-interactive: process all clusters in impact order). Review individual learning docs before the pattern docs that depend on them — stale learnings make a pattern look more valid than it is. If the user named a pattern doc, you may start there, but inspect its supporting learnings before changing it.
18Render that last line for the active harness: `/ce-compound` by default, `$ce-compound` on Codex or another host documenting dollar-prefixed skill invocation. Print one form only.

Scope selection and triage

Find all .md files under <root>/solutions/, excluding README.md files and anything under _archived/ (if _archived/ exists, flag it in the report as legacy to clean up). READMEs are excluded as review candidates only: whenever an action deletes, renames, moves, consolidates, or replaces a doc a catalog README lists, update that README's rows mechanically as part of the action's cleanup.

Words that describe the run rather than name a doc, category, module, or keyword are not a scope hint: an operation word (refresh, audit, check), a worth-lens intent (SKILL.md, Worth lens), or a mode token. Remove them first; the remainder is the hint, and an empty remainder means the whole store.

If a scope argument was provided, narrow with the first strategy that produces results: subdirectory name → frontmatter (module/component/tags) → filename → content keyword. No matches: ask the user to clarify (interactive) or report the miss and exit (non-interactive).

If the store is empty, report:

No candidate docs found in <root>/solutions/.
Run /ce-compound after solving problems to start building your knowledge base.

For a broad sweep (9+ docs), triage before deep investigation: read all frontmatter, cluster by module/category, spot-check whether primary referenced files still exist, and start with the highest-impact cluster (interactive: confirm the starting area with the user; non-interactive: process all clusters in impact order). Review individual learning docs before the pattern docs that depend on them — stale learnings make a pattern look more valid than it is. If the user named a pattern doc, you may start there, but inspect its supporting learnings before changing it.

Render that last line for the active harness: /ce-compound by default, $ce-compound on Codex or another host documenting dollar-prefixed skill invocation. Print one form only.

Raw lines 1 to 18
Involves a person ask the user :7
Names a skill ce-compound :18