planflow-ai 1.0.0

package/dist/cli/utils/files.d.ts

@@ -0,0 +1,37 @@
+/**
+ * File operation utilities for the init command
+ */
+import type { CopyOptions, CopyResult } from '../types.js';
+/**
+ * Resolves the package root directory by finding the nearest package.json
+ * with name "plan-flow" starting from a known internal path.
+ *
+ * Works with:
+ * - Local development (src/cli/utils/)
+ * - Built output (dist/cli/utils/)
+ * - npx / global install (node_modules/plan-flow/dist/cli/utils/)
+ * - Jest/CJS (__dirname available)
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Recursively copies a directory, preserving structure.
+ * Returns a CopyResult with created, skipped, and updated files.
+ */
+export declare function copyDir(src: string, dest: string, options: CopyOptions): CopyResult;
+/**
+ * Copies a single file with skip/overwrite logic.
+ */
+export declare function copyFile(src: string, dest: string, options: CopyOptions): CopyResult;
+/**
+ * Creates a directory recursively if it doesn't exist.
+ */
+export declare function ensureDir(dir: string): void;
+/**
+ * Checks if a file or directory exists.
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Formats a file path relative to a base for display.
+ */
+export declare function relativePath(filePath: string, base: string): string;
+//# sourceMappingURL=files.d.ts.map

package/dist/cli/utils/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM3D;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAsBvC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,UAAU,CA8BZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,UAAU,CAkBZ;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/cli/utils/files.js

@@ -0,0 +1,115 @@
+/**
+ * File operation utilities for the init command
+ */
+import { existsSync, mkdirSync, copyFileSync, readdirSync, readFileSync, statSync, } from 'node:fs';
+import { join, dirname, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ESM equivalent of __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolves the package root directory by finding the nearest package.json
+ * with name "plan-flow" starting from a known internal path.
+ *
+ * Works with:
+ * - Local development (src/cli/utils/)
+ * - Built output (dist/cli/utils/)
+ * - npx / global install (node_modules/plan-flow/dist/cli/utils/)
+ * - Jest/CJS (__dirname available)
+ */
+export function getPackageRoot() {
+    // Start from this file's directory and walk up to find package root
+    let dir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === 'planflow-ai') {
+                    return dir;
+                }
+            }
+            catch {
+                // Not valid JSON, continue walking up
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // reached filesystem root
+        dir = parent;
+    }
+    // If we can't find it, fall back to 3 levels up from __dirname
+    return resolve(__dirname, '..', '..', '..');
+}
+/**
+ * Recursively copies a directory, preserving structure.
+ * Returns a CopyResult with created, skipped, and updated files.
+ */
+export function copyDir(src, dest, options) {
+    const result = { created: [], skipped: [], updated: [] };
+    if (!existsSync(src)) {
+        return result;
+    }
+    ensureDir(dest);
+    const entries = readdirSync(src);
+    for (const entry of entries) {
+        const srcPath = join(src, entry);
+        const destPath = join(dest, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            const subResult = copyDir(srcPath, destPath, options);
+            result.created.push(...subResult.created);
+            result.skipped.push(...subResult.skipped);
+            result.updated.push(...subResult.updated);
+        }
+        else {
+            const fileResult = copyFile(srcPath, destPath, options);
+            result.created.push(...fileResult.created);
+            result.skipped.push(...fileResult.skipped);
+            result.updated.push(...fileResult.updated);
+        }
+    }
+    return result;
+}
+/**
+ * Copies a single file with skip/overwrite logic.
+ */
+export function copyFile(src, dest, options) {
+    const result = { created: [], skipped: [], updated: [] };
+    ensureDir(dirname(dest));
+    if (existsSync(dest)) {
+        if (options.force) {
+            copyFileSync(src, dest);
+            result.updated.push(dest);
+        }
+        else {
+            result.skipped.push(dest);
+        }
+    }
+    else {
+        copyFileSync(src, dest);
+        result.created.push(dest);
+    }
+    return result;
+}
+/**
+ * Creates a directory recursively if it doesn't exist.
+ */
+export function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Checks if a file or directory exists.
+ */
+export function fileExists(filePath) {
+    return existsSync(filePath);
+}
+/**
+ * Formats a file path relative to a base for display.
+ */
+export function relativePath(filePath, base) {
+    return relative(base, filePath);
+}
+//# sourceMappingURL=files.js.map

package/dist/cli/utils/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/cli/utils/files.ts"],"names":[],"mappings":"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"}

package/dist/cli/utils/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Console output with ANSI colors (no external dependencies)
+ */
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function info(msg: string): void;
+export declare function error(msg: string): void;
+export declare function skip(msg: string): void;
+export declare function header(msg: string): void;
+export declare function blank(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/cli/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}

package/dist/cli/utils/logger.js

@@ -0,0 +1,34 @@
+/**
+ * Console output with ANSI colors (no external dependencies)
+ */
+const colors = {
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+    reset: '\x1b[0m',
+};
+export function success(msg) {
+    console.log(`${colors.green}  +${colors.reset} ${msg}`);
+}
+export function warn(msg) {
+    console.log(`${colors.yellow}  ~${colors.reset} ${msg}`);
+}
+export function info(msg) {
+    console.log(`${colors.blue}  i${colors.reset} ${msg}`);
+}
+export function error(msg) {
+    console.log(`${colors.red}  x${colors.reset} ${msg}`);
+}
+export function skip(msg) {
+    console.log(`${colors.gray}  -${colors.reset} ${msg}`);
+}
+export function header(msg) {
+    console.log(`\n${colors.bold}${msg}${colors.reset}`);
+}
+export function blank() {
+    console.log('');
+}
+//# sourceMappingURL=logger.js.map

package/dist/cli/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/utils/prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Interactive prompts using Node.js readline/promises
+ */
+import type { Platform } from '../types.js';
+/**
+ * Asks the user which platforms to install for.
+ * Returns selected platform names.
+ */
+export declare function selectPlatforms(): Promise<Platform[]>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/cli/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6D3D"}

package/dist/cli/utils/prompts.js

@@ -0,0 +1,65 @@
+/**
+ * Interactive prompts using Node.js readline/promises
+ */
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+/**
+ * Asks the user which platforms to install for.
+ * Returns selected platform names.
+ */
+export async function selectPlatforms() {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        console.log('\nWhich platform(s) would you like to install for?\n');
+        console.log('  1. Claude Code  (.claude/commands/ + .claude/rules/)');
+        console.log('  2. Cursor       (.cursor/commands/ + .cursor/rules/)');
+        console.log('  3. OpenClaw     (skills/plan-flow/)');
+        console.log('  4. Codex CLI    (.agents/skills/plan-flow/ + AGENTS.md)');
+        console.log('  5. All of the above');
+        console.log('');
+        const answer = await rl.question('Enter your choice (1-5, comma-separated): ');
+        const choices = answer
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        const platforms = [];
+        for (const choice of choices) {
+            switch (choice) {
+                case '1':
+                    if (!platforms.includes('claude'))
+                        platforms.push('claude');
+                    break;
+                case '2':
+                    if (!platforms.includes('cursor'))
+                        platforms.push('cursor');
+                    break;
+                case '3':
+                    if (!platforms.includes('openclaw'))
+                        platforms.push('openclaw');
+                    break;
+                case '4':
+                    if (!platforms.includes('codex'))
+                        platforms.push('codex');
+                    break;
+                case '5':
+                    return ['claude', 'cursor', 'openclaw', 'codex'];
+                default:
+                    // Try matching platform names directly
+                    if (['claude', 'cursor', 'openclaw', 'codex'].includes(choice.toLowerCase())) {
+                        const p = choice.toLowerCase();
+                        if (!platforms.includes(p))
+                            platforms.push(p);
+                    }
+            }
+        }
+        if (platforms.length === 0) {
+            console.log('\nNo valid platforms selected. Use --claude, --cursor, --openclaw, or --all flags.');
+            process.exit(1);
+        }
+        return platforms;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cli/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/cli/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC,CAAC;QAE/E,MAAM,OAAO,GAAG,MAAM;aACnB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,GAAG;oBACN,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC5D,MAAM;gBACR,KAAK,GAAG;oBACN,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC5D,MAAM;gBACR,KAAK,GAAG;oBACN,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAChE,MAAM;gBACR,KAAK,GAAG;oBACN,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,GAAG;oBACN,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBACnD;oBACE,uCAAuC;oBACvC,IACE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAChD,MAAM,CAAC,WAAW,EAAc,CACjC,EACD,CAAC;wBACD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAc,CAAC;wBAC3C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;4BAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChD,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CACT,oFAAoF,CACrF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/test/setup.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Jest test setup
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/test/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/test/setup.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/test/setup.js

@@ -0,0 +1,7 @@
+/**
+ * Jest test setup
+ */
+// Increase timeout for CI environments
+jest.setTimeout(10000);
+export {};
+//# sourceMappingURL=setup.js.map

package/dist/test/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/test/setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uCAAuC;AACvC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "planflow-ai",
+  "version": "1.0.0",
+  "description": "Structured AI-assisted development workflows for discovery, planning, execution, code reviews, and testing",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "plan-flow": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist/",
+    ".claude/commands/",
+    ".claude/rules/",
+    "rules/",
+    "skills/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "cursor",
+    "claude",
+    "openclaw",
+    "codex",
+    "code-review",
+    "planning",
+    "development",
+    "structured-development",
+    "workflow",
+    "ai-assisted"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.5",
+    "jest": "^29.7.0",
+    "prettier": "^3.4.2",
+    "ts-jest": "^29.2.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/rules/core/_index.mdc

@@ -0,0 +1,99 @@
+---
+description: "Summary index for core rules - load this to see available references"
+alwaysApply: false
+---
+
+# Core Rules Index
+
+## Overview
+
+Core rules define the foundational coding standards that apply across the entire project. These include best practices to follow (allowed patterns), anti-patterns to avoid (forbidden patterns), and complexity scoring for implementation planning.
+
+**Total Files**: 4 files, ~833 lines
+**Reference Codes**: COR-AP-1 through COR-LDG-2
+
+---
+
+## Reference Codes
+
+### Allowed Patterns (`allowed-patterns.mdc`)
+
+| Code | Description | Source | Lines |
+|------|-------------|--------|-------|
+| COR-AP-1 | Example patterns (Naming, SRP, Errors, Types, Organization) | allowed-patterns.mdc | 45-152 |
+| COR-AP-2 | Template for adding new patterns | allowed-patterns.mdc | 167-186 |
+
+### Forbidden Patterns (`forbidden-patterns.mdc`)
+
+| Code | Description | Source | Lines |
+|------|-------------|--------|-------|
+| COR-FP-1 | Example anti-patterns (Magic Numbers, Silent Errors, Ternaries, Mutation, Async) | forbidden-patterns.mdc | 41-230 |
+| COR-FP-2 | Template for adding new anti-patterns | forbidden-patterns.mdc | 245-264 |
+
+### Complexity Scoring (`complexity-scoring.mdc`)
+
+| Code | Description | Source | Lines |
+|------|-------------|--------|-------|
+| COR-CS-1 | Complexity scale table (0-10 levels) | complexity-scoring.mdc | 12-21 |
+| COR-CS-2 | Scoring criteria modifiers (+/- points) | complexity-scoring.mdc | 23-51 |
+| COR-CS-3 | Execution strategy and aggregation rules | complexity-scoring.mdc | 53-70 |
+| COR-CS-4 | Common complexity patterns table | complexity-scoring.mdc | 168-185 |
+| COR-CS-5 | Real-world scoring examples | complexity-scoring.mdc | 187-236 |
+
+### Project Ledger (`project-ledger.mdc`)
+
+| Code | Description | Source | Lines |
+|------|-------------|--------|-------|
+| COR-LDG-1 | Ledger behavior, entry format, and sections | project-ledger.mdc | 10-110 |
+| COR-LDG-2 | Maintenance rules and plan-flow integration | project-ledger.mdc | 112-155 |
+
+---
+
+## When to Expand
+
+| Code | Expand When |
+|------|-------------|
+| COR-AP-1 | Need to see example good patterns for code generation |
+| COR-AP-2 | Adding a new allowed pattern to the project |
+| COR-FP-1 | Need to see anti-patterns to avoid |
+| COR-FP-2 | Adding a new forbidden pattern to the project |
+| COR-CS-1 | Need complexity level definitions |
+| COR-CS-2 | Calculating complexity score for a phase |
+| COR-CS-3 | Determining execution strategy for plan phases |
+| COR-CS-4 | Quick lookup of typical complexity scores |
+| COR-CS-5 | Need detailed scoring examples |
+| COR-LDG-1 | Need ledger behavior and entry guidelines |
+| COR-LDG-2 | Need ledger maintenance and integration rules |
+
+---
+
+## Quick Reference
+
+### Allowed Patterns Summary
+- **Descriptive Naming**: Clear, self-documenting names
+- **Single Responsibility**: One function = one purpose
+- **Error Handling**: Explicit errors with logging
+- **Type Safety**: Leverage TypeScript types
+- **Code Organization**: Consistent folder structure
+
+### Forbidden Patterns Summary
+- **No Magic Numbers**: Use named constants
+- **No Silent Errors**: Always log and handle
+- **No Nested Ternaries**: Use if/else or switch
+- **No Parameter Mutation**: Return new objects/arrays
+- **No Mixed Async**: Use async/await consistently
+
+### Complexity Levels
+- **0-2 Trivial**: Simple, mechanical changes
+- **3-4 Low**: Straightforward implementation
+- **5-6 Medium**: Moderate complexity, some decisions
+- **7-8 High**: Complex, multiple concerns
+- **9-10 Very High**: Requires careful attention
+
+---
+
+## Notes
+
+- `allowed-patterns.mdc` and `forbidden-patterns.mdc` have `alwaysApply: true` - they are loaded automatically by Cursor
+- `project-ledger.mdc` has `alwaysApply: true` - maintains persistent project memory
+- `complexity-scoring.mdc` is loaded on-demand when needed for planning

package/rules/core/allowed-patterns.mdc

@@ -0,0 +1,185 @@
+---
+description: "Best practices and recommended patterns that should always be followed"
+alwaysApply: true
+---
+
+# Allowed Patterns
+
+This file defines **best practices and recommended patterns** for your project. Add patterns that your team agrees upon and wants the AI to follow during code generation.
+
+---
+
+## How to Use This File
+
+1. **Add patterns** that represent your team's coding standards
+2. **Include examples** showing the correct way to implement each pattern
+3. **Explain why** each pattern is beneficial
+4. **Reference tools/rules** if applicable (ESLint, SonarQube, etc.)
+
+---
+
+## Example Pattern Structure
+
+### Pattern Name
+
+Brief description of what this pattern accomplishes.
+
+```typescript
+// GOOD - Example of the correct approach
+const example = doThingCorrectly()
+
+// Optionally show the contrast
+// BAD - What to avoid (but keep this minimal)
+const badExample = doThingWrong()
+```
+
+**Why**: Explain the benefit of following this pattern.
+
+**Guidelines**:
+
+- Specific guideline 1
+- Specific guideline 2
+
+---
+
+## Example Patterns
+
+### 1. Descriptive Naming
+
+Use clear, descriptive names for functions, variables, and components.
+
+```typescript
+// GOOD - Clear intent
+function calculateOrderTotal(items: OrderItem[]): number
+function fetchUserProfile(userId: string): Promise<User>
+const isAuthenticated = checkAuthStatus()
+
+// GOOD - Component names describe what they render
+export const UserProfileCard = () => { ... }
+export const OrderSummaryTable = () => { ... }
+```
+
+**Why**: Improves code readability and makes the codebase self-documenting.
+
+---
+
+### 2. Single Responsibility
+
+Each function/component should do one thing well.
+
+```typescript
+// GOOD - Focused function
+function formatCurrency(amount: number): string {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+  }).format(amount)
+}
+
+// GOOD - Focused component
+const PriceDisplay = ({ amount }: { amount: number }) => (
+  <span className="price">{formatCurrency(amount)}</span>
+)
+```
+
+**Why**: Easier to test, maintain, and reuse.
+
+---
+
+### 3. Error Handling
+
+Handle errors explicitly with meaningful messages.
+
+```typescript
+// GOOD - Explicit error handling
+async function fetchData(url: string) {
+  try {
+    const response = await fetch(url)
+    if (!response.ok) {
+      throw new ApiError(`Request failed: ${response.status}`)
+    }
+    return response.json()
+  } catch (error) {
+    logger.error('Failed to fetch data', { url, error })
+    throw error
+  }
+}
+```
+
+**Why**: Makes debugging easier and provides better user feedback.
+
+---
+
+### 4. Type Safety
+
+Leverage TypeScript's type system to catch errors at compile time.
+
+```typescript
+// GOOD - Explicit types for function signatures
+interface User {
+  id: string
+  name: string
+  email: string
+}
+
+function createUser(input: CreateUserInput): User {
+  // Implementation
+}
+
+// GOOD - Use type inference where appropriate
+const users = await fetchUsers() // Type inferred from function return
+```
+
+**Why**: Catches errors before runtime and improves IDE autocomplete.
+
+---
+
+### 5. Consistent Code Organization
+
+Follow a consistent structure for files and folders.
+
+```
+src/
+├── components/       # UI components
+├── hooks/            # Custom React hooks
+├── utils/            # Utility functions
+├── types/            # TypeScript type definitions
+├── services/         # API and external service integrations
+└── stores/           # State management
+```
+
+**Why**: Makes the codebase navigable and predictable.
+
+---
+
+## Adding Your Patterns
+
+When adding new patterns to this file:
+
+1. **Start with the pattern name** as a heading
+2. **Provide code examples** showing the correct approach
+3. **Explain the "Why"** - benefits of the pattern
+4. **Add guidelines** for edge cases or nuances
+5. **Reference external rules** if applicable (linting, etc.)
+
+---
+
+## Template for New Patterns
+
+```markdown
+### Pattern Name
+
+Brief description of what this pattern accomplishes.
+
+\`\`\`typescript
+// GOOD - Example code
+const example = correctApproach()
+\`\`\`
+
+**Why**: Explanation of benefits.
+
+**Guidelines**:
+
+- Guideline 1
+- Guideline 2
+```