thachvd-kit 1.0.0 → 1.0.2

package/rules/GEMINI.md

@@ -53,7 +53,7 @@ trigger: always_on
 | Web frontend (any framework) | `frontend-specialist` | `frontend-design` + framework skill from PROJECT_CONTEXT |
 | Backend API (any language) | `backend-specialist` | language skill + `api-design` |
 | Database / Schema | `database-architect` | `database-design` |
-| Mobile / Desktop (Tauri, RN, Flutter) | `mobile-developer` | `mobile-design` |
+| Mobile / Desktop (Tauri, RN, Flutter) | `mobile-developer` | platform skill from PROJECT_CONTEXT |
 | DevOps / Cloud / CI | `devops-engineer` | `docker-patterns`, `deployment-procedures` |
 | Security audit | `security-auditor` | `vulnerability-scanner` |
 | Debug / RCA | `debugger` | `systematic-debugging` |
@@ -65,12 +65,14 @@ trigger: always_on
 | Framework/Language | Load Skill |
 |-------------------|-----------|
 | Vue | `frontend-design` (+ Vue-specific if available) |
-| React / Next.js | `nextjs-react-expert` |
+| React | `react-frontend` |
+| Next.js | `nextjs-react-expert` |
 | Laravel | `laravel-patterns` + `laravel-security` |
 | Node.js | `nodejs-best-practices` |
 | Python | `python-patterns` |
 | Go | `golang-patterns` |
-| Rust / Tauri | `rust-pro` |
+| Rust | `rust-pro` |
+| Tauri | `desktop-design` + `rust-pro` |
 | Docker | `docker-patterns` |
 
 > If stack not in mapping → use agent's general skill set + `clean-code`.

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