thachvd-kit 1.0.0 → 1.0.1

package/scripts/init.py

@@ -9,11 +9,12 @@ Usage:
     python scripts/init.py --platform claude  # Only CLAUDE.md
 """
 
-import sys
-import os
-import argparse
-from pathlib import Path
-from datetime import datetime
+import sys
+import os
+import argparse
+import json
+from pathlib import Path
+from datetime import datetime
 
 # ─── Color helpers ──────────────────────────────────────────────────────────
 
@@ -53,13 +54,17 @@ def ask_multi(prompt, choices, default=None):
             selected.append(part)  # allow free-text
     return selected
 
-def ask_bool(prompt, default=True):
+def ask_bool(prompt, default=True):
     """Yes/no prompt."""
     default_str = "Y/n" if default else "y/N"
     val = input(f"  {bold('→')} {prompt} [{dim(default_str)}]: ").strip().lower()
-    if not val:
-        return default
-    return val.startswith("y")
+    if not val:
+        return default
+    return val.startswith("y")
+
+def ask_select(prompt, choices, default=None):
+    default = default or choices[0]
+    return ask(prompt, default=default, choices=choices)
 
 def section(title):
     print(f"\n{bold(cyan('━━ ' + title + ' '))}")
@@ -79,10 +84,10 @@ LANG_SKILLS = {
     "csharp":     ["api-design"],
 }
 
-FRAMEWORK_SKILLS = {
-    "vue":           ["frontend-design", "tailwind-patterns"],
-    "react":         ["nextjs-react-expert", "frontend-design"],
-    "next":          ["nextjs-react-expert", "frontend-design"],
+FRAMEWORK_SKILLS = {
+    "vue":           ["frontend-design", "tailwind-patterns"],
+    "react":         ["react-frontend", "frontend-design"],
+    "next":          ["nextjs-react-expert", "frontend-design"],
     "nuxt":          ["frontend-design"],
     "svelte":        ["frontend-design"],
     "laravel":       ["laravel-patterns", "laravel-security", "laravel-tdd"],
@@ -91,12 +96,12 @@ FRAMEWORK_SKILLS = {
     "django":        ["python-patterns", "api-design"],
     "gin":           ["golang-patterns", "golang-testing"],
     "fiber":         ["golang-patterns", "golang-testing"],
-    "tauri":         ["rust-pro", "mobile-design"],
-    "flutter":       ["mobile-design"],
-    "react-native":  ["mobile-design"],
-}
+    "tauri":         ["rust-pro", "desktop-design"],
+    "flutter":       ["mobile-design"],
+    "react-native":  ["mobile-design"],
+}
 
-INFRA_SKILLS = {
+INFRA_SKILLS = {
     "docker": ["docker-patterns"],
     "aws":    ["deployment-procedures", "docker-patterns"],
     "gcp":    ["deployment-procedures", "docker-patterns"],
@@ -120,7 +125,157 @@ def resolve_skills(data):
             if key in infra_lower:
                 skills.update(vals)
     skills.update(["clean-code", "systematic-debugging"])
-    return sorted(skills)
+    return sorted(skills)
+
+FRAMEWORKS_ALL = ["vue", "react", "next", "nuxt", "svelte", "angular",
+                  "laravel", "express", "fastapi", "django", "gin", "fiber", "nestjs",
+                  "tauri", "flutter", "react-native"]
+LANGUAGES_ALL = ["typescript", "javascript", "python", "go", "php", "rust", "java", "swift", "kotlin", "csharp", "c", "cpp"]
+PROJECT_TYPES_ALL = ["web-app", "api", "mobile", "desktop", "cli", "library", "fullstack"]
+DATABASES_ALL = ["postgres", "mysql", "sqlite", "mongodb", "redis", "dynamodb", "supabase", "prisma", "none"]
+PACKAGE_MANAGERS_ALL = ["npm", "pnpm", "yarn", "bun", "pip", "uv", "poetry", "go mod", "cargo", "composer", "auto-detect"]
+TEST_FRAMEWORKS_ALL = ["jest", "vitest", "pytest", "go test", "phpunit", "pest", "rspec", "junit", "auto-detect"]
+CLOUDS_ALL = ["aws", "gcp", "azure", "vercel", "fly", "railway", "digitalocean", "none"]
+
+def read_text_if_exists(*parts):
+    path = Path.cwd().joinpath(*parts)
+    try:
+        return path.read_text(encoding="utf-8") if path.exists() else ""
+    except Exception:
+        return ""
+
+def read_json_if_exists(*parts):
+    path = Path.cwd().joinpath(*parts)
+    try:
+        return json.loads(path.read_text(encoding="utf-8")) if path.exists() else None
+    except Exception:
+        return None
+
+def detect_package_manager():
+    cwd = Path.cwd()
+    if (cwd / "pnpm-lock.yaml").exists(): return "pnpm"
+    if (cwd / "yarn.lock").exists(): return "yarn"
+    if (cwd / "bun.lockb").exists() or (cwd / "bun.lock").exists(): return "bun"
+    if (cwd / "package-lock.json").exists(): return "npm"
+    if (cwd / "uv.lock").exists(): return "uv"
+    if (cwd / "poetry.lock").exists(): return "poetry"
+    if (cwd / "requirements.txt").exists() or (cwd / "pyproject.toml").exists(): return "pip"
+    if (cwd / "go.mod").exists(): return "go mod"
+    if (cwd / "Cargo.toml").exists(): return "cargo"
+    if (cwd / "composer.json").exists(): return "composer"
+    return "auto-detect"
+
+def uniq(values):
+    return list(dict.fromkeys(v for v in values if v))
+
+def scan_project():
+    pkg = read_json_if_exists("package.json") or {}
+    deps = {}
+    for key in ("dependencies", "devDependencies", "peerDependencies"):
+        deps.update(pkg.get(key, {}) or {})
+    dep_names = set(deps.keys())
+    frameworks = []
+    infrastructure = []
+    primary_language = ""
+    project_type = ""
+    database = "none"
+    test_framework = "auto-detect"
+    cloud = "none"
+    ci_cd = "none"
+
+    def add_framework(name, condition):
+        if condition:
+            frameworks.append(name)
+
+    requirements = read_text_if_exists("requirements.txt")
+    go_mod = read_text_if_exists("go.mod")
+    pubspec = read_text_if_exists("pubspec.yaml")
+
+    add_framework("next", "next" in dep_names)
+    add_framework("react", "react" in dep_names)
+    add_framework("vue", "vue" in dep_names)
+    add_framework("nuxt", "nuxt" in dep_names)
+    add_framework("svelte", "svelte" in dep_names or "@sveltejs/kit" in dep_names)
+    add_framework("angular", "@angular/core" in dep_names)
+    add_framework("express", "express" in dep_names)
+    add_framework("nestjs", "@nestjs/core" in dep_names)
+    add_framework("fastapi", "fastapi" in requirements.lower())
+    add_framework("django", "django" in requirements.lower())
+    add_framework("tauri", "@tauri-apps/api" in dep_names or Path("src-tauri/tauri.conf.json").exists() or Path("src-tauri/tauri.conf.json5").exists())
+    add_framework("flutter", "flutter:" in pubspec.lower())
+    add_framework("react-native", "react-native" in dep_names or "expo" in dep_names)
+    add_framework("laravel", Path("artisan").exists())
+    add_framework("gin", "github.com/gin-gonic/gin" in go_mod.lower())
+    add_framework("fiber", "github.com/gofiber/fiber" in go_mod.lower())
+
+    if Path("tsconfig.json").exists() or "typescript" in dep_names: primary_language = "typescript"
+    elif Path("Cargo.toml").exists() or Path("src-tauri/Cargo.toml").exists(): primary_language = "rust"
+    elif Path("go.mod").exists(): primary_language = "go"
+    elif Path("requirements.txt").exists() or Path("pyproject.toml").exists(): primary_language = "python"
+    elif Path("composer.json").exists(): primary_language = "php"
+    elif dep_names or Path("package.json").exists(): primary_language = "javascript"
+
+    if "tauri" in frameworks: project_type = "desktop"
+    elif "flutter" in frameworks or "react-native" in frameworks: project_type = "mobile"
+    elif any(f in frameworks for f in ["express", "fastapi", "django", "laravel", "gin", "fiber", "nestjs"]):
+        project_type = "fullstack" if any(f in frameworks for f in ["react", "next", "vue", "nuxt", "svelte", "angular"]) else "api"
+    elif any(f in frameworks for f in ["react", "next", "vue", "nuxt", "svelte", "angular"]):
+        project_type = "web-app"
+    elif Path("package.json").exists() and pkg.get("bin"):
+        project_type = "cli"
+
+    if "pg" in dep_names or "postgres" in dep_names or "@prisma/client" in dep_names or "postgres" in json.dumps(pkg).lower(): database = "postgres"
+    elif "mysql" in dep_names or "mysql2" in dep_names: database = "mysql"
+    elif "sqlite3" in dep_names or "better-sqlite3" in dep_names or "rusqlite" in dep_names: database = "sqlite"
+    elif "mongodb" in dep_names or "mongoose" in dep_names: database = "mongodb"
+    elif "redis" in dep_names or "ioredis" in dep_names: database = "redis"
+    elif "@aws-sdk/client-dynamodb" in dep_names: database = "dynamodb"
+
+    if "vitest" in dep_names: test_framework = "vitest"
+    elif "jest" in dep_names: test_framework = "jest"
+    elif "pytest" in dep_names or "pytest" in requirements.lower(): test_framework = "pytest"
+    elif "phpunit" in dep_names: test_framework = "phpunit"
+    elif "pest" in dep_names: test_framework = "pest"
+    elif Path("go.mod").exists(): test_framework = "go test"
+
+    if Path("Dockerfile").exists() or Path("docker-compose.yml").exists() or Path("docker-compose.yaml").exists():
+        infrastructure.append("docker")
+
+    if Path("vercel.json").exists():
+        cloud = "vercel"
+        infrastructure.append("vercel")
+    elif Path("fly.toml").exists():
+        cloud = "fly"
+        infrastructure.append("fly")
+    elif Path("railway.json").exists() or Path("railway.toml").exists():
+        cloud = "railway"
+        infrastructure.append("railway")
+
+    if Path(".github/workflows").exists(): ci_cd = "github-actions"
+    elif Path(".gitlab-ci.yml").exists(): ci_cd = "gitlab-ci"
+    elif Path(".circleci/config.yml").exists(): ci_cd = "circleci"
+    elif Path("Jenkinsfile").exists(): ci_cd = "jenkins"
+
+    return {
+        "project_name": Path.cwd().name,
+        "description": pkg.get("description", "A software project"),
+        "project_type": project_type if project_type in PROJECT_TYPES_ALL else "web-app",
+        "primary_language": primary_language if primary_language in LANGUAGES_ALL else "typescript",
+        "frameworks": uniq(frameworks),
+        "database": database if database in DATABASES_ALL else "none",
+        "package_manager": detect_package_manager(),
+        "uses_docker": "docker" in infrastructure,
+        "cloud": cloud,
+        "infrastructure": uniq(infrastructure),
+        "ci_cd": ci_cd,
+        "test_framework": test_framework if test_framework in TEST_FRAMEWORKS_ALL else "auto-detect",
+        "max_file_lines": "300",
+        "code_style": "project-standard",
+        "architecture_notes": "<!-- Add notes -->",
+        "current_phase": "Initial setup",
+        "next_phase": "—",
+        "known_issues": "<!-- None yet -->",
+    }
 
 def resolve_agent_table(data):
     rows = []
@@ -252,11 +407,12 @@ def generate_claude_md(data):
 {data['description']}
 Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
 
-## Rules
-- Read PROJECT_CONTEXT.md first for stack details and agent routing.
-- Follow skills in .claude/skills/ (or skills/ if using Antigravity).
-- Tests are mandatory. Verify before claiming done.
-- Max {data.get('max_file_lines', '300')} lines per file.
+## Rules
+- Read PROJECT_CONTEXT.md first for stack details and agent routing.
+- If PROJECT_CONTEXT.md is missing or stale, create/update it before major work.
+- Follow skills in .claude/skills/ (or skills/ if using Antigravity).
+- Tests are mandatory. Verify before claiming done.
+- Max {data.get('max_file_lines', '300')} lines per file.
 
 ## Key Skills
 - Plan: `plan-writing` → `executing-plans`
@@ -275,19 +431,20 @@ See PROJECT_CONTEXT.md for full agent routing table.
 
 # ─── Main wizard ─────────────────────────────────────────────────────────────
 
-def main():
-    parser = argparse.ArgumentParser(description="thachvd-kit project init wizard")
-    parser.add_argument("--platform", choices=["antigravity", "claude", "all"], default="antigravity",
-                        help="Which platform config to generate (default: antigravity)")
-    parser.add_argument("--yes", "-y", action="store_true", help="Use defaults without prompting")
-    args = parser.parse_args()
+def main():
+    parser = argparse.ArgumentParser(description="thachvd-kit project init wizard")
+    parser.add_argument("--platform", choices=["antigravity", "claude", "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")
+    args = parser.parse_args()
 
     print(f"""
-{bold(cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))}
-  {bold('thachvd-kit')} — Project Init Wizard
-  Generates PROJECT_CONTEXT.md for smart agent routing
-{bold(cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))}
-""")
+{bold(cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))}
+  {bold('thachvd-kit')} — Project Init Wizard
+  Generates PROJECT_CONTEXT.md for smart agent routing{' (scan-assisted)' if args.scan else ''}
+{bold(cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))}
+""")
 
     # Check if PROJECT_CONTEXT.md already exists
     output_path = Path("PROJECT_CONTEXT.md")
@@ -297,85 +454,118 @@ def main():
             print(f"\n  {yellow('Aborted.')} Existing PROJECT_CONTEXT.md unchanged.\n")
             sys.exit(0)
 
-    data = {}
-
-    # ── Project Info ──────────────────────────────────────────────────────
-    section("Project Info")
-    data["project_name"] = ask("Project name", default=Path.cwd().name)
-    data["description"]  = ask("Short description", default="A software project")
-    data["project_type"] = ask("Project type",
-        default="web-app",
-        choices=["web-app", "api", "mobile", "desktop", "cli", "library", "fullstack"])
-
-    # ── Tech Stack ────────────────────────────────────────────────────────
-    section("Tech Stack")
-
-    LANGUAGES = ["typescript", "javascript", "python", "go", "php", "rust", "java", "swift", "kotlin", "csharp", "c", "cpp"]
-    data["primary_language"] = ask("Primary language",
-        default="typescript",
-        choices=LANGUAGES)
-
-    FRAMEWORKS = ["vue", "react", "next", "nuxt", "svelte", "angular",
-                  "laravel", "express", "fastapi", "django", "gin", "fiber", "nestjs",
-                  "tauri", "flutter", "react-native",
-                  "none"]
-    frameworks = ask_multi("Frameworks (select all that apply)", FRAMEWORKS, default=None)
-    data["frameworks"] = frameworks or []
-
-    DATABASES = ["postgres", "mysql", "sqlite", "mongodb", "redis", "dynamodb", "supabase", "prisma", "none"]
-    data["database"] = ask("Database / ORM", default="postgres", choices=DATABASES)
-
-    PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun", "pip", "uv", "poetry", "go mod", "cargo", "composer", "auto-detect"]
-    data["package_manager"] = ask("Package manager", default="auto-detect", choices=PACKAGE_MANAGERS)
-
-    # ── Infrastructure ────────────────────────────────────────────────────
-    section("Infrastructure")
-
-    data["uses_docker"] = ask_bool("Uses Docker / Docker Compose?", default=True)
-    CLOUDS = ["aws", "gcp", "azure", "vercel", "fly", "railway", "digitalocean", "none"]
-    cloud = ask("Cloud provider", default="none", choices=CLOUDS)
-    data["cloud"] = cloud
-
-    infrastructure = []
-    if data["uses_docker"]: infrastructure.append("docker")
-    if cloud != "none": infrastructure.append(cloud)
-    data["infrastructure"] = infrastructure
-
-    CI_CD = ["github-actions", "gitlab-ci", "circleci", "jenkins", "none"]
-    data["ci_cd"] = ask("CI/CD", default="github-actions", choices=CI_CD)
-
-    # ── Testing ───────────────────────────────────────────────────────────
-    section("Testing")
-
-    TEST_FRAMEWORKS = ["jest", "vitest", "pytest", "go test", "phpunit", "pest", "rspec", "junit", "auto-detect"]
-    data["test_framework"] = ask("Test framework", default="auto-detect", choices=TEST_FRAMEWORKS)
-
-    # ── Conventions ───────────────────────────────────────────────────────
-    section("Coding Conventions")
-
-    data["max_file_lines"] = ask("Max lines per file before splitting", default="300")
-    data["code_style"]     = ask("Code style / linter", default="project-standard",
-        choices=["eslint", "prettier", "ruff", "gofmt", "pint", "standard", "project-standard"])
-
-    # ── Optional fields ───────────────────────────────────────────────────
-    section("Architecture (Optional — press Enter to skip)")
-
-    data["architecture_notes"] = ask("Key architecture notes", default="<!-- Add notes -->")
-    data["current_phase"]      = ask("Current phase", default="Initial setup")
-    data["next_phase"]         = ask("Next planned phase", default="—")
-    data["known_issues"]       = ask("Known issues / tasks", default="<!-- None yet -->")
-
-    # ── Generate files ────────────────────────────────────────────────────
-    section("Generating Files")
+    use_scan = args.scan
+    if not args.scan and not args.yes:
+        section("Setup Mode")
+        project_setup = ask_select("Project already exists or are you starting fresh",
+            ["existing", "new"], default="existing")
+        if project_setup == "existing":
+            existing_mode = ask_select("How should thachvd-kit build PROJECT_CONTEXT.md",
+                ["scan", "manual"], default="scan")
+            use_scan = existing_mode == "scan"
+
+    scanned = scan_project() if use_scan else None
+    if use_scan:
+        print(f"  {dim('Scan mode: detecting stack from current project files...')}")
+        print(f"  {bold('Scan result:')} {scanned['primary_language']} | {', '.join(scanned['frameworks']) or 'no framework'}")
+        print(f"  {bold('Detected infra:')} {', '.join(scanned['infrastructure']) or 'none'}\n")
+    elif not args.yes:
+        print(f"  {dim('Manual mode: asking for project context explicitly.')}\n")
+
+    if args.yes and scanned:
+        data = dict(scanned)
+    else:
+        data = {}
+
+    if not args.yes:
+        # ── Project Info ──────────────────────────────────────────────────────
+        section("Project Info")
+        data["project_name"] = ask("Project name", default=(scanned or {}).get("project_name", Path.cwd().name))
+        data["description"]  = ask("Short description", default=(scanned or {}).get("description", "A software project"))
+        data["project_type"] = ask("Project type",
+            default=(scanned or {}).get("project_type", "web-app"),
+            choices=PROJECT_TYPES_ALL)
+
+        # ── Tech Stack ────────────────────────────────────────────────────────
+        section("Tech Stack")
+
+        data["primary_language"] = ask("Primary language",
+            default=(scanned or {}).get("primary_language", "typescript"),
+            choices=LANGUAGES_ALL)
+
+        frameworks = ask_multi("Frameworks (select all that apply)", FRAMEWORKS_ALL, default=", ".join((scanned or {}).get("frameworks", [])) or None)
+        data["frameworks"] = frameworks or []
+
+        data["database"] = ask("Database / ORM", default=(scanned or {}).get("database", "postgres"), choices=DATABASES_ALL)
+
+        data["package_manager"] = ask("Package manager", default=(scanned or {}).get("package_manager", "auto-detect"), choices=PACKAGE_MANAGERS_ALL)
+
+        # ── Infrastructure ────────────────────────────────────────────────────
+        section("Infrastructure")
+
+        data["uses_docker"] = ask_bool("Uses Docker / Docker Compose?", default=(scanned or {}).get("uses_docker", True))
+        cloud = ask("Cloud provider", default=(scanned or {}).get("cloud", "none"), choices=CLOUDS_ALL)
+        data["cloud"] = cloud
+
+        infrastructure = []
+        if data["uses_docker"]: infrastructure.append("docker")
+        if cloud != "none": infrastructure.append(cloud)
+        data["infrastructure"] = infrastructure
+
+        CI_CD = ["github-actions", "gitlab-ci", "circleci", "jenkins", "none"]
+        data["ci_cd"] = ask("CI/CD", default=(scanned or {}).get("ci_cd", "github-actions"), choices=CI_CD)
+
+        # ── Testing ───────────────────────────────────────────────────────────
+        section("Testing")
+
+        data["test_framework"] = ask("Test framework", default=(scanned or {}).get("test_framework", "auto-detect"), choices=TEST_FRAMEWORKS_ALL)
+
+        # ── Conventions ───────────────────────────────────────────────────────
+        section("Coding Conventions")
+
+        data["max_file_lines"] = ask("Max lines per file before splitting", default=(scanned or {}).get("max_file_lines", "300"))
+        data["code_style"]     = ask("Code style / linter", default=(scanned or {}).get("code_style", "project-standard"),
+            choices=["eslint", "prettier", "ruff", "gofmt", "pint", "standard", "project-standard"])
+
+        # ── Optional fields ───────────────────────────────────────────────────
+        section("Architecture (Optional — press Enter to skip)")
+
+        data["architecture_notes"] = ask("Key architecture notes", default=(scanned or {}).get("architecture_notes", "<!-- Add notes -->"))
+        data["current_phase"]      = ask("Current phase", default=(scanned or {}).get("current_phase", "Initial setup"))
+        data["next_phase"]         = ask("Next planned phase", default=(scanned or {}).get("next_phase", "—"))
+        data["known_issues"]       = ask("Known issues / tasks", default=(scanned or {}).get("known_issues", "<!-- None yet -->"))
+
+    data["project_name"] = data.get("project_name", (scanned or {}).get("project_name", Path.cwd().name))
+    data["description"] = data.get("description", (scanned or {}).get("description", "A software project"))
+    data["project_type"] = data.get("project_type", (scanned or {}).get("project_type", "web-app"))
+    data["primary_language"] = data.get("primary_language", (scanned or {}).get("primary_language", "typescript"))
+    data["frameworks"] = data.get("frameworks", (scanned or {}).get("frameworks", []))
+    data["database"] = data.get("database", (scanned or {}).get("database", "none"))
+    data["package_manager"] = data.get("package_manager", (scanned or {}).get("package_manager", "auto-detect"))
+    data["uses_docker"] = data.get("uses_docker", (scanned or {}).get("uses_docker", True))
+    data["cloud"] = data.get("cloud", (scanned or {}).get("cloud", "none"))
+    data["test_framework"] = data.get("test_framework", (scanned or {}).get("test_framework", "auto-detect"))
+    data["max_file_lines"] = data.get("max_file_lines", (scanned or {}).get("max_file_lines", "300"))
+    data["code_style"] = data.get("code_style", (scanned or {}).get("code_style", "project-standard"))
+    data["architecture_notes"] = data.get("architecture_notes", (scanned or {}).get("architecture_notes", "<!-- Add notes -->"))
+    data["current_phase"] = data.get("current_phase", (scanned or {}).get("current_phase", "Initial setup"))
+    data["next_phase"] = data.get("next_phase", (scanned or {}).get("next_phase", "—"))
+    data["known_issues"] = data.get("known_issues", (scanned or {}).get("known_issues", "<!-- None yet -->"))
+    data["infrastructure"] = []
+    if data["uses_docker"]: data["infrastructure"].append("docker")
+    if data["cloud"] != "none": data["infrastructure"].append(data["cloud"])
+
+    # ── Generate files ────────────────────────────────────────────────────
+    section("Generating Files")
 
     # PROJECT_CONTEXT.md (always)
-    context_content = generate_project_context(data)
-    output_path.write_text(context_content, encoding="utf-8")
-    print(f"  {green('✓')} {bold('PROJECT_CONTEXT.md')} generated")
-
-    # CLAUDE.md (for Claude Code / Codex)
-    if args.platform in ("claude", "all"):
-        claude_path = Path("CLAUDE.md")
+    context_content = generate_project_context(data)
+    output_path.write_text(context_content, encoding="utf-8")
+    print(f"  {green('✓')} {bold('PROJECT_CONTEXT.md')} generated")
+
+    # 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)")
 
@@ -388,16 +578,21 @@ def main():
   {bold('Stack:')}   {data['primary_language']} | {', '.join(data['frameworks']) or 'no framework'}
   {bold('Infra:')}   {', '.join(data['infrastructure']) or 'none'}
 
-  {bold('Auto-resolved skills:')}
-{chr(10).join(f'    · {s}' for s in auto_skills)}
-
-  {bold('Next steps:')}
-    1. Review {bold('PROJECT_CONTEXT.md')} and add architecture notes
-    2. Open project in your AI editor (Antigravity / Claude Code / Codex)
-    3. The agent will read PROJECT_CONTEXT.md on session start
-
-{dim('  Tip: Run with --platform all to also generate CLAUDE.md')}
-""")
+  {bold('Auto-resolved skills:')}
+{chr(10).join(f'    · {s}' for s in auto_skills)}
+
+  {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('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
+    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')}
+""")
 
 if __name__ == "__main__":
     main()

package/skills/desktop-design/SKILL.md

@@ -0,0 +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

package/skills/react-frontend/SKILL.md

@@ -0,0 +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

package/.shared/ui-ux-pro-max/data/charts.csv

@@ -1,26 +0,0 @@
-No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
-1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
-2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
-3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
-4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
-5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
-6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
-7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
-8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
-9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
-10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
-11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
-12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
-13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
-14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
-15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
-16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
-17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
-18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
-19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
-20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
-21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
-22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
-23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS, SciChart,Real-time + Pause
-24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
-25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click