create-next-pro-cli 0.1.29 → 0.1.31

package/README.md

@@ -71,13 +71,16 @@ cd my-app
 Then install dependencies with your preferred package manager:
 
 ```bash
-bun install && bun run dev
+bun install && cp .env.example .env && bun run dev
 # or
-npm install && npm run dev
+npm install && cp .env.example .env && npm run dev
 # or
-pnpm install && pnpm run dev
+pnpm install && cp .env.example .env && pnpm run dev
 ```
 
+The creation result reports `.env.example` explicitly and provides the same
+local-development commands in both human and JSON output.
+
 An existing destination is rejected by default. `--force` only permits replacement of the requested child destination:
 
 ```bash
@@ -129,9 +132,15 @@ The Next.js route and its interface are separate: `src/app` owns routing while `
 
 ```text
 my-app/
+├── .agents/
+│   └── skills/
+│       ├── create-next-pro-create-project/
+│       ├── create-next-pro-addpage/
+│       └── ...
 ├── .env.example
 ├── .gitignore
 ├── .prettierignore
+├── AGENTS.md
 ├── bun.lock
 ├── cnp.config.json
 ├── messages/
@@ -199,6 +208,8 @@ my-app/
 
 Template working files (`.env`, the nested Git repository, caches, screenshots, and test results) are not copied into generated projects. The CLI creates `cnp.config.json` with the project name and selected alias.
 
+Generated projects also include concise root guidance in `AGENTS.md` and eight instruction-only command skills under `.agents/skills`. Agents should prefer the deterministic `--json` contract and read the matching skill before invoking a project mutation.
+
 ## CLI architecture
 
 ```text
@@ -332,7 +343,7 @@ Interactive input is never attempted in JSON mode. Pass every required argument
 Generated projects contain only the canonical `.env.example`, never the template's local `.env` or other environment copies. Copy it before configuring Auth.js:
 
 ```bash
-cp .env.example .env.local
+cp .env.example .env
 ```
 
 The Google and Auth.js values shipped in `.env.example` are intentionally public, limited development credentials. Replace all of them before production use. Nested Git repositories, caches, installed dependencies, Playwright artifacts, agent context, the local `.env`, and every non-canonical `.env*` file are excluded from generated projects and the npm package. For checks without authentication, use `AUTH_DISABLED=true`.

package/dist/bin.bun.js

@@ -6846,6 +6846,24 @@ import { fileURLToPath } from "url";
 
 // src/core/template-manifest.ts
 import path8 from "path";
+
+// src/core/agent-guidance.ts
+var PROJECT_SKILL_NAMES = [
+  "create-next-pro-create-project",
+  "create-next-pro-addcomponent",
+  "create-next-pro-addpage",
+  "create-next-pro-addlib",
+  "create-next-pro-addapi",
+  "create-next-pro-addlanguage",
+  "create-next-pro-addtext",
+  "create-next-pro-rmpage"
+];
+var PROJECT_AGENT_GUIDANCE_FILES = [
+  "AGENTS.md",
+  ...PROJECT_SKILL_NAMES.map((name) => `.agents/skills/${name}/SKILL.md`)
+];
+
+// src/core/template-manifest.ts
 var TEMPLATE_DENY_NAMES = new Set([
   ".env",
   ".git",
@@ -6893,6 +6911,7 @@ async function templateManifest(root, fs) {
 async function validateScaffoldTemplate(root, fs) {
   const manifest = await templateManifest(root, fs);
   for (const required of [
+    ...PROJECT_AGENT_GUIDANCE_FILES.map((relative) => relative.split("/").join(path8.sep)),
     "package.json",
     "tsconfig.json",
     ".env.example",
@@ -7060,6 +7079,17 @@ async function createProjectFromOptions(options, context) {
         message: "Run the generated project checks before development.",
         paths: [{ scope: "project", path: "package.json" }],
         commands: ["bun run check", "npm run check", "pnpm run check"]
+      },
+      {
+        kind: "run",
+        required: false,
+        message: "To run the project locally, copy the development environment example and start the development server.",
+        paths: [{ scope: "project", path: ".env.example" }],
+        commands: [
+          `cd ${options.projectName} && cp .env.example .env && bun run dev`,
+          `cd ${options.projectName} && cp .env.example .env && npm run dev`,
+          `cd ${options.projectName} && cp .env.example .env && pnpm run dev`
+        ]
       }
     ],
     data: {

package/dist/bin.node.js

@@ -2067,6 +2067,24 @@ import { fileURLToPath } from "url";
 
 // src/core/template-manifest.ts
 import path8 from "path";
+
+// src/core/agent-guidance.ts
+var PROJECT_SKILL_NAMES = [
+  "create-next-pro-create-project",
+  "create-next-pro-addcomponent",
+  "create-next-pro-addpage",
+  "create-next-pro-addlib",
+  "create-next-pro-addapi",
+  "create-next-pro-addlanguage",
+  "create-next-pro-addtext",
+  "create-next-pro-rmpage"
+];
+var PROJECT_AGENT_GUIDANCE_FILES = [
+  "AGENTS.md",
+  ...PROJECT_SKILL_NAMES.map((name) => `.agents/skills/${name}/SKILL.md`)
+];
+
+// src/core/template-manifest.ts
 var TEMPLATE_DENY_NAMES = /* @__PURE__ */ new Set([
   ".env",
   ".git",
@@ -2116,6 +2134,9 @@ async function templateManifest(root, fs) {
 async function validateScaffoldTemplate(root, fs) {
   const manifest = await templateManifest(root, fs);
   for (const required of [
+    ...PROJECT_AGENT_GUIDANCE_FILES.map(
+      (relative) => relative.split("/").join(path8.sep)
+    ),
     "package.json",
     "tsconfig.json",
     ".env.example",
@@ -2334,6 +2355,17 @@ async function createProjectFromOptions(options, context) {
         message: "Run the generated project checks before development.",
         paths: [{ scope: "project", path: "package.json" }],
         commands: ["bun run check", "npm run check", "pnpm run check"]
+      },
+      {
+        kind: "run",
+        required: false,
+        message: "To run the project locally, copy the development environment example and start the development server.",
+        paths: [{ scope: "project", path: ".env.example" }],
+        commands: [
+          `cd ${options.projectName} && cp .env.example .env && bun run dev`,
+          `cd ${options.projectName} && cp .env.example .env && npm run dev`,
+          `cd ${options.projectName} && cp .env.example .env && pnpm run dev`
+        ]
       }
     ],
     data: {