thachvd-kit 1.0.23 → 1.0.24

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
@@ -1661,9 +1670,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)],

package/package.json

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