docs: reorganise -- current reference gathered, finished work archived, superseded and dead ideas marked as such
docs/CLAUDE.md Phase 2, 2026-10-14. All moves by git mv; every archived file carries a header saying what it is, why, and where to look instead. - docs/reference/ (new): roadmap and versioning policy, M7.1, word-ACL design, kernel args, hosted acceptance test, dictionary, primitives, ontology, L8 table -- previously spread over docs/, docs/lithosananke/ and docs/03-architecture/. - docs/working/archive/historical/: finished work (session plan, test-gap audit, birthing plan, fix write-ups, the January architecture draft). - docs/working/archive/superseded/: the Hermes-VM Tripod docs and July Hermes designs (-> FABRIC-3.5/3.6), the StarForth roadmap, every working doc already flagged superseded or obsolete. - docs/working/archive/dead/: the hal_* target contract (never adopted), L4Re, metrics-and-knobs. - Papers and proposals into docs/working/papers/. - References rewritten across the repo (not logs/, not docs/patent/); CLAUDE.md's documentation section rewritten. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rajames
co-authored by
Claude Opus 5.5
Claude Opus 5.5
parent
1a4b163861
commit
7aed588f78
@@ -48,7 +48,7 @@
|
||||
\part{$2^7$ Factorial Campaign}
|
||||
|
||||
\chapter{Campaign Design}
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/guide.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/guide.md
|
||||
%% docs/working/experiments/campaigns/doe_2x7/README.md
|
||||
\input{../scraps/experiments/02-experiments/factorial-doe/guide}
|
||||
\input{../scraps/experiments/02-experiments/factorial-doe/workflow}
|
||||
@@ -57,7 +57,7 @@
|
||||
\input{../scraps/experiments/campaigns/shape_validation/README}
|
||||
|
||||
\chapter{Incompatible Configurations}
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/incompatible-configs.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/incompatible-configs.md
|
||||
\input{../scraps/experiments/02-experiments/factorial-doe/incompatible-configs}
|
||||
|
||||
\chapter{Campaign Results — 90 Runs}
|
||||
@@ -146,8 +146,8 @@
|
||||
\part{Supplementary Campaigns}
|
||||
|
||||
\chapter{Heartbeat DoE}
|
||||
%% SOURCE: docs/working/experiments/02-experiments/heartbeat-doe/design.md
|
||||
%% docs/working/experiments/02-experiments/heartbeat-doe/corrected-design.md
|
||||
%% SOURCE: docs/working/archive/superseded/heartbeat-doe-design.md
|
||||
%% docs/working/archive/superseded/heartbeat-doe-corrected-design.md
|
||||
\input{../scraps/experiments/02-experiments/heartbeat-doe/design}
|
||||
\input{../scraps/experiments/02-experiments/heartbeat-doe/corrected-design}
|
||||
\input{../scraps/experiments/02-experiments/heartbeat-doe/implementation-summary}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/adaptive-systems/loop-5-sketch
|
||||
%% SOURCE: docs/working/architecture/03-architecture/adaptive-systems/loop-5-sketch.md
|
||||
%% SOURCE: docs/working/archive/superseded/loop-5-sketch.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-physics
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/README
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/README.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/README.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/interfaces
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/interfaces.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/interfaces.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/migration-plan
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/migration-plan.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/migration-plan.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/overview
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/overview.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/overview.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/platform-implementations
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/platform-implementations.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/platform-implementations.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/hal/starkernel-integration
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/starkernel-integration.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/starkernel-integration.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-platform
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/heartbeat-system/implementation-plan
|
||||
%% SOURCE: docs/working/architecture/03-architecture/heartbeat-system/implementation-plan.md
|
||||
%% SOURCE: docs/working/archive/superseded/heartbeat-rate-logging-plan.md
|
||||
%% STATUS: HISTORICAL
|
||||
%% FITS: dev-guide/ch-heartbeat
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/physics-engine/feedback-loops-analysis
|
||||
%% SOURCE: docs/working/architecture/03-architecture/physics-engine/feedback-loops-analysis.md
|
||||
%% SOURCE: docs/working/archive/superseded/feedback-loops-analysis.md
|
||||
%% STATUS: HISTORICAL
|
||||
%% FITS: dev-guide/ch-physics
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/physics-engine/metrics-and-knobs
|
||||
%% SOURCE: docs/working/architecture/03-architecture/physics-engine/metrics-and-knobs.md
|
||||
%% SOURCE: docs/working/archive/dead/metrics-and-knobs.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-physics, cookbook/ch-physics
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/03-architecture/physics-engine/steady-state-machine
|
||||
%% SOURCE: docs/working/architecture/03-architecture/physics-engine/steady-state-machine.md
|
||||
%% SOURCE: docs/working/archive/superseded/steady-state-machine.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: dev-guide/ch-physics
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: architecture/getting-started/quick-start/factorial-doe
|
||||
%% SOURCE: docs/working/architecture/getting-started/quick-start/factorial-doe.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/quick-start.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: cookbook/ch-doe
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -36,7 +36,7 @@ The audit assigned priority as follows.
|
||||
\begin{itemize}
|
||||
\item Add missing \texttt{README} files to all numbered directories.
|
||||
\item Update \texttt{CLAUDE.md} to reflect HAL and StarKernel vision.
|
||||
\item Create \texttt{docs/03-architecture/README.md} as a system overview.
|
||||
\item Create \texttt{docs/working/archive/superseded/2026-08-tripod/03-architecture-README.md} as a system overview.
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Medium priority:}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/L8_WIRING_PLAN
|
||||
%% SOURCE: docs/working/experiments/02-experiments/L8_WIRING_PLAN.md
|
||||
%% SOURCE: docs/working/archive/superseded/L8_WIRING_PLAN.md
|
||||
%% STATUS: HISTORICAL
|
||||
%% FITS: experiments/ch-l8
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/factorial-doe/guide
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/guide.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/guide.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: experiments/ch-factorial, cookbook/ch-doe
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/factorial-doe/incompatible-configs
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/incompatible-configs.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/incompatible-configs.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: experiments/ch-factorial
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/factorial-doe/index
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/index.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/index.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: experiments/ch-factorial
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/factorial-doe/workflow
|
||||
%% SOURCE: docs/working/experiments/02-experiments/factorial-doe/workflow.md
|
||||
%% SOURCE: docs/working/archive/superseded/factorial-doe/workflow.md
|
||||
%% STATUS: CURRENT
|
||||
%% FITS: experiments/ch-factorial, cookbook/ch-doe
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/heartbeat-doe/corrected-design
|
||||
%% SOURCE: docs/working/experiments/02-experiments/heartbeat-doe/corrected-design.md
|
||||
%% SOURCE: docs/working/archive/superseded/heartbeat-doe-corrected-design.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: experiments/ch-heartbeat
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: experiments/02-experiments/heartbeat-doe/design
|
||||
%% SOURCE: docs/working/experiments/02-experiments/heartbeat-doe/design.md
|
||||
%% SOURCE: docs/working/archive/superseded/heartbeat-doe-design.md
|
||||
%% STATUS: WORKING
|
||||
%% FITS: experiments/ch-heartbeat
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: hardware/platform-integration/L4RE_DICTIONARY_ALLOCATION
|
||||
%% SOURCE: docs/working/hardware/platform-integration/L4RE_DICTIONARY_ALLOCATION.adoc
|
||||
%% SOURCE: docs/working/archive/dead/l4re/L4RE_DICTIONARY_ALLOCATION.adoc
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-l4re
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: hardware/platform-integration/L4RE_INTEGRATION
|
||||
%% SOURCE: docs/working/hardware/platform-integration/L4RE_INTEGRATION.adoc
|
||||
%% SOURCE: docs/working/archive/dead/l4re/L4RE_INTEGRATION.adoc
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-l4re
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: hardware/platform-integration/l_4_re_blkio_endpoints
|
||||
%% SOURCE: docs/working/hardware/platform-integration/l_4_re_blkio_endpoints.adoc
|
||||
%% SOURCE: docs/working/archive/dead/l4re/l_4_re_blkio_endpoints.adoc
|
||||
%% STATUS: WORKING
|
||||
%% FITS: dev-guide/ch-l4re
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -40,7 +40,7 @@ They are deferred to a later, build-verified pass.
|
||||
\toprule
|
||||
Path & Description \\
|
||||
\midrule
|
||||
\texttt{docs/ontology.tex} / \texttt{.pdf} & Formal ontology source and compiled PDF; candidate for \texttt{formal/}. \\
|
||||
\texttt{docs/working/papers/ontology.tex} / \texttt{.pdf} & Formal ontology source and compiled PDF; candidate for \texttt{formal/}. \\
|
||||
\texttt{docs/ontology\_diagrams.dot} & Graphviz source for ontology diagrams. \\
|
||||
\texttt{docs/fig\_*.png} / \texttt{.svg} & Shared figure assets referenced by ontology and system narrative LaTeX. \\
|
||||
\bottomrule
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
%% SCRAP: scratch/src/L4RE_INTEGRATION_TODO
|
||||
%% SOURCE: docs/working/scratch/src/L4RE_INTEGRATION_TODO.adoc
|
||||
%% SOURCE: docs/working/archive/dead/l4re/L4RE_INTEGRATION_TODO.adoc
|
||||
%% STATUS: HISTORICAL
|
||||
%% FITS: dev-guide/ch-l4re
|
||||
%% EDITORIAL: lifted — prose rewritten to press voice
|
||||
|
||||
@@ -22,7 +22,7 @@ Built via `make -C docs/formal vol2`; output lands at
|
||||
|
||||
## See also
|
||||
|
||||
- [`docs/lithosananke/README.md`](../../lithosananke/README.md) — the
|
||||
- [`docs/working/archive/historical/2026-10-lithosananke-orientation.md`](../../lithosananke/README.md) — the
|
||||
living kernel-branch documentation this volume draws from.
|
||||
- [`docs/formal/README.md`](../README.md) — the three research volumes
|
||||
this belongs to (with `vol1-vm-physics/` and `vol3-research/`).
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
%% Vol II, Chapter 4 — Platform Support
|
||||
%% SOURCE: docs/working/scratch/src/platform-integration/ (multiple .adoc files)
|
||||
%% docs/working/architecture/03-architecture/hal/ (HAL design — aspirational)
|
||||
%% docs/working/archive/dead/hal-target-contract/ (HAL design — aspirational)
|
||||
%% .claude/CLAUDE.md (Platform abstraction, build targets)
|
||||
|
||||
\chapter{Platform Support}
|
||||
@@ -43,7 +43,7 @@
|
||||
\section{Platform Abstraction Layer (HAL Target)}
|
||||
\label{vol2:sec:platforms:hal}
|
||||
|
||||
%% SOURCE: docs/working/architecture/03-architecture/hal/overview.md
|
||||
%% SOURCE: docs/working/archive/dead/hal-target-contract/overview.md
|
||||
%% IMPORTANT: the hal_* API described in the hal/ doc family is the TARGET
|
||||
%% design, not the current codebase. Current code uses sf_time_backend_t-style
|
||||
%% naming. This section describes the planned migration.
|
||||
|
||||
Reference in New Issue
Block a user