Contributing

Guides for changing TomoriBot’s code. Set up with getting-started.md, read the conventions and gates in development-tasks.md, then open the guide for your task.

Extending the bot (`extending/`)

Task	Guide
Add a slash command	`slash-command.md`
Add a panel, or a button to one	`panel.md`
Add an event handler	`event-handler.md`
Add a built-in tool	`builtin-tool.md`
Add a feature-flagged tool	`feature-flag-tool.md`
Add a DB column or table	`db-column.md`
Add a Full Install setup module	`setup-module.md`
Add an AI provider	`new-provider.md`
Add a persona preset	`persona-preset.md`
Add a participant field	`participant-extension.md`
Add an environment variable	`env-variable.md`

Localization and docs (`localization/`)

Task	Guide
Add a locale	`new-locale.md`
Publish translated docs or READMEs	`docs-site.md`
Add or move docs pages	`docs-authoring.md`

Testing (`testing/`)

Task	Guide
Test database code	`db-changes.md`
Test chat pipeline code	`chat-changes.md`
Mock a module in tests	`module-mocks.md`
Keep tests small, fast, and honest	`maintainable-tests.md`

Policies (`policies/`)

comments.md: what a comment may say, dashes, and the comment and prose audits
command-archetypes.md: which kind of command or panel to build, with reference commands
panel-prose-and-layout.md: text and components inside a panel
raw-sql.md: raw SQL stays in the repository layer
dependency-security.md: overrides, patches, and audit exceptions