thachvd-kit 1.0.18 → 1.0.20

package/bin/cli.js

@@ -136,12 +136,13 @@ ${pc.bold('Options:')}
   --help    Show this help message
 
 ${pc.bold('What gets generated:')}
-  AGENTS.md   Shared instructions for Codex, Antigravity, and Claude Code
+  AGENTS.md   Shared instructions for Codex, Antigravity, Claude Code, and Cursor
   CLAUDE.md   Claude Code entry file that imports AGENTS.md
   GEMINI.md   Antigravity entry file that points to AGENTS.md
+  .cursorrules Cursor entry file that points to AGENTS.md
   .agent/     Shared docs, skills, workflows, agents, and rules
-  .agents/skills/  Selected Codex repo skills copied from .agent/skills
-  .claude/skills/  Selected Claude Code project skills copied from .agent/skills
+  ~/.codex/skills/  Selected Codex skills copied to global user dir (shows in $ menu)
+  .claude/skills/   Selected Claude Code project skills copied from .agent/skills
 
 ${pc.bold('Workflow guide:')}
   Idea is fuzzy            /brainstorm  Explore options, tradeoffs, and recommended direction
@@ -885,248 +886,257 @@ function resolveAgentTable(data) {
     rows.push(["Debug", "debugger", "systematic-debugging"]);
     rows.push(["Security", "security-auditor", "vulnerability-scanner"]);
     rows.push(["Planning", "project-planner", "brainstorming, plan-writing"]);
-
-    return rows;
-}
-
-// --- File Generators ---
-
-function generateSharedAgentsMd(data) {
-    return `# AGENTS.md
-
-Shared operating instructions for Codex, Antigravity, and Claude Code.
-
-## Startup
-
-1. Read this file first.
-2. Read \`.agent/docs/project.md\` for detected stack, commands, and routing.
+
    return rows;
+}
+// --- File Generators ---
+
+function generateSharedAgentsMd(data) {
+    return `# AGENTS.md
+
+Shared operating instructions for Codex, Antigravity, Claude Code, and Cursor.
+
+## Startup
+
+1. Read this file first.
+2. Read \`.agent/docs/project.md\` for detected stack, commands, and routing.
 3. Read \`.agent/docs/workflow.md\` for the task flow before editing.
 4. Read \`.agent/docs/architecture.md\` and \`.agent/docs/conventions.md\` before planning code changes.
 5. Read \`.agent/docs/tooling.md\` when the task needs Playwright, codegraph, MCP, or native Codex/Claude skill setup.
 6. Select and load only the agent, skill, or workflow files that match the current task.
-
-If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the docs by scanning the project before making product code changes.
-
-## Task Flow
-
-- Questions and analysis: answer directly, cite relevant files when useful, and do not edit code.
-- Simple fix: inspect dependencies, make the smallest change, run focused verification.
-- Feature or refactor: define success criteria, make a short plan, implement, then verify.
+
+If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the docs by scanning the project before making product code changes.
+
+## Task Flow
+
+- Questions and analysis: answer directly, cite relevant files when useful, and do not edit code.
+- Simple fix: inspect dependencies, make the smallest change, run focused verification.
+- Feature or refactor: define success criteria, make a short plan, implement, then verify.
 - Multi-domain work: use \`.agent/workflows/orchestrate.md\` and route to the relevant specialist docs.
 - UI work: read \`.agent/agents/frontend-specialist.md\` and applicable design skills before editing.
 
 ## Skill Loading
 
 - Treat \`.agent/skills/\` as the shared source of truth for all kit skills.
-- Codex should discover native repo skills from \`.agents/skills/\`; Claude Code should discover project skills from \`.claude/skills/\`.
-- If native skill discovery is unavailable or stale, fall back to the matching \`.agent/skills/<skill>/SKILL.md\` file.
+- Codex exposes skills from \`~/.codex/skills/\` in the \`$\` menu; \`thachvd-kit\` copies selected skills there on init.
+- Claude Code project skills live in \`.claude/skills/\`.
+- If a skill is missing from the global dir, fall back to the matching \`.agent/skills/<skill>/SKILL.md\` file.
 - Do not load skill bodies by default; load a skill only when the user mentions it, the task clearly matches its description, or \`.agent/docs/project.md\` routes the task to it.
 - Prefer explicit skill mentions for predictable behavior: \`$clean-code\`, \`$systematic-debugging\`, \`$webapp-testing\`, or any skill listed in \`.agent/docs/project.md\`.
 - Run \`thachvd-kit --help\` to see common workflow and skill recommendations.
 - When creating or improving skills, use \`writing-skills\` first and make the \`description\` field specific enough for implicit invocation.
 
 ## Rules
-
-- Respond in the user's language; keep code, identifiers, and code comments in English.
-- State assumptions when the request is ambiguous.
-- Prefer the existing project style over new abstractions.
-- Keep changes surgical and remove only dead code introduced by your change.
-- Tests or equivalent verification are mandatory before claiming done.
-- Keep files under ${data.max_file_lines || '300'} lines unless the project already has a different standard in \`.agent/docs/conventions.md\`.
-
-## Shared Knowledge
-
+
+- Respond in the user's language; keep code, identifiers, and code comments in English.
+- State assumptions when the request is ambiguous.
+- Prefer the existing project style over new abstractions.
+- Keep changes surgical and remove only dead code introduced by your change.
+- Tests or equivalent verification are mandatory before claiming done.
+- Keep files under ${data.max_file_lines || '300'} lines unless the project already has a different standard in \`.agent/docs/conventions.md\`.
+
+## Shared Knowledge
+
 - Project docs: \`.agent/docs/\`
 - Specialist agents: \`.agent/agents/\`
 - Skills: \`.agent/skills/\`
-- Codex native skills: \`.agents/skills/\`
+- Codex global skills: \`~/.codex/skills/\` (installed by thachvd-kit init)
 - Claude Code project skills: \`.claude/skills/\`
 - Workflows: \`.agent/workflows/\`
 - Tooling setup: \`.agent/docs/tooling.md\`
 - Antigravity mirror rules: \`.agent/rules/GEMINI.md\`
+- Cursor entry rules: \`.cursorrules\`
 `;
 }
-
-function generateSharedClaudeMd() {
-    return `@AGENTS.md
-
-## Claude Code
-
-This repository uses AGENTS.md as the shared cross-agent entry file. Follow the imported instructions and keep Claude-specific notes here only when they cannot apply to Codex or Antigravity.
-`;
-}
-
-function generateSharedGeminiMd() {
-    return `# GEMINI.md
-
-Antigravity entry file for this project.
-
-Read AGENTS.md first, then follow the shared docs under .agent/docs/.
-`;
-}
-
-function resolveCommands(data) {
-    const frameworks = data.frameworks || [];
-    const primaryLang = data.primary_language || 'javascript';
-    const pkgManager = data.package_manager || 'npm';
-    const testFramework = data.test_framework || 'auto-detect';
-
-    const isPython = primaryLang === 'python';
-    const isGo = primaryLang === 'go';
-    const isRust = primaryLang === 'rust';
-    const isPhp = primaryLang === 'php';
-
-    let install = 'npm install';
-    let dev = 'npm run dev';
-    let build = 'npm run build';
-    let test = 'npm test';
-    let lint = 'npm run lint';
-
-    if (pkgManager === 'pnpm') { install = 'pnpm install'; dev = 'pnpm dev'; build = 'pnpm build'; test = 'pnpm test'; lint = 'pnpm lint'; }
-    else if (pkgManager === 'yarn') { install = 'yarn'; dev = 'yarn dev'; build = 'yarn build'; test = 'yarn test'; lint = 'yarn lint'; }
-    else if (pkgManager === 'bun') { install = 'bun install'; dev = 'bun dev'; build = 'bun run build'; test = 'bun test'; lint = 'bun run lint'; }
-    else if (isPython) { install = 'pip install -r requirements.txt'; dev = 'python manage.py runserver'; build = '# no build step'; test = 'pytest'; lint = 'ruff check .'; }
-    else if (isGo) { install = 'go mod download'; dev = 'go run .'; build = 'go build ./...'; test = 'go test ./...'; lint = 'golangci-lint run'; }
-    else if (isRust) { install = 'cargo build'; dev = 'cargo run'; build = 'cargo build --release'; test = 'cargo test'; lint = 'cargo clippy'; }
-    else if (isPhp) {
-        install = 'composer install';
-        build = '# no build step';
-        test = testFramework === 'pest' ? './vendor/bin/pest' : './vendor/bin/phpunit';
-        const isCakePHP = frameworks.some(f => f.toLowerCase().includes('cakephp'));
-        const isSymfony = frameworks.some(f => f.toLowerCase().includes('symfony'));
-        const isCodeIgniter = frameworks.some(f => f.toLowerCase().includes('codeigniter'));
-        if (isCakePHP) {
-            dev = 'bin/cake server';
-            lint = './vendor/bin/phpcs';
-        } else if (isSymfony) {
-            dev = 'bin/console server:run';
-            lint = './vendor/bin/phpcs';
-        } else if (isCodeIgniter) {
-            dev = 'php spark serve';
-            lint = './vendor/bin/phpcs';
-        } else {
-            dev = 'php artisan serve';
-            lint = 'php artisan pint';
-        }
-    }
-
-    if (testFramework === 'vitest') test = `${pkgManager === 'pnpm' ? 'pnpm' : pkgManager === 'yarn' ? 'yarn' : pkgManager === 'bun' ? 'bun run' : 'npx'} vitest`;
-    else if (testFramework === 'jest') test = `${pkgManager === 'pnpm' ? 'pnpm' : pkgManager === 'yarn' ? 'yarn' : 'npx'} jest`;
-
-    return { install, dev, build, test, lint };
-}
-
-function generateProjectDoc(data) {
-    const commands = resolveCommands(data);
-    const agentRows = resolveAgentTable(data).map(([task, agent, skills]) => `| ${task} | \`${agent}\` | ${skills} |`).join('\n');
-    const skillsList = resolveSkills(data).map(s => `- ${s}`).join('\n');
-    const evidence = (data.scan_evidence || []).length > 0
-        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
-        : '- TODO: refine scan evidence by inspecting the project.';
-
-    return `# Project Rules
-
-Generated by thachvd-kit on ${new Date().toISOString().split('T')[0]}.
-
-## Summary
-
-- Name: ${data.project_name}
-- Description: ${data.description}
-- Type: ${data.project_type}
-- App root: ${data.app_root || '.'}
-
-## Stack
-
-- Language: ${data.primary_language}
-- Frameworks: ${(data.frameworks || []).join(', ') || 'none'}
-- Database: ${data.database || 'none'}
-- Infrastructure: ${(data.infrastructure || []).join(', ') || 'none'}
-- Package manager: ${data.package_manager || 'auto-detect'}
-- Test framework: ${data.test_framework || 'auto-detect'}
-
-## Commands
-
-- Install: \`${commands.install}\`
-- Dev: \`${commands.dev}\`
-- Build: \`${commands.build}\`
-- Test: \`${commands.test}\`
-- Lint: \`${commands.lint}\`
-
-## Agent Routing
-
-| Task Type | Agent | Primary Skills |
-|-----------|-------|----------------|
-${agentRows}
-
-## Auto-Resolved Skills
-
-${skillsList}
-
-## Scan Evidence
-
-${evidence}
-`;
-}
-
-function generateArchitectureDoc(data) {
-    const appRootLine = data.app_root && data.app_root !== '.'
-        ? `- App root is currently detected as \`${data.app_root}\`.`
-        : '- App root is the repository root unless refined below.';
-    const evidence = (data.scan_evidence || []).length > 0
-        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
-        : '- TODO: refine architecture by scanning source directories.';
-
-    return `# Architecture Notes
-
-## Current Map
-
-${appRootLine}
-- TODO: refine major directories and responsibilities.
-- TODO: refine main entry points, routing, state boundaries, and integration boundaries.
-
-## Detected Evidence
-
-${evidence}
-
-## AI Maintenance Rule
-
-Before non-trivial implementation work, inspect this file. If it is stale or still contains TODO items relevant to the task, update it from the code before editing product code.
-`;
-}
-
-function generateConventionsDoc(data) {
-    return `# Coding Conventions
-
-## Current Standards
-
-- Maximum file length: ${data.max_file_lines || '300'} lines unless the existing project standard is stricter.
-- Code comments and identifiers should be written in English.
-- Keep changes scoped to the user request.
-- Prefer existing local patterns over introducing new abstractions.
-- TODO: refine naming, formatting, folder, API, state, styling, and testing conventions from the real codebase.
-
-## Verification
-
-- Run the focused test or lint command that matches the touched area.
-- If no automated check exists, document the manual verification performed.
-- Do not claim completion without verification evidence.
-`;
-}
-
+
+function generateSharedClaudeMd() {
+    return `@AGENTS.md
+
+## Claude Code
+
+This repository uses AGENTS.md as the shared cross-agent entry file. Follow the imported instructions and keep Claude-specific notes here only when they cannot apply to Codex or Antigravity.
+`;
+}
+
+function generateSharedGeminiMd() {
+    return `# GEMINI.md
+
+Antigravity entry file for this project.
+
+Read AGENTS.md first, then follow the shared docs under .agent/docs/.
+`;
+}
+
+function generateSharedCursorrules() {
+    return `# Cursor Rules
+
+This repository uses AGENTS.md as the shared cross-agent entry file. Follow the instructions in AGENTS.md and keep Cursor-specific notes here only when they cannot apply to Codex, Antigravity, or Claude Code.
+
+Read AGENTS.md first, then follow the shared docs under .agent/docs/.
+`;
+}
+
+function resolveCommands(data) {
+    const frameworks = data.frameworks || [];
+    const primaryLang = data.primary_language || 'javascript';
+    const pkgManager = data.package_manager || 'npm';
+    const testFramework = data.test_framework || 'auto-detect';
+
+    const isPython = primaryLang === 'python';
+    const isGo = primaryLang === 'go';
+    const isRust = primaryLang === 'rust';
+    const isPhp = primaryLang === 'php';
+
+    let install = 'npm install';
+    let dev = 'npm run dev';
+    let build = 'npm run build';
+    let test = 'npm test';
+    let lint = 'npm run lint';
+
+    if (pkgManager === 'pnpm') { install = 'pnpm install'; dev = 'pnpm dev'; build = 'pnpm build'; test = 'pnpm test'; lint = 'pnpm lint'; }
+    else if (pkgManager === 'yarn') { install = 'yarn'; dev = 'yarn dev'; build = 'yarn build'; test = 'yarn test'; lint = 'yarn lint'; }
+    else if (pkgManager === 'bun') { install = 'bun install'; dev = 'bun dev'; build = 'bun run build'; test = 'bun test'; lint = 'bun run lint'; }
+    else if (isPython) { install = 'pip install -r requirements.txt'; dev = 'python manage.py runserver'; build = '# no build step'; test = 'pytest'; lint = 'ruff check .'; }
+    else if (isGo) { install = 'go mod download'; dev = 'go run .'; build = 'go build ./...'; test = 'go test ./...'; lint = 'golangci-lint run'; }
+    else if (isRust) { install = 'cargo build'; dev = 'cargo run'; build = 'cargo build --release'; test = 'cargo test'; lint = 'cargo clippy'; }
+    else if (isPhp) {
+        install = 'composer install';
+        build = '# no build step';
+        test = testFramework === 'pest' ? './vendor/bin/pest' : './vendor/bin/phpunit';
+        const isCakePHP = frameworks.some(f => f.toLowerCase().includes('cakephp'));
+        const isSymfony = frameworks.some(f => f.toLowerCase().includes('symfony'));
+        const isCodeIgniter = frameworks.some(f => f.toLowerCase().includes('codeigniter'));
+        if (isCakePHP) {
+            dev = 'bin/cake server';
+            lint = './vendor/bin/phpcs';
+        } else if (isSymfony) {
+            dev = 'bin/console server:run';
+            lint = './vendor/bin/phpcs';
+        } else if (isCodeIgniter) {
+            dev = 'php spark serve';
+            lint = './vendor/bin/phpcs';
+        } else {
+            dev = 'php artisan serve';
+            lint = 'php artisan pint';
+        }
+    }
+
+    if (testFramework === 'vitest') test = `${pkgManager === 'pnpm' ? 'pnpm' : pkgManager === 'yarn' ? 'yarn' : pkgManager === 'bun' ? 'bun run' : 'npx'} vitest`;
+    else if (testFramework === 'jest') test = `${pkgManager === 'pnpm' ? 'pnpm' : pkgManager === 'yarn' ? 'yarn' : 'npx'} jest`;
+
+    return { install, dev, build, test, lint };
+}
+
+function generateProjectDoc(data) {
+    const commands = resolveCommands(data);
+    const agentRows = resolveAgentTable(data).map(([task, agent, skills]) => `| ${task} | \`${agent}\` | ${skills} |`).join('\n');
+    const skillsList = resolveSkills(data).map(s => `- ${s}`).join('\n');
+    const evidence = (data.scan_evidence || []).length > 0
+        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
+        : '- TODO: refine scan evidence by inspecting the project.';
+
+    return `# Project Rules
+
+Generated by thachvd-kit on ${new Date().toISOString().split('T')[0]}.
+
+## Summary
+
+- Name: ${data.project_name}
+- Description: ${data.description}
+- Type: ${data.project_type}
+- App root: ${data.app_root || '.'}
+
+## Stack
+
+- Language: ${data.primary_language}
+- Frameworks: ${(data.frameworks || []).join(', ') || 'none'}
+- Database: ${data.database || 'none'}
+- Infrastructure: ${(data.infrastructure || []).join(', ') || 'none'}
+- Package manager: ${data.package_manager || 'auto-detect'}
+- Test framework: ${data.test_framework || 'auto-detect'}
+
+## Commands
+
+- Install: \`${commands.install}\`
+- Dev: \`${commands.dev}\`
+- Build: \`${commands.build}\`
+- Test: \`${commands.test}\`
+- Lint: \`${commands.lint}\`
+
+## Agent Routing
+
+| Task Type | Agent | Primary Skills |
+|-----------|-------|----------------|
+${agentRows}
+
+## Auto-Resolved Skills
+
+${skillsList}
+
+## Scan Evidence
+
+${evidence}
+`;
+}
+
+function generateArchitectureDoc(data) {
+    const appRootLine = data.app_root && data.app_root !== '.'
+        ? `- App root is currently detected as \`${data.app_root}\`.`
+        : '- App root is the repository root unless refined below.';
+    const evidence = (data.scan_evidence || []).length > 0
+        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
+        : '- TODO: refine architecture by scanning source directories.';
+
+    return `# Architecture Notes
+
+## Current Map
+
+${appRootLine}
+- TODO: refine major directories and responsibilities.
+- TODO: refine main entry points, routing, state boundaries, and integration boundaries.
+
+## Detected Evidence
+
+${evidence}
+
+## AI Maintenance Rule
+
+Before non-trivial implementation work, inspect this file. If it is stale or still contains TODO items relevant to the task, update it from the code before editing product code.
+`;
+}
+
+function generateConventionsDoc(data) {
+    return `# Coding Conventions
+
+## Current Standards
+
+- Maximum file length: ${data.max_file_lines || '300'} lines unless the existing project standard is stricter.
+- Code comments and identifiers should be written in English.
+- Keep changes scoped to the user request.
+- Prefer existing local patterns over introducing new abstractions.
+- TODO: refine naming, formatting, folder, API, state, styling, and testing conventions from the real codebase.
+
+## Verification
+
+- Run the focused test or lint command that matches the touched area.
+- If no automated check exists, document the manual verification performed.
+- Do not claim completion without verification evidence.
+`;
+}
+
 function generateWorkflowDoc() {
-    return `# Agent Workflow
-
-## Before Every Task
-
+    return `# Agent Workflow
+
+## Before Every Task
+
 1. Read AGENTS.md.
 2. Read .agent/docs/project.md.
 3. Classify the request: question, survey, simple fix, feature, refactor, debug, UI, security, or deploy.
-4. Read only the relevant docs under .agent/agents, .agent/skills, .agents/skills, .claude/skills, and .agent/workflows.
+4. Read only the relevant docs under .agent/agents, .agent/skills, .claude/skills, and .agent/workflows.
 
 ## Skill Selection
 
 - Prefer native skill discovery when the client exposes it.
-- Codex repo skills live in .agents/skills.
+- Codex global skills live in ~/.codex/skills/ and are visible via the $ menu; thachvd-kit copies selected skills there on init.
 - Claude Code project skills live in .claude/skills.
 - Shared fallback skills live in .agent/skills.
 - Do not load skill bodies by default.
@@ -1135,20 +1145,20 @@ function generateWorkflowDoc() {
 - Run thachvd-kit --help to see common workflow and skill recommendations.
 
 ## Implementation Flow
-
-1. State assumptions and success criteria when the task is not trivial.
-2. Inspect dependent files before editing.
-3. Make the smallest coherent change.
-4. Add or update focused tests when behavior changes.
-5. Run verification.
-6. Summarize changed files and verification evidence.
-
-## When To Update Docs
-
-- Update .agent/docs/architecture.md when structure, boundaries, or entry points change.
-- Update .agent/docs/conventions.md when repeated project patterns become clear.
-- Update .agent/docs/project.md when stack, scripts, app root, test tooling, or routing changes.
-- Keep AGENTS.md concise. Put project-specific detail in .agent/docs.
+
+1. State assumptions and success criteria when the task is not trivial.
+2. Inspect dependent files before editing.
+3. Make the smallest coherent change.
+4. Add or update focused tests when behavior changes.
+5. Run verification.
+6. Summarize changed files and verification evidence.
+
+## When To Update Docs
+
+- Update .agent/docs/architecture.md when structure, boundaries, or entry points change.
+- Update .agent/docs/conventions.md when repeated project patterns become clear.
+- Update .agent/docs/project.md when stack, scripts, app root, test tooling, or routing changes.
+- Keep AGENTS.md concise. Put project-specific detail in .agent/docs.
 `;
 }
 
@@ -1281,14 +1291,13 @@ Common local path:
 
 ## Native Skill Folders
 
-The shared kit skills live in \`.agent/skills/\`. Antigravity can use that folder directly, but Codex expects repo skills under \`.agents/skills/\` or user skills under \`~/.agents/skills/\`. Claude Code may require its own native skill location depending on the installed client.
+The shared kit skills live in \`.agent/skills/\`. Antigravity reads that folder directly. Codex shows skills from \`~/.codex/skills/\` in the \`$\` menu. Claude Code reads project skills from \`.claude/skills/\`.
 
-- Codex repo skills: \`.agents/skills/\`
-- Codex user skills: \`~/.agents/skills/\`
-- Codex may also keep installed/system skills under \`$CODEX_HOME/skills\` such as \`~/.codex/skills\`; treat that as local Codex state, not a repo folder to generate or commit.
-- Claude Code project skills commonly live under \`.claude/skills/\`.
-- \`thachvd-kit\` copies selected native skills to \`.agents/skills/\` and \`.claude/skills/\` based on the detected stack.
+- Codex global skills: \`~/.codex/skills/\` — installed by \`thachvd-kit init\`, visible in Codex \`$\` menu
+- Claude Code project skills: \`.claude/skills/\`
+- Antigravity: reads \`.agent/skills/\` directly (no copy needed)
 - Keep \`.agent/skills/\` as the full shared source of truth committed with the repo.
+- Do not commit \`~/.codex/skills/\`; it is local user state.
 
 Recommended candidates to copy first:
 
@@ -1298,39 +1307,39 @@ Recommended candidates to copy first:
 - Stack-specific skills listed in \`.agent/docs/project.md\`
 `;
 }
-
-// --- Agent Folder Copy ---
-
+
+// --- Agent Folder Copy ---
+
 function copyAgentFolder() {
-    const srcAgent = path.join(sourceDir, '.agent');
-    if (!fs.existsSync(srcAgent)) return { copied: 0, skipped: 0 };
-
-    const destAgent = path.join(targetDir, '.agent');
-    let copied = 0;
-    let skipped = 0;
-
-    function copyDir(src, dest) {
-        fs.mkdirSync(dest, { recursive: true });
-        for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-            const srcPath = path.join(src, entry.name);
-            const destPath = path.join(dest, entry.name);
-            const relativeSrc = path.relative(srcAgent, srcPath).split(path.sep).join('/');
-            if (relativeSrc === 'docs' || relativeSrc.startsWith('docs/')) {
-                continue;
-            }
-            if (entry.isDirectory()) {
-                copyDir(srcPath, destPath);
-            } else {
-                if (fs.existsSync(destPath)) {
-                    skipped++;
-                } else {
-                    fs.copyFileSync(srcPath, destPath);
-                    copied++;
-                }
-            }
-        }
-    }
-
+    const srcAgent = path.join(sourceDir, '.agent');
+    if (!fs.existsSync(srcAgent)) return { copied: 0, skipped: 0 };
+
+    const destAgent = path.join(targetDir, '.agent');
+    let copied = 0;
+    let skipped = 0;
+
+    function copyDir(src, dest) {
+        fs.mkdirSync(dest, { recursive: true });
+        for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            const relativeSrc = path.relative(srcAgent, srcPath).split(path.sep).join('/');
+            if (relativeSrc === 'docs' || relativeSrc.startsWith('docs/')) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                copyDir(srcPath, destPath);
+            } else {
+                if (fs.existsSync(destPath)) {
+                    skipped++;
+                } else {
+                    fs.copyFileSync(srcPath, destPath);
+                    copied++;
+                }
+            }
+        }
+    }
+
     copyDir(srcAgent, destAgent);
     return { copied, skipped };
 }
@@ -1340,10 +1349,15 @@ function copySelectedSkillFolders(data, assumeYes) {
     if (!fs.existsSync(srcSkills)) return { copied: 0, skipped: 0, missing: 0, skills: [] };
 
     const selectedSkills = resolveNativeSkills(data);
-    const destinations = [
-        path.join(targetDir, '.agents', 'skills'),
-        path.join(targetDir, '.claude', 'skills')
-    ];
+
+    // ~/.codex/skills/ — global Codex user skills dir, always visible in the $ menu
+    const codexSkillsDir = homePath('.codex', 'skills');
+    // .claude/skills/ — project-level Claude Code skills
+    const claudeSkillsDir = path.join(targetDir, '.claude', 'skills');
+
+    const destinations = [claudeSkillsDir];
+    if (codexSkillsDir) destinations.push(codexSkillsDir);
+
     let copied = 0;
     let skipped = 0;
     let missing = 0;
@@ -1516,28 +1530,28 @@ function setupMcpServers() {
 }
 
 // --- Main CLI ---
-
+
 async function main() {
-    const rawArgs = process.argv.slice(2);
-    const command = rawArgs[0] && !rawArgs[0].startsWith('-') ? rawArgs[0] : 'init';
-    const args = command === 'init' ? rawArgs.slice(rawArgs[0] === 'init' ? 1 : 0) : rawArgs.slice(1);
-
-    if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
-        console.log(packageJson.version);
-        return;
-    }
-
-    if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
-        printHelp();
-        return;
-    }
-
-    if (command !== 'init') {
-        console.error(pc.red(`Unknown command: ${command}`));
-        printHelp();
-        process.exit(1);
-    }
-
+    const rawArgs = process.argv.slice(2);
+    const command = rawArgs[0] && !rawArgs[0].startsWith('-') ? rawArgs[0] : 'init';
+    const args = command === 'init' ? rawArgs.slice(rawArgs[0] === 'init' ? 1 : 0) : rawArgs.slice(1);
+
+    if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+        console.log(packageJson.version);
+        return;
+    }
+
+    if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
+        printHelp();
+        return;
+    }
+
+    if (command !== 'init') {
+        console.error(pc.red(`Unknown command: ${command}`));
+        printHelp();
+        process.exit(1);
+    }
+
     const assumeYes = args.includes('--yes') || args.includes('-y');
     const skipMcpSetup = args.includes('--no-setup-mcp') || process.env.THACHVD_KIT_SKIP_MCP_SETUP === '1';
 
@@ -1574,17 +1588,17 @@ async function main() {
         test_framework: scanned?.test_framework || 'auto-detect',
         max_file_lines: scanned?.max_file_lines || '300'
     };
-
-    data.database = data.database || scanned?.database || 'none';
-    data.uses_docker = typeof data.uses_docker === 'boolean' ? data.uses_docker : (scanned?.uses_docker ?? true);
-    data.cloud = data.cloud || scanned?.cloud || 'none';
-    data.package_manager = data.package_manager || scanned?.package_manager || 'auto-detect';
-    data.test_framework = data.test_framework || scanned?.test_framework || 'auto-detect';
-    data.max_file_lines = data.max_file_lines || scanned?.max_file_lines || '300';
-    data.framework_details = scanned?.framework_details || [];
-    data.scan_evidence = scanned?.scan_evidence || [];
-    data.app_root = scanned?.app_root || '.';
-
+
+    data.database = data.database || scanned?.database || 'none';
+    data.uses_docker = typeof data.uses_docker === 'boolean' ? data.uses_docker : (scanned?.uses_docker ?? true);
+    data.cloud = data.cloud || scanned?.cloud || 'none';
+    data.package_manager = data.package_manager || scanned?.package_manager || 'auto-detect';
+    data.test_framework = data.test_framework || scanned?.test_framework || 'auto-detect';
+    data.max_file_lines = data.max_file_lines || scanned?.max_file_lines || '300';
+    data.framework_details = scanned?.framework_details || [];
+    data.scan_evidence = scanned?.scan_evidence || [];
+    data.app_root = scanned?.app_root || '.';
+
     data.infrastructure = [];
     if (data.uses_docker) data.infrastructure.push('docker');
     if (data.cloud !== 'none') data.infrastructure.push(data.cloud);
@@ -1592,36 +1606,37 @@ async function main() {
     const shouldSetupMcp = !skipMcpSetup;
 
     console.log(`\n${pc.bold(pc.cyan('Generating Files'))}`);
-
-    // Shared entry files are written after the .agent folder is available.
-
-    // Copy .agent folder
-    const { copied, skipped } = copyAgentFolder();
-    if (copied > 0) {
-        console.log(`  ${pc.green('OK')} Copied ${pc.bold('.agent/')} (${copied} file${copied !== 1 ? 's' : ''} added${skipped > 0 ? `, ${skipped} skipped` : ''})`);
+
+    // Shared entry files are written after the .agent folder is available.
+
+    // Copy .agent folder
+    const { copied, skipped } = copyAgentFolder();
+    if (copied > 0) {
+        console.log(`  ${pc.green('OK')} Copied ${pc.bold('.agent/')} (${copied} file${copied !== 1 ? 's' : ''} added${skipped > 0 ? `, ${skipped} skipped` : ''})`);
     } else if (skipped > 0) {
         console.log(`  ${pc.yellow('~')} ${pc.bold('.agent/')} already exists - ${skipped} file${skipped !== 1 ? 's' : ''} skipped (no overwrite)`);
     }
 
     const nativeSkills = copySelectedSkillFolders(data, assumeYes);
     if (nativeSkills.copied > 0) {
-        console.log(`  ${pc.green('OK')} Copied native skills to ${pc.bold('.agents/skills/')} and ${pc.bold('.claude/skills/')} (${nativeSkills.skills.join(', ')})`);
+        console.log(`  ${pc.green('OK')} Copied native skills to ${pc.bold('~/.codex/skills/')} and ${pc.bold('.claude/skills/')} (${nativeSkills.skills.join(', ')})`);
     } else if (nativeSkills.skipped > 0) {
         console.log(`  ${pc.yellow('~')} Native skills already exist - ${nativeSkills.skipped} file${nativeSkills.skipped !== 1 ? 's' : ''} skipped`);
     }
 
 
     const generatedFiles = [
-        ['AGENTS.md', generateSharedAgentsMd(data)],
-        ['CLAUDE.md', generateSharedClaudeMd()],
-        ['GEMINI.md', generateSharedGeminiMd()],
-        [path.join('.agent', 'docs', 'project.md'), generateProjectDoc(data)],
+        ['AGENTS.md', generateSharedAgentsMd(data)],
+        ['CLAUDE.md', generateSharedClaudeMd()],
+        ['GEMINI.md', generateSharedGeminiMd()],
+        ['.cursorrules', generateSharedCursorrules()],
+        [path.join('.agent', 'docs', 'project.md'), generateProjectDoc(data)],
         [path.join('.agent', 'docs', 'architecture.md'), generateArchitectureDoc(data)],
         [path.join('.agent', 'docs', 'conventions.md'), generateConventionsDoc(data)],
         [path.join('.agent', 'docs', 'workflow.md'), generateWorkflowDoc()],
         [path.join('.agent', 'docs', 'tooling.md'), generateToolingDoc(data)]
     ];
-
+
     for (const [relativePath, content] of generatedFiles) {
         const wrote = await writeGeneratedFile(relativePath, content, assumeYes);
         if (wrote) console.log(`  ${pc.green('OK')} Generated ${pc.bold(relativePath)}`);
@@ -1637,17 +1652,18 @@ async function main() {
     }
 
     console.log(`\n${pc.bold(pc.green('Done!'))}
-
-  ${pc.bold('Project:')} ${data.project_name}
-  ${pc.bold('Stack:')}   ${data.primary_language} | ${(data.frameworks || []).join(', ') || 'no framework'}
-
-  ${pc.bold('Generated:')}
-    - ${pc.bold('AGENTS.md')} shared entry for Codex, Antigravity, and Claude Code
-    - ${pc.bold('CLAUDE.md')} Claude Code entry that imports AGENTS.md
+
+  ${pc.bold('Project:')} ${data.project_name}
+  ${pc.bold('Stack:')}   ${data.primary_language} | ${(data.frameworks || []).join(', ') || 'no framework'}
+
+  ${pc.bold('Generated:')}
+    - ${pc.bold('AGENTS.md')} shared entry for Codex, Antigravity, Claude Code, and Cursor
+    - ${pc.bold('CLAUDE.md')} Claude Code entry that imports AGENTS.md
     - ${pc.bold('GEMINI.md')} Antigravity entry
+    - ${pc.bold('.cursorrules')} Cursor entry
     - ${pc.bold('.agent/docs/')} scan-based project rules
     - ${pc.bold('.agent/')} skills, workflows, agents, and rules
-    - ${pc.bold('.agents/skills/')} selected Codex native skills
+    - ${pc.bold('~/.codex/skills/')} selected Codex skills installed globally (visible in $ menu)
     - ${pc.bold('.claude/skills/')} selected Claude Code native skills
 
   ${pc.bold('MCP/tooling setup:')}
@@ -1659,22 +1675,23 @@ async function main() {
 
   ${pc.bold('Next steps:')}
     1. Copy the prompt below into your AI editor and describe what the project does
-    2. Commit ${pc.bold('AGENTS.md')}, ${pc.bold('CLAUDE.md')}, ${pc.bold('GEMINI.md')}, and ${pc.bold('.agent/')}
-    3. Open the project in Codex, Antigravity, or Claude Code
+    2. Commit ${pc.bold('AGENTS.md')}, ${pc.bold('CLAUDE.md')}, ${pc.bold('GEMINI.md')}, ${pc.bold('.cursorrules')}, and ${pc.bold('.agent/')}
+    3. Open the project in Codex, Antigravity, Claude Code, or Cursor
 
   ${pc.bold('Copy this prompt into your AI editor:')}
 ${pc.dim('---')}
 Read AGENTS.md and all files under .agent/docs/.
 Ask me what this project does and any important conventions I want preserved.
 Then scan this repository.
-Update AGENTS.md and .agent/docs/project.md, .agent/docs/architecture.md, .agent/docs/conventions.md, .agent/docs/workflow.md, and .agent/docs/tooling.md with factual project-specific rules.
+Update AGENTS.md, .cursorrules and .agent/docs/project.md, .agent/docs/architecture.md, .agent/docs/conventions.md, .agent/docs/workflow.md, and .agent/docs/tooling.md with factual project-specific rules.
 Do not implement product code.
 Remove TODO: refine only when backed by evidence from the codebase.
 ${pc.dim('---')}
-`);
-}
+`);
+}
+
+main().catch(err => {
+    console.error(pc.red('\nError during init:'), err);
+    process.exit(1);
+});
 
-main().catch(err => {
-    console.error(pc.red('\nError during init:'), err);
-    process.exit(1);
-});