ai-policy-pack-cli 0.1.2 → 0.1.4

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/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/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.2",
+  "version": "0.1.4",
   "description": "Multi-IDE AI policy pack generator for Cursor, Copilot, Antigravity, and Claude",
   "type": "module",
   "bin": {

package/presets/anhtdq/policy.yml

@@ -1,5 +1,79 @@
 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.
+
+  ---
+
+  ## 5. Documentation Currency Policy
+
+  - Use `README.md` as the primary module-context document format; keep `AGENTS.md` focused on AI workflow/policy at repository root.
+  - Update module `README.md` only when behavior or contracts changed (API/DTO, business flow, schema/migration, module structure, or reusable patterns), not for trivial refactors.
+  - For tasks that trigger doc updates, refresh outdated sections and remove stale context in the same task before marking work complete.
+  - During pre-implementation, read the nearest module `README.md` to minimize broad code scanning and reduce context usage.
+  - Before declaring task completion, report whether docs were updated or intentionally skipped.
+
+  ---
+
+  **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.
@@ -21,6 +95,11 @@ globalRules:
   - 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.
+  - Use README.md as the primary module-context document format and keep AGENTS.md focused on repository-level AI workflow policy.
+  - Update module README.md when behavior/contracts change; skip doc edits for trivial refactors.
+  - If docs are required, refresh stale sections in the same task before completion.
+  - Read the nearest module README.md before implementation to reduce unnecessary broad scanning.
+  - Before closing a task, explicitly report whether docs were updated or intentionally skipped.
 fileRules:
   - name: universal-code-rules
     patterns: