This repo owns the Agent Trail format specification, schema artifacts, fixtures, and format ADRs.
- Start from the linked Linear issue or maintainer direction.
- Keep changes scoped to this repo's public spec, schema, fixture, or documentation surface.
- Do not add implementation-only contracts to the format spec.
- Do not commit real local sessions, secrets, credentials, private logs, or unredacted user data.
- Use
mise run setupfor local tool and hook setup. - Use
mise run checkbefore opening or updating a pull request. - Use
mise run check:actionsafter editing GitHub Actions workflows.
- Before introducing a package, tool, or GitHub Action, check the latest upstream stable version and use it unless there is a documented reason not to.
- Use
.github/PULL_REQUEST_TEMPLATE.md. - Link the Linear issue.
- State public spec, schema, fixture, or docs impact.
- Include exact verification commands and results.