| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 13 | 0 | 0 | 100% |
| Commands | 1 | 0 | 0 | 100% |
| Section tags | 8 | 0 | 0 | 100% |
What each file covers
Sections
13 shared · 0 only in A · 0 only in B- Forem AI Context & Rules
- Meta: AI Instruction Synchronization
- General Philosophy
- Background Workers & Sidekiq
- Testing Standards
- Performance, Callbacks & Caching
- Database & Schema Collisions
- Internationalization (i18n)
- Frontend
- Documentation
- Scratch Files
- ML & AI Infrastructure
- API Changes & Specification Enforcement
Commands
1 shared · 0 only in A · 0 only in B- bundle exec rake rswag:specs:swaggerize
Section tags
8 shared · 0 only in A · 0 only in B- test
- code-style
- types
- database
- api
- performance
- do-not
- docs
Line diff
forem/forem · .cursorrules
@@ −66 @@
66- **Document All API Changes**: Any time you modify or add any routes, controller actions, or parameters under `/api/*` (such as adding semantic or fuzzy search endpoints), you **MUST** update or create the corresponding RSWAG documentation specs in `spec/requests/api/v1/docs/*_spec.rb` (or matching version).
67- **Regenerate OpenAPI Schema**: After updating the swagger spec files, you **MUST** run the Swagger generation rake task (`bundle exec rake rswag:specs:swaggerize`) to regenerate the `swagger/v1/api_v1.json` file.
68- **Do Not Leave Specs Outdated**: Outdated API specifications cause integration failures for external services, gateway clients, and LLM MCP servers. Always treat specs as part of the core delivery.
69
forem/forem · AGENTS.md
@@ +66 @@
66- **Document All API Changes**: Any time you modify or add any routes, controller actions, or parameters under `/api/*` (such as adding semantic or fuzzy search endpoints), you **MUST** update or create the corresponding RSWAG documentation specs in `spec/requests/api/v1/docs/*_spec.rb` (or matching version).
67- **Regenerate OpenAPI Schema**: After updating the swagger spec files, you **MUST** run the Swagger generation rake task (`bundle exec rake rswag:specs:swaggerize`) to regenerate the `swagger/v1/api_v1.json` file.
68- **Do Not Leave Specs Outdated**: Outdated API specifications cause integration failures for external services, gateway clients, and LLM MCP servers. Always treat specs as part of the core delivery.
@@ −66 +66 @@
6666 - **Document All API Changes**: Any time you modify or add any routes, controller actions, or parameters under `/api/*` (such as adding semantic or fuzzy search endpoints), you **MUST** update or create the corresponding RSWAG documentation specs in `spec/requests/api/v1/docs/*_spec.rb` (or matching version).
6767 - **Regenerate OpenAPI Schema**: After updating the swagger spec files, you **MUST** run the Swagger generation rake task (`bundle exec rake rswag:specs:swaggerize`) to regenerate the `swagger/v1/api_v1.json` file.
6868 - **Do Not Leave Specs Outdated**: Outdated API specifications cause integration failures for external services, gateway clients, and LLM MCP servers. Always treat specs as part of the core delivery.
69−
