git:20261014.53838c2 to git:20261015.b8d4be2

3 added, 2 removed. Audit A to A.

# celis trails — repo conventions

## Layout

- `crates/` is one Cargo workspace. Run cargo from there.

- `spec/` holds the contract, as CIPs. `spec/fixtures/` holds what two ends must match.

- `plugins/celis/` is the plugin: one manifest per agent, and the same hooks. Gemini CLI installs from the

repo root, so `gemini-extension.json` and `hooks/` are there. Antigravity does too, so

`.antigravity-plugin/` and `hooks.json` are there. The card's command lines match the usage in

`crates/celis/src/help.rs`; `crates/celis/tests/help.rs` checks it.

## Writing

- Say it once, in the fewest words that keep the meaning. Short sentences, never fragments.

- A name is a noun for what a thing is. No `-er`/`-or` agent names (`Manager`, `Handler`).

- One primary type per file; the filename matches it.

## Docstrings

- On types and members only. No inline comments.

- A docstring states what the item does, not how or why. Five lines on a type, three on a member, none

where the name says it.

- A test cites the spec section it proves: ``(`spec/03-steps.md`, "Section")``.

## Tests

- Unit tests go in a sibling `tests.rs` (`foo.rs` → `foo/tests.rs`).

- A test proves behaviour through the public surface. Fakes stand in only at I/O.

## Verify

```bash

make verify # fmt, clippy -D warnings, and the tests

```

- A release is a GitHub release on a `v<version>` tag. The repo keeps `crates/celis` and `plugin.json` at `0.0.0`; the

- release passes the version in through `CELIS_VERSION`.

+ A release is a manual run of the Release workflow with a version. It writes the version in each plugin manifest,

+ commits that to `main`, tags it `v<version>`, and publishes the GitHub release. The repo keeps `crates/celis` at

+ `0.0.0`; the release passes the version in through `CELIS_VERSION`.