thachvd-kit 1.0.23 → 1.0.25

package/.agent/docs/conventions.md

@@ -12,4 +12,5 @@
 
 - Run the focused test or lint command that matches the touched area.
 - If no automated check exists, document the manual verification performed.
+- For UI/web changes, prioritize using Playwright MCP to automatically verify client-side behavior and capture screenshots.
 - Do not claim completion without verification evidence.

package/.agent/docs/workflow.md

@@ -6,6 +6,7 @@
 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, .claude/skills, and .agent/workflows.
+5. Check if MCP servers (like `codegraph`) are active/available and prioritize using them as the primary entry point to search and locate files, symbols, and code blocks.
 
 ## Skill Selection
 
@@ -24,7 +25,7 @@
 2. Inspect dependent files before editing.
 3. Make the smallest coherent change.
 4. Add or update focused tests when behavior changes.
-5. Run verification.
+5. Run verification (prioritize using Playwright MCP for web/UI changes to automate verification and capture screenshots).
 6. Summarize changed files and verification evidence.
 
 ## When To Update Docs

package/bin/cli.js

@@ -931,6 +931,7 @@ If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the doc
 - 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.
+- **MCP First**: Prioritize using MCP server tools (e.g., \`codegraph\` for codebase search/symbol tracking, \`context7\` for API/docs queries, and \`playwright\` for browser/UI testing and verification) to explore, search, and verify rather than recursively listing directories, running expensive shell commands/grep, or reading large files. This minimizes token usage and maintains a cleaner context.
 - 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\`.
 
@@ -948,9 +949,11 @@ If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the doc
 `;
 }
 
-function generateSharedClaudeMd() {
+function generateSharedClaudeMd(data) {
     return `@AGENTS.md
 
+${generateSharedAgentsMd(data)}
+
 ## 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.
@@ -966,12 +969,16 @@ Read AGENTS.md first, then follow the shared docs under .agent/docs/.
 `;
 }
 
-function generateSharedCursorrules() {
+function generateSharedCursorrules(data) {
     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/.
+
+---
+
+${generateSharedAgentsMd(data)}
 `;
 }
 
@@ -1119,6 +1126,7 @@ function generateConventionsDoc(data) {
 
 - Run the focused test or lint command that matches the touched area.
 - If no automated check exists, document the manual verification performed.
+- For UI/web changes, prioritize using Playwright MCP to automatically verify client-side behavior and capture screenshots.
 - Do not claim completion without verification evidence.
 `;
 }
@@ -1132,6 +1140,7 @@ function generateWorkflowDoc() {
 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, .claude/skills, and .agent/workflows.
+5. Check if MCP servers (like \`codegraph\`) are active/available and prioritize using them as the primary entry point to search and locate files, symbols, and code blocks.
 
 ## Skill Selection
 
@@ -1150,7 +1159,7 @@ function generateWorkflowDoc() {
 2. Inspect dependent files before editing.
 3. Make the smallest coherent change.
 4. Add or update focused tests when behavior changes.
-5. Run verification.
+5. Run verification (prioritize using Playwright MCP for web/UI changes to automate verification and capture screenshots).
 6. Summarize changed files and verification evidence.
 
 ## When To Update Docs
@@ -1336,7 +1345,6 @@ function copyAgentFolder() {
 
     const destAgent = path.join(targetDir, '.agent');
     let copied = 0;
-    let skipped = 0;
 
     function copyDir(src, dest) {
         fs.mkdirSync(dest, { recursive: true });
@@ -1350,18 +1358,14 @@ function copyAgentFolder() {
             if (entry.isDirectory()) {
                 copyDir(srcPath, destPath);
             } else {
-                if (fs.existsSync(destPath)) {
-                    skipped++;
-                } else {
-                    fs.copyFileSync(srcPath, destPath);
-                    copied++;
-                }
+                fs.copyFileSync(srcPath, destPath);
+                copied++;
             }
         }
     }
 
     copyDir(srcAgent, destAgent);
-    return { copied, skipped };
+    return { copied, skipped: 0 };
 }
 
 function copySelectedSkillFolders(data, assumeYes) {
@@ -1379,7 +1383,6 @@ function copySelectedSkillFolders(data, assumeYes) {
     if (codexSkillsDir) destinations.push(codexSkillsDir);
 
     let copied = 0;
-    let skipped = 0;
     let missing = 0;
 
     function copyDir(src, dest) {
@@ -1389,8 +1392,6 @@ function copySelectedSkillFolders(data, assumeYes) {
             const destPath = path.join(dest, entry.name);
             if (entry.isDirectory()) {
                 copyDir(srcPath, destPath);
-            } else if (fs.existsSync(destPath) && !assumeYes) {
-                skipped++;
             } else {
                 fs.mkdirSync(path.dirname(destPath), { recursive: true });
                 fs.copyFileSync(srcPath, destPath);
@@ -1410,13 +1411,25 @@ function copySelectedSkillFolders(data, assumeYes) {
         }
     }
 
-    return { copied, skipped, missing, skills: selectedSkills };
+    return { copied, skipped: 0, missing, skills: selectedSkills };
 }
 
 async function writeGeneratedFile(relativePath, content, assumeYes) {
     const outputPath = path.join(targetDir, relativePath);
     const exists = fs.existsSync(outputPath);
-    if (exists && !assumeYes) return false;
+    if (exists && !assumeYes) {
+        const response = await prompts({
+            type: 'confirm',
+            name: 'overwrite',
+            message: `File ${pc.bold(relativePath)} already exists. Do you want to overwrite it?`,
+            initial: false
+        });
+        if (response.overwrite === undefined) {
+            console.log(pc.yellow('\nCancelled.'));
+            process.exit(130);
+        }
+        if (!response.overwrite) return false;
+    }
 
     fs.mkdirSync(path.dirname(outputPath), { recursive: true });
     fs.writeFileSync(outputPath, content, 'utf8');
@@ -1661,9 +1674,9 @@ async function main() {
 
     const generatedFiles = [
         ['AGENTS.md', generateSharedAgentsMd(data)],
-        ['CLAUDE.md', generateSharedClaudeMd()],
+        ['CLAUDE.md', generateSharedClaudeMd(data)],
         ['GEMINI.md', generateSharedGeminiMd()],
-        ['.cursorrules', generateSharedCursorrules()],
+        ['.cursorrules', generateSharedCursorrules(data)],
         [path.join('.agent', 'docs', 'project.md'), generateProjectDoc(data)],
         [path.join('.agent', 'docs', 'architecture.md'), generateArchitectureDoc(data)],
         [path.join('.agent', 'docs', 'conventions.md'), generateConventionsDoc(data)],
@@ -1714,10 +1727,10 @@ async function main() {
 
   ${pc.bold('Copy this prompt into your AI editor:')}
 ${pc.dim('---')}
-Read AGENTS.md and all files under .agent/docs/.
+Read CLAUDE.md (if using Claude Code), 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, .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.
+Update CLAUDE.md, 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('---')}

package/kit/PROMPT_RECIPE.md

@@ -5,9 +5,9 @@ Use these prompts after `thachvd-kit init` when you want the AI agent to refine
 ## Initial Refinement
 
 ```text
-Read AGENTS.md and all files under .agent/docs/.
+Read CLAUDE.md (if using Claude Code), AGENTS.md, and all files under .agent/docs/.
 Scan the current repository.
-Update .agent/docs/project.md, .agent/docs/architecture.md, and .agent/docs/conventions.md with factual project-specific rules.
+Update CLAUDE.md, AGENTS.md, .cursorrules and .agent/docs/project.md, .agent/docs/architecture.md, and .agent/docs/conventions.md with factual project-specific rules.
 Do not implement product code.
 Remove TODO: refine items only when you have real evidence from the codebase.
 ```
@@ -15,7 +15,7 @@ Remove TODO: refine items only when you have real evidence from the codebase.
 ## Before A Feature
 
 ```text
-Read AGENTS.md and .agent/docs/workflow.md.
+Read CLAUDE.md (if using Claude Code), AGENTS.md, and .agent/docs/workflow.md.
 Check whether .agent/docs/architecture.md and .agent/docs/conventions.md are accurate for this task.
 If they are stale, update the relevant docs first.
 Then define success criteria, implement the smallest coherent change, and verify.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.23",
+    "version": "1.0.25",
     "description": "Cross-agent project rules bootstrap kit for Codex, Antigravity, and Claude Code",
     "bin": {
         "thachvd-kit": "./bin/cli.js"