Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Development documentation
This folder is for people working on Aetheris. It is not user documentation:
for current behavior, use docs/public and the compiler.
| Folder | What is in it |
|---|---|
history/ |
Start here. The project's story in nine eras, the decision log, and an index of every original report with how to restore it from git. |
architecture/ |
Durable internal contracts: kernel (Boolean lessons, BRep Surgery), authoring and kernel boundaries, face orientation, STEP pcurves, imported-hole revisions, the Firmament language service, and the LLM CAD strategy notes. |
reports/2026-10/ |
Working reports for the current era (October 2026): language decisions, syntax review, frontend migrations, Helios, Preview 4. Summarized in era 9; they move into the history when the era closes. |
proposals/ |
Design proposals that are not implemented. A proposal never grants source admission. |
milestones/, implementation/, history/firmament, history/preview2 |
Only files that code, tests or scripts read, and evidence beside tracked artifacts. Everything else from these folders is in the history. |
Rules
- User-facing behavior is documented in
docs/publiconly. If you change behavior, update the public guide in the same change. - New work reports go in
reports/<yyyy-mm>/. Keep them short: what changed, the evidence, the verdict (success, meaningful progression, or honest stop). - When an era closes, summarize its reports into a page under
history/eras/, add lasting decisions tohistory/DECISIONS.md, list the originals inhistory/ORIGINALS.md, and delete them. Git keeps them. - Do not delete a file that code, tests or scripts read without moving the
reference too.
git grep <file name>outside Markdown before removing anything. - Generated output is local by default. See the generated-artifact policy before promoting any generated result into this tree.
Maintainer build and test policy is in AGENTS.md and
CONTRIBUTING.md.