make-app-runtime

Use this skill for Make App runtime and packaging contracts. These rules are intentionally strict because platform image entrypoints and publish artifacts should not vary per POC.

This skill owns project runtime structure, workspace manifests, build outputs, Service start entry, Service port baseline, runtime config file location, Docker/K8s runtime entry alignment, publish-readiness script guidance, and publish-readiness checks.

It does not own UI layout (makeui), authentication implementation (make-app-auth), single-app permission logic (make-app-permission), Make adapter environment variable semantics (make-app-service), DSL modeling (makedsl), Make resource deployment (makecli), or canvas-table behavior (canvas-table-integration).

Quick start

1. Identify whether the task touches apps/, apps/service, apps/ui/dist, package scripts, Docker/K8s, image entrypoints, publish readiness, or a runtime error such as Cannot find module '/app/apps/service/dist/server.js'.
2. Preserve the platform image contract unless the user explicitly says the platform contract itself is changing.
3. For a new App or an explicit runtime migration, verify the runtime baseline in apps/package.json: it must declare "packageManager": "pnpm@10.20.0" and "engines": { "node": "22.20.0", "pnpm": "10.20.0" }. Existing Make Apps keep their declared runtime during unrelated work; change it only after the user requests an explicit runtime migration.
4. For a new or explicitly migrated App, run package commands through Corepack (corepack pnpm), not an ambient pnpm binary. For an existing App without a runtime migration, use its compatible declared package manager, lockfile, and established workspace workflow.
5. For a new or explicitly reorganized App, verify workspace manifests: apps/package.json, apps/pnpm-workspace.yaml, apps/ui/package.json, and apps/service/package.json. For a legacy App, first identify its actual workspace structure without rewriting it.
6. Verify build artifacts before declaring ready: frontend apps/ui/dist and the Service entry selected by the actual platform image (apps/service/dist/server.js for the default contract).
7. Add or preserve a contract test for the Service runtime entry.

Workspace contract