thachvd-kit 1.0.6 → 1.0.7

package/README.md

@@ -18,6 +18,7 @@ npx github:thachvd/thachvd-kit init
 The interactive wizard will first ask whether this is a new project or an existing one.
 If it is an existing project, it can scan the current codebase to prefill `PROJECT_CONTEXT.md`, or let you enter everything manually.
 The scan mode uses evidence-based detectors and shows why a framework was inferred, so you can quickly confirm or correct it.
+After init, you can also generate an AI refinement prompt to let your editor/agent deepen the project context.
 
 ```bash
 thachvd-kit init --scan

package/bin/cli.js

@@ -842,9 +842,73 @@ Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ')}
 - \`/test\` — Run test suite
 - \`/deploy\` — Deploy checklist
 
-See PROJECT_CONTEXT.md for full agent routing table.
-`;
-}
+See PROJECT_CONTEXT.md for full agent routing table.
+`;
+}
+
+function generateAiContextRefinementPrompt(data) {
+    const evidence = (data.scan_evidence || []).length > 0
+        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
+        : '- No scan evidence was captured during init.';
+
+    return `# AI Context Refinement
+
+Use this prompt in your AI editor after \`thachvd-kit init\`.
+
+## Goal
+
+Refine \`PROJECT_CONTEXT.md\` so it reflects the real project more accurately than the baseline init scan.
+
+## Current Baseline
+
+- Project: ${data.project_name}
+- Type: ${data.project_type}
+- Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ') || 'no framework'}
+- Database: ${data.database || 'none'}
+- Infra: ${(data.infrastructure || []).join(', ') || 'none'}
+
+## Scan Evidence
+
+${evidence}
+
+## Instructions For The AI Agent
+
+1. Read \`PROJECT_CONTEXT.md\` first.
+2. Inspect the project selectively to improve factual accuracy.
+3. Prioritize:
+   - real database/config detection
+   - domain/capability inference
+   - architecture notes
+   - more accurate auto-resolved skills
+   - important project-specific constraints
+4. Update \`PROJECT_CONTEXT.md\` directly.
+5. Distinguish facts from inferences when uncertain.
+6. Do not implement product code in this pass. Only refine project context.
+
+## Suggested Files To Inspect
+
+- Root manifests: \`package.json\`, \`composer.json\`, \`Cargo.toml\`, \`pyproject.toml\`
+- Infrastructure/config: Docker, CI, env, framework config files
+- Database config and models
+- Main app entry points, routing, controllers/services
+- README and existing documentation
+
+## Desired Improvements
+
+- Correct the \`database\` field if config files reveal the real DB.
+- Add architecture notes that explain the actual structure.
+- Infer domain capabilities such as scraping, browser automation, external API integrations, queues, workers, etc.
+- Expand auto-resolved skills when there is clear evidence in the codebase.
+- Add caveats or assumptions if parts of the stack are still uncertain.
+
+## Completion Standard
+
+When done, summarize:
+- what was corrected
+- what is still inferred
+- which files provided the strongest evidence
+`;
+}
 
 // --- Main CLI ---
 
@@ -925,6 +989,7 @@ async function main() {
 
     const scanned = useScan ? scanProject() : null;
     let reviewScannedFields = !useScan;
+    let requestAiRefinement = false;
 
     if (useScan) {
         console.log(`${pc.bold('  Scan result:')} ${scanned.primary_language} | ${scanned.frameworks.join(', ') || 'no framework'}`);
@@ -1052,9 +1117,26 @@ async function main() {
     const claudeMdPath = path.join(targetDir, 'CLAUDE.md');
     fs.writeFileSync(claudeMdPath, generateClaudeMd(data), 'utf8');
     console.log(`  ${pc.green('✓')} Generated ${pc.bold('CLAUDE.md')}`);
-
-    // Summary
-    const autoSkills = resolveSkills(data);
+
+    if (!assumeYes) {
+        const aiRefineAnswer = await askQuestions({
+            type: 'confirm',
+            name: 'ai_refine',
+            message: 'Do you want an AI refinement prompt for PROJECT_CONTEXT.md?',
+            initial: useScan
+        });
+        requestAiRefinement = Boolean(aiRefineAnswer.ai_refine);
+    }
+
+    let aiRefinementPath = null;
+    if (requestAiRefinement) {
+        aiRefinementPath = path.join(targetDir, 'AI_CONTEXT_REFINEMENT.md');
+        fs.writeFileSync(aiRefinementPath, generateAiContextRefinementPrompt(data), 'utf8');
+        console.log(`  ${pc.green('✓')} Generated ${pc.bold('AI_CONTEXT_REFINEMENT.md')}`);
+    }
+
+    // Summary
+    const autoSkills = resolveSkills(data);
     console.log(`\n${pc.bold(pc.green('━━ Done! ━━'))}
   
   ${pc.bold('Project:')} ${data.project_name}
@@ -1067,11 +1149,12 @@ ${autoSkills.map(s => '    · ' + s).join('\n')}
   ${pc.bold('Generated files:')}
     · ${pc.bold(projectContextPath)}
     · ${pc.bold(claudeMdPath)}
+${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. Instruct the agent to read/update ${pc.bold('PROJECT_CONTEXT.md')} before major tasks
+    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
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.6",
+    "version": "1.0.7",
     "description": "Universal Agent Kit for Antigravity, Claude Code, and OpenCode",
     "bin": {
         "thachvd-kit": "./bin/cli.js"

package/scripts/init.py

@@ -607,7 +607,7 @@ Based on your stack, these skills will be loaded automatically:
 {data.get('known_issues', '<!-- Add known issues or pending tasks -->')}
 """
 
-def generate_claude_md(data):
+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.
@@ -636,8 +636,69 @@ Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
 - `/test` — Run test suite
 - `/deploy` — Deploy checklist
 
-See PROJECT_CONTEXT.md for full agent routing table.
-"""
+See PROJECT_CONTEXT.md for full agent routing table.
+"""
+
+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."
+    return f"""# AI Context Refinement
+
+Use this prompt in your AI editor after `thachvd-kit init`.
+
+## Goal
+
+Refine `PROJECT_CONTEXT.md` so it reflects the real project more accurately than the baseline init scan.
+
+## Current Baseline
+
+- Project: {data['project_name']}
+- Type: {data['project_type']}
+- Stack: {data['primary_language']} | {', '.join(data.get('frameworks', [])) or 'no framework'}
+- Database: {data.get('database', 'none')}
+- Infra: {', '.join(data.get('infrastructure', [])) or 'none'}
+
+## Scan Evidence
+
+{evidence_block}
+
+## Instructions For The AI Agent
+
+1. Read `PROJECT_CONTEXT.md` first.
+2. Inspect the project selectively to improve factual accuracy.
+3. Prioritize:
+   - real database/config detection
+   - domain/capability inference
+   - architecture notes
+   - more accurate auto-resolved skills
+   - important project-specific constraints
+4. Update `PROJECT_CONTEXT.md` directly.
+5. Distinguish facts from inferences when uncertain.
+6. Do not implement product code in this pass. Only refine project context.
+
+## Suggested Files To Inspect
+
+- Root manifests: `package.json`, `composer.json`, `Cargo.toml`, `pyproject.toml`
+- Infrastructure/config: Docker, CI, env, framework config files
+- Database config and models
+- Main app entry points, routing, controllers/services
+- README and existing documentation
+
+## Desired Improvements
+
+- Correct the `database` field if config files reveal the real DB.
+- Add architecture notes that explain the actual structure.
+- Infer domain capabilities such as scraping, browser automation, external API integrations, queues, workers, etc.
+- Expand auto-resolved skills when there is clear evidence in the codebase.
+- Add caveats or assumptions if parts of the stack are still uncertain.
+
+## Completion Standard
+
+When done, summarize:
+- what was corrected
+- what is still inferred
+- which files provided the strongest evidence
+"""
 
 # ─── Main wizard ─────────────────────────────────────────────────────────────
 
@@ -788,11 +849,17 @@ def main():
     # CLAUDE.md (for Claude Code / Codex)
     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)")
-
-    # Summary
-    auto_skills = resolve_skills(data)
+        claude_path.write_text(generate_claude_md(data), encoding="utf-8")
+        print(f"  {green('✓')} {bold('CLAUDE.md')} generated (Claude Code / Codex)")
+
+    ai_refine_path = None
+    if not args.yes and ask_bool("Generate AI context refinement prompt?", default=use_scan):
+        ai_refine_path = Path("AI_CONTEXT_REFINEMENT.md")
+        ai_refine_path.write_text(generate_ai_context_refinement_prompt(data), encoding="utf-8")
+        print(f"  {green('✓')} {bold('AI_CONTEXT_REFINEMENT.md')} generated")
+
+    # Summary
+    auto_skills = resolve_skills(data)
     print(f"""
 {bold(green('━━ Done! ━━'))}
 
@@ -806,10 +873,11 @@ 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(ai_refine_path.resolve())) if ai_refine_path else 'AI_CONTEXT_REFINEMENT.md not generated'}
 
   {bold('Next steps:')}
     1. Review {bold('PROJECT_CONTEXT.md')} first and add architecture notes
-    2. Instruct the agent to read/update {bold('PROJECT_CONTEXT.md')} before major tasks
+    2. {"Open " + bold("AI_CONTEXT_REFINEMENT.md") + " in your AI editor to refine project context" if ai_refine_path else "Instruct the agent to read/update " + bold("PROJECT_CONTEXT.md") + " before major tasks"}
     3. Open project in your AI editor (Antigravity / Claude Code / Codex)
     4. The agent will read PROJECT_CONTEXT.md on session start