The conventions and the migration guides of the stack, versioned with its Stack repository. They apply to people and
to coding agents alike. What a package does is documented with the package (its README.md), not here.
A new guideline or migration guide adds its row to these tables.
The rules for working in the repositories of the stack (Guidelines/).
| Guideline | Read it when |
|---|---|
| Branching | Before the first commit in a repository: no commit in a bare branch (stable, develop), only in its dev/ counterpart (a Stack repository commits on main). |
| Documentation | Writing or reviewing a README.md or another Markdown document: where it lives, what it says, how it links. |
| Design principles | Designing a package, a feature or an application (a configuration, a party, a token, a link). |
| Removing or renaming a package | Retiring a package or publishing it under a new name: its tombstone. |
| Migration guides | Writing or testing a migration guide. |
| Working with ckli | Building, testing or changing the package versions of a repository with ckli. |
| The .wip folder | Keeping working notes: the shared notes of the team (Shared/) and your own (User/). |
What a repository (or a World) that uses the stack must change to move from a release to the next one (Migrations/).
| Guide | From | To |
|---|---|---|
| v2026.282 to explo/cris-auth | The v2026.282.0 release | The packages of the explo/cris-auth branch: the authentication made of Cris commands and an Authentication Center. |