AGENTS.md@projects-folder/nanochat_cpu git:20260928.63ead0bA

Immutable. This exact content never changes and is served at /api/v1/blob/cd3217f52ccb1d00.

# Project Instructions

Based on the `ai_research_template` project template, last synced 2026-09-29.

These rules govern agent work in this project directory, whether the project
lives inside the AI-Human Research OS or stands alone as its own repository.
If this directory is `projects-folder/templates/<name>/`, it is the template
itself: edit it as a template and skip the project rules below.

## Start

Read [index.md](index.md) for navigation and the Snapshot in
[PROJECT_MEMORY.md](PROJECT_MEMORY.md) for current state; use
[Code/README.md](Code/README.md) for setup, commands, and results.

## Workflow

- **Code and data:** work under [Code/](Code/), manage its environment with
  `uv`, and store datasets under [Code/Datasets/](Code/Datasets/) with their
  source, version, and license. Keep the paired code READMEs current with
  setup, run commands, inputs, outputs, results, and limitations.
- **Artifacts:** place figures and tables in [Figs/](Figs/) and baseline notes
  or comparison materials in [Baselines/](Baselines/).
- **Writing:** edit [paper/main.tex](paper/main.tex), with claims and evidence
  tracked in [paper_skeleton.md](paper_skeleton.md) and project BibTeX entries
  in [paper/references.bib](paper/references.bib). Build from `paper/` with
  `latexmk -pdf -interaction=nonstopmode main.tex`; the expected output is
  `paper/main.pdf`.
- **Evaluation:** store one full report per evaluation under `Evaluations/`
  when that directory is needed; keep only summary state in
  `PROJECT_MEMORY.md`.
- **Session end:** add a dated bullet to the newest-first Progress Log in
  `PROJECT_MEMORY.md` and update every Snapshot field the session changed.

## Parallel work

Create `Tasks/<task-id>/` only for work that is decomposable, independently
verifiable, and worth the merge cost. Record the task goal, inputs, success
criteria, findings, and artifacts there; merge only verified outputs into the
project's main areas.

## Research integrity

- Preserve original datasets, reference material, and user-provided research
  material; keep frozen evaluators and authoritative result files as they are.
- Keep every claim traceable to a source or artifact, and every reported
  number reproducible from a stated command. Record unknowns as unknown;
  never invent citations, quotations, data, results, or verification.

## Inside the Research OS

When this project sits under `projects-folder/` in the Research OS, the
repository root's `AGENTS.md` applies as well, and:

- Reusable paper understanding goes to the shared
  [paper wiki](../../paper-wiki/index.md); project-specific BibTeX stays in
  `paper/references.bib`.
- The project's row in [global memory](../../memory/MEMORY.md) is a projection
  of the Snapshot: after changing the Snapshot, run `research-project-manager`
  `sync`. Edit global memory directly only for cross-project changes.
- The source idea lives under [ideas/](../../ideas/).

## Project-specific rules

<!-- Rules that apply only to this project: hardware, data locations,
protected files, scope. Keep the sections above as the template ships them, so
later template changes can be ported. -->

- This project is a runnable Research OS example, not a research result.
  Keep `bash runs/runcpu_small.sh all` (run from `Code/nanochat/`) finishing
  in a few minutes on a laptop-class CPU; larger recipes belong in the
  "Scaling notes" section of [Code/README.md](Code/README.md).
- [paper/main.tex](paper/main.tex) is a short write-up of this example, the
  Research OS's worked example of the Writing workflow. When results or
  timings change, update the paper, `paper_skeleton.md`, and `Code/README.md`
  together and rebuild `paper/main.pdf`.
- Train on CPU. The runner sets `NANOCHAT_BASE_DIR`, `NANOCHAT_COMPILE=0`,
  and `ARROW_DEFAULT_MEMORY_POOL=system`; set the same variables to run a
  script by hand.
- Data, checkpoints, and logs stay under `Code/nanochat/.cache/` and
  `Code/results/`; datasets download there, not into `Code/Datasets/`.
- `Code/nanochat/` is a port of OpenResearch's `demo/nanochat` (commit
  `27cb342`; nanochat by Andrej Karpathy, MIT). Keep its LICENSE and README,
  and record every code change under "Changes from the demo" in
  [Code/README.md](Code/README.md).
- [Baselines/openresearch-demo/](Baselines/openresearch-demo/) holds
  unchanged copies of the reference run's evidence; keep them as they are.