# batches/ — convention only; the data lives under `user://`

This folder documents the batch layout. **It does not hold batches.**

Real batch output is written under `ISLA_OUTPUT_DIR` (default `user://output/batches`), resolved by
`Core/Scripts/ToolingPaths.cs`. Generated worlds are large, regenerable, and do not belong in git.

## Layout

```
batches/NN_<name>/                  NN = the task number that ran it
├── INDEX.md                        what varied, what to look at, what was concluded
├── scratch/                        intermediates — PERSISTENT, never cleaned
└── <seed>_<variant>/               one directory per generated world
```

`INDEX.md` is not optional. A/B comparisons are browsed by a human, and a flat directory of
same-named PNGs is not browsable.

## ⚠ No deletions here. Ever.

`FileSafety.AssertDeletable` refuses any path under the batches root, and it refuses without a
stated reason regardless. **Intermediates persist.** Any deletion that does happen elsewhere is
named explicitly in the run report.

→ `Tools/README.md`, `Design - Tooling - Iteration and Batching.md`