# Contributing (https://docs.helico.site/docs/contributing)

The rules the repositories follow, and why two of them matter most.

The full guide is [`CONTRIBUTING.md`](https://github.com/0xHelico/helico/blob/main/CONTRIBUTING.md).

## Rules with a penalty behind them
1. **Commit small and often.** Judges read the history. Never squash it.
2. **Write the plan before the code**, in `docs/plans/`, with how it will be verified.
3. **Never claim an integration that is not proven to work.** If it is untested, say so.
4. **Log AI usage** in `AI-USAGE.md`, prompts included.

## Conventions
English everywhere; Conventional Commits; issue, then a `type/short-topic` branch, then a
pull request that the reviewer merges with a merge commit; every partner integration is a
package under `packages/plugins/`; nothing that would help a competitor goes in the public
repository.

## These docs
[`0xHelico/docs`](https://github.com/0xHelico/docs). Pages are MDX under `content/docs`;
`pnpm dev` runs it, and CI runs `pnpm lint`, `pnpm build` and `pnpm lint:links`.