Files
LithosAnanake/docs/formal/scraps/architecture/getting-started
rajamesandClaude Opus 5.5 7aed588f78 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>
2026-10-14 16:03:56 -04:00
..

%% SCRAP: architecture/getting-started/README
%% SOURCE: docs/working/architecture/getting-started/README.md
%% STATUS: SUPERSEDED
%% FITS: dev-guide/ch-install
%% EDITORIAL: lifted — prose rewritten to press voice

\section{Getting Started: Orientation}

%% This source is a directory-index README. Its substantive content is the
%% Developer Guide (see DEVELOPER scrap) plus the quick-start experiment guides;
%% in the formal doc set it is superseded by those chapters. Retained here only
%% as a brief signpost.

The getting-started material orients new users and developers. The developer
setup and contribution workflow are covered in the Developer Environment
chapter. Three quick-start guides walk through running experiments:

\begin{itemize}
  \item Factorial Design of Experiments --- the $2^7$ factorial harness.
  \item Heartbeat logging experiments.
  \item Physics-optimization experiments.
\end{itemize}

From here, readers proceed to the experimental protocols to run their own
experiments, the architecture documentation to understand the system
internals, and the source-code reference for detailed technical material.

%% TODO(bob): this index README is redundant with DEVELOPER and the quick-start guides. Confirm it should be folded into ch-install rather than carried as its own section, and point the three quick-start bullets at their promoted formal locations.