Contributing

Disclaimer

This specific page uses temporary drafts written and maintained by Generative AI. While verified to be accurate, please cross-verify with source code.

Step-by-step guides for contributing code to TomoriBot. These assume you have the repository cloned and the source open — they extend or modify the bot itself.

Start with development-tasks.md for the task index and coding conventions, then jump to the guide for your task.

Local Setup

• getting-started.md — set up TomoriBot locally with Bun + PostgreSQL for development
• docs-authoring.md — docs routes, frontmatter, sidebar, cards, and asset conventions

Adding Things

• adding-slash-command.md
• adding-event-handler.md
• adding-builtin-tool.md
• adding-feature-flag-tool.md
• adding-setup-module.md
• adding-db-column.md
• adding-new-provider.md
• adding-locale.md
• adding-persona-preset.md

Testing Your Changes

• testing-db-changes.md
• testing-chat-changes.md
• testing-module-mocks.md

Conventions and Policies

• comment-policy.md — durable comments and the advisory policy audit
• raw-sql-boundary.md — keeping raw SQL in the repository layer
• dependency-security-policy.md — overrides, patches, and audit exceptions