ai-policy-pack-cli 0.1.1 → 0.1.3

package/README.md

@@ -26,7 +26,7 @@ npx ai-policy-pack-cli install --targets cursor,copilot,antigravity,claude --yes
 ### Install
 
 ```bash
-npx ai-policy-pack-cli install [--targets cursor,copilot,antigravity,claude] [--preset karpathy] [--yes] [--dry-run]
+npx ai-policy-pack-cli install [--targets cursor,copilot,antigravity,claude] [--preset anhtdq] [--yes] [--dry-run]
 ```
 
 - Generates target files from preset
@@ -45,7 +45,7 @@ npx ai-policy-pack-cli verify
 ### Update
 
 ```bash
-npx ai-policy-pack-cli update [--preset karpathy] [--yes] [--dry-run]
+npx ai-policy-pack-cli update [--preset anhtdq] [--yes] [--dry-run]
 ```
 
 - Re-applies current targets from manifest
@@ -55,7 +55,7 @@ npx ai-policy-pack-cli update [--preset karpathy] [--yes] [--dry-run]
 
 Current default preset:
 
-- `presets/karpathy/policy.yml`
+- `presets/anhtdq/policy.yml`
 
 Preset layout:
 

package/dist/src/adapters/antigravity.js

@@ -8,16 +8,7 @@ export class AntigravityAdapter {
             "",
             "Shared rules for all compatible AI coding tools.",
             "",
-            "## Core Rules",
-            ...policy.globalRules.map((rule) => `- ${rule}`),
-            "",
-            "## Language-Specific Rules",
-            ...policy.fileRules.flatMap((rule) => [
-                `### ${rule.name}`,
-                `Applies to: ${rule.patterns.join(", ")}`,
-                ...rule.rules.map((item) => `- ${item}`),
-                ""
-            ])
+            policy.guidelineMarkdown
         ].join("\n");
         files.push({
             path: "AGENTS.md",

package/dist/src/adapters/claude.js

@@ -6,16 +6,7 @@ export class ClaudeAdapter {
             "",
             "Project instructions for Claude-compatible agents.",
             "",
-            "## Core Rules",
-            ...policy.globalRules.map((rule) => `- ${rule}`),
-            "",
-            "## File-Specific Rules",
-            ...policy.fileRules.flatMap((rule) => [
-                `### ${rule.name}`,
-                `Applies to: ${rule.patterns.join(", ")}`,
-                ...rule.rules.map((item) => `- ${item}`),
-                ""
-            ])
+            policy.guidelineMarkdown
         ].join("\n");
         return [
             {

package/dist/src/adapters/copilot.js

@@ -8,28 +8,13 @@ export class CopilotAdapter {
             "",
             ...(override?.repoIntro ?? []),
             ...(override?.repoIntro?.length ? [""] : []),
-            "## Core Rules",
-            ...policy.globalRules.map((rule) => `- ${rule}`)
+            policy.guidelineMarkdown
         ].join("\n");
         files.push({
             path: ".github/copilot-instructions.md",
             content: `${repoWide}\n`
         });
-        for (const fileRule of policy.fileRules) {
-            const scoped = [
-                "---",
-                `applyTo: "${fileRule.patterns.join(",")}"`,
-                "---",
-                "",
-                `# ${fileRule.name}`,
-                "",
-                ...fileRule.rules.map((rule) => `- ${rule}`)
-            ].join("\n");
-            files.push({
-                path: `.github/instructions/${fileRule.name}.instructions.md`,
-                content: `${scoped}\n`
-            });
-        }
+        void policy.fileRules;
         return files;
     }
 }

package/dist/src/adapters/cursor.js

@@ -8,37 +8,15 @@ export class CursorAdapter {
             "alwaysApply: true",
             "---",
             "",
-            "# Team Global Rules",
+            "# Team Global Guidelines",
             "",
-            ...policy.globalRules.map((rule) => `- ${rule}`)
+            policy.guidelineMarkdown
         ].join("\n");
         files.push({
             path: ".cursor/rules/global-policy.mdc",
             content: `${globalContent}\n`
         });
-        for (const fileRule of policy.fileRules) {
-            const content = [
-                "---",
-                `description: ${fileRule.name} generated by ai-policy-pack`,
-                `globs: ${fileRule.patterns.join(",")}`,
-                "alwaysApply: false",
-                "---",
-                "",
-                `# ${toTitleCase(fileRule.name)}`,
-                "",
-                ...fileRule.rules.map((rule) => `- ${rule}`)
-            ].join("\n");
-            files.push({
-                path: `.cursor/rules/${fileRule.name}.mdc`,
-                content: `${content}\n`
-            });
-        }
+        void policy.fileRules;
         return files;
     }
 }
-function toTitleCase(value) {
-    return value
-        .split("-")
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
-}

package/dist/src/commands/install.js

@@ -6,7 +6,7 @@ import { renderForTargets } from "../core/render.js";
 import { CliError } from "../core/errors.js";
 export async function runInstallCommand(args, deps) {
     const targets = await resolveTargets(args);
-    const presetName = args.preset ?? "karpathy";
+    const presetName = args.preset ?? "anhtdq";
     const policy = await loadPolicyPreset(deps.cwd, presetName, deps.packageRoot);
     const files = renderForTargets(policy, targets);
     deps.logger.info(`Preset: ${policy.name}`);

package/dist/src/core/policy-schema.js

@@ -4,12 +4,14 @@ export function validatePolicyPreset(input) {
     }
     const name = expectString(input.name, "name");
     const description = optionalString(input.description, "description");
+    const guidelineMarkdown = expectString(input.guidelineMarkdown, "guidelineMarkdown");
     const globalRules = expectStringArray(input.globalRules, "globalRules");
     const fileRules = expectFileRules(input.fileRules);
     const targetOverrides = expectTargetOverrides(input.targetOverrides);
     return {
         name,
         description,
+        guidelineMarkdown,
         globalRules,
         fileRules,
         targetOverrides

package/dist/test/adapters.spec.js

@@ -4,7 +4,7 @@ import { renderForTargets } from "../src/core/render.js";
 const CWD = "d:/ATS/Project/AI/rulecusor";
 describe("adapters render", () => {
     it("renders target-specific files", async () => {
-        const policy = await loadPolicyPreset(CWD, "karpathy", CWD);
+        const policy = await loadPolicyPreset(CWD, "anhtdq", CWD);
         const files = renderForTargets(policy, ["cursor", "copilot", "antigravity", "claude"]);
         const paths = files.map((item) => item.path).sort();
         expect(paths).toContain(".cursor/rules/global-policy.mdc");

package/dist/test/args.spec.js

@@ -8,7 +8,7 @@ describe("parseArgs", () => {
             "--targets",
             "cursor,copilot",
             "--preset",
-            "karpathy",
+            "anhtdq",
             "--yes",
             "--dry-run",
             "--force"
@@ -16,7 +16,7 @@ describe("parseArgs", () => {
         expect(parsed).toEqual({
             command: "install",
             targets: ["cursor", "copilot"],
-            preset: "karpathy",
+            preset: "anhtdq",
             yes: true,
             dryRun: true,
             force: true

package/dist/test/npx-runtime.spec.js

@@ -24,6 +24,6 @@ describe("runtime path behavior", () => {
             packageVersion: "0.1.0",
             logger: silentLogger
         });
-        await expect(fs.readFile(path.join(projectWorkspace, ".cursor/rules/global-policy.mdc"), "utf8")).resolves.toContain("Team Global Rules");
+        await expect(fs.readFile(path.join(projectWorkspace, ".cursor/rules/global-policy.mdc"), "utf8")).resolves.toContain("Think Before Coding");
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-policy-pack-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Multi-IDE AI policy pack generator for Cursor, Copilot, Antigravity, and Claude",
   "type": "module",
   "bin": {

package/presets/anhtdq/policy.yml

@@ -0,0 +1,102 @@
+name: anhtdq
+description: Behavioral guardrails to reduce common LLM coding mistakes across all code
+guidelineMarkdown: |
+  Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+  **Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+  ## 1. Think Before Coding
+
+  **Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+  Before implementing:
+  - State your assumptions explicitly. If uncertain, ask.
+  - If multiple interpretations exist, present them - don't pick silently.
+  - If a simpler approach exists, say so. Push back when warranted.
+  - If something is unclear, stop. Name what's confusing. Ask.
+
+  ## 2. Simplicity First
+
+  **Minimum code that solves the problem. Nothing speculative.**
+
+  - No features beyond what was asked.
+  - No abstractions for single-use code.
+  - No "flexibility" or "configurability" that wasn't requested.
+  - No error handling for impossible scenarios.
+  - If you write 200 lines and it could be 50, rewrite it.
+
+  Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+  ## 3. Surgical Changes
+
+  **Touch only what you must. Clean up only your own mess.**
+
+  When editing existing code:
+  - Don't "improve" adjacent code, comments, or formatting.
+  - Don't refactor things that aren't broken.
+  - Match existing style, even if you'd do it differently.
+  - If you notice unrelated dead code, mention it - don't delete it.
+
+  When your changes create orphans:
+  - Remove imports/variables/functions that YOUR changes made unused.
+  - Don't remove pre-existing dead code unless asked.
+
+  The test: Every changed line should trace directly to the user's request.
+
+  ## 4. Goal-Driven Execution
+
+  **Define success criteria. Loop until verified.**
+
+  Transform tasks into verifiable goals:
+  - "Add validation" -> "Write tests for invalid inputs, then make them pass"
+  - "Fix the bug" -> "Write a test that reproduces it, then make it pass"
+  - "Refactor X" -> "Ensure tests pass before and after"
+
+  For multi-step tasks, state a brief plan:
+  ```
+  1. [Step] -> verify: [check]
+  2. [Step] -> verify: [check]
+  3. [Step] -> verify: [check]
+  ```
+
+  Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+  ---
+
+  **These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.
+globalRules:
+  - Before implementing, state assumptions explicitly. If uncertain, ask instead of guessing.
+  - If multiple interpretations exist, surface them and confirm direction before coding.
+  - If a simpler approach exists, recommend it and explain the tradeoff.
+  - If requirements are unclear or contradictory, stop and ask a focused clarification question.
+  - Implement the minimum code that solves the requested problem.
+  - Do not add speculative features or future-proof abstractions unless explicitly requested.
+  - Do not add configurability that is not required by the task.
+  - Do not add error handling for impossible scenarios.
+  - If implementation feels overcomplicated, simplify until it is easy to reason about.
+  - Touch only lines required by the requested change.
+  - Do not refactor unrelated modules or formatting during focused tasks.
+  - Match existing project patterns and style unless user asks to change conventions.
+  - If unrelated dead code is discovered, mention it but do not delete it automatically.
+  - Remove only orphaned code introduced by your own change.
+  - Define clear success criteria before implementation.
+  - Convert requests into verifiable goals with checks or tests.
+  - For bug fixes, reproduce with a failing test/check first, then fix, then verify pass.
+  - For refactors, verify behavior before and after with stable checks.
+  - For multi-step work, provide a short step plan with explicit verification at each step.
+  - Do not claim completion until verification actually passes.
+fileRules:
+  - name: universal-code-rules
+    patterns:
+      - "**/*"
+    rules:
+      - Apply these standards to all code and configuration files unless the user explicitly narrows scope.
+      - Prefer readable, straightforward code and avoid hidden magic.
+      - Keep changes cohesive, easy to review, and directly traceable to the request.
+targetOverrides:
+  antigravity:
+    geminiRules:
+      - Keep AGENTS.md as shared cross-tool policy and use GEMINI.md only for Antigravity-specific overrides.
+  copilot:
+    repoIntro:
+      - Follow repository build, test, and lint commands from project documentation before submitting changes.

package/presets/karpathy/policy.yml

@@ -1,30 +0,0 @@
-name: karpathy
-description: Karpathy-inspired guardrails adapted for multi-IDE agents
-globalRules:
-  - State assumptions and ask clarifying questions before coding when requirements are ambiguous.
-  - Prefer the simplest implementation that solves the user's request; avoid speculative abstractions.
-  - Keep changes surgical and scoped to the requested task; avoid unrelated refactors.
-  - Define explicit success criteria and verify changes with tests or commands before claiming completion.
-  - Remove dead code created by your own change but do not clean unrelated legacy code unless asked.
-fileRules:
-  - name: typescript-standards
-    patterns:
-      - "**/*.ts"
-      - "**/*.tsx"
-    rules:
-      - Favor strict typing and avoid any unless there is a documented reason.
-      - Keep functions focused and small; split logic when a function mixes responsibilities.
-      - Add concise comments only when code intent is not obvious.
-  - name: python-standards
-    patterns:
-      - "**/*.py"
-    rules:
-      - Prefer explicit names over abbreviations and keep functions single-purpose.
-      - Handle expected exceptions explicitly and include actionable error messages.
-targetOverrides:
-  antigravity:
-    geminiRules:
-      - Use GEMINI.md for tool-specific overrides and AGENTS.md for shared team policy.
-  copilot:
-    repoIntro:
-      - Follow repository build, test, and lint commands from project docs before submitting changes.