Guides Contributing Overview

How to contribute to Kanna.

Kanna is a community fork. PRs are welcome — see the guides below for the rules of the road.

• Filing Issues — the bug and feature forms, and what makes an issue implementable
• Architecture — event sourcing, the IO seal, C3 docs
• From send to "Starting..." — the prompt-to-processing-row path and how to profile it
• Pull Requests — where to open, how to target
• Lint & Tests — CI gates
• Dev Workflow — local setup, worktrees, fast iteration
• Releasing — release-please, commit messages, recovering a failed publish

Agents read the short rule set in CLAUDE.md and the skills under .claude/skills/; each rule is enforced by a gate whose error message explains the fix, and these pages give the longer background.