| name | mern-kit |
| description | Startup runbook for MERN projects. Establishes stack decisions, scaffolds the project, configures GitHub security, and confirms governing constraints. |
Purpose
Initialize a new MERN project with the standard stack, scaffolding, GitHub security, and constraints.
Input: <app-name> (optional, default: "app"). Use . to scaffold in the current (empty) directory.
Startup sequence (run in order)
1. Confirm stack decisions
/mern-stack
Establishes: toolchain, monorepo layout, Next.js conventions, database approach, environments.
2. Scaffold the project
/mern-scaffold <app-name> [--github]
Creates: build-green baseline with CI, tests, shared packages, server utilities, tooling.
The scaffold step includes git init at the end.
3. Set up local Git hooks
Prerequisite: The scaffold step must have completed git init first.
/github-hooks --platform mern
Installs: Husky + lint-staged, pre-commit validation (lint, format, secrets), commit message enforcement, pre-push tests.
4. Configure GitHub security (if --github was used)
/github-secure
Applies: branch protection, Dependabot alerts, auto-merge. Skips files already created by scaffold.
5. Verify constraints are active
Confirm these always-on skills are enabled:
mern-sec — security policy
mern-nfr — non-functional requirements
mern-std — coding standards
mern-styleguide — design/UX standards
6. Verify CI passes (if --github)