forinda/kick-fullstack-netlify

kickjs-add-adapter

Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).

kickjs-add-module

Use when the user asks to add a new feature module (controller + service + repo + DTOs).

kickjs-add-plugin

Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).

kickjs-bootstrap-export

Use when HMR is silently doing full restarts on every save, or createTestApp can't find the app handle.

kickjs-cli-commands-cheatsheet

Use as a quick reference for the most common kick CLI workflows — scaffolding, dev/build/start, generation, inspection.

kickjs-context-contributor

Use when a middleware's only job is to set ctx values consumed elsewhere — replace with defineHttpContextDecorator (HTTP) or defineContextDecorator (transport-agnostic).

kickjs-deny-list

Patterns to refuse outright when the user asks for them — they break v4 invariants.

kickjs-docs-lookup

Use FIRST when unsure about any KickJS API, option, or behaviour — before guessing from memory or inferring from surrounding code.

kickjs-env-wiring-check

Use when ConfigService.get('SOME_KEY') returns undefined or @Value silently falls back to process.env.

kickjs-guard-vs-middleware-vs-contributor

Use when adding auth checks, request-scoped values, or anything "before the handler" — picks between a guard, a middleware, and a context contributor.

kickjs-query-parsing-list-endpoint

Use when adding a paginated/filterable list route — emit ctx.qs + ctx.paginate with an allow-list.

kickjs-refresh-agent-docs

Use after a KickJS version bump to sync the .agents/ docs with the latest CLI templates.

kickjs-thin-entry-file

Use when src/index.ts is accumulating module/middleware/plugin/adapter literals.

kickjs-use-asset-manager

Use when code reads template files / JSON fixtures via fs.readFile + path arithmetic — switch to assets.<ns>.<key>() and the kick.config.ts assetMap.

kickjs-write-controller-test

Use when adding a Vitest test that exercises an HTTP route or DI graph.

kickjs-add-adapter

Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).

kickjs-add-module

Use when the user asks to add a new feature module (controller + service + repo + DTOs).

kickjs-add-plugin

Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).

kickjs-bootstrap-export

Use when HMR is silently doing full restarts on every save, or createTestApp can't find the app handle.

kickjs-cli-commands-cheatsheet

Use as a quick reference for the most common kick CLI workflows — scaffolding, dev/build/start, generation, inspection.

kickjs-context-contributor

Use when a middleware's only job is to set ctx values consumed elsewhere — replace with defineHttpContextDecorator (HTTP) or defineContextDecorator (transport-agnostic).

kickjs-deny-list

Patterns to refuse outright when the user asks for them — they break v4 invariants.

kickjs-docs-lookup

Use FIRST when unsure about any KickJS API, option, or behaviour — before guessing from memory or inferring from surrounding code.

kickjs-env-wiring-check

Use when ConfigService.get('SOME_KEY') returns undefined or @Value silently falls back to process.env.

kickjs-guard-vs-middleware-vs-contributor

Use when adding auth checks, request-scoped values, or anything "before the handler" — picks between a guard, a middleware, and a context contributor.

kickjs-query-parsing-list-endpoint

Use when adding a paginated/filterable list route — emit ctx.qs + ctx.paginate with an allow-list.

kickjs-refresh-agent-docs

Use after a KickJS version bump to sync the .agents/ docs with the latest CLI templates.

kickjs-thin-entry-file

Use when src/index.ts is accumulating module/middleware/plugin/adapter literals.

kickjs-use-asset-manager

Use when code reads template files / JSON fixtures via fs.readFile + path arithmetic — switch to assets.<ns>.<key>() and the kick.config.ts assetMap.

kickjs-write-controller-test

Use when adding a Vitest test that exercises an HTTP route or DI graph.