project-template

Build or change API behavior in api/ using Express routers, middleware, CustomError, model instances, and camelCase JSON responses.

Review backend and frontend template code for real defects, boundary violations, security gaps, and missing tests. Auto-invoke for code reviews or bug investigations. Triggers: "bug review", "review code", "find bugs", "security audit", "check defects".

Implement OOP API entities in api/model/ using the shared Model base class and relation helper.

Maintain the api/helpers/postgres.js SQL boundary, CRUD helper surface, and safe filter conventions.

Update project-local agent guidance when architecture, workflows, commands, or conventions change. Auto-invoke when user or agent output indicates a reusable workflow or durable rule. Triggers: "update docs", "update skill", "create new skill", "update agent instructions", "document recurring pattern", "capture reusable workflow".

Add accurate JSDoc and focused comments when changing template code. Auto-invoke during code writing or refactoring. Triggers: "document code", "jsdoc", "code comments", "add comments", "explain logic".

Keep human docs, agent guidance, and touched code comments aligned with the real web/api implementation, compose workflow, and validation commands. Auto-invoke when auditing docs or after major architectural changes. Triggers: "audit docs", "check context", "documentation maintenance", "audit documentation", "verify docs".

Deliver template behavior changes with focused automated tests, build checks, and honest validation reporting. Auto-invoke when writing tests, fixing bugs, refactoring routes/models, or validating web/api changes. Triggers: "test-first", "run test", "add unit test", "add integration test", "browser smoke", "validate changes".

Manage translations and locale loading for the Web service using i18next-based middleware, server-injected template variables, and the client-side Translator helper.

Enforce the current web CSS architecture and warm editorial styling conventions in this repository. Use when creating or changing styles, theming, design tokens, component visuals, layout classes, or page atmosphere in web/src/css.

Build or change the Express/Mustache/Webpack frontend in web/ with page scripts, DOM components, helpers, and API-backed frontend models.