From fa37d0d0c7d9f8ea33ea630571ed6117581a1958 Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Mon, 16 Nov 2026 16:45:34 +0000 Subject: [PATCH] chore: retire Discussion Framework workflow and retain lessons --- .gitignore | 4 ---- README.md | 6 +++++- docs/specs/README.md | 7 ++++--- docs/specs/compiler/README.md | 5 +++-- docs/specs/studio/10. DEV and Automation Specification.md | 2 +- tools/documentation/verify.py | 1 - tools/pbs-production-corpus/README.md | 4 ++-- tools/pbs-production-corpus/run.py | 6 +++--- 8 files changed, 18 insertions(+), 17 deletions(-) diff --git a/.gitignore b/.gitignore index ebdf1eaa..5c9408b0 100644 --- a/.gitignore +++ b/.gitignore @@ -25,9 +25,5 @@ build .DS_Store -# Discussion workflow state is local; only consolidated lessons are versioned. -discussion/* -!discussion/lessons/ -!discussion/lessons/** temp/ temp/** diff --git a/README.md b/README.md index f15ea4c8..b1935797 100644 --- a/README.md +++ b/README.md @@ -16,9 +16,13 @@ The root project is a monorepo with these main areas: - `prometeu-compiler`: compiler core, build pipeline, frontend APIs, and the PBS frontend. - `prometeu-infra`: shared infrastructure used across modules. - `docs/`: normative specifications and architectural references. -- `discussion/`: workflow artifacts for agendas, decisions, plans, and lessons. +- `discussion/lessons/`: published engineering lessons and supporting assets. - `test-projects/`: sample workspaces used for local development and tests. +Engineering discussions, decisions, plans and execution evidence are maintained in +the enclosing [Prometeu Engineering workspace](../README.md) using +[AI Engineering](../.ai-engineering/README.md). + ## Current Product Shape The Studio shell currently organizes the product around four workspaces: diff --git a/docs/specs/README.md b/docs/specs/README.md index 75e3121f..ef2619c1 100644 --- a/docs/specs/README.md +++ b/docs/specs/README.md @@ -22,9 +22,10 @@ The runtime repository owns PBX, ISA, admission and VM execution. Studio's their separate provenance and synchronization policy. [Roadmaps](../roadmaps/) describe cross-domain planning, not an alternative contract source. -The operational lifecycle is `agenda -> decision -> plan -> implement -> lesson`. -Keep its artifacts in `discussion/` and use the local `discussion` CLI for state -transitions, validation and housekeeping. See [repository instructions](../../AGENTS.md). +Engineering discussions, decisions, plans and execution evidence are maintained +in the enclosing workspace's [AI Engineering project](../../../.ai-engineering/README.md). +Published lessons and supporting assets remain in `discussion/lessons/`. +See [repository instructions](../../AGENTS.md). ## Navigation verification diff --git a/docs/specs/compiler/README.md b/docs/specs/compiler/README.md index ded51b1b..0cae4a98 100644 --- a/docs/specs/compiler/README.md +++ b/docs/specs/compiler/README.md @@ -41,7 +41,8 @@ are stable and do not imply language-version numbers. Write specs in English with title, status, scope, authority, normative rules, non-goals and conformance/exit criteria. Keep one owner per detailed contract; summaries link to it. Only settled decisions may change normative behavior. -Agendas, decisions and plans live in `discussion/`, and completed teaching -material lives in `discussion/lessons/`; they are not parallel spec sources. +Engineering discussions, decisions and plans live in the enclosing workspace's +AI Engineering project. Published teaching material remains in +`discussion/lessons/`; neither is a parallel spec source. See the [specification guide](../README.md) for other domains. diff --git a/docs/specs/studio/10. DEV and Automation Specification.md b/docs/specs/studio/10. DEV and Automation Specification.md index d4ca7047..ecb33832 100644 --- a/docs/specs/studio/10. DEV and Automation Specification.md +++ b/docs/specs/studio/10. DEV and Automation Specification.md @@ -411,7 +411,7 @@ mature gameplay library is not a prerequisite. - Replacing compiler, Packer, LSP, VM or human Debug semantics; a new general-purpose Studio source editor. - Remote MCP, accounts/OAuth and network runtime discovery. Studio-owned stdio and local Codex preparation are the explicit DEC-0061 additions. - Additional language implementation, persistent operation recovery or automatic task resumption. -- Integrated discussion-framework agendas/decisions/plans in the product; those are future work, not this runtime/DEV/MCP contract. +- Product-integrated engineering workflow management is outside this runtime/DEV/MCP contract. ## Exit Criteria diff --git a/tools/documentation/verify.py b/tools/documentation/verify.py index 3263db3a..179effae 100644 --- a/tools/documentation/verify.py +++ b/tools/documentation/verify.py @@ -48,7 +48,6 @@ def verify(root, runtime): ["git", "ls-files", "--cached", "--others", "--exclude-standard", "-z"], cwd=root, text=True).split("\0") files = {root / name for name in tracked if name.endswith(".md")} - files.update((root / "discussion/workflow").rglob("*.md")) files.add(root / "AGENTS.md") files = sorted(path for path in files if path.is_file()) mirror_names = {"docs/vm-arch/ARCHITECTURE.md", "docs/vm-arch/ISA_CORE.md"} diff --git a/tools/pbs-production-corpus/README.md b/tools/pbs-production-corpus/README.md index 99500bd3..689029e4 100644 --- a/tools/pbs-production-corpus/README.md +++ b/tools/pbs-production-corpus/README.md @@ -16,11 +16,11 @@ Each case is compiled in a fresh JVM/project outside the checkout. Checkout mode The required corpus produces 168 observations: 28 cases × checkout/installed × optimized production stages, investigation-only unoptimized stages, and the public optimized facade. Unoptimized means omitting OptimizeIRVMPipelineStage and emitting original IRVM; it is not a public compiler flag. The expected runtime matrix is 108 executions: 27 compiled cases × checkout/installed × two optimization configurations, with 104 normal three-frame successes and four deliberately faulting controls. The file-private case must remain a structured source rejection in all six compile configurations. -Use --select id1,id2 or --origins checkout/installed for focused investigation. Without those restrictions, exit zero requires the complete expected matrix and classifications. Output directories cannot be reused or target the original AGD-0113 baseline. Runtime processes are terminated and waited for on every path. Logs are local evidence, while summary.json and per-case JSON preserve structured results. +Use --select id1,id2 or --origins checkout/installed for focused investigation. Without those restrictions, exit zero requires the complete expected matrix and classifications. Output directories cannot be reused or target published lessons and their evidence. Runtime processes are terminated and waited for on every path. Logs are local evidence, while summary.json and per-case JSON preserve structured results. The focused-cases.json resource is an additional matrix for contextual overloads, noncommutative receiver/argument order, original global storage, service singleton identity and privacy. It does not replace or alter the frozen corpus. Successful compiler proof does not imply qualification of an installed runtime distribution or a live Studio session. The Studio tests independently preserve MCP/LSP diagnostic contracts. -The completed DEC-0088/PLN-0166 result, original baseline and separate post-fix reports are consolidated in [LSN-0106](../../discussion/lessons/DSC-0111-pbs-production-reproductions-and-fixes/LSN-0106-pbs-production-binding-and-lowering-corrections.md). +The completed production corrections, original baseline and separate post-fix reports are consolidated in [LSN-0106](../../discussion/lessons/DSC-0111-pbs-production-reproductions-and-fixes/LSN-0106-pbs-production-binding-and-lowering-corrections.md). ## Installed authoring contracts diff --git a/tools/pbs-production-corpus/run.py b/tools/pbs-production-corpus/run.py index f8ffb170..c20a3a96 100644 --- a/tools/pbs-production-corpus/run.py +++ b/tools/pbs-production-corpus/run.py @@ -133,9 +133,9 @@ def main(): corpus, distribution, binary, output = args.corpus.resolve(strict=True), args.distribution.resolve(strict=True), args.runtime_headless.resolve(strict=True), args.output.resolve() if output.exists(): parser.error("Output must be a new directory; evidence is never overwritten") - baseline = ROOT / "discussion/workflow/agendas/AGD-0113-evidence" - if output == baseline or baseline in output.parents: - parser.error("The frozen baseline is read-only") + lessons = ROOT / "discussion/lessons" + if output == lessons or lessons in output.parents: + parser.error("Published lessons and their evidence are read-only") output.mkdir(parents=True) cases = json.loads(corpus.read_text())["cases"] if args.select: