thachvd-kit 1.0.10 → 1.0.11

package/README.md

@@ -40,6 +40,7 @@ Generated files:
 - `.agent/workflows`
 - `PROJECT_CONTEXT.md`
 - `CLAUDE.md`
+- `AGENTS.md`
 - `AI_CONTEXT_REFINEMENT.md` when first-session AI refinement is enabled
 
 ## Scan Behavior
@@ -73,7 +74,7 @@ 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` instruct it to:
+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`
@@ -107,5 +108,5 @@ Generic quality skills such as `clean-code` and `systematic-debugging` are alway
 
 ## Notes
 
-- `thachvd-kit` is compatible with Codex workflows through `PROJECT_CONTEXT.md` and `CLAUDE.md`; it does not directly control Codex sessions.
+- `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.

package/bin/cli.js

@@ -953,11 +953,11 @@ ${autoSkillsList}
 function generateClaudeMd(data) {
     return `# CLAUDE.md — ${data.project_name}
 # Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
-# Cross-platform: Claude Code · Codex · OpenCode
-
-## Project
-${data.description}
-Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ')}
+# Platform: Claude Code
+
+## Project
+${data.description}
+Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ')}
 
 ## Rules
 - Read PROJECT_CONTEXT.md first for stack details and agent routing.
@@ -977,11 +977,52 @@ Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ')}
 - \`/debug\` — Systematic debugging
 - \`/test\` — Run test suite
 - \`/deploy\` — Deploy checklist
-
+
 See PROJECT_CONTEXT.md for full agent routing table.
 `;
 }
 
+function generateAgentsMd(data) {
+    return `# AGENTS.md — ${data.project_name}
+# Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
+# Platform: Codex / AGENTS-compatible editors
+
+## Project
+${data.description}
+Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ') || 'no framework'}
+
+## Mandatory First Action
+- Read \`PROJECT_CONTEXT.md\` before making plans or code changes.
+- If \`PROJECT_CONTEXT.md\` is missing or stale, create/update it before major work.
+- If \`context.needs_ai_refinement: true\`, refine \`PROJECT_CONTEXT.md\` first, then set:
+  - \`context.status: refined\`
+  - \`context.needs_ai_refinement: false\`
+  - \`context.last_refined_at: <today>\`
+
+## Working Rules
+- Use \`.agent/agents\`, \`.agent/skills\`, \`.agent/rules\`, and \`.agent/workflows\` as the local project kit.
+- Match the task against the Agent Routing table in \`PROJECT_CONTEXT.md\`.
+- Load relevant skills before editing code.
+- Tests are mandatory. Verify before claiming done.
+- Keep files under ${data.max_file_lines || '300'} lines when practical, then split into modules.
+- Update dependent files together when a change crosses boundaries.
+
+## Preferred Workflow
+- Plan work from \`PROJECT_CONTEXT.md\` first.
+- For feature work, use: \`plan-writing\` -> \`executing-plans\` -> \`verification-before-completion\`.
+- For reviews, use: \`requesting-code-review\` / \`receiving-code-review\`.
+- For debugging, use: \`systematic-debugging\`.
+
+## Key Paths
+- Project context: \`PROJECT_CONTEXT.md\`
+- Agent kit: \`.agent/\`
+- Skills: \`.agent/skills/\`
+- Workflows: \`.agent/workflows/\`
+
+See \`PROJECT_CONTEXT.md\` for stack details, routing, and auto-resolved skills.
+`;
+}
+
 function generateAiContextRefinementPrompt(data) {
     const evidence = (data.scan_evidence || []).length > 0
         ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
@@ -1272,6 +1313,10 @@ async function main() {
     fs.writeFileSync(claudeMdPath, generateClaudeMd(data), 'utf8');
     console.log(`  ${pc.green('✓')} Generated ${pc.bold('CLAUDE.md')}`);
 
+    const agentsMdPath = path.join(targetDir, 'AGENTS.md');
+    fs.writeFileSync(agentsMdPath, generateAgentsMd(data), 'utf8');
+    console.log(`  ${pc.green('✓')} Generated ${pc.bold('AGENTS.md')}`);
+
     let aiRefinementPath = null;
     if (requestAiRefinement) {
         aiRefinementPath = path.join(targetDir, 'AI_CONTEXT_REFINEMENT.md');
@@ -1293,13 +1338,14 @@ ${autoSkills.map(s => '    · ' + s).join('\n')}
   ${pc.bold('Generated files:')}
     · ${pc.bold(projectContextPath)}
     · ${pc.bold(claudeMdPath)}
+    · ${pc.bold(agentsMdPath)}
 ${aiRefinementPath ? `    · ${pc.bold(aiRefinementPath)}` : ''}
 
   ${pc.bold('Next steps:')}
     1. Your kit is installed in ${pc.bold('./.agent')}
     2. Review ${pc.bold('PROJECT_CONTEXT.md')} first and add architecture notes
     3. ${aiRefinementPath ? `Open ${pc.bold('AI_CONTEXT_REFINEMENT.md')} in your AI editor to refine project context` : `Instruct the agent to read/update ${pc.bold('PROJECT_CONTEXT.md')} before major tasks`}
-    4. Open project in Antigravity or Claude Code — the agent will read context on start
+    4. Open project in Claude Code or Codex — the agent will read context on start
 `);
 }
 

package/kit/README.md

@@ -1,6 +1,6 @@
-# 🛡️ Antigravity Project Kit
-
-This toolkit helps you build high-quality, modular, and performance-optimized applications by leveraging the full power of AI Agents with a Context-First approach.
+# 🛡️ Cross-Platform Project Kit
+
+This toolkit helps you build high-quality, modular, and performance-optimized applications by leveraging AI agents with a context-first approach across Antigravity, Claude Code, and Codex-compatible editors.
 
 ---
 
@@ -11,10 +11,11 @@ This toolkit helps you build high-quality, modular, and performance-optimized ap
 - Update project metadata (e.g., `package.json`).
 - Rename and fill out `PROJECT_CONTEXT.template.md` as `PROJECT_CONTEXT.md` in the root directory.
 
-### 2. Working with AI Agents
-- Always use the templates provided in `kit/PROMPT_RECIPE.md`.
-- Ensure the Agent reads and updates `PROJECT_CONTEXT.md`.
-- Enforce file splitting rules (e.g., Max 250 lines) to maintain a clean codebase.
+### 2. Working with AI Agents
+- Always use the templates provided in `kit/PROMPT_RECIPE.md`.
+- Ensure the Agent reads and updates `PROJECT_CONTEXT.md`.
+- Use `CLAUDE.md` for Claude Code and `AGENTS.md` for Codex when generating project-specific entry files.
+- Enforce file splitting rules (e.g., Max 250 lines) to maintain a clean codebase.
 
 ### 3. Proposed Structure
 - `.agent/rules/GEMINI.md`: Core behavioral rules and protocols.
@@ -29,4 +30,4 @@ This toolkit helps you build high-quality, modular, and performance-optimized ap
 
 ---
 
-*Powered by Antigravity Framework.*
+*Powered by thachvd-kit.*

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.10",
+    "version": "1.0.11",
     "description": "Project context bootstrap kit for Antigravity, Claude Code, and Codex",
     "bin": {
         "thachvd-kit": "./bin/cli.js"

package/rules/GEMINI.md

@@ -21,7 +21,7 @@ trigger: always_on
 ```
 
 > All routing decisions below depend on PROJECT_CONTEXT.md.
-> Without it, ask user to run: `python scripts/init.py`
+> Without it, ask user to run: `thachvd-kit init`
 > Baseline context must be refined once when `context.needs_ai_refinement = true`.
 
 ---
@@ -203,7 +203,7 @@ scripts/    → scripts/init.py, checklist.py, verify_all.py
 | Platform | Rules File | Skills Dir | Workflows |
 |----------|-----------|-----------|-----------|
 | **Antigravity** | `rules/GEMINI.md` (this file) | `skills/` | `workflows/` |
-| **Claude Code** | `CLAUDE.md` at project root | `.claude/skills/` | `.claude/commands/` |
-| **Codex / OpenCode** | `CLAUDE.md` at project root | `.claude/skills/` | — |
-
-> Run `python scripts/init.py --platform all` to generate platform-specific config files automatically.
+| **Claude Code** | `CLAUDE.md` at project root | `.agent/skills/` | `.agent/workflows/` |
+| **Codex / OpenCode** | `AGENTS.md` at project root | `.agent/skills/` | `.agent/workflows/` |
+
+> Run `thachvd-kit init` to generate project context and platform entry files automatically.

package/scripts/init.py

@@ -3,10 +3,11 @@
 thachvd-kit — Project Init Wizard
 Generates PROJECT_CONTEXT.md and optional platform config files.
 
-Usage:
-    python scripts/init.py                    # Interactive wizard
-    python scripts/init.py --platform all    # Also generate CLAUDE.md
-    python scripts/init.py --platform claude  # Only CLAUDE.md
+Usage:
+    python scripts/init.py                    # Interactive wizard
+    python scripts/init.py --platform all    # Also generate CLAUDE.md + AGENTS.md
+    python scripts/init.py --platform claude  # Only CLAUDE.md
+    python scripts/init.py --platform codex   # Only AGENTS.md
 """
 
 import sys
@@ -695,14 +696,14 @@ Based on your stack, these skills will be loaded automatically:
 """
 
 def generate_claude_md(data):
-    """Generate CLAUDE.md for Claude Code / Codex compatibility."""
-    return f"""# CLAUDE.md — {data['project_name']}
-# Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
-# Cross-platform: Claude Code · Codex · OpenCode
-
-## Project
-{data['description']}
-Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
+    """Generate CLAUDE.md for Claude Code."""
+    return f"""# CLAUDE.md — {data['project_name']}
+# Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
+# Platform: Claude Code
+
+## Project
+{data['description']}
+Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
 
 ## Rules
 - Read PROJECT_CONTEXT.md first for stack details and agent routing.
@@ -726,6 +727,47 @@ Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
 See PROJECT_CONTEXT.md for full agent routing table.
 """
 
+def generate_agents_md(data):
+    """Generate AGENTS.md for Codex and AGENTS-compatible editors."""
+    return f"""# AGENTS.md — {data['project_name']}
+# Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
+# Platform: Codex / AGENTS-compatible editors
+
+## Project
+{data['description']}
+Stack: {data['primary_language']} | {', '.join(data.get('frameworks', [])) or 'no framework'}
+
+## Mandatory First Action
+- Read `PROJECT_CONTEXT.md` before making plans or code changes.
+- If `PROJECT_CONTEXT.md` is missing or stale, create/update it before major work.
+- If `context.needs_ai_refinement: true`, refine `PROJECT_CONTEXT.md` first, then set:
+  - `context.status: refined`
+  - `context.needs_ai_refinement: false`
+  - `context.last_refined_at: <today>`
+
+## Working Rules
+- Use `.agent/agents`, `.agent/skills`, `.agent/rules`, and `.agent/workflows` as the local project kit.
+- Match the task against the Agent Routing table in `PROJECT_CONTEXT.md`.
+- Load relevant skills before editing code.
+- Tests are mandatory. Verify before claiming done.
+- Keep files under {data.get('max_file_lines', '300')} lines when practical, then split into modules.
+- Update dependent files together when a change crosses boundaries.
+
+## Preferred Workflow
+- Plan work from `PROJECT_CONTEXT.md` first.
+- For feature work, use: `plan-writing` -> `executing-plans` -> `verification-before-completion`.
+- For reviews, use: `requesting-code-review` / `receiving-code-review`.
+- For debugging, use: `systematic-debugging`.
+
+## Key Paths
+- Project context: `PROJECT_CONTEXT.md`
+- Agent kit: `.agent/`
+- Skills: `.agent/skills/`
+- Workflows: `.agent/workflows/`
+
+See `PROJECT_CONTEXT.md` for stack details, routing, and auto-resolved skills.
+"""
+
 def generate_ai_context_refinement_prompt(data):
     scan_evidence = data.get("scan_evidence", [])
     evidence_block = "\n".join("- " + line for line in scan_evidence) if scan_evidence else "- No scan evidence was captured during init."
@@ -805,7 +847,7 @@ def format_scan_preview_lines(scanned):
 
 def main():
     parser = argparse.ArgumentParser(description="thachvd-kit project init wizard")
-    parser.add_argument("--platform", choices=["antigravity", "claude", "all"], default="antigravity",
+    parser.add_argument("--platform", choices=["antigravity", "claude", "codex", "all"], default="antigravity",
                         help="Which platform config to generate (default: antigravity)")
     parser.add_argument("--yes", "-y", action="store_true", help="Use defaults without prompting")
     parser.add_argument("--scan", action="store_true", help="Scan the current project to prefill or auto-generate PROJECT_CONTEXT.md")
@@ -956,11 +998,17 @@ def main():
     output_path.write_text(context_content, encoding="utf-8")
     print(f"  {green('✓')} {bold('PROJECT_CONTEXT.md')} generated")
 
-    # CLAUDE.md (for Claude Code / Codex)
+    # CLAUDE.md (for Claude Code)
     if args.platform in ("claude", "all"):
         claude_path = Path("CLAUDE.md")
         claude_path.write_text(generate_claude_md(data), encoding="utf-8")
-        print(f"  {green('✓')} {bold('CLAUDE.md')} generated (Claude Code / Codex)")
+        print(f"  {green('✓')} {bold('CLAUDE.md')} generated (Claude Code)")
+
+    # AGENTS.md (for Codex / AGENTS-compatible editors)
+    if args.platform in ("codex", "all"):
+        agents_path = Path("AGENTS.md")
+        agents_path.write_text(generate_agents_md(data), encoding="utf-8")
+        print(f"  {green('✓')} {bold('AGENTS.md')} generated (Codex)")
 
     ai_refine_path = None
     if data.get("needs_ai_refinement"):
@@ -983,6 +1031,7 @@ def main():
   {bold('Generated files:')}
     · {bold(str(output_path.resolve()))}
     · {bold(str(Path("CLAUDE.md").resolve())) if args.platform in ("claude", "all") else 'CLAUDE.md not generated for this platform'}
+    · {bold(str(Path("AGENTS.md").resolve())) if args.platform in ("codex", "all") else 'AGENTS.md not generated for this platform'}
     · {bold(str(ai_refine_path.resolve())) if ai_refine_path else 'AI_CONTEXT_REFINEMENT.md not generated'}
 
   {bold('Next steps:')}
@@ -991,7 +1040,7 @@ def main():
     3. Open project in your AI editor (Antigravity / Claude Code / Codex)
     4. The agent will read PROJECT_CONTEXT.md on session start
 
-{dim('  Tip: Run with --platform all to also generate CLAUDE.md')}
+{dim('  Tip: Run with --platform all to also generate CLAUDE.md and AGENTS.md')}
 """)
 
 if __name__ == "__main__":