Add intent install to CLI next steps (#168)

Add intent install to CLI next steps

Add agent intent install to CLI next steps

Add agent instructions to scaffold templates

Inject agent instructions from template constants

Simplify scaffold agent instructions

Refine scaffold agent instructions

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

* **New Features**
  * Added agent instruction guidance into the project-creation flow and next-steps output
  * CLI now displays a required agent install command during setup

* **Documentation**
  * New agent instruction placeholder files added to project templates for downstream projects
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: eluce2

packages/cli/src/consts.ts

@@ -16,20 +16,26 @@ const versionCharLength = version.length;
 //export const PKG_ROOT = path.dirname(require.main.filename);
 
 export const TITLE_TEXT = `
- _______                             ___  ___  ____    _   _   
-|_   __ \\                          .' ..]|_  ||_  _|  (_) / |_ 
+ _______                             ___  ___  ____    _   _
+|_   __ \\                          .' ..]|_  ||_  _|  (_) / |_
   | |__) |_ .--.   .--.    .--.   _| |_    | |_/ /    __ \`| |-'
-  |  ___/[ \`/'\`\\]/ .'\`\\ \\/ .'\`\\ \\'-| |-'   |  __'.   [  | | |  
- _| |_    | |    | \\__. || \\__. |  | |    _| | \\  \\_  | | | |, 
-|_____|  [___]    '.__.'  '.__.'  [___]  |____||____|[___]\\__/ 
+  |  ___/[ \`/'\`\\]/ .'\`\\ \\/ .'\`\\ \\'-| |-'   |  __'.   [  | | |
+ _| |_    | |    | \\__. || \\__. |  | |    _| | \\  \\_  | | | |,
+|_____|  [___]    '.__.'  '.__.'  [___]  |____||____|[___]\\__/
 ${" ".repeat(61 - versionCharLength)}v${version}
 `;
 export const DEFAULT_APP_NAME = "my-proofkit-app";
 export const CREATE_FM_APP = cliName;
+export const AGENT_INSTRUCTIONS = [
+  "Use the ProofKit docs as the primary reference for this project: https://proofkit.dev/docs",
+  "Before doing any AI-assisted development here, run `npx @tanstack/intent@latest install` in the project root to load skills relevant to this project",
+].join("\n");
 
 // Registry URL is injected at build time via tsdown define
 declare const __REGISTRY_URL__: string;
 // Provide a safe fallback when running from source (not built)
 export const DEFAULT_REGISTRY_URL =
   // typeof check avoids ReferenceError if not defined at runtime
-  typeof __REGISTRY_URL__ !== "undefined" && __REGISTRY_URL__ ? __REGISTRY_URL__ : "https://proofkit.dev";
+  typeof __REGISTRY_URL__ !== "undefined" && __REGISTRY_URL__
+    ? __REGISTRY_URL__
+    : "https://proofkit.dev";

packages/cli/src/helpers/createProject.ts

@@ -1,5 +1,6 @@
 import path from "node:path";
 
+import { AGENT_INSTRUCTIONS } from "~/consts.js";
 import { installPackages } from "~/helpers/installPackages.js";
 import { scaffoldProject } from "~/helpers/scaffoldProject.js";
 import type { AvailableDependencies } from "~/installers/dependencyVersionMap.js";
@@ -130,6 +131,7 @@ export const createBareProject = async ({
 
   replaceTextInFiles(state.projectDir, "__PNPM_COMMAND__", pkgManagerCommand);
   replaceTextInFiles(state.projectDir, "__PACKAGE_MANAGER__", pkgManager);
+  replaceTextInFiles(state.projectDir, "__AGENT_INSTRUCTIONS__", AGENT_INSTRUCTIONS);
 
   return state.projectDir;
 };

packages/cli/src/helpers/logNextSteps.ts

@@ -6,8 +6,13 @@ import { state } from "~/state.js";
 import { getUserPkgManager } from "~/utils/getUserPkgManager.js";
 import { logger } from "~/utils/logger.js";
 
-const formatRunCommand = (pkgManager: ReturnType<typeof getUserPkgManager>, command: string) =>
-  ["npm", "bun"].includes(pkgManager) ? `${pkgManager} run ${command}` : `${pkgManager} ${command}`;
+const formatRunCommand = (
+  pkgManager: ReturnType<typeof getUserPkgManager>,
+  command: string,
+) =>
+  ["npm", "bun"].includes(pkgManager)
+    ? `${pkgManager} run ${command}`
+    : `${pkgManager} ${command}`;
 
 // This logs the next steps that the user should take in order to advance the project
 export const logNextSteps = ({
@@ -19,7 +24,9 @@ export const logNextSteps = ({
   logger.info(chalk.bold("Next steps:"));
   logger.dim("\nNavigate to the project directory:");
   projectName !== "." && logger.info(`  cd ${projectName}`);
-  logger.dim("(or open in your code editor, and run the rest of these commands from there)");
+  logger.dim(
+    "(or open in your code editor, and run the rest of these commands from there)",
+  );
 
   if (noInstall) {
     logger.dim("\nInstall dependencies:");
@@ -31,18 +38,30 @@ export const logNextSteps = ({
     }
   }
 
+  logger.dim(
+    "\nAgent instruction (required before continuing any AI-assisted development in this project):",
+  );
+  logger.info("  npx @tanstack/intent@latest install");
+  logger.dim(
+    "  Have your agent run this command in the newly created project so it can discover and learn important skills relevant to the project.",
+  );
+
   logger.dim("\nStart the dev server to view your app in a browser:");
   logger.info(`  ${formatRunCommand(pkgManager, "dev")}`);
 
   if (state.appType === "webviewer") {
     logger.dim("\nWhen you're ready to generate FileMaker clients:");
     logger.info(`  ${formatRunCommand(pkgManager, "typegen")}`);
 
-    logger.dim("\nTo open the starter inside FileMaker once your file is ready:");
+    logger.dim(
+      "\nTo open the starter inside FileMaker once your file is ready:",
+    );
     logger.info(`  ${formatRunCommand(pkgManager, "launch-fm")}`);
   }
 
-  logger.dim("\nOr, run the ProofKit command again to add more to your project:");
+  logger.dim(
+    "\nOr, run the ProofKit command again to add more to your project:",
+  );
   logger.info(`  ${formatRunCommand(pkgManager, "proofkit")}`);
   logger.dim("(Must be inside the project directory)");
 };

packages/cli/template/nextjs-mantine/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

packages/cli/template/nextjs-mantine/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

packages/cli/template/nextjs-shadcn/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

packages/cli/template/nextjs-shadcn/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

packages/cli/template/vite-wv/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

packages/cli/template/vite-wv/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md