antosubash

Use when invoking the `smpy` CLI for a simple_module_python project — starting a new app, scaffolding a host or a publishable module, bumping simple_module_* dependencies to their latest PyPI versions, regenerating the Inertia page manifest, importing settings overrides from env, creating an admin user, or installing the bundled agent skills. Triggers on "smpy new", "smpy create-host", "smpy create-module", "smpy package-update", "smpy host gen-pages", "smpy users create-admin", "smpy skills add", or any unfamiliar `smpy` subcommand.

Use when writing or reviewing code inside modules/ in a simple_module_python codebase, hitting type-check or lint failures in module code, or unsure which base class / settings prefix / file structure to use. Triggers on "add a model", "where do settings go", "why is doctor warning", or any edit under modules/.

Use when adding a new feature package to a simple_module_python app. Triggers on "create a new module", "add a module", "scaffold a feature", or when an empty module directory under modules/ needs to be filled in.

Use when adding SQLModel tables to a simple_module_python module, deciding whether to inherit a mixin, or debugging session/transaction behavior. Triggers on "add a table", "audit fields", "soft delete", "tenant scoping", "why is this commit firing twice", or any edit involving create_module_base, AuditMixin, SoftDeleteMixin, MultiTenantMixin, VersionedMixin, or get_db.

Use when interpreting a simple_module_python diagnostic code (SM001–SM021) printed at boot or by the diagnostics runner — what the code means, whether it's blocking, and the concrete fix. Triggers on any "SMnnn" code in logs, "InvalidModuleError", "module silently doesn't load", or "production failed boot".

Use when adding or debugging an Inertia.js page in a simple_module_python module — TSX file naming, the inertia.render() namespace, shared props (auth, menus, i18n), or why a page renders blank or fires SM003/SM004. Triggers on "inertia.render", "page not found", "auth.user is null", "InertiaDep", or any edit involving pages/*.tsx in a module.

Use when adding or debugging i18n in a simple_module_python module — declaring `locale_dirs()`, naming JSON files, picking a namespace, writing CLDR-pluralized keys, or fixing SM013–SM016. Triggers on "translations", "locales", "useT", "i18n", "missing locale", "non-string leaf", "first-render-locale freeze", or any edit under `<module>/locales/`.

Use when generating, applying, or reviewing Alembic migrations in a simple_module_python host project, especially after installing or upgrading a module package. Triggers on "alembic revision", "autogenerate", "branch labels", "downgrade", "SM010", "SM011", or "migration drift".

Write correct ASP.NET Minimal API endpoints in the SimpleModule modular monolith. Use when creating, modifying, or reviewing any IEndpoint or IViewEndpoint implementation, or when writing endpoint code that uses parameter binding, authorization, validation, CrudEndpoints helpers, Inertia.Render, or form handling. Triggers on: "add endpoint", "create endpoint", "new endpoint", "API endpoint", "view endpoint", "MapGet", "MapPost", "MapPut", "MapDelete", "Inertia.Render", route handling, parameter binding questions, "FormRequest", "Route const", "IAuthorizer", "policy", "RequirePermission", or any work touching files in Endpoints/, Pages/, or FormRequests/ directories.

Scaffold a new SimpleModule module with contracts, implementation, and test projects following the project's modular monolith conventions. Use when creating a new module from scratch.

Comprehensive guide for working with the SimpleModule modular monolith framework. Use when creating modules, adding features, writing endpoints, configuring services, working with the event bus, permissions, menus, settings, database contexts, or understanding the project architecture. Triggers on: "add module", "new module", "add feature", "create endpoint", "module architecture", "how does SimpleModule work", "event bus", "permissions", "menu", "settings", "database context", "contracts", "IModule", "IEndpoint", "IViewEndpoint", "Inertia", "CrudEndpoints", "debug module", "review module", "module status", "SM00", "source generator diagnostic", "module not found", "page 404", "event bus", "settings", "IMessageBus", "Wolverine", "SettingDefinition", "policy", "IPolicy", "IAuthorizer", "entity-level authorization", "FormRequest", "Route const".

End-to-end verification of a feature implementation before opening a PR. Starts the SimpleModule.Host (killing port 5001 if occupied), drives the feature in a real browser via playwright-cli, runs every local CI step, and only then opens a pull request. Use when the user asks to "verify the feature", "test and ship", "run e2e + CI + PR", or any variation that means "prove it works, then PR it".

Use when building React 18+ applications in .jsx or .tsx files, Next.js App Router projects, or create-react-app setups. Creates components, implements custom hooks, debugs rendering issues, migrates class components to functional, and implements state management. Invoke for Server Components, Suspense boundaries, useActionState forms, performance optimization, or React 19 features.