SchOS/.claude/memory
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nexoniarz 57aff40228 docs: four directories, and a rule for when a thing leaves the roadmap
docs/ was ten files where a plan, a description, a guide and a bug report all
sat next to each other. It is now architecture/ (what SchOS is), plan/ (what it
will be), guides/ (how to work on it) and history/ (why it is like this), with
an index that states the one rule holding it together: when something is
finished it moves from plan/ to architecture/ and is rewritten as a description
of the thing rather than a record of building it.

A ticked checkbox says the work happened. It does not say what the work
*produced*, and six months later the checkbox is all that is left. The network
stack proved the point: finished, verified end to end, and for a month the only
description of it anywhere was a checkbox four levels of indentation deep.

So roadmap.md went from 534 lines to 181 -- nothing deleted, the done work
graduated. Seven subsystems that were finished and undescribed now have
descriptions: boot, kernel, syscalls, filesystem, networking, graphics, usb,
init. Every one ends with "What it does not do", which is the section that pays;
a document listing only strengths is marketing, and the reader who needs it most
is the one about to trip over a limitation nobody wrote down.

schfs.md still opened with "phases 1 through 3 1/2 are done, phase 4 is next"
long after all five had landed. It is a description now, with the phase record
and the hard-won bugs moved to history/.

Three corrections found on the way, all load-bearing:

  * projects/schcom/README.md claimed SCM_RIGHTS was done. There is no
    sendmsg/recvmsg in the kernel at all, and an entire GUI plan rested on it.
  * The root README said "No TCP/IP" months after the stack landed.
  * history/kernel.md sec.7 was marked "in progress" on a problem that process
    groups solved.

Also adds plan/1.0.md, which draws a finish line so the open list stops being
infinite, and marks schwm/ and schde/ superseded: in Wayland the compositor is
the window manager, so that split dissolves rather than being abandoned.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VQ7Qx8E1q1M1bbCq8QLHS2
2026-09-12 17:13:35 +02:00
..
MEMORY.md memory: the SchFS and platform roadmap, and the 614 MB ceiling 2026-08-10 18:53:32 +02:00
nexoniarz-sharing-preference.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schcom-v0.md memory: Schcom v0, and the order change that put it before the installer 2026-08-09 23:12:56 +02:00
schfs-btree-phase1.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schfs-next-and-platform-roadmap.md memory: the SchFS and platform roadmap, and the 614 MB ceiling 2026-08-10 18:53:32 +02:00
schfs-phase2-mount.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schfs-phase3-writes.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schfs-v2-and-ramdisk.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schos-boot-split.md memory: schinit and the BIOS/UEFI split 2026-08-09 16:36:54 +02:00
schos-bootcheck-trust.md Rebuild when RAMROOT is toggled, and add an opt-in KVM target 2026-08-09 22:46:00 +02:00
schos-cross-platform-build.md Rewrite run.ps1; it was five kinds of stale 2026-08-09 14:49:47 +02:00
schos-fedora-move-bugs.md Fix two bugs the Fedora move exposed 2026-08-09 19:29:21 +02:00
schos-linux-machine.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schos-memory-sync.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schos-performance-and-init.md memory: performance, init signal safety, and trusting the harness 2026-08-09 15:55:11 +02:00
schos-rename-and-git.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schos-schinit.md memory: schinit and the BIOS/UEFI split 2026-08-09 16:36:54 +02:00
schos-uefi-loader.md Rebuild when RAMROOT is toggled, and add an opt-in KVM target 2026-08-09 22:46:00 +02:00
schunix-boot-splash-logo.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-build-environment.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-build-speed.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-console-tty.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-crash-screen.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-devfs-procfs.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-device-model.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-dirsiz-14.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-doom-acceptance-test.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-driver-infrastructure.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-e1000-and-driver-layout.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-framebuffer-device.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-ioremap-and-bars.md memory: UEFI reaches userspace, and the ISO grows a hierarchy 2026-08-09 22:04:12 +02:00
schunix-iso-boot.md memory: the installer is scoped, and the live CD is off the list 2026-08-09 22:20:20 +02:00
schunix-layout-migration.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-licensing.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-linux-abi-decision.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-linux-open-flags.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-network-stack-choice.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-pci-drivers.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-qr-encoder.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-ramdisk-root-sizing.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-rewrite-priorities.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-roadmap-and-projects.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-schapi-direction.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-shm-and-mmap.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-smp-and-memory-bugs.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-sockets-and-evdev.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-syscall-single-table.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-text-rendering.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-ttf-rasteriser.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-tty-fg-pgrp-coupling.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-usb-ids.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-usb-xhci.md docs: four directories, and a rule for when a thing leaves the roadmap 2026-09-12 17:13:35 +02:00
schunix-verify-by-driving-shell.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-virtio-gpu.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00
schunix-wall-clock.md Carry project memory in the repo, with tools/memory-sync.sh 2026-08-09 14:27:22 +02:00