feat: add script coverage file and Workflow D sync contract

This commit is contained in:
meels
2026-07-28 13:54:31 +02:00
parent 0304757982
commit 39d8fffdcb
4 changed files with 87 additions and 1 deletions

View File

@@ -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.