thachvd-kit

thachvd-kit bootstraps project context for AI coding agents such as Antigravity, Claude Code, and Codex.

It installs a local .agent/ kit, generates PROJECT_CONTEXT.md, and can scan an existing codebase to infer stack, framework, database, and infra signals before your agent starts working.

Quick Start

Install globally:

npm install -g thachvd-kit

Then run inside any project folder:

thachvd-kit init

You can also skip directly to scan mode:

thachvd-kit init --scan

What init Does

thachvd-kit init now supports both new and existing projects:

• New project: enter context manually.
• Existing project: choose scan mode or manual mode.
• Scan mode: detect stack from the codebase, show evidence, then either accept detected values or review/edit them.

Generated files:

• .agent/agents
• .agent/rules
• .agent/skills
• .agent/workflows
• PROJECT_CONTEXT.md
• CLAUDE.md
• AGENTS.md
• AI_CONTEXT_REFINEMENT.md when first-session AI refinement is enabled

Scan Behavior

The scanner is hybrid and practical:

• App stack detection uses an inferred app_root so nested apps like src/ can still resolve Laravel, CakePHP, Next.js, and similar stacks correctly.
• Infra detection stays repo-wide, so folders like dev/, stg/, prod/ can still contribute Docker and CI evidence.
• Noise folders such as vendor, node_modules, .git, dist, and build are ignored during recursive scan.

The scan preview surfaces:

• app root
• project type
• primary language
• frameworks
• database
• package manager
• test framework
• cloud
• infrastructure
• CI/CD
• evidence for each inferred framework

AI Refinement Flow

init creates a baseline PROJECT_CONTEXT.md.

If you enable first-session AI refinement, the generated context is marked with:

• context.status: baseline
• context.needs_ai_refinement: true

Then, when your agent opens the project, GEMINI.md / CLAUDE.md / AGENTS.md instruct it to:

1. Read PROJECT_CONTEXT.md
2. Refine the context once if needs_ai_refinement is true
3. Update the file to context.status: refined
4. Set context.needs_ai_refinement: false

This keeps init simple while still allowing a deeper AI pass without requiring API-key integration inside the CLI.

Skill Resolution

The kit auto-loads generic and framework-specific skills based on detected context.

Examples:

• React -> react-frontend, frontend-design
• Next.js -> nextjs-react-expert, frontend-design
• Laravel -> laravel-patterns, laravel-security, laravel-tdd
• Tauri -> rust-pro, desktop-design

Generic quality skills such as clean-code and systematic-debugging are always included.

Directory Layout

.agent/
├── agents/
├── rules/
├── skills/
└── workflows/

Notes

• thachvd-kit generates both CLAUDE.md for Claude Code and AGENTS.md for Codex/AGENTS-compatible editors.
• The npm package page updates only after a new npm publish, not just after pushing to GitHub.