feat: add script coverage file and Workflow D sync contract
This commit is contained in:
30
CLAUDE.md
30
CLAUDE.md
@@ -34,6 +34,7 @@ raw/
|
||||
|
||||
wiki/
|
||||
overview.md # top-level synthesis and navigation
|
||||
script-coverage.md # machine-maintained: concept coverage vs the webinar script
|
||||
sources/ # one summary page per ingested raw source
|
||||
entities/ # people, orgs, projects, places, tools
|
||||
concepts/ # themes, ideas, methods, frameworks
|
||||
@@ -69,6 +70,7 @@ Folder → required tag:
|
||||
| Folder / file | Tag |
|
||||
| ---------------------- | -------------- |
|
||||
| `wiki/overview.md` | `#overview` |
|
||||
| `wiki/script-coverage.md` | `#coverage` |
|
||||
| `wiki/sources/*` | `#source` |
|
||||
| `wiki/entities/*` | `#entity` |
|
||||
| `wiki/concepts/*` | `#concept` |
|
||||
@@ -156,6 +158,33 @@ Run periodic health checks for:
|
||||
|
||||
Write report to `wiki/lint-reports/YYYY-MM-DD-lint.md`, then update `index.md` and `log.md`.
|
||||
|
||||
### Workflow D: Sync Script Coverage
|
||||
|
||||
Maintains `wiki/script-coverage.md` — one row per page in `wiki/concepts/`, judged
|
||||
against the script named in that file's `**Script:**` metadata field.
|
||||
|
||||
1. Read `wiki/script-coverage.md` and note every row where `Pinned` is `yes`.
|
||||
2. Read the script and every page in `wiki/concepts/`.
|
||||
3. For each concept, decide `Status` and `Station`:
|
||||
- `covered` — the script delivers the idea, whether or not it uses the page's name.
|
||||
- `partial` — the script gestures at it but never lands it.
|
||||
- `absent` — the script never reaches it.
|
||||
- `Station` is one of the seven, a comma-separated list, `all`, or `—` when absent.
|
||||
4. **Never modify a row whose `Pinned` is `yes`** — not its status, not its station.
|
||||
A pinned row is the user's judgment and outranks yours.
|
||||
5. Add rows for concept pages with no row. Remove rows whose concept page no longer exists.
|
||||
6. Update `**Last synced:**` to today.
|
||||
7. Update `index.md` and append a `sync` entry to `log.md`.
|
||||
|
||||
Run this workflow:
|
||||
|
||||
- at the end of any ingest that creates or modifies a page in `wiki/concepts/`
|
||||
- whenever the script file itself changes
|
||||
- on the explicit `sync script coverage` intent
|
||||
|
||||
The coverage baseline is always the raw script. Ingesting the script into
|
||||
`wiki/sources/` does not change the baseline.
|
||||
|
||||
## Citation & Evidence Policy
|
||||
|
||||
- Prefer citing wiki source summaries (`wiki/sources/*.md`) rather than raw files in normal answers.
|
||||
@@ -177,6 +206,7 @@ Supported intents:
|
||||
- "lint wiki"
|
||||
- "show recent changes"
|
||||
- "suggest next sources"
|
||||
- "sync script coverage"
|
||||
|
||||
Always execute intents according to workflows above.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user