# Repository guidance

This is Maintainer Skills Lab, an independent library of maintainer workflows.
Keep changes scoped to this repository. Source skills and agent profiles are
shared; client outputs are generated by `tools/kit.py`.

## Before editing

- Read README.md and relevant implementation files.
- Check git status and existing PRs. Preserve unrelated or user-authored changes.
- Use a `codex/` branch for a coherent change and continue a matching open PR
  rather than creating duplicates.

## Verification

Run the affected checks, and run the complete small suite before publishing an
implementation change:

```sh
python3 tools/kit.py check
python3 -m unittest discover -s tests -v
python3 examples/bugfix/run.py
python3 tools/kit.py build
```

Source validation, fixture execution, and actual agent evaluation are different
claims. Record which happened. Never mark a client as tested solely because its
files parse. Native agent exports inherit model and execution policy.

## Maintenance

- Prefer one useful, complete improvement over activity-only changes.
- Commit and push real verified work. Don't manufacture empty commits, alter
  dates, add timestamp-only logs, or split changes solely to inflate activity.
- Keep documentation focused on available features, usage, and verified limitations.
- Don't send promotional messages or contact other people without a user request.
- Existing user authorization covers commits, pushes, and PRs for this project;
  do not repeatedly ask for those permissions.
- Do not purchase services or run paid APIs as part of routine checks.