thachvd-kit 1.0.19 → 1.0.20

package/README.md

@@ -19,45 +19,46 @@ thachvd-kit
 ```
 
 By default, `thachvd-kit` scans the current project, generates shared AI-agent files, installs/configures Codegraph when needed, and configures Context7, Codegraph, and Playwright MCP for local AI clients. Use `--no-setup-mcp` to skip machine-level MCP setup.
-
-## What `init` Generates
-
-- `AGENTS.md`: shared entry instructions for Codex, Antigravity, and Claude Code.
-- `CLAUDE.md`: Claude Code entry file that imports `AGENTS.md`.
-- `GEMINI.md`: Antigravity entry file that points to `AGENTS.md`.
-- `.agent/docs/project.md`: stack, commands, routing, and scan evidence.
+
+## What `init` Generates
+
+- `AGENTS.md`: shared entry 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/docs/project.md`: stack, commands, routing, and scan evidence.
 - `.agent/docs/architecture.md`: architecture map and maintenance rule.
 - `.agent/docs/conventions.md`: coding and verification conventions.
 - `.agent/docs/workflow.md`: repeatable task flow for future AI work.
 - `.agent/docs/tooling.md`: setup hints for Playwright, codegraph, and native Codex/Claude skill folders.
 - `.agent/agents`, `.agent/skills`, `.agent/workflows`, `.agent/rules`.
-- `.agents/skills`: selected repo-native Codex skills copied from the kit.
+- `~/.codex/skills/`: selected Codex skills copied to the global user dir.
 - `.claude/skills`: selected Claude Code project skills copied from the kit.
-
-## Why Docs Live Under `.agent/docs`
-
-Root instruction files are loaded often, so they should stay short and stable. Project-specific details belong in `.agent/docs/`:
-
-- update `project.md` when stack, scripts, or tooling changes;
-- update `architecture.md` when structure or boundaries change;
-- update `conventions.md` when repeated patterns become clear;
-- update `workflow.md` when the repo needs special task steps.
-
-`AGENTS.md` tells every AI agent to read these docs before coding. If a doc contains `TODO: refine`, the agent should scan the repository and update the doc before product code changes.
-
+
+## Why Docs Live Under `.agent/docs`
+
+Root instruction files are loaded often, so they should stay short and stable. Project-specific details belong in `.agent/docs/`:
+
+- update `project.md` when stack, scripts, or tooling changes;
+- update `architecture.md` when structure or boundaries change;
+- update `conventions.md` when repeated patterns become clear;
+- update `workflow.md` when the repo needs special task steps.
+
+`AGENTS.md` tells every AI agent to read these docs before coding. If a doc contains `TODO: refine`, the agent should scan the repository and update the doc before product code changes.
+
 ## Platform Notes
 
 - Codex reads `AGENTS.md`.
 - Claude Code reads `CLAUDE.md`; this kit uses `@AGENTS.md` inside `CLAUDE.md` so Claude shares the same rules.
 - Antigravity can use `GEMINI.md`; this kit points it back to the shared `AGENTS.md`.
-- `.agent/skills` is committed shared knowledge. `thachvd-kit` also copies selected native skills into `.agents/skills` for Codex and `.claude/skills` for Claude Code.
+- `.agent/skills` is committed shared knowledge. `thachvd-kit` also copies selected native skills into `~/.codex/skills/` for Codex and `.claude/skills` for Claude Code.
 
 ## Skill Usage Best Practice
 
 Skills work best through progressive disclosure: the agent should first see skill names and descriptions, then read only the matching `SKILL.md` body.
 
 - Keep `.agent/skills` as the complete shared source from the kit.
-- Let `thachvd-kit` copy selected skills to `.agents/skills` for Codex and `.claude/skills` for Claude Code.
+- Let `thachvd-kit` copy selected skills to `~/.codex/skills/` for Codex and `.claude/skills` for Claude Code.
 - Make every `SKILL.md` frontmatter `description` specific: include when to use it, trigger phrases, and boundaries.
 - Run `thachvd-kit --help` to see a compact workflow guide without adding that guidance to every agent context. It recommends when to use `/brainstorm`, `/plan`, `/create`, `/enhance`, `/debug`, `/test`, `/preview`, `/deploy`, `/status`, and `/orchestrate`.
 - Use explicit prompts when implicit matching misses, for example `Use $webapp-testing to verify this UI` or `Use $clean-code before refactoring`.
@@ -73,37 +74,37 @@ Skills work best through progressive disclosure: the agent should first see skil
 - Gemini/Antigravity MCP: uses `mcp_config.json` with a top-level `mcpServers` object. The generated config includes `codegraph`, `context7`, and `playwright`.
 - Claude Code MCP: uses `~/.claude.json` with a top-level `mcpServers` object.
 - Codegraph indexes: `.codegraph/` is local state and should not be committed.
-- Native skills: Codex repo skills live in `.agents/skills/`, Claude Code project skills live in `.claude/skills/`, and the full shared source remains in `.agent/skills/`. Codex may also keep installed/system skills in `$CODEX_HOME/skills` such as `~/.codex/skills`; do not treat repo `.codex/skills` as the generated project skill folder.
-
-## Directory Layout
-
-```text
-.agent/
-├── agents/
-├── docs/
+- Native skills: Codex global skills live in `~/.codex/skills/`, Claude Code project skills live in `.claude/skills/`, and the full shared source remains in `.agent/skills/`.
+
+## Directory Layout
+
+```text
+.agent/
+├── agents/
+├── docs/
 │   ├── architecture.md
 │   ├── conventions.md
 │   ├── project.md
 │   ├── tooling.md
 │   └── workflow.md
-├── rules/
-├── skills/
+├── rules/
+├── skills/
 └── workflows/
 ```
 
-The generated project also gets selected native skill folders:
+The generated project copies selected native skills to global user folder and project folder:
 
 ```text
-.agents/skills/
+~/.codex/skills/
 .claude/skills/
 ```
-
-## Development
-
-```bash
-npm install
-npm test
-npm pack --dry-run
-```
-
-The npm package page updates only after `npm publish`.
+
+## Development
+
+```bash
+npm install
+npm test
+npm pack --dry-run
+```
+
+The npm package page updates only after `npm publish`.