@thanhthi2895/luna-ai 2.16.2

package/agentic/antigravity/.luna.json

@@ -0,0 +1,22 @@
+{
+  "plan": {
+    "namingFormat": "{date}-{feature-name}",
+    "validation": {
+      "requireBrief": true,
+      "requireResearch": true,
+      "requirePhases": true
+    },
+    "reportsDir": "reports"
+  },
+  "paths": {
+    "plans": "plans",
+    "docs": "docs"
+  },
+  "locale": {
+    "thinkingLanguage": "en",
+    "responseLanguage": "vi"
+  },
+  "project": {
+    "type": "auto"
+  }
+}

package/agentic/antigravity/README.md

@@ -0,0 +1,70 @@
+# Antigravity Profile (Luna AI)
+
+Self-contained Antigravity runtime profile for Luna AI.
+
+## Purpose
+
+This profile provides canonical Antigravity assets at `agentic/antigravity/.agents/` and syncs them to Gemini runtime locations.
+
+## Install
+
+```bash
+cp agentic/antigravity/.env.example agentic/antigravity/.env  # fill in API keys
+bash agentic/antigravity/install.sh
+```
+
+## Uninstall
+
+```bash
+bash agentic/antigravity/uninstall.sh              # remove everything
+bash agentic/antigravity/uninstall.sh --dry-run   # preview only
+```
+
+Removes all profile symlinks from `~/.gemini/`. Does **not** delete real files.
+
+
+## Sync
+
+```bash
+bash agentic/antigravity/scripts/sync.sh --force
+```
+
+## Verify
+
+```bash
+bash agentic/antigravity/scripts/sync.sh --status
+```
+
+## Sync Mapping
+
+- `agentic/antigravity/.agents/skills` → `~/.gemini/antigravity/skills`
+- `agentic/antigravity/.agents/rules` + `agentic/antigravity/.agents/agents` → `~/.gemini/antigravity/rules` (merged, `agent-*.md` prefix)
+- `agentic/antigravity/.agents/scripts` → `~/.agents/scripts`
+- `agentic/antigravity/.agents/GEMINI.md` → `~/.gemini/GEMINI.md`
+- `agentic/antigravity/.env` → `~/.gemini/antigravity/.env`
+
+## Directory Structure
+
+```text
+agentic/antigravity/
+├── .agents/
+│   ├── skills/
+│   ├── rules/
+│   ├── agents/
+│   ├── scripts/
+│   ├── templates/
+│   └── GEMINI.md
+├── .env                  ← 🔑 Central env vars (API keys, secrets) — gitignored
+├── .env.example          ← Template for .env (tracked in git)
+├── .luna.json
+├── scripts/sync.sh
+├── install.sh
+├── uninstall.sh
+├── GEMINI.md
+└── README.md
+```
+
+## Relationship to Claude Profile
+
+`agentic/antigravity/` and `agentic/claude/` are independent profiles.
+They have separate runtime targets and separate sync/install scripts.

package/agentic/antigravity/install.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# install.sh — Install Antigravity profile to ~/.gemini/ and ~/.agents/.
+#
+# Run once after copying agentic/antigravity/ to any location:
+#   bash agentic/antigravity/install.sh
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AGENTIC_SRC="$SCRIPT_DIR/.agents"
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; BLUE='\033[0;34m'; NC='\033[0m'
+
+echo -e "\n${BLUE}════════════════════════════════════════${NC}"
+echo -e "${GREEN}   Antigravity Profile Installer${NC}"
+echo -e "${BLUE}════════════════════════════════════════${NC}\n"
+echo "  Source : $AGENTIC_SRC"
+echo "  Target : $HOME/.gemini/antigravity/"
+echo "  Global : $HOME/.gemini/GEMINI.md"
+echo ""
+
+[ -d "$AGENTIC_SRC" ] || { echo -e "${RED}Error:${NC} .agents/ not found: $AGENTIC_SRC"; exit 1; }
+
+echo -e "${BLUE}[1/2] Syncing profile...${NC}"
+bash "$SCRIPT_DIR/scripts/sync.sh" --force
+echo ""
+
+# ── Step 2: Install luna-cli ──────────────────────────────────────────────────
+echo -e "${BLUE}[2/2] Installing luna-cli...${NC}"
+LUNA_CLI_DIR="$HOME/.luna/scripts/luna-cli"
+LUNA_BIN_SRC="$LUNA_CLI_DIR/bin/luna"
+LUNA_BIN_DST="$HOME/.local/bin/luna"
+
+# Chmod luna-cli.cjs and bin/luna
+if [ -f "$LUNA_CLI_DIR/luna-cli.cjs" ]; then
+  chmod +x "$LUNA_CLI_DIR/luna-cli.cjs"
+  echo -e "  ${GREEN}✓${NC} chmod +x luna-cli.cjs"
+else
+  echo -e "  ~ luna-cli.cjs not found at $LUNA_CLI_DIR (skipped)"
+fi
+
+if [ -f "$LUNA_BIN_SRC" ]; then
+  chmod +x "$LUNA_BIN_SRC"
+  echo -e "  ${GREEN}✓${NC} chmod +x bin/luna"
+
+  # Symlink bin/luna → ~/.local/bin/luna
+  mkdir -p "$(dirname "$LUNA_BIN_DST")"
+  if [ -L "$LUNA_BIN_DST" ] || [ -e "$LUNA_BIN_DST" ]; then
+    rm -f "$LUNA_BIN_DST"
+  fi
+  ln -s "$LUNA_BIN_SRC" "$LUNA_BIN_DST"
+  echo -e "  ${GREEN}✓${NC} luna → $LUNA_BIN_DST"
+
+  # Suggest PATH update if ~/.local/bin is not in PATH
+  if ! echo "$PATH" | grep -q "$HOME/.local/bin"; then
+    echo -e "  ${YELLOW}!${NC} Add ~/.local/bin to PATH:"
+    echo "      export PATH=\"\$HOME/.local/bin:\$PATH\""
+    echo "    Then reload your shell or run: source ~/.bashrc"
+  fi
+else
+  echo -e "  ~ bin/luna not found at $LUNA_BIN_SRC (skipped)"
+fi
+echo ""
+
+echo -e "${GREEN}════════════════════════════════════════${NC}"
+echo -e "${GREEN}  ✓ Done! Antigravity profile installed.${NC}"
+echo -e "${GREEN}════════════════════════════════════════${NC}\n"
+echo -e "${YELLOW}Verify:${NC}"
+echo "  bash agentic/antigravity/scripts/sync.sh --status"
+echo "  luna --help"
+echo ""
+echo -e "${YELLOW}Re-sync after edits:${NC}"
+echo "  bash agentic/antigravity/scripts/sync.sh --force"
+echo ""
+echo -e "${YELLOW}To uninstall:${NC}"
+echo "  bash agentic/antigravity/uninstall.sh"
+echo ""

package/agentic/antigravity/scripts/sync.sh

@@ -0,0 +1,194 @@
+#!/usr/bin/env bash
+# sync.sh — Sync Antigravity profile to ~/.gemini and ~/.agents.
+#
+# Usage:
+#   bash agentic/antigravity/scripts/sync.sh            # sync
+#   bash agentic/antigravity/scripts/sync.sh --status   # show status
+#   bash agentic/antigravity/scripts/sync.sh --force    # replace conflicts
+#   bash agentic/antigravity/scripts/sync.sh --dry-run  # preview only
+#   bash agentic/antigravity/scripts/sync.sh --unlink   # remove Luna symlinks
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROFILE_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+AGENTS_ROOT="$PROFILE_ROOT/.agents"
+
+SKILLS_SRC="$AGENTS_ROOT/skills"
+RULES_SRC="$AGENTS_ROOT/rules"
+SCRIPTS_SRC="$PROFILE_ROOT/../shared/scripts"
+GEMINI_SRC="$AGENTS_ROOT/GEMINI.md"
+ENV_SRC="$PROFILE_ROOT/.env"
+SET_ACTIVE_PLAN_SRC="$SCRIPTS_SRC/set-active-plan.cjs"
+
+GEMINI_HOME="$HOME/.gemini"
+ANTIGRAVITY_HOME="$GEMINI_HOME/antigravity"
+SET_ACTIVE_PLAN_DST="$ANTIGRAVITY_HOME/scripts/set-active-plan.cjs"
+RULES_DST="$ANTIGRAVITY_HOME/rules"
+
+SKILLS_DST="$ANTIGRAVITY_HOME/skills"
+GEMINI_DST="$GEMINI_HOME/GEMINI.md"
+ENV_DST="$ANTIGRAVITY_HOME/.env"
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; BLUE='\033[0;34m'; NC='\033[0m'
+log_ok()   { echo -e "  ${GREEN}✓${NC} $1"; }
+log_warn() { echo -e "  ${YELLOW}!${NC} $1"; }
+log_err()  { echo -e "  ${RED}✗${NC} $1"; }
+log_info() { echo -e "  ${BLUE}→${NC} $1"; }
+log_skip() { echo -e "  ~ $1"; }
+
+FORCE=false
+DRY_RUN=false
+STATUS=false
+UNLINK=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --force) FORCE=true ;;
+    --dry-run) DRY_RUN=true ;;
+    --status) STATUS=true ;;
+    --unlink) UNLINK=true ;;
+    --help|-h)
+      sed -n '3,10p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0
+      ;;
+    *)
+      echo "Unknown flag: $1. Use --help."
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+[ -d "$AGENTS_ROOT" ] || { echo -e "${RED}Error:${NC} Source not found: $AGENTS_ROOT"; exit 1; }
+
+is_linked_to_src() {
+  local dst="$1"
+  local expected_src="$2"
+  [ -L "$dst" ] || return 1
+  local resolved
+  resolved="$(readlink -f "$dst")"
+  [ "$resolved" = "$expected_src" ]
+}
+
+link_item() {
+  local src="$1"
+  local dst="$2"
+  local label="$3"
+
+  [ -e "$src" ] || { log_skip "$label (source not found, skip)"; return; }
+
+  if is_linked_to_src "$dst" "$src"; then
+    log_ok "$label (already synced)"
+    return
+  fi
+
+  if [ -e "$dst" ] || [ -L "$dst" ]; then
+    if ! $FORCE; then
+      log_skip "$label (conflict — use --force to replace)"
+      return
+    fi
+    if $DRY_RUN; then
+      log_info "$label → would replace"
+    else
+      if [[ "$BACKUP_CONFIRMED" == "y" ]]; then
+        local bak="$dst.bak-$(date +%Y%m%d-%H%M%S)"
+        mv "$dst" "$bak"
+        log_info "$label → replaced (backup: $(basename "$bak"))"
+      else
+        rm -rf "$dst"
+        log_info "$label → replaced (no backup)"
+      fi
+    fi
+  fi
+
+  if $DRY_RUN; then
+    log_info "$label → would link"
+  else
+    mkdir -p "$(dirname "$dst")"
+    ln -s "$src" "$dst"
+    log_ok "$label → linked"
+  fi
+}
+
+unlink_item() {
+  local src="$1"
+  local dst="$2"
+  local label="$3"
+
+  if is_linked_to_src "$dst" "$src"; then
+    if $DRY_RUN; then
+      log_info "$label [dry-run]"
+    else
+      rm "$dst"
+      log_ok "$label → unlinked"
+    fi
+  else
+    log_skip "$label (not a Luna symlink)"
+  fi
+}
+
+status_item() {
+  local src="$1"
+  local dst="$2"
+  local label="$3"
+
+  if is_linked_to_src "$dst" "$src"; then
+    log_ok "$label (synced)"
+  elif [ -L "$dst" ]; then
+    log_warn "$label → $(readlink "$dst") (external symlink)"
+  elif [ -e "$dst" ]; then
+    log_warn "$label (real file/dir — run --force to sync)"
+  else
+    log_err "$label (missing)"
+  fi
+}
+
+
+
+if $STATUS; then
+  echo -e "\n${BLUE}Antigravity Sync Status${NC}"
+  echo "  Source: $AGENTS_ROOT"
+  echo "  Target: $ANTIGRAVITY_HOME"
+  echo ""
+
+  status_item "$SKILLS_SRC" "$SKILLS_DST" "skills/"
+  status_item "$RULES_SRC" "$RULES_DST" "rules/"
+  status_item "$SET_ACTIVE_PLAN_SRC" "$SET_ACTIVE_PLAN_DST" "scripts/set-active-plan.cjs"
+  status_item "$GEMINI_SRC" "$GEMINI_DST" "GEMINI.md"
+  status_item "$ENV_SRC" "$ENV_DST" ".env"
+  echo ""
+  exit 0
+fi
+
+if $UNLINK; then
+  echo -e "\n${BLUE}Antigravity Unlink${NC}"
+  unlink_item "$SKILLS_SRC" "$SKILLS_DST" "skills/"
+  unlink_item "$RULES_SRC" "$RULES_DST" "rules/"
+  unlink_item "$SET_ACTIVE_PLAN_SRC" "$SET_ACTIVE_PLAN_DST" "scripts/set-active-plan.cjs"
+  unlink_item "$GEMINI_SRC" "$GEMINI_DST" "GEMINI.md"
+  unlink_item "$ENV_SRC" "$ENV_DST" ".env"
+  echo ""
+  exit 0
+fi
+
+DRY_TAG=$($DRY_RUN && echo " [DRY RUN]" || echo "")
+echo -e "\n${BLUE}Antigravity Sync${NC}${DRY_TAG}"
+echo "  Source: $AGENTS_ROOT"
+echo ""
+
+# Ask once: backup conflicts or not? (only when --force and not --dry-run)
+BACKUP_CONFIRMED="n"
+if $FORCE && ! $DRY_RUN; then
+  read -r -p "  $(echo -e "${YELLOW}?${NC}") Create .bak backups for existing files before replacing? [y/N] " BACKUP_CONFIRMED < /dev/tty || true
+  echo ""
+fi
+
+link_item "$SKILLS_SRC" "$SKILLS_DST" "skills/"
+link_item "$RULES_SRC" "$RULES_DST" "rules/"
+link_item "$SET_ACTIVE_PLAN_SRC" "$SET_ACTIVE_PLAN_DST" "scripts/set-active-plan.cjs"
+link_item "$GEMINI_SRC" "$GEMINI_DST" "GEMINI.md"
+link_item "$ENV_SRC" "$ENV_DST" ".env"
+
+echo ""
+echo -e "${GREEN}✓ Done.${NC} Run with --status to verify."
+echo ""

package/agentic/antigravity/uninstall.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# uninstall.sh — Remove Antigravity profile from ~/.gemini/ and ~/.agents/.
+#
+# Mirrors install.sh — undoes everything it set up:
+#   1. Removes all profile symlinks (skills, rules, scripts, GEMINI.md) via sync.sh --unlink
+#
+# Usage:
+#   bash agentic/antigravity/uninstall.sh
+#   bash agentic/antigravity/uninstall.sh --dry-run   # preview only, no changes
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SYNC_SH="$SCRIPT_DIR/scripts/sync.sh"
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; BLUE='\033[0;34m'; NC='\033[0m'
+
+# ── Flags ─────────────────────────────────────────────────────────────────────
+DRY_RUN=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dry-run) DRY_RUN=true ;;
+    --help|-h)
+      sed -n '3,9p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0 ;;
+    *) echo "Unknown flag: $1. Use --help."; exit 1 ;;
+  esac
+  shift
+done
+
+DRY_TAG=$($DRY_RUN && echo " [DRY RUN]" || echo "")
+
+echo -e "\n${BLUE}════════════════════════════════════════${NC}"
+echo -e "${RED}   Antigravity Profile Uninstaller${NC}${DRY_TAG}"
+echo -e "${BLUE}════════════════════════════════════════${NC}\n"
+echo "  Profile source : $SCRIPT_DIR/.agents"
+echo "  Target gemini  : $HOME/.gemini/antigravity/"
+echo "  Target rules   : $HOME/.gemini/antigravity/rules/"
+echo "  Target GEMINI  : $HOME/.gemini/GEMINI.md"
+echo ""
+
+[ -f "$SYNC_SH" ] || { echo -e "${RED}Error:${NC} sync.sh not found: $SYNC_SH"; exit 1; }
+
+# ── Step 1: Remove profile symlinks via sync.sh --unlink ──────────────────────
+echo -e "${BLUE}[1/1] Removing profile symlinks...${NC}"
+UNLINK_ARGS="--unlink"
+$DRY_RUN && UNLINK_ARGS="--unlink --dry-run"
+bash "$SYNC_SH" $UNLINK_ARGS
+echo ""
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo -e "${GREEN}════════════════════════════════════════${NC}"
+if $DRY_RUN; then
+  echo -e "${YELLOW}  ✓ Dry run complete — no changes made.${NC}"
+  echo -e "${YELLOW}  Run without --dry-run to apply.${NC}"
+else
+  echo -e "${GREEN}  ✓ Done! Antigravity profile uninstalled.${NC}"
+fi
+echo -e "${GREEN}════════════════════════════════════════${NC}\n"
+
+if ! $DRY_RUN; then
+  echo -e "${YELLOW}Verify:${NC}"
+  echo "  bash agentic/antigravity/scripts/sync.sh --status"
+  echo ""
+  echo -e "${YELLOW}To reinstall:${NC}"
+  echo "  bash agentic/antigravity/install.sh"
+  echo ""
+fi

package/agentic/claude/.claude/.claudeignore

@@ -0,0 +1,52 @@
+# Luna Agents Ignore
+# Blocks access to these paths via scout-block hook
+# Syntax: gitignore-style patterns
+
+# Dependencies
+node_modules/
+node_modules/**
+.venv/
+venv/
+vendor/
+
+# Build outputs
+dist/
+dist/**
+.next/
+.next/**
+build/
+build/**
+out/
+out/**
+__pycache__/
+*.pyc
+*.pyo
+
+# Cache & generated
+.turbo/
+.cache/
+coverage/
+.nyc_output/
+.parcel-cache/
+
+# Version control
+.git/
+.git/**
+
+# Logs
+*.log
+logs/
+
+# OS artifacts
+.DS_Store
+Thumbs.db
+
+# Secrets
+.env
+.env.*
+!.env.example
+*.local.json
+
+# Large binaries
+*.min.js
+*.min.css

package/agentic/claude/.claude/CLAUDE.md

@@ -0,0 +1,200 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Role & Responsibilities
+
+Your role is to analyze user requirements, delegate tasks to appropriate sub-agents, and ensure cohesive delivery of features that meet specifications and architectural standards.
+
+## Workflows
+
+- Primary workflow: `~/.claude/rules/primary-workflow.md`
+- Development rules: `~/.claude/rules/development-rules.md`
+- Orchestration protocols: `~/.claude/rules/orchestration-protocol.md`
+- Documentation management: `~/.claude/rules/documentation-management.md`
+- And other workflows: `~/.claude/rules/*`
+
+**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
+**IMPORTANT:** You must follow strictly the development rules in `~/.claude/rules/development-rules.md` file.
+**IMPORTANT:** Before you plan or proceed any implementation, always read the `./README.md` file first to get context.
+**IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
+**IMPORTANT:** In reports, list any unresolved questions at the end, if any.
+
+## How to Use Skills
+
+When a task matches a skill, you MUST invoke it using the `Skill` tool BEFORE proceeding.
+
+**Activation steps:**
+1. Identify which skill matches (check descriptions in the Skills Catalog below)
+2. If `Skill` tool is not yet loaded, call `ToolSearch` with `"select:Skill"` first
+3. Call `Skill` tool with the skill name
+
+**Trigger guide:**
+
+| User intent | Skill to invoke |
+|---|---|
+| Implement feature / "cook this" / end-to-end task | `lu:cook` |
+| Fix bug / error / "fix this" | `lu:fix` |
+| Debug / investigate root cause / trace call stack | `lu:debugger` |
+| Commit / push / PR / merge | `lu:git` |
+| Research codebase / gather context | `lu:research` |
+| Semantic code search / find code related to X / codebase index | `ccc` |
+| Quick file discovery / broad scouting | `lu:scout` |
+| React folder structure / Container-View / scaffold | `lu:react-structure` |
+| React performance / optimization / bundle | `lu:react-best-practices` |
+| UI/UX design / build page / component | `lu:ui-ux-pro-max` |
+| Update STRUCTURE.md / rebuild cache | `ccc search` first, then scan project with `find` for structure inventory |
+| Write/update docs | `lu:docs` |
+| Run full review before handoff | `lu:review` |
+| Archive completed plan | `lu:plan archive` |
+| True parallel agents / tasks hoàn toàn độc lập / KHÔNG cần codebase context | `lu:team` (requires opencode) |
+| Research codebase với nhiều góc độ / cần skills (ccc, etc.) | `lu:research` (KHÔNG dùng lu:team) |
+| ClickUp task / DEV-xxxx | `lu:clickup-task` |
+| Jira task / PROJ-xxxx / search jira | `lu:jira-task` |
+| Asana task / subtasks / comments / search asana | `lu:asana-task` |
+| Plan from brief/research | `lu:plan` |
+| Track project progress / update plan statuses | `lu:project-management` |
+| Brainstorm / architecture decision / trade-offs | `lu:brainstorm` |
+| Step-by-step reasoning / deep single-path analysis | `lu:sequential-thinking` |
+| Stuck / blocked after conventional approaches failed | `lu:problem-solving` |
+| Create git worktree / parallel dev branch | `lu:worktree` |
+| Run tests / coverage / QA report | `lu:test` |
+| Library docs / API reference lookup | `lu:docs-seeker` |
+| Browser automation / screenshot / scraping | `lu:chrome-devtools` |
+| Wrap up session / review recent changes | `lu:watzup` |
+| Find skill for a task / discover capabilities | `lu:find-skills` |
+| Create diagrams / flowcharts / architecture | `lu:mermaidjs-v11` |
+| View plans kanban board / progress dashboard | `lu:plans-kanban` |
+| Build backend API / Node.js / Python / Go | `lu:backend-development` |
+| Build frontend / React / TypeScript | `lu:frontend-development` |
+| Optimize context / token usage / agent design | `lu:context-engineering` |
+| Impact analysis / dependency graph / cascading risks | `lu:gkg` |
+| Onboard existing project / no docs / analyze codebase | `lu:onboard` |
+| Analyze images/audio/video / generate image or video | `lu:ai-multimodal` |
+| Generate AI art / image prompts / Nano Banana | `lu:ai-artist` |
+| Bootstrap new project / full project setup | `lu:bootstrap` |
+| Create new skill / extend Luna capabilities | `lu:create-skill` |
+
+Default code-discovery routing: start semantic search with `ccc search`; use `lu:scout` only for broad file discovery; run `ccc index` when index is stale or after major code changes (new files, refactors, module renames).
+
+**Skill boundary clarification:**
+- `lu:brainstorm` = explore 2+ approaches with trade-offs (before deciding)
+- `lu:sequential-thinking` = deep single-path chain of reasoning (after deciding)
+- `lu:problem-solving` = stuck/blocked after conventional approaches failed
+- `lu:debugger` = investigation only, no code changes
+- `lu:fix` = full pipeline (debug investigation + implementation)
+- `lu:team` = TRUE parallel via opencode subprocesses — chỉ dùng khi tasks hoàn toàn độc lập (không cần ccc/skills/codebase context). Khi cần codebase research → dùng `lu:research` thay thế.
+
+## Hook Response Protocol
+
+### Privacy Block Hook (`@@PRIVACY_PROMPT@@`)
+
+When a tool call is blocked by the privacy-block hook, the output contains a JSON marker between `@@PRIVACY_PROMPT_START@@` and `@@PRIVACY_PROMPT_END@@`. **You MUST use the `AskUserQuestion` tool** to get proper user approval.
+
+**Required Flow:**
+
+1. Parse the JSON from the hook output
+2. Use `AskUserQuestion` with the question data from the JSON
+3. Based on user's selection:
+   - **"Yes, approve access"** → Use `bash cat "filepath"` to read the file (bash is auto-approved)
+   - **"No, skip this file"** → Continue without accessing the file
+
+**Example AskUserQuestion call:**
+
+```json
+{
+  "questions": [
+    {
+      "question": "I need to read \".env\" which may contain sensitive data. Do you approve?",
+      "header": "File Access",
+      "options": [
+        {
+          "label": "Yes, approve access",
+          "description": "Allow reading .env this time"
+        },
+        {
+          "label": "No, skip this file",
+          "description": "Continue without accessing this file"
+        }
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+```
+
+**IMPORTANT:** Always ask the user via `AskUserQuestion` first. Never try to work around the privacy block without explicit user approval.
+
+## Python Scripts (Skills)
+
+When running Python scripts from skills, use the venv Python interpreter:
+
+- **Linux/macOS:** `~/.claude/skills/.venv/bin/python3 scripts/xxx.py`
+- **Windows:** `%USERPROFILE%\.claude\skills\.venv\Scripts\python.exe scripts\xxx.py`
+
+This ensures packages installed by `install.sh` (google-genai, pypdf, etc.) are available.
+
+**IMPORTANT:** When scripts of skills failed, don't stop, try to fix them directly.
+
+## [IMPORTANT] Consider Modularization
+
+- If a code file exceeds 200 lines of code, consider modularizing it
+- Check existing modules before creating new
+- Analyze logical separation boundaries (functions, classes, concerns)
+- Use kebab-case naming with long descriptive names, it's fine if the file name is long because this ensures file names are self-documenting for LLM tools (Grep, Glob, Search)
+- Write descriptive code comments
+- After modularization, continue with main task
+- When not to modularize: Markdown files, plain text files, bash scripts, configuration files, environment variables files, etc.
+
+## Documentation Management
+
+We keep all important docs in `./docs` folder and keep updating them, structure like below:
+
+```
+./docs
+├── project-overview-pdr.md
+├── code-standards.md
+├── codebase-summary.md
+└── system-architecture.md
+```
+
+## 🧰 Skills Catalog (39 Skills)
+
+- **Core**: `lu:research`, `lu:gkg`, `ccc`
+- **Planning**: `lu:plan`, `lu:project-management`
+- **Execution**: `lu:react-structure`, `lu:react-best-practices`, `lu:onboard`, `lu:bootstrap`, `lu:backend-development`, `lu:frontend-development`
+- **Review & Archive**: `lu:review` (`lu:plan archive` for archiving)
+- **Utility**: `lu:git`, `lu:ui-ux-pro-max`, `lu:watzup`, `lu:find-skills`, `lu:create-skill`
+- **Luna Skills**: `lu:cook`, `lu:fix`, `lu:debugger`, `lu:scout`, `lu:docs`, `lu:team`, `lu:clickup-task`, `lu:jira-task`, `lu:asana-task`
+- **Problem & Analysis**: `lu:brainstorm`, `lu:sequential-thinking`, `lu:problem-solving`, `lu:context-engineering`
+- **Dev Tools**: `lu:worktree`, `lu:test`, `lu:docs-seeker`, `lu:chrome-devtools`, `lu:ai-multimodal`, `lu:ai-artist`, `lu:mermaidjs-v11`, `lu:plans-kanban`
+
+> _(internal)_ = called automatically by other skills, not triggered directly by user intent.
+
+**Agent-Only Roles** (no skill file — spawn via `Task(subagent_type: "...")` only):
+- `code-simplifier` — simplify code after implementation, before review
+- `fullstack-developer` — dev teammate in `/team cook` workflows
+- `project-manager` — plan sync-back and status tracking in finalize phase
+- `docs-manager` — update `./docs` after major changes
+- `git-manager` — commit/PR automation in finalize phase
+- `brainstormer` — standalone brainstorm/debate agent (also available as `lu:brainstorm` skill)
+- `ui-ux-designer` — UI/UX implementation agent (also available as `lu:ui-ux-pro-max` skill)
+
+**IMPORTANT:** _MUST READ_ and _MUST COMPLY_ all _INSTRUCTIONS_ in project `./CLAUDE.md`, especially _WORKFLOWS_ section is _CRITICALLY IMPORTANT_, this rule is _MANDATORY. NON-NEGOTIABLE. NO EXCEPTIONS. MUST REMEMBER AT ALL TIMES!!!_
+
+## Key Paths (Claude-native)
+
+| Path | Purpose |
+|---|---|
+| `.claude/skills/` | 42 skill definitions (Claude-native source) |
+| `.claude/agents/` | Agent role definitions |
+| `.claude/hooks/` | Hook scripts |
+| `.claude/rules/` | Rule files |
+
+## Development Notes
+
+- Hooks use CommonJS (.cjs), fail-open (always process.exit(0))
+- Skills: edit SKILL.md directly in `.claude/skills/`, no build step needed
+- Rule changes: edit `.claude/rules/` directly
+- After editing `~/.claude/CLAUDE.md`, run your install/sync flow to republish runtime assets to `~/.claude/`
+- `~/.claude/` is Antigravity-only — do NOT mix