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
2026-10-14 16:03:56 -04:00
co-authored by Claude Opus 5.5
parent 1a4b163861
commit 7aed588f78
116 changed files with 305 additions and 175 deletions
+6 -6
View File
@@ -12,12 +12,12 @@ reorganization. They remain in `docs/` exactly where they were.
| Path (unchanged) | What it is |
|------------------|------------|
| docs/patent/ (entire tree) | USPTO provisional patent: `main.tex` + `sections/`, compiled PDFs, USPTO forms (sb0015a/sb0016), `final_provisional/`, revision logs. |
| docs/DARPA_SSM_Proposal_James.docx | DARPA SSM grant proposal (Word). |
| docs/DARPA_SSM_Proposal_James.pdf | DARPA SSM grant proposal (PDF). |
| docs/SSM_DARPA_Complete_Proposal_James_FINAL.docx | DARPA SSM complete/final proposal (Word, "FINAL"). |
| docs/working/papers/proposals/DARPA_SSM_Proposal_James.docx | DARPA SSM grant proposal (Word). |
| docs/working/papers/proposals/DARPA_SSM_Proposal_James.pdf | DARPA SSM grant proposal (PDF). |
| docs/working/papers/proposals/SSM_DARPA_Complete_Proposal_James_FINAL.docx | DARPA SSM complete/final proposal (Word, "FINAL"). |
| docs/SSM_DARPA_Summary_Slide.pptx | DARPA SSM summary slide deck. |
| docs/SYSTEM_NARRATIVE.tex | Technical narrative written for patent counsel and reviewers. |
| docs/SYSTEM_NARRATIVE.pdf | Compiled system narrative. |
| docs/working/papers/SYSTEM_NARRATIVE.tex | Technical narrative written for patent counsel and reviewers. |
| docs/working/papers/SYSTEM_NARRATIVE.pdf | Compiled system narrative. |
## Also deferred this pass (not legal, but left in place for safety)
@@ -26,7 +26,7 @@ risks breaking `\includegraphics`. Deferred to a later, build-verified pass.
| Path (unchanged) | What it is |
|------------------|------------|
| docs/ontology.tex / docs/ontology.pdf | Formal ontology LaTeX source + compiled PDF (strong `formal/` candidate). |
| docs/working/papers/ontology.tex / docs/working/papers/ontology.pdf | Formal ontology LaTeX source + compiled PDF (strong `formal/` candidate). |
| docs/ontology_diagrams.dot | Graphviz source for ontology diagrams. |
| docs/fig_*.png / docs/fig_*.svg | Shared figure assets referenced by the ontology and/or system-narrative LaTeX. |