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/
|
wiki/
|
||||||
overview.md # top-level synthesis and navigation
|
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
|
sources/ # one summary page per ingested raw source
|
||||||
entities/ # people, orgs, projects, places, tools
|
entities/ # people, orgs, projects, places, tools
|
||||||
concepts/ # themes, ideas, methods, frameworks
|
concepts/ # themes, ideas, methods, frameworks
|
||||||
@@ -69,6 +70,7 @@ Folder → required tag:
|
|||||||
| Folder / file | Tag |
|
| Folder / file | Tag |
|
||||||
| ---------------------- | -------------- |
|
| ---------------------- | -------------- |
|
||||||
| `wiki/overview.md` | `#overview` |
|
| `wiki/overview.md` | `#overview` |
|
||||||
|
| `wiki/script-coverage.md` | `#coverage` |
|
||||||
| `wiki/sources/*` | `#source` |
|
| `wiki/sources/*` | `#source` |
|
||||||
| `wiki/entities/*` | `#entity` |
|
| `wiki/entities/*` | `#entity` |
|
||||||
| `wiki/concepts/*` | `#concept` |
|
| `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`.
|
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
|
## Citation & Evidence Policy
|
||||||
|
|
||||||
- Prefer citing wiki source summaries (`wiki/sources/*.md`) rather than raw files in normal answers.
|
- Prefer citing wiki source summaries (`wiki/sources/*.md`) rather than raw files in normal answers.
|
||||||
@@ -177,6 +206,7 @@ Supported intents:
|
|||||||
- "lint wiki"
|
- "lint wiki"
|
||||||
- "show recent changes"
|
- "show recent changes"
|
||||||
- "suggest next sources"
|
- "suggest next sources"
|
||||||
|
- "sync script coverage"
|
||||||
|
|
||||||
Always execute intents according to workflows above.
|
Always execute intents according to workflows above.
|
||||||
|
|
||||||
|
|||||||
6
index.md
6
index.md
@@ -18,7 +18,11 @@ Every wiki page carries a page-type tag under its H1 (`#source`, `#entity`, `#co
|
|||||||
- [[2026-07-22-ai-is-stupid]] — YouTube short (author unknown): "stupid AI" = model minus context minus harness; Nobel-vs-employee analogy _(raw: ИИ глупый!.md)_
|
- [[2026-07-22-ai-is-stupid]] — YouTube short (author unknown): "stupid AI" = model minus context minus harness; Nobel-vs-employee analogy _(raw: ИИ глупый!.md)_
|
||||||
- [[2026-07-24-youre-reading-way-too-much-code]] — Theo Browne (video): make more cheap code, four tiers of code, 100:1 slop-to-ship verification _(raw: You're reading way too much code.md)_
|
- [[2026-07-24-youre-reading-way-too-much-code]] — Theo Browne (video): make more cheap code, four tiers of code, 100:1 slop-to-ship verification _(raw: You're reading way too much code.md)_
|
||||||
|
|
||||||
**Raw, not yet ingested:** `raw/sources/Ideas for webinar.md` · `raw/sources/Webinar Plan - From Chat Box to Your Own OS.md` · `raw/sources/Webinar script.md` · `raw/sources/my theses.md`
|
**Raw, not yet ingested:** `raw/sources/Agentic Engineering, explained by a 10x developer.md` · `raw/sources/Webinar Plan - From Chat Box to Your Own OS.md` · `raw/sources/Webinar script.md`
|
||||||
|
|
||||||
|
## Coverage
|
||||||
|
|
||||||
|
- [[script-coverage]] — every concept vs `raw/sources/Webinar script.md`; 5 covered, 4 partial, 10 absent
|
||||||
|
|
||||||
## Entities
|
## Entities
|
||||||
|
|
||||||
|
|||||||
8
log.md
8
log.md
@@ -147,3 +147,11 @@ Entry format:
|
|||||||
- Pages updated: [[make-more-cheap-code]] (next-question marked answered, link added), [[leave-less-room-for-imagination]] (new next-question: drift harnessed as a sandboxed ambiguity diagnostic — synthesis, tentative), `index.md` (Queries section).
|
- Pages updated: [[make-more-cheap-code]] (next-question marked answered, link added), [[leave-less-room-for-imagination]] (new next-question: drift harnessed as a sandboxed ambiguity diagnostic — synthesis, tentative), `index.md` (Queries section).
|
||||||
- Notes: Pure synthesis, no new source — every mapped pattern is grounded in corpus use cases (Nina/Yulia job descriptions, candidate KB, sourcing; Larysa spec ambiguity; Allie's anti-AI-language checker-skill precedent). Key reframes with durable value: (1) the fresh-agent misread test inverts [[leave-less-room-for-imagination]] — drift becomes a diagnostic when sandboxed; (2) [[solve-first-then-skillify]] populates skills in two species, producers and checkers. Flagged honestly: the whole mapping is argument-by-analogy with no measured claim; Nina's transcript-beats-summary finding is a standing counterweight to summary-based review.
|
- Notes: Pure synthesis, no new source — every mapped pattern is grounded in corpus use cases (Nina/Yulia job descriptions, candidate KB, sourcing; Larysa spec ambiguity; Allie's anti-AI-language checker-skill precedent). Key reframes with durable value: (1) the fresh-agent misread test inverts [[leave-less-room-for-imagination]] — drift becomes a diagnostic when sandboxed; (2) [[solve-first-then-skillify]] populates skills in two species, producers and checkers. Flagged honestly: the whole mapping is argument-by-analogy with no measured claim; Nina's transcript-beats-summary finding is a standing counterweight to summary-based review.
|
||||||
- Next: decide whether "checker skills" earns a slide on the webinar's skills rung; the webinar-deliverable docs (`Ideas`, `Plan`, `script`, `my theses.md`) remain un-ingested; first lint pass still overdue (9 sources, 18 concepts, 2026-07-24 now has 1 query, 0 lint reports).
|
- Next: decide whether "checker skills" earns a slide on the webinar's skills rung; the webinar-deliverable docs (`Ideas`, `Plan`, `script`, `my theses.md`) remain un-ingested; first lint pass still overdue (9 sources, 18 concepts, 2026-07-24 now has 1 query, 0 lint reports).
|
||||||
|
|
||||||
|
## 2026-07-28 — sync (script coverage, initial)
|
||||||
|
- Intent: sync script coverage
|
||||||
|
- Input: first run of Workflow D, establishing `wiki/script-coverage.md`.
|
||||||
|
- Pages created: [[script-coverage]] (coverage) — 19 rows, one per concept page.
|
||||||
|
- Pages updated: `CLAUDE.md` (folder convention, `#coverage` tag row, Workflow D, new intent), `index.md` (new Coverage section; corrected the not-yet-ingested list — `Ideas for webinar.md` and `my theses.md` were listed under `raw/sources/` but live in `raw/notes/`, and `Agentic Engineering, explained by a 10x developer.md` was missing entirely).
|
||||||
|
- Notes: Initial assessment is 5 covered, 4 partial, 10 absent. Every absent concept is human-side or strategy-side — the script is entirely machine-side. The `ReAct` station carries no wiki concept. No concept pages were edited.
|
||||||
|
- Next: decide whether the human-side cluster earns a station or is a deliberate cut; pin the rows that are decided so future syncs leave them alone.
|
||||||
|
|||||||
44
wiki/script-coverage.md
Normal file
44
wiki/script-coverage.md
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
# Script coverage
|
||||||
|
|
||||||
|
#coverage
|
||||||
|
|
||||||
|
## Metadata
|
||||||
|
|
||||||
|
- **Script:** `raw/sources/Webinar script.md`
|
||||||
|
- **Last synced:** 2026-07-28
|
||||||
|
- **Stations:** Chat box · ReAct · Tools · Memory · Skills · Process · OS
|
||||||
|
|
||||||
|
## Coverage
|
||||||
|
|
||||||
|
| Concept | Status | Station | Pinned |
|
||||||
|
|---|---|---|---|
|
||||||
|
| [[harness]] | covered | Tools | |
|
||||||
|
| [[evolution-of-agent-tooling]] | covered | Tools | |
|
||||||
|
| [[skills-as-memory]] | covered | Skills | |
|
||||||
|
| [[solve-first-then-skillify]] | covered | Skills | |
|
||||||
|
| [[personal-ai-operating-system]] | covered | OS | |
|
||||||
|
| [[context-as-scarce-resource]] | partial | Memory | |
|
||||||
|
| [[agentic-loops]] | partial | Process | |
|
||||||
|
| [[code-as-throwaway]] | partial | OS | |
|
||||||
|
| [[levels-of-ai-usage]] | partial | all | |
|
||||||
|
| [[integration-dead-ends]] | absent | — | |
|
||||||
|
| [[leave-less-room-for-imagination]] | absent | — | |
|
||||||
|
| [[product-ownership]] | absent | — | |
|
||||||
|
| [[connections-as-moat]] | absent | — | |
|
||||||
|
| [[network-from-a-standing-start]] | absent | — | |
|
||||||
|
| [[seniority-and-the-junior-squeeze]] | absent | — | |
|
||||||
|
| [[decoupling-identity-from-profession]] | absent | — | |
|
||||||
|
| [[think-wider-not-bigger]] | absent | — | |
|
||||||
|
| [[make-more-cheap-code]] | absent | — | |
|
||||||
|
| [[enterprise-ai-reality]] | absent | — | |
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- The script is entirely machine-side. Every absent concept is human-side or strategy-side.
|
||||||
|
- The `ReAct` station carries no wiki concept at all.
|
||||||
|
- Set `Pinned` to `yes` on any row whose status is a deliberate decision. Sync will not touch it.
|
||||||
|
|
||||||
|
## Related Pages
|
||||||
|
|
||||||
|
- [[overview]]
|
||||||
|
- `raw/sources/Webinar script.md`
|
||||||
Reference in New Issue
Block a user