thachvd-kit 1.0.17 → 1.0.19

package/kit/PROMPT_RECIPE.md

@@ -1,30 +1,30 @@
-# Prompt Recipes
-
-Use these prompts after `thachvd-kit init` when you want the AI agent to refine project rules.
-
-## Initial Refinement
-
-```text
-Read 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.
-Do not implement product code.
-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.
-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.
-```
-
-## After A Task
-
-```text
-Review the files changed in this task.
-If stack, architecture, conventions, commands, or workflow changed, update the relevant .agent/docs/*.md file.
-Summarize verification evidence before claiming done.
-```
+# Prompt Recipes
+
+Use these prompts after `thachvd-kit init` when you want the AI agent to refine project rules.
+
+## Initial Refinement
+
+```text
+Read 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.
+Do not implement product code.
+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.
+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.
+```
+
+## After A Task
+
+```text
+Review the files changed in this task.
+If stack, architecture, conventions, commands, or workflow changed, update the relevant .agent/docs/*.md file.
+Summarize verification evidence before claiming done.
+```

package/kit/README.md

@@ -1,29 +1,29 @@
-# thachvd-kit Kit
-
-This kit keeps AI coding behavior consistent across Codex, Antigravity, and Claude Code.
-
-## Entry Files
-
-- `AGENTS.md`: shared cross-agent instructions.
-- `CLAUDE.md`: Claude Code entry file that imports `AGENTS.md`.
-- `GEMINI.md`: Antigravity entry file that points to `AGENTS.md`.
-
-## Shared Docs
-
-Project-specific knowledge belongs under `.agent/docs/`:
-
-- `project.md`: stack, commands, tools, routing, and scan evidence.
-- `architecture.md`: codebase structure, entry points, and boundaries.
-- `conventions.md`: naming, formatting, testing, API, state, and styling patterns.
-- `workflow.md`: repeatable task flow.
-
-Agents should update these docs when they discover real project facts. Keep root entry files short.
-
-## Local Kit
-
-- `.agent/agents/`: specialist agent guidance.
-- `.agent/skills/`: reusable capability instructions.
-- `.agent/workflows/`: task workflows.
-- `.agent/rules/GEMINI.md`: Antigravity-compatible mirror rules.
-
-Powered by thachvd-kit.
+# thachvd-kit Kit
+
+This kit keeps AI coding behavior consistent across Codex, Antigravity, and Claude Code.
+
+## Entry Files
+
+- `AGENTS.md`: shared cross-agent instructions.
+- `CLAUDE.md`: Claude Code entry file that imports `AGENTS.md`.
+- `GEMINI.md`: Antigravity entry file that points to `AGENTS.md`.
+
+## Shared Docs
+
+Project-specific knowledge belongs under `.agent/docs/`:
+
+- `project.md`: stack, commands, tools, routing, and scan evidence.
+- `architecture.md`: codebase structure, entry points, and boundaries.
+- `conventions.md`: naming, formatting, testing, API, state, and styling patterns.
+- `workflow.md`: repeatable task flow.
+
+Agents should update these docs when they discover real project facts. Keep root entry files short.
+
+## Local Kit
+
+- `.agent/agents/`: specialist agent guidance.
+- `.agent/skills/`: reusable capability instructions.
+- `.agent/workflows/`: task workflows.
+- `.agent/rules/GEMINI.md`: Antigravity-compatible mirror rules.
+
+Powered by thachvd-kit.

package/package.json

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

package/rules/GEMINI.md

@@ -1,45 +1,45 @@
----
-trigger: always_on
----
-
-# GEMINI.md
-
-Antigravity-compatible entry rules for thachvd-kit projects.
-
-## Startup
-
-1. Read `AGENTS.md` at the project root.
-2. Read `.agent/docs/project.md` for stack, commands, and routing.
-3. Read `.agent/docs/workflow.md` before editing.
-4. Read `.agent/docs/architecture.md` and `.agent/docs/conventions.md` before planning non-trivial code changes.
-5. If any `.agent/docs/*.md` file contains `TODO: refine`, update that doc from the real code before product code changes.
-
-## Routing
-
-- Frontend/UI: `.agent/agents/frontend-specialist.md`
-- Backend/API: `.agent/agents/backend-specialist.md`
-- Database/schema: `.agent/agents/database-architect.md`
-- Mobile/desktop: `.agent/agents/mobile-developer.md`
-- DevOps/CI/deploy: `.agent/agents/devops-engineer.md`
-- Debug/RCA: `.agent/agents/debugger.md`
-- Security: `.agent/agents/security-auditor.md`
-- Multi-domain: `.agent/agents/orchestrator.md`
-
-Load only the agent, skill, or workflow files relevant to the current task.
-
-## Execution
-
-- Questions and analysis: answer directly; do not edit code.
-- Simple fix: inspect dependencies, make the smallest change, verify.
-- Feature or refactor: state assumptions, define success criteria, plan, implement, verify.
-- UI work: use relevant frontend design skills before editing.
-- Security or deploy work: run the matching checklist before claiming done.
-
-## Standards
-
-- Respond in the user's language.
-- Keep code, identifiers, and code comments in English.
-- Prefer existing project patterns over new abstractions.
-- Keep changes surgical.
-- Tests or equivalent verification are mandatory.
-- Update `.agent/docs/*` when stack, architecture, workflow, or conventions change.
+---
+trigger: always_on
+---
+
+# GEMINI.md
+
+Antigravity-compatible entry rules for thachvd-kit projects.
+
+## Startup
+
+1. Read `AGENTS.md` at the project root.
+2. Read `.agent/docs/project.md` for stack, commands, and routing.
+3. Read `.agent/docs/workflow.md` before editing.
+4. Read `.agent/docs/architecture.md` and `.agent/docs/conventions.md` before planning non-trivial code changes.
+5. If any `.agent/docs/*.md` file contains `TODO: refine`, update that doc from the real code before product code changes.
+
+## Routing
+
+- Frontend/UI: `.agent/agents/frontend-specialist.md`
+- Backend/API: `.agent/agents/backend-specialist.md`
+- Database/schema: `.agent/agents/database-architect.md`
+- Mobile/desktop: `.agent/agents/mobile-developer.md`
+- DevOps/CI/deploy: `.agent/agents/devops-engineer.md`
+- Debug/RCA: `.agent/agents/debugger.md`
+- Security: `.agent/agents/security-auditor.md`
+- Multi-domain: `.agent/agents/orchestrator.md`
+
+Load only the agent, skill, or workflow files relevant to the current task.
+
+## Execution
+
+- Questions and analysis: answer directly; do not edit code.
+- Simple fix: inspect dependencies, make the smallest change, verify.
+- Feature or refactor: state assumptions, define success criteria, plan, implement, verify.
+- UI work: use relevant frontend design skills before editing.
+- Security or deploy work: run the matching checklist before claiming done.
+
+## Standards
+
+- Respond in the user's language.
+- Keep code, identifiers, and code comments in English.
+- Prefer existing project patterns over new abstractions.
+- Keep changes surgical.
+- Tests or equivalent verification are mandatory.
+- Update `.agent/docs/*` when stack, architecture, workflow, or conventions change.

package/skills/desktop-design/SKILL.md

@@ -1,25 +1,25 @@
----
-name: desktop-design
-description: Desktop and cross-platform app design guidance for Tauri and similar desktop shells. Use when building desktop-first interfaces, windowed workflows, keyboard-heavy UX, or cross-platform desktop UI behavior.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
----
-
-# Desktop Design
-
-This skill covers desktop-first product thinking where `mobile-design` is the wrong default.
-
-Use it for Tauri and other desktop-oriented apps with window management, keyboard shortcuts, dense layouts, or multi-panel workflows.
-
-## Guidance
-
-- Design for pointer + keyboard, not touch-first.
-- Use information density deliberately; desktop screens can support richer sidebars and multi-column layouts.
-- Respect platform conventions for menus, shortcuts, dialogs, file pickers, and drag/drop.
-- Assume resizing, multiple windows, and long-running sessions are normal.
-- Pair with `rust-pro` for Tauri backend/native concerns and `frontend-design` for UI execution.
-
-## Related Skills
-
-- `mobile-design` for touch-first mobile products
-- `frontend-design` for visual and interaction design
-- `rust-pro` for Rust and Tauri implementation details
+---
+name: desktop-design
+description: Desktop and cross-platform app design guidance for Tauri and similar desktop shells. Use when building desktop-first interfaces, windowed workflows, keyboard-heavy UX, or cross-platform desktop UI behavior.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Desktop Design
+
+This skill covers desktop-first product thinking where `mobile-design` is the wrong default.
+
+Use it for Tauri and other desktop-oriented apps with window management, keyboard shortcuts, dense layouts, or multi-panel workflows.
+
+## Guidance
+
+- Design for pointer + keyboard, not touch-first.
+- Use information density deliberately; desktop screens can support richer sidebars and multi-column layouts.
+- Respect platform conventions for menus, shortcuts, dialogs, file pickers, and drag/drop.
+- Assume resizing, multiple windows, and long-running sessions are normal.
+- Pair with `rust-pro` for Tauri backend/native concerns and `frontend-design` for UI execution.
+
+## Related Skills
+
+- `mobile-design` for touch-first mobile products
+- `frontend-design` for visual and interaction design
+- `rust-pro` for Rust and Tauri implementation details

package/skills/project-onboarding/SKILL.md

@@ -1,42 +1,42 @@
----
-name: project-onboarding
-description: Scan the repository and refine `.agent/docs/*` so all supported AI tools share accurate project rules.
----
-
-# Project Onboarding
-
-Use this skill when a project has just run `thachvd-kit init`, when `.agent/docs/*` contains `TODO: refine`, or when the stack/architecture has changed.
-
-## Goal
-
-Create or update the shared project docs used by Codex, Antigravity, and Claude Code:
-
-- `.agent/docs/project.md`
-- `.agent/docs/architecture.md`
-- `.agent/docs/conventions.md`
-- `.agent/docs/workflow.md`
-
-Do not create a legacy root context file.
-
-## Process
-
-1. Read `AGENTS.md`.
-2. Inspect repository structure, package/build config, test config, entry points, and representative source files.
-3. Update `.agent/docs/project.md` with stack, app root, commands, test/lint tooling, and routing.
-4. Update `.agent/docs/architecture.md` with major directories, entry points, boundaries, and important decisions.
-5. Update `.agent/docs/conventions.md` with real naming, formatting, API, state, styling, and testing patterns.
-6. Update `.agent/docs/workflow.md` only when the repository needs project-specific workflow steps.
-
-## Rules
-
-- Keep docs concise and factual.
-- Mark unknowns as `TODO: refine` only when the codebase does not provide evidence.
-- Do not implement product code during onboarding.
-- Do not overwrite unrelated user-maintained notes.
-
-## Completion Checklist
-
-- [ ] `.agent/docs/project.md` reflects actual stack and commands.
-- [ ] `.agent/docs/architecture.md` maps the current codebase.
-- [ ] `.agent/docs/conventions.md` captures observed patterns.
-- [ ] `.agent/docs/workflow.md` has the task flow agents should follow.
+---
+name: project-onboarding
+description: Scan the repository and refine `.agent/docs/*` so all supported AI tools share accurate project rules.
+---
+
+# Project Onboarding
+
+Use this skill when a project has just run `thachvd-kit init`, when `.agent/docs/*` contains `TODO: refine`, or when the stack/architecture has changed.
+
+## Goal
+
+Create or update the shared project docs used by Codex, Antigravity, and Claude Code:
+
+- `.agent/docs/project.md`
+- `.agent/docs/architecture.md`
+- `.agent/docs/conventions.md`
+- `.agent/docs/workflow.md`
+
+Do not create a legacy root context file.
+
+## Process
+
+1. Read `AGENTS.md`.
+2. Inspect repository structure, package/build config, test config, entry points, and representative source files.
+3. Update `.agent/docs/project.md` with stack, app root, commands, test/lint tooling, and routing.
+4. Update `.agent/docs/architecture.md` with major directories, entry points, boundaries, and important decisions.
+5. Update `.agent/docs/conventions.md` with real naming, formatting, API, state, styling, and testing patterns.
+6. Update `.agent/docs/workflow.md` only when the repository needs project-specific workflow steps.
+
+## Rules
+
+- Keep docs concise and factual.
+- Mark unknowns as `TODO: refine` only when the codebase does not provide evidence.
+- Do not implement product code during onboarding.
+- Do not overwrite unrelated user-maintained notes.
+
+## Completion Checklist
+
+- [ ] `.agent/docs/project.md` reflects actual stack and commands.
+- [ ] `.agent/docs/architecture.md` maps the current codebase.
+- [ ] `.agent/docs/conventions.md` captures observed patterns.
+- [ ] `.agent/docs/workflow.md` has the task flow agents should follow.

package/skills/react-frontend/SKILL.md

@@ -1,25 +1,25 @@
----
-name: react-frontend
-description: React-focused frontend guidance for component architecture, state flow, rendering boundaries, and maintainable UI systems. Use for plain React apps that are not specifically Next.js-first.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
----
-
-# React Frontend
-
-This skill is the React-first counterpart to `nextjs-react-expert`.
-
-Use it when the project uses React without needing Next.js-specific assumptions such as SSR, App Router, or server components.
-
-## Guidance
-
-- Prefer the existing project architecture over introducing a new pattern.
-- Keep state ownership shallow and explicit.
-- Separate presentational UI from data-fetching and side effects when it improves maintainability.
-- Optimize rendering only after confirming an actual bottleneck.
-- Pair with `frontend-design` for UI/UX decisions.
-
-## Related Skills
-
-- `nextjs-react-expert` for Next.js-specific performance and routing concerns
-- `frontend-design` for layout, visual hierarchy, and responsive design
-- `clean-code` for naming, file boundaries, and readability
+---
+name: react-frontend
+description: React-focused frontend guidance for component architecture, state flow, rendering boundaries, and maintainable UI systems. Use for plain React apps that are not specifically Next.js-first.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# React Frontend
+
+This skill is the React-first counterpart to `nextjs-react-expert`.
+
+Use it when the project uses React without needing Next.js-specific assumptions such as SSR, App Router, or server components.
+
+## Guidance
+
+- Prefer the existing project architecture over introducing a new pattern.
+- Keep state ownership shallow and explicit.
+- Separate presentational UI from data-fetching and side effects when it improves maintainability.
+- Optimize rendering only after confirming an actual bottleneck.
+- Pair with `frontend-design` for UI/UX decisions.
+
+## Related Skills
+
+- `nextjs-react-expert` for Next.js-specific performance and routing concerns
+- `frontend-design` for layout, visual hierarchy, and responsive design
+- `clean-code` for naming, file boundaries, and readability