This directory contains the project documents that agents and contributors should consult before making non-trivial changes.
coding-preferences.md- Captures project coding preferences and implementation constraints in an agent-friendly form.
layer-responsibilities.md- Defines what belongs in command handlers, services, the Telegram boundary, and utility/helper layers.
testing-conventions.md- Defines the testing strategy, test layering, and expectations for new and changed behavior.
changelog.md- Product-facing release history grouped by version, using Git tag creation dates.
changes/- Historical feature specifications, refactoring plans, and design notes for individual changes.
- Documents in this directory are immutable after the related change lands: do not edit them to match later behavior.
- When a task references an existing feature, bug, or refactor plan, check for a matching document here as historical context only. If the current implementation differs, prefer the current code and update living documentation outside
changes/when needed.
- Read
layer-responsibilities.mdto understand architectural boundaries. - Read
coding-preferences.mdto align with local implementation style and constraints. - Read
testing-conventions.mdbefore adding or changing tests. - Read the relevant document in
changes/as historical context when working on a planned feature or refactor.