feat: harden AI prompts and inject strict v4 guidelines into LLM context files

Author: CODE-Y02

docs/.vitepress/config.ts

@@ -124,15 +124,15 @@ export default defineConfig({
         items: [
           {
             text: "✦ Perplexity (Best)",
-            link: `https://www.perplexity.ai/?q=Act+as+a+Senior+Expert+on+Create+Express+Forge+v4.+Read+https://code-y02.github.io/express-cli/llms-full.txt+and+answer+my+question+STRICTLY+following+v4+standards+(Biome,+Zod-to-OpenAPI,+ESM,+Functional+Helpers).+Ignore+legacy+v3+patterns.`,
+            link: `https://www.perplexity.ai/?q=Act+as+a+Senior+Architect+for+Create+Express+Forge+v4.+You+MUST+read+https://code-y02.github.io/express-cli/llms-full.txt+and+answer+STRICTLY+based+on+it.+RULES:+Use+Biome+for+linting,+Zod-to-OpenAPI+for+docs,+and+Functional+Helpers+for+responses.+Ignore+v3+patterns.`,
           },
           {
             text: "Ask Claude",
-            link: `https://claude.ai/new?q=Please+read+the+full+v4+documentation+for+Create+Express+Forge+at+https://code-y02.github.io/express-cli/llms-full.txt.+I+need+help+with+a+v4+project.+STRICT+REQUIREMENT:+Use+Biome+for+linting+and+Zod-to-OpenAPI+for+docs.+Do+not+suggest+ESLint+or+JSDoc.`,
+            link: `https://claude.ai/new?q=Please+read+the+Create+Express+Forge+v4+documentation+at+https://code-y02.github.io/express-cli/llms-full.txt.+You+are+an+expert+on+this+framework.+STRICTLY+follow+v4+standards:+Biome,+Zod-to-OpenAPI,+and+ESM.+Do+not+suggest+legacy+v3+code.`,
           },
           {
             text: "Ask ChatGPT",
-            link: `https://chatgpt.com/?q=You+are+the+official+AI+assistant+for+Create+Express+Forge+v4.+Context:+https://code-y02.github.io/express-cli/llms-full.txt.+Answer+my+question+using+v4+patterns+ONLY+(Functional+ApiResponse,+Biome,+Zod-to-OpenAPI).`,
+            link: `https://chatgpt.com/?q=You+are+the+Senior+Architect+for+Create+Express+Forge+v4.+Context:+https://code-y02.github.io/express-cli/llms-full.txt.+Answer+my+question+using+v4+patterns+ONLY+(Functional+ApiResponse,+Biome,+Zod-to-OpenAPI).+Never+suggest+ESLint.`,
           },
           {
             text: "📄 Raw AI Context (llms-full.txt)",

docs/guide/ai-integration.md

@@ -57,5 +57,5 @@ A machine-readable manifest that describes the project's features, available com
 You can customize the AI behavior by modifying the `ai.json` file in your project root or by updating the MCP server settings.
 
 ::: tip PRO TIP
-If you are using Cursor, add `https://expressforge.com/llms.txt` to your `@docs` to give the AI agent full knowledge of the framework!
+If you are using Cursor, add `https://code-y02.github.io/express-cli/llms.txt` to your `@docs` to give the AI agent full knowledge of the framework!
 :::

docs/public/ai.json

@@ -24,7 +24,14 @@
         "guide/troubleshooting",
         "reference/cli-options",
         "reference/config"
-      ]
+      ],
+      "rules": {
+        "linting": "biome",
+        "formatting": "biome",
+        "apiDocumentation": "zod-to-openapi",
+        "moduleSystem": "esm",
+        "packageManager": "pnpm"
+      }
     },
     "v3": {
       "status": "lts",

docs/public/llms-full.txt

@@ -1,11 +1,14 @@
 # Create Express Forge v4.x (Latest) - Full Documentation
 
 > [!IMPORTANT]
-> STRICT v4 GUIDELINES:
-> - Linter: Biome (NOT ESLint/Prettier)
-> - API Docs: Zod-to-OpenAPI (NOT JSDoc/@openapi)
-> - Architecture: Functional Helpers (NOT Classes for ApiResponse)
-> - Modules: ESM (NOT CommonJS)
+> YOU ARE A DOCUMENTATION-STRICT ASSISTANT.
+> - DOCUMENTATION SOURCE: https://code-y02.github.io/express-cli/llms-full.txt
+> - VERSION: v4.x (Latest)
+> - LINTER: Biome (Suggesting ESLint/Prettier is a FAILURE)
+> - API DOCS: Zod-to-OpenAPI (Suggesting JSDoc/@openapi is a FAILURE)
+> - RESPONSES: Functional Helpers (Suggesting ApiResponse Class is a FAILURE)
+> - MODULES: ESM (Suggesting CommonJS is a FAILURE)
+> - RULE: If info is missing, say "I don't know" and refer to docs. DO NOT HALUCINATE.
 
 
 

docs/scripts/generate-llms-docs.ts

@@ -30,11 +30,14 @@ async function generate() {
 
     if (versionName.includes('v4')) {
       fullDocs += `> [!IMPORTANT]\n`;
-      fullDocs += `> STRICT v4 GUIDELINES:\n`;
-      fullDocs += `> - Linter: Biome (NOT ESLint/Prettier)\n`;
-      fullDocs += `> - API Docs: Zod-to-OpenAPI (NOT JSDoc/@openapi)\n`;
-      fullDocs += `> - Architecture: Functional Helpers (NOT Classes for ApiResponse)\n`;
-      fullDocs += `> - Modules: ESM (NOT CommonJS)\n\n`;
+      fullDocs += `> YOU ARE A DOCUMENTATION-STRICT ASSISTANT.\n`;
+      fullDocs += `> - DOCUMENTATION SOURCE: https://code-y02.github.io/express-cli/llms-full.txt\n`;
+      fullDocs += `> - VERSION: v4.x (Latest)\n`;
+      fullDocs += `> - LINTER: Biome (Suggesting ESLint/Prettier is a FAILURE)\n`;
+      fullDocs += `> - API DOCS: Zod-to-OpenAPI (Suggesting JSDoc/@openapi is a FAILURE)\n`;
+      fullDocs += `> - RESPONSES: Functional Helpers (Suggesting ApiResponse Class is a FAILURE)\n`;
+      fullDocs += `> - MODULES: ESM (Suggesting CommonJS is a FAILURE)\n`;
+      fullDocs += `> - RULE: If info is missing, say "I don't know" and refer to docs. DO NOT HALUCINATE.\n\n`;
     }
 
     for (const file of allFiles) {
@@ -93,7 +96,14 @@ npx create-express-forge@3.3.2 my-api
       v4: {
         status: "latest",
         fullDocs: "https://code-y02.github.io/express-cli/llms-full.txt",
-        slugs: v4Slugs
+        slugs: v4Slugs,
+        rules: {
+          linting: "biome",
+          formatting: "biome",
+          apiDocumentation: "zod-to-openapi",
+          moduleSystem: "esm",
+          packageManager: "pnpm",
+        }
       },
       v3: {
         status: "lts",