What problem does it solve?
Proto files in Forge projects can silently drift from the conventions that drive reliable code generation, causing failing builds, out-of-sync ORM state, and confusing generator errors.
Core Features & Use Cases
- Proto-first structure guidance: Clarifies where service, entity, and shared proto files belong, enforcing the one-service-per-file approach.
- Annotation and field rules: Defines how to mark entities, primary keys, tenant scoping, timestamps, and field behaviors so Forge can generate correct CRUD and ORM layers.
- Conventions for safe evolution: Covers enum requirements, reserved fields, List request optional filters, and correct handling of greenfield vs migrated projects.
- Error prevention workflows: Explains the canonical workflow (forge generate + forge lint + forge build) and why running buf generate alone leads to ORM out-of-sync checks.
Quick Start
Ask the skill to review your proto file named service task definitions and tell you what to change so it satisfies Forge entity, field, and CRUD conventions before you run forge lint --conventions.