@antoneeo/course-creator 0.1.0-beta.5 → 0.1.0-beta.7

package/skills/course-creator/scripts/shared_files.py

@@ -54,6 +54,13 @@ SHARED_FILES = (
     "scripts/test_chronology.py",
     "scripts/test_merge_safety.py",
     "scripts/test_audit_refs.py",
+    # the docs site (F-072): generator, its battery and its page
+    "scripts/docs_site.py",
+    "scripts/test_docs_site.py",
+    "docs_site/index.html",
+    "docs_site/app.js",
+    "docs_site/style.css",
+    "docs_site/strings.js",
     # domain-neutral doctrine
     "review.md",
     "routing.md",

package/skills/course-creator/scripts/shared_manifest.json

@@ -1,28 +1,34 @@
-{
-  "_comment": "Generated by shared_files.py --update. IDENTICAL in every distribution of the family: if two copies of this file differ, the spine has diverged. Never edit by hand.",
-  "files": {
-    "LICENSE": "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30",
-    "NOTICE": "8414f424f7c1db19d89d74286fd2d6b1acdd9eedde910fa57a16d6835602e4bd",
-    "dispatch.md": "d127057198415f81b921c74e3234a47d5794a2af662eeadaf3dff3cc1739ebc8",
-    "guides.md": "651c150ad3014edbbbc1908dfdca2404db2a877e3d0cbf5cc7921d9be31c187f",
-    "memory.md": "5907be5f99b18eb66ffda2c25815f4fa266fff4b3767f4c142d601b146271167",
-    "review.md": "0b94b48b0ef3b407c3fe8b2a503e89fb30af4dfcf37519b5541ff017cfa83f00",
-    "routing.md": "2f90556cb8516599b9fd6ebf0b5f61dffc107ff186a4c14aed0e483b82cf91d2",
-    "scripts/entry_point.py": "4a560d4d41db989d3426182f1b24270cbb934b3db0f3246c700578a4ed93089b",
-    "scripts/knowledge.py": "ac50bffcbfd9c7d7c098e4a40995f66f18884202a5511d602961c9dcd9afa498",
-    "scripts/sdlc_core.py": "709bcfc98cf9d0a5941aeca3e109d8b74f2d441314a303ac38f07b5db30de1a8",
-    "scripts/shared_files.py": "525a6f9dc278d3e35c6ff41e634038c0f1d6ab3a31eea5903440d22029ea176b",
-    "scripts/test_audit_refs.py": "a6f06e73f4c9469dd64bed283024b6b37294e6c26f171d8cbdbdfd03771a6884",
-    "scripts/test_chronology.py": "5cffc2711282452fe1148a95e46b0b31940809aed3a63950329d9b3e868d0cda",
-    "scripts/test_docs_root.py": "19753e0316c0df63ed321d24b411a9ff36eea2058421fd69fc57e507d75566d0",
-    "scripts/test_domain_rules.py": "33542b5dc2bb77c05ece55cf0446065cc4226c763ef5e040aa77364f226937bb",
-    "scripts/test_drift.py": "c7b7121a8a308b0f3fe12c0c0c346444e632b7aaeff47dc8818b621e5c20cb38",
-    "scripts/test_merge_safety.py": "8b9241077bf7ecd6dd335907c640044ab38968ff4c9fdc464450e732cb77adf4",
-    "scripts/test_migrate.py": "c129823bf4feb0614acd975351632a6ae62d7896a0ef32724419a8e9335e3110",
-    "scripts/test_plan.py": "4c011a63aa834b55e9c5d13fb4ea76b131b742356001364b0a508435ba013e27",
-    "scripts/test_project_memory.py": "2cb85cef01161d881a11d84cfe9ebb72915104e8d1822e4de739f7d00ae6cd59",
-    "scripts/test_session_start.py": "203fa72b87fb263663ce7fcd737460530b75fd5e76e883f25cd849e6cca98275",
-    "scripts/test_skill_invariants.py": "4e1bb3c918415e2ef519ed993d5b8d6e453ba8d802d9fe537060c178ada58996",
-    "vision.md": "191696a8283b2873fea6e57d16fbb3b4f24b82bf0c79bcfd77d52141a9ca2a5b"
-  }
-}
+{
+  "_comment": "Generated by shared_files.py --update. IDENTICAL in every distribution of the family: if two copies of this file differ, the spine has diverged. Never edit by hand.",
+  "files": {
+    "LICENSE": "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30",
+    "NOTICE": "8414f424f7c1db19d89d74286fd2d6b1acdd9eedde910fa57a16d6835602e4bd",
+    "dispatch.md": "d127057198415f81b921c74e3234a47d5794a2af662eeadaf3dff3cc1739ebc8",
+    "docs_site/app.js": "e325179e34ded97fcff7ac0275c753e7aa1a64f34b206816d419872fae13364c",
+    "docs_site/index.html": "2b64167470f754e46fa4bb4e73a3d2c34ee632d91fe2f17705a58d18b5018af5",
+    "docs_site/strings.js": "6f8720c156396bc6553b41a706502d6cbb59b1417c0ba5e5fb6d0f55f480abbb",
+    "docs_site/style.css": "851c0ff7c75efdcc481add7dae225fb6f83f03dcb5449f446e0d61bbfe4cb7e7",
+    "guides.md": "651c150ad3014edbbbc1908dfdca2404db2a877e3d0cbf5cc7921d9be31c187f",
+    "memory.md": "5907be5f99b18eb66ffda2c25815f4fa266fff4b3767f4c142d601b146271167",
+    "review.md": "0b94b48b0ef3b407c3fe8b2a503e89fb30af4dfcf37519b5541ff017cfa83f00",
+    "routing.md": "2f90556cb8516599b9fd6ebf0b5f61dffc107ff186a4c14aed0e483b82cf91d2",
+    "scripts/docs_site.py": "c9407e344f2783f9286955829b78e1431ea20320e5b41c358b04f8bac8f8f6a2",
+    "scripts/entry_point.py": "4a560d4d41db989d3426182f1b24270cbb934b3db0f3246c700578a4ed93089b",
+    "scripts/knowledge.py": "ac50bffcbfd9c7d7c098e4a40995f66f18884202a5511d602961c9dcd9afa498",
+    "scripts/sdlc_core.py": "709bcfc98cf9d0a5941aeca3e109d8b74f2d441314a303ac38f07b5db30de1a8",
+    "scripts/shared_files.py": "bc3b311ca5c736070e9970428429226ca0a9186e010c265b556512b6df191e73",
+    "scripts/test_audit_refs.py": "a6f06e73f4c9469dd64bed283024b6b37294e6c26f171d8cbdbdfd03771a6884",
+    "scripts/test_chronology.py": "5cffc2711282452fe1148a95e46b0b31940809aed3a63950329d9b3e868d0cda",
+    "scripts/test_docs_root.py": "19753e0316c0df63ed321d24b411a9ff36eea2058421fd69fc57e507d75566d0",
+    "scripts/test_docs_site.py": "e0746f7b7745261c3f2557a0696181394811d7e0df34e36c065ca5cc573b1587",
+    "scripts/test_domain_rules.py": "33542b5dc2bb77c05ece55cf0446065cc4226c763ef5e040aa77364f226937bb",
+    "scripts/test_drift.py": "c7b7121a8a308b0f3fe12c0c0c346444e632b7aaeff47dc8818b621e5c20cb38",
+    "scripts/test_merge_safety.py": "8b9241077bf7ecd6dd335907c640044ab38968ff4c9fdc464450e732cb77adf4",
+    "scripts/test_migrate.py": "c129823bf4feb0614acd975351632a6ae62d7896a0ef32724419a8e9335e3110",
+    "scripts/test_plan.py": "4c011a63aa834b55e9c5d13fb4ea76b131b742356001364b0a508435ba013e27",
+    "scripts/test_project_memory.py": "2cb85cef01161d881a11d84cfe9ebb72915104e8d1822e4de739f7d00ae6cd59",
+    "scripts/test_session_start.py": "203fa72b87fb263663ce7fcd737460530b75fd5e76e883f25cd849e6cca98275",
+    "scripts/test_skill_invariants.py": "17dbccaac688b75e04c44eaaf0ee5b78e85ce2aa4697fc7a52041f3175fe0735",
+    "vision.md": "a19a7d7d5044215b726b66f74e422c9cdedcc856c0a53151f20a6d9840b8f6c4"
+  }
+}

package/skills/course-creator/templates.md

@@ -4,7 +4,7 @@ These are starting shapes, not substitute explanations. Keep one authority for e
 
 ## Course Vision — `vision/features/VISION_course_<slug>.md`
 
-Read `vision.md` and use its blind check before APPROVED. The person approves benefit and scope, not the agent.
+Written only after the owner interview (`vision.md` §The owner interview), with its north star approved first. Read `vision.md` and use its blind check before APPROVED. The person approves benefit and scope, not the agent.
 
 ```markdown
 ---
@@ -15,16 +15,20 @@ domain: course
 # Course Vision: <title>
 Status: DRAFT
 
+## North Star
+<One or two sentences in the person's words, approved before the rest: REQUEST_course_<slug>.md#R<n>.>
+## Problem
+<One concrete case that today does not get the expected result, with its example.>
 ## Expected Benefit
 <Why the learner needs the knowledge and what becomes possible.>
 ## Learners and Starting Point
-<Who, context of use, what is known with evidence, what remains uncertain.>
+<Who, context of use, what is known with evidence, what remains uncertain; who receives the benefit, who acts, who has the initiative.>
 ## Promised Understanding and Ability
 <Knowledge and usable capability, not a list of slides.>
 ## Success Signals
-<Observable understanding or use; distinguish simulated diagnosis from real evidence.>
+<Observable understanding or use, each with its starting value; distinguish simulated diagnosis from real evidence.>
 ## Scope and Non-Goals
-<Boundaries, delivery constraints and facts outside this course.>
+<Scope this course does not pursue (not a ban on existing behaviour); delivery constraints and facts outside this course, each with its provenance: owner REQUEST_course_<slug>.md#R<n>, a higher Vision quoted, or an inference the person confirmed.>
 ```
 
 Approval changes both `status:` and `Status:` to `APPROVED`.

package/skills/course-creator/vision.md

@@ -47,14 +47,67 @@ Four consequences, each operational:
 
 Extracting the benefit from a discussion is real work: a discourse arrives with
 solutions, preferences and constraints tangled together, and the Vision is the
-distilled benefit only. The elicitation round (`elicitation.md`) asks for it first
-— and a mechanism ("a dashboard") is not an acceptable answer to a benefit
-question ("never lose the thread"); ask again until the answer names what the
-actor obtains.
+distilled benefit only. The owner interview below asks for it — and a mechanism
+("a dashboard") is not an acceptable answer to a benefit question ("never lose
+the thread"); ask again until the answer names what the actor obtains.
 
 The deletion test decides **which** rules exist. Everything below decides **how**
 to write a rule so it holds once you know it must exist.
 
+## The owner interview (before any Vision text)
+
+A Vision is the **owner's** statement of what is to be obtained. Nothing in this
+file after this section can detect a Vision the author wrote alone: the blind
+check (§6) tests whether the rules survive a hostile reader, never whether they
+are the owner's. So every Vision is born from an interview of the owner, and its
+north star is approved **before** a line of it is drafted.
+
+**Scope — every Vision, in every mode:** `project_vision.md`, a feature
+`VISION_*.md`, a lens Vision (course, marketing), and the devPNT M-VISION in
+Hybrid; also an ANALYSIS `## Feature Vision` that states a benefit no existing
+Vision names (one that cites an approved Vision's benefit is alignment, not a
+Vision). An amendment re-runs the questions whose answers it changes, and Gate 1
+again when the north star changes. **There is no skip path**: one sentence from
+the user plus a spike is not a complete spec — that exact shortcut produced a
+Vision with an imported prohibition, no north star and a missing actor, and four
+downstream artifacts built on it (field case, 2026-10). A reply already on record
+in the owner's words is read back for confirmation, never re-asked as an open
+question; an answer the author derived (from a spike, the code, another Vision)
+is never an answer — it is a proposal the owner confirms or rejects.
+
+**The questions, in this order.** Each is repeated until its answer has the form
+stated; the wrong form is named so it can be recognized and asked again.
+
+| # | Question | Right form | Wrong form — ask again |
+|---|---|---|---|
+| 1 | **Problem** — which concrete case today does not get the expected result? | one real case, with an example | a missing feature ("there is no drawing tool") |
+| 2 | **Benefit** — once solved, who obtains what? | a result for a named actor | a function or mechanism ("a renderer") |
+| 3 | **Actors** — who receives the benefit, who acts, who has the initiative? | all three named, initiative included | only the one who asks — the actor who acts unprompted goes missing |
+| 4 | **Success** — what observable signal shows the benefit arrived? | a signal with its starting value | a feeling, or a signal with no baseline |
+| 5 | **Boundaries** — what does this NOT pursue? | scope excluded from this work | a ban on behaviour ("X must never happen") — that is a constraint (6) or an obligation (2, 4) |
+| 6 | **Known constraints** — each with its provenance: owner, a quoted line of a higher Vision, or author inference | every constraint sourced; every inference asked here | a constraint written in silently, or imported from a higher Vision without asking whether it applies here |
+
+A **Non-Goal bounds scope**: it rejects a proposal that pursues what it names; it
+is not a ban on behaviour that already exists, and it creates no obligation.
+Obligations come from the Benefit and the Success Signals.
+
+**Gate 1 — north star.** One or two sentences, in the owner's words, explicitly
+approved by the owner. The author may compose a wording from the answers; the
+approval is of that exact text, recorded verbatim in the request record
+(`audit/requests/REQUEST_[unit].md`; a Vision written outside any unit, such as
+the project Vision after bootstrap, records its interview in
+`audit/requests/REQUEST_project_vision.md`). **Without it no Vision text is written** —
+not a DRAFT, not a reconstruction: bootstrap writes a stub awaiting the
+interview, and what the agent observed goes to `strategic/`.
+Unattended, the unit is `BLOCKED on the user` (`elicitation.md` Unattended path).
+
+**Gate 2 — the full Vision**, written from the answers. Every section traces to
+an answer or a stated provenance (`REQUEST_[unit].md#R<n>`); every rule carries
+its provenance; an author inference the owner did not confirm is not in it. The
+blind check (§6) verifies that it holds; the approved north star verifies that it
+is the owner's. Promotion to APPROVED still needs the owner's explicit
+confirmation — Gate 2 is that confirmation, given on the written text.
+
 ## 0. The one-line test
 
 > Could a reader who has never seen this project rule ACCEPT or REJECT on a
@@ -138,7 +191,14 @@ rule that survived and the same rule leaking.
 This is the most common structural failure and it is invisible from the inside.
 
 - **A Goal cannot reject anything.** If the admission test says "advances a Goal
-  and violates no Non-Goal", then rejection power lives *only* in the Non-Goals.
+  and violates no Non-Goal", then rejection power lives *only* in the Non-Goals
+  (and the Invariants, where the Vision has them).
+- **A Non-Goal rejects scope, not behaviour.** It turns away a proposal that
+  pursues what it names; it never forbids a behaviour the product already has, and
+  it never creates an obligation — obligations come from the Benefit and the
+  Success Signals. A behaviour the product must never have is an Invariant, or a
+  constraint with its provenance (§The owner interview, question 6). Written as a
+  Non-Goal, it reads as a ban the owner never stated.
   A Goal that says "scale cost to risk in both directions" cannot stop cost
   inflation — you need a prohibition for that.
 - **A prohibition scoped to one rung of your own scale protects only that rung.**
@@ -204,7 +264,10 @@ it.
 ## 6. The blind check (procedure)
 
 Run this **before promoting any Vision to APPROVED, and before any amendment of an
-approved one**. Not for DRAFT edits — promotion is when authority is granted, and
+approved one**. It runs on a Vision that already passed Gate 1 (§The owner
+interview): it tests whether the rules hold against a hostile reader, and it
+cannot see whether they are the owner's — a Vision the author wrote alone passes
+it cleanly. Not for DRAFT edits — promotion is when authority is granted, and
 it is rare, so the cost lands where it buys most.
 
 1. **Give the reviewer the document text and nothing else.** Not a path — the