Use when an agent needs authoritative make/go command usage in this repository, including test, run, guides, deploy, server setup, and generator invocations.

2026-02-140

monolith-controller-and-view-development

cggonzal/monolith

Use when building HTTP controllers and templates, including REST action scaffolding, view rendering patterns, and route wiring.

2026-02-140

monolith-database-and-services

cggonzal/monolith

Use when working on persistence setup, migrations, and service integrations (like email) that depend on app config and models.

2026-02-140

monolith-generator-workflows

cggonzal/monolith

Use when adding app features via the built-in generator (model/controller/resource/authentication/job/admin), including expected file mutations and post-generation validation.

2026-02-140

name	monolith-routing-and-middleware
description	Use when editing route registration, middleware ordering, CSRF behavior, and request pipeline behavior for HTTP handlers.

Monolith Routing and Middleware

Use this skill when

Adding new HTTP endpoints.
Inserting request/response middleware.
Troubleshooting request flow issues.

Routing fundamentals

Main router is http.ServeMux in app/routes/routes.go.
Routes are registered in registerRoutes.
Pattern format uses method + path (e.g., "GET /widgets/{id}").

Middleware fundamentals

Middleware registration order lives in app/middleware/registration.go.
Current baseline includes logging and CSRF middleware.
Middleware wraps mux globally through InitServerHandler.

Adding middleware safely

Implement func(http.Handler) http.Handler in app/middleware/.
Add it to registration slice in desired order.
Ensure it is side-effect free and deterministic.
Add tests similar to existing middleware tests.

CSRF behavior

CSRFMiddleware leverages Go's cross-origin protections; keep it in the stack unless you intentionally disable protection for a specific reason.