Files

T

Claude aec7ddb56e chore(lfs): trim 3,939 files whose LFS objects never reached the server

Their pointers were committed in a5ed8c3d (2026-08-01) and the objects were
never uploaded: the server answers 404 for all of them, and no copy exists
(Captain Bob, 2026-11-11: "they can be trimmed out").

Removed: 3,827 phase-1 logs (docs/working/archive/legacy/phase-1), 3 in
docs/working/archive/historical, 106 DoE CSVs in experiments/bare_metal/runs,
QEMU_BASELINE.log, docs/SYSTEM_NARRATIVE.log, docs/ontology.log.

Kept: the 5 LaTeX build logs under docs/patent (legal hold) -- excluded from
fetch instead. .lfsconfig excludes every one of these paths, so older commits
check out and LFS fetches run without 404s.

Every LFS pointer left in the tree (1,195) has its object on the server.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm

2026-11-11 16:56:32 +00:00

architecture

docs: the 12 duplicates deleted; README rewritten to the system as it is

2026-10-14 16:45:39 -04:00

README.md

docs/working/ — Living Documentation

Source material for the formal documentation tier. Design notes, DoE logs, architecture decisions, experiment reports, draft specs — everything not yet promoted to docs/formal/. See docs/CLAUDE.md for the two-tier model.

Layout

Directory	Contents
`architecture/`	System design: physics engine, HAL, heartbeat, pipelining, word-ACL, adaptive systems, getting-started, plus dated design/finding notes for Artemis, Hermes, and the K-PUSH dictionary-shadowing bug. (`03-architecture/`, `getting-started/`, `heartbeat_csv_export.md`)
`experiments/`	DoE designs and run data. (`02-experiments/`, `campaigns/` = former top-level `experiments/`, including the `l8_attractor_map`, `l8_validation`, `doe_2x7`, `shape_validation`, and `window_scaling` campaigns)
`specifications/`	Protocol/format specs — currently `HOLA_PROTOCOL.adoc`.
`hardware/`	Board bring-up, platform/perf notes — `PGO_GUIDE.adoc`, `PLATFORM_BUILD_GUIDE.adoc`, plus `performance-profiling/` and `platform-integration/` subtrees.
`legal/`	Patent-adjacent material — HOLD. See `legal/README.md`. Nothing moved here without Bob's instruction.
`papers/`	Academic / citable writing: claim tables, anti-claims, null hypothesis, reproducibility, ontology (markdown), SSRN companion (`SSRN_companion/`), `FINAL_REPORT/`, published SSRN PDF (`published/`).
`scratch/`	Uncategorized working material: governance/meta docs (`governance/`, `ci-cd/`, `testing-quality/`), the full `docs/src/` developer-reference tree (`src/`), asset holding area (`assets/`).
`archive/`	Historical / superseded / obsolete records: quality audits, operations, research drafts, session logs, the former `docs/archive/` tree (`legacy/`), artifacts.

Phase 2 reorganization notes (2026-06-16)

Moves used git mv (history preserved). Each moved .md/.adoc/.tex file carries a one-line provenance header noting its original path.
Reorg used directory-level consolidation rather than splitting every mixed-tag directory file-by-file, to keep companion data (logs, CSVs, randomization matrices) with the reports they belong to. Per-file status tags remain authoritative in docs/INDEX.md.
docs/src/ landed under scratch/src/ as a holding area — it is mixed developer reference that still needs semantic re-filing into architecture/, hardware/, and specifications/.
Repo-root convention files (README.md, ROADMAP.md, ONTOLOGY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, NOTICE.md) and the docs landing files (docs/CLAUDE.md, docs/INDEX.md, docs/README.md) were left in place.
DELETE candidates: see docs/DELETE-CANDIDATES.md (nothing deleted).