invar-tools 1.12.0__py3-none-any.whl → 1.15.0__py3-none-any.whl

invar/shell/commands/init.py

@@ -16,13 +16,14 @@ from rich.console import Console
 from rich.panel import Panel
 
 from invar.core.sync_helpers import VALID_LANGUAGES, SyncConfig
-from invar.shell.claude_hooks import install_claude_hooks
+from invar.shell.claude_hooks import add_feedback_config, install_claude_hooks
 from invar.shell.commands.template_sync import sync_templates
 from invar.shell.mcp_config import (
     generate_mcp_json,
     get_recommended_method,
 )
 from invar.shell.pi_hooks import install_pi_hooks
+from invar.shell.pi_tools import install_pi_tools
 from invar.shell.templates import (
     add_config,
     create_directories,
@@ -60,6 +61,7 @@ FILE_CATEGORIES: dict[str, list[tuple[str, str]]] = {
         ("CLAUDE.md", "Agent instructions (Pi compatible)"),
         (".claude/skills/", "Workflow automation (Pi compatible)"),
         (".pi/hooks/", "Pi-specific hooks"),
+        (".pi/tools/", "Pi custom tools (invar_guard, invar_sig, invar_map)"),
     ],
 }
 
@@ -153,29 +155,43 @@ def _get_prompt_style():
 
 # @shell_complexity: Interactive prompt with cursor selection
 def _prompt_agent_selection() -> list[str]:
-    """Prompt user to select code agent using cursor navigation."""
+    """Prompt user to select agent(s) using checkbox (DX-81: multi-agent support)."""
     import questionary
 
-    console.print("\n[bold]Select code agent:[/bold]")
-    console.print("[dim]Use arrow keys to move, enter to select[/dim]\n")
+    console.print("\n[bold]Select agent(s) to configure:[/bold]")
+    console.print("[dim]Space to toggle, Enter to confirm (can select multiple)[/dim]\n")
 
     choices = [
-        questionary.Choice("Claude Code (recommended)", value="claude"),
-        questionary.Choice("Pi Coding Agent", value="pi"),
-        questionary.Choice("Other (AGENT.md)", value="generic"),
+        questionary.Choice(
+            "Claude Code (recommended)",
+            value="claude",
+            checked=True  # Default selection
+        ),
+        questionary.Choice(
+            "Pi Coding Agent",
+            value="pi",
+            checked=False
+        ),
+        questionary.Choice(
+            "Other (AGENT.md)",
+            value="generic",
+            checked=False
+        ),
     ]
 
-    selected = questionary.select(
+    selected = questionary.checkbox(
         "",
         choices=choices,
         instruction="",
         style=_get_prompt_style(),
     ).ask()
 
-    # Handle Ctrl+C
+    # Handle Ctrl+C or empty selection
     if not selected:
-        return ["claude"]  # Default to Claude Code
-    return [selected]
+        console.print("[yellow]No agents selected, using Claude Code as default.[/yellow]")
+        return ["claude"]
+
+    return selected
 
 
 # @shell_complexity: Interactive file selection with cursor navigation
@@ -205,9 +221,10 @@ def _prompt_file_selection(agents: list[str]) -> dict[str, bool]:
     console.print()
     console.print("[dim]Use arrow keys to move, space to toggle, enter to confirm[/dim]\n")
 
-    # Build choices with categories as separators
+    # Build choices with categories as separators (DX-81: deduplicate shared files)
     choices: list[questionary.Choice | questionary.Separator] = []
     file_list: list[str] = []
+    seen_files: set[str] = set()
 
     for category, files in available.items():
         if category == "required":
@@ -217,12 +234,19 @@ def _prompt_file_selection(agents: list[str]) -> dict[str, bool]:
             category_name = "Claude Code"
         elif category == "pi":
             category_name = "Pi Coding Agent"
-        choices.append(questionary.Separator(f"── {category_name} ──"))
-        for file, desc in files:
-            choices.append(
-                questionary.Choice(f"{file:28} {desc}", value=file, checked=True)
-            )
-            file_list.append(file)
+
+        # Filter out files already seen (shared between categories)
+        unique_files = [(f, d) for f, d in files if f not in seen_files]
+
+        # Only add separator if there are unique files to show
+        if unique_files:
+            choices.append(questionary.Separator(f"── {category_name} ──"))
+            for file, desc in unique_files:
+                choices.append(
+                    questionary.Choice(f"{file:28} {desc}", value=file, checked=True)
+                )
+                file_list.append(file)
+                seen_files.add(file)
 
     selected = questionary.checkbox(
         "Select files to install:",
@@ -239,6 +263,40 @@ def _prompt_file_selection(agents: list[str]) -> dict[str, bool]:
     return {f: f in selected for f in file_list}
 
 
+# @shell_complexity: Interactive consent prompt for feedback collection
+def _prompt_feedback_consent() -> bool:
+    """
+    Prompt user for consent to enable automatic feedback collection.
+
+    DX-79 Phase C: Opt-out consent flow (default: enabled).
+
+    Returns:
+        True if user consents (or accepts default), False otherwise
+    """
+    from rich import print as rprint
+    from rich.prompt import Confirm
+
+    rprint()
+    rprint("[bold]━" * 40)
+    rprint("[bold]📊 Usage Feedback (Optional)")
+    rprint("[bold]━" * 40)
+    rprint()
+    rprint("Invar can automatically reflect on tool usage to help improve")
+    rprint("the framework. Feedback is:")
+    rprint("  • Stored locally in [cyan].invar/feedback/[/cyan]")
+    rprint("  • Never sent automatically")
+    rprint("  • You decide what (if anything) to share")
+    rprint()
+
+    # Opt-out: default is True (Y)
+    consent = Confirm.ask(
+        "Enable automatic feedback collection?",
+        default=True,
+    )
+
+    return consent
+
+
 def _show_execution_output(
     created: list[str],
     merged: list[str],
@@ -356,10 +414,7 @@ def init(
     """
     from invar import __version__
 
-    # Mutual exclusivity check
-    if claude and pi:
-        console.print("[red]Error:[/red] Cannot use --claude and --pi together.")
-        raise typer.Exit(1)
+    # DX-81: Multi-agent support - removed mutual exclusivity check
 
     if mcp_only and (claude or pi):
         console.print("[red]Error:[/red] --mcp-only cannot be combined with --claude or --pi.")
@@ -424,8 +479,10 @@ def init(
             console.print(f"[red]Error:[/red] Invalid language '{language}'. Must be one of: {valid}")
             raise typer.Exit(1)
 
-    # Header
-    if claude:
+    # Header (DX-81: Support multi-agent display)
+    if claude and pi:
+        console.print(f"\n[bold]Invar v{__version__} - Quick Setup (Claude Code + Pi)[/bold]")
+    elif claude:
         console.print(f"\n[bold]Invar v{__version__} - Quick Setup (Claude Code)[/bold]")
     elif pi:
         console.print(f"\n[bold]Invar v{__version__} - Quick Setup (Pi)[/bold]")
@@ -434,21 +491,32 @@ def init(
     console.print("=" * 45)
     console.print(f"[dim]Language: {language} | Existing files will be MERGED.[/dim]")
 
-    # Determine agents and files
-    if claude:
-        # Quick mode: Claude Code defaults
-        agents = ["claude"]
+    # DX-81: Determine agents and files (multi-agent support)
+    if claude or pi:
+        # Quick mode: Build agent list from flags
+        agents = []
+        if claude:
+            agents.append("claude")
+        if pi:
+            agents.append("pi")
+
+        # Build selected_files from all agents' categories
         selected_files: dict[str, bool] = {}
-        for category in ["optional", "claude"]:
-            for file, _ in FILE_CATEGORIES.get(category, []):
-                selected_files[file] = True
-    elif pi:
-        # Quick mode: Pi defaults
-        agents = ["pi"]
-        selected_files = {}
-        for category in ["optional", "pi"]:
+        for agent in agents:
+            category = AGENT_CONFIGS[agent]["category"]
             for file, _ in FILE_CATEGORIES.get(category, []):
                 selected_files[file] = True
+
+        # Add optional files
+        for file, _ in FILE_CATEGORIES["optional"]:
+            selected_files[file] = True
+
+        # DX-79: Default feedback enabled for quick mode
+        feedback_enabled = True
+        if len(agents) > 1:
+            console.print(f"\n[dim]📊 Configuring for {len(agents)} agents: {', '.join(agents)}[/dim]")
+        console.print("\n[dim]📊 Feedback collection enabled by default (stored locally in .invar/feedback/)[/dim]")
+        console.print("[dim]   To disable: Set feedback.enabled=false in .claude/settings.local.json[/dim]")
     else:
         # Interactive mode
         if not _is_interactive():
@@ -457,6 +525,8 @@ def init(
 
         agents = _prompt_agent_selection()
         selected_files = _prompt_file_selection(agents)
+        # DX-79: Prompt for feedback consent (opt-out, default: enabled)
+        feedback_enabled = _prompt_feedback_consent()
 
     # Preview mode
     if preview:
@@ -554,6 +624,16 @@ def init(
     if "pi" in agents and selected_files.get(".pi/hooks/", True):
         install_pi_hooks(path, console)
 
+    # Install Pi custom tools if selected
+    if "pi" in agents and selected_files.get(".pi/tools/", True):
+        install_pi_tools(path, console)
+
+    # Add feedback configuration (DX-79 Phase C)
+    if "claude" in agents or "pi" in agents:
+        feedback_result = add_feedback_config(path, feedback_enabled, console)
+        if isinstance(feedback_result, Failure):
+            console.print(f"[yellow]Warning:[/yellow] {feedback_result.failure()}")
+
     # Create MCP setup guide
     mcp_setup = invar_dir / "mcp-setup.md"
     if not mcp_setup.exists():
@@ -572,7 +652,7 @@ def init(
     # Completion message
     console.print(f"\n[bold green]✓ Initialized Invar v{__version__}[/bold green]")
 
-    # Show agent-specific tips
+    # Show agent-specific tips (DX-81: show all relevant tips)
     if "claude" in agents:
         console.print()
         console.print(
@@ -583,7 +663,7 @@ def init(
                 border_style="dim",
             )
         )
-    elif "pi" in agents:
+    if "pi" in agents:
         console.print()
         console.print(
             Panel(

invar/shell/pi_tools.py

@@ -0,0 +1,120 @@
+"""
+Pi Coding Agent custom tools for Invar.
+
+Provides Invar CLI commands as Pi custom tools for better LLM integration.
+"""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from returns.result import Failure, Result, Success
+
+if TYPE_CHECKING:
+    from rich.console import Console
+
+# Pi tools directory
+PI_TOOLS_DIR = ".pi/tools/invar"
+
+
+def get_pi_tools_template_path() -> Path:
+    """Get the path to Pi tools template."""
+    return Path(__file__).parent.parent / "templates" / "pi-tools" / "invar"
+
+
+def install_pi_tools(
+    project_path: Path,
+    console: Console,
+) -> Result[list[str], str]:
+    """
+    Install Pi custom tools for Invar.
+
+    Creates .pi/tools/invar/index.ts with:
+    - invar_guard: Wrapper for invar guard command
+    - invar_sig: Wrapper for invar sig command
+    - invar_map: Wrapper for invar map command
+    """
+    tools_dir = project_path / PI_TOOLS_DIR
+    tools_dir.mkdir(parents=True, exist_ok=True)
+
+    console.print("\n[bold]Installing Pi custom tools...[/bold]")
+    console.print("  Tools provide:")
+    console.print("    ✓ invar_guard - Smart verification (static + doctests + symbolic)")
+    console.print("    ✓ invar_sig - Show function signatures and contracts")
+    console.print("    ✓ invar_map - Symbol map with reference counts")
+    console.print("")
+
+    template_path = get_pi_tools_template_path()
+    tool_file = template_path / "index.ts"
+
+    if not tool_file.exists():
+        return Failure(f"Template not found: {tool_file}")
+
+    try:
+        # Copy the template file
+        dest_file = tools_dir / "index.ts"
+        shutil.copy2(tool_file, dest_file)
+
+        console.print(f"  [green]Created[/green] {PI_TOOLS_DIR}/index.ts")
+        console.print("\n  [bold green]✓ Pi custom tools installed[/bold green]")
+        console.print("  [dim]Pi will auto-discover tools in .pi/tools/[/dim]")
+        console.print("  [yellow]⚠ Restart Pi session for tools to take effect[/yellow]")
+
+        return Success(["index.ts"])
+    except Exception as e:
+        return Failure(f"Failed to install Pi tools: {e}")
+
+
+def remove_pi_tools(
+    project_path: Path,
+    console: Console,
+) -> Result[None, str]:
+    """Remove Pi custom tools."""
+    tools_dir = project_path / PI_TOOLS_DIR
+    tool_file = tools_dir / "index.ts"
+
+    if tool_file.exists():
+        tool_file.unlink()
+        console.print(f"  [red]Removed[/red] {PI_TOOLS_DIR}/index.ts")
+
+        # Remove directory if empty
+        try:
+            tools_dir.rmdir()
+            console.print(f"  [red]Removed[/red] {PI_TOOLS_DIR}/")
+        except OSError:
+            pass  # Directory not empty, keep it
+
+        console.print("[bold green]✓ Pi custom tools removed[/bold green]")
+    else:
+        console.print("[dim]No Pi custom tools installed[/dim]")
+
+    return Success(None)
+
+
+def pi_tools_status(
+    project_path: Path,
+    console: Console,
+) -> Result[dict[str, str], str]:
+    """Check status of Pi custom tools."""
+    tools_dir = project_path / PI_TOOLS_DIR
+    tool_file = tools_dir / "index.ts"
+
+    status: dict[str, str] = {}
+
+    if not tool_file.exists():
+        console.print("[dim]No Pi custom tools installed[/dim]")
+        return Success({"status": "not_installed"})
+
+    status["status"] = "installed"
+
+    # Try to check file size (basic validation)
+    try:
+        size = tool_file.stat().st_size
+        status["size"] = f"{size} bytes"
+        console.print(f"[green]✓ Pi custom tools installed[/green] ({size} bytes)")
+    except OSError:
+        console.print("[green]✓ Pi custom tools installed[/green]")
+
+    return Success(status)

invar/templates/claude-md/universal/tool-selection.md

@@ -0,0 +1,110 @@
+### Document Tools (DX-76)
+
+| I want to... | Use |
+|--------------|-----|
+| View document structure | `{% if syntax == "mcp" %}invar_doc_toc(file="<file>"){% else %}invar doc toc <file> [--format text]{% endif %}` |
+| Read specific section | `{% if syntax == "mcp" %}invar_doc_read(file="<file>", section="<section>"){% else %}invar doc read <file> <section>{% endif %}` |
+| Search sections by title | `{% if syntax == "mcp" %}invar_doc_find(file="<file>", pattern="<pattern>"){% else %}invar doc find <pattern> <files...>{% endif %}` |
+| Replace section content | `{% if syntax == "mcp" %}invar_doc_replace(file="<file>", section="<section>"){% else %}invar doc replace <file> <section>{% endif %}` |
+| Insert new section | `{% if syntax == "mcp" %}invar_doc_insert(file="<file>", anchor="<anchor>"){% else %}invar doc insert <file> <anchor>{% endif %}` |
+| Delete section | `{% if syntax == "mcp" %}invar_doc_delete(file="<file>", section="<section>"){% else %}invar doc delete <file> <section>{% endif %}` |
+
+**Section addressing:** slug path (`requirements/auth`), fuzzy (`auth`), index (`#0/#1`), line (`@48`)
+
+## Tool Selection
+
+### Calling Methods (Priority Order)
+
+Invar tools can be called in 3 ways. **Try in order:**
+
+1. **MCP tools** (Claude Code with MCP enabled)
+   - Direct function calls: `invar_guard()`, `invar_sig()`, etc.
+   - No Bash wrapper needed
+
+2. **CLI command** (if `invar` installed in PATH)
+   - Via Bash: `invar guard`, `invar sig`, etc.
+   - Install: `pip install invar-tools`
+
+3. **uvx fallback** (always available, no install needed)
+   - Via Bash: `uvx invar-tools guard`, `uvx invar-tools sig`, etc.
+
+---
+
+### Parameter Reference
+
+**guard** - Verify code quality
+```{% if syntax == "mcp" %}python
+# MCP
+invar_guard()                    # Check changed files (default)
+invar_guard(changed=False)       # Check all files{% else %}bash
+# CLI
+invar guard                      # Check changed files (default)
+invar guard --all                # Check all files{% endif %}
+```
+
+**sig** - Show function signatures and contracts
+```{% if syntax == "mcp" %}python
+# MCP
+invar_sig(target="src/foo.py"){% else %}bash
+# CLI
+invar sig src/foo.py
+invar sig src/foo.py::function_name{% endif %}
+```
+
+**map** - Find entry points
+```{% if syntax == "mcp" %}python
+# MCP
+invar_map(path=".", top=10){% else %}bash
+# CLI
+invar map [path] --top 10{% endif %}
+```
+
+**refs** - Find all references to a symbol
+```{% if syntax == "mcp" %}python
+# MCP
+invar_refs(target="src/foo.py::MyClass"){% else %}bash
+# CLI
+invar refs src/foo.py::MyClass{% endif %}
+```
+
+**doc*** - Document tools
+```{% if syntax == "mcp" %}python
+# MCP
+invar_doc_toc(file="docs/spec.md")
+invar_doc_read(file="docs/spec.md", section="intro"){% else %}bash
+# CLI
+invar doc toc docs/spec.md
+invar doc read docs/spec.md intro{% endif %}
+```
+
+---
+
+### Quick Examples
+
+```{% if syntax == "mcp" %}python
+# Verify after changes (all three methods identical)
+invar_guard()                        # MCP
+bash("invar guard")                  # CLI
+bash("uvx invar-tools guard")        # uvx
+
+# Full project check
+invar_guard(changed=False)           # MCP
+bash("invar guard --all")            # CLI
+
+# See function contracts
+invar_sig(target="src/core/parser.py")
+bash("invar sig src/core/parser.py"){% else %}bash
+# Verify after changes (all three methods identical)
+invar guard                          # CLI
+uvx invar-tools guard                # uvx
+
+# Full project check
+invar guard --all                    # CLI
+uvx invar-tools guard --all          # uvx
+
+# See function contracts
+invar sig src/core/parser.py
+uvx invar-tools sig src/core/parser.py{% endif %}
+```
+
+**Note**: All three methods now have identical default behavior.

invar/templates/config/CLAUDE.md.jinja

@@ -23,6 +23,8 @@
 {% include "claude-md/typescript/quick-reference.md" %}
 {% endif %}
 
+{% include "claude-md/universal/tool-selection.md" %}
+
 {% include "claude-md/universal/workflow.md" %}
 
 ---

invar/templates/hooks/UserPromptSubmit.sh.jinja

@@ -2,6 +2,7 @@
 # Invar UserPromptSubmit Hook
 # Protocol: v{{ protocol_version }} | Generated: {{ generated_date }}
 # DX-57: Protocol refresh with full INVAR.md injection
+# DX-79: Automatic feedback trigger via message count
 
 USER_MESSAGE="$1"
 
@@ -82,3 +83,33 @@ if [[ $COUNT -ge 25 && $((COUNT % 10)) -eq 0 ]]; then
 INVAR_EOF
   echo "</system-reminder>"
 fi
+
+# ============================================
+# DX-79: Feedback trigger at threshold
+# ============================================
+
+# Read feedback configuration
+FEEDBACK_ENABLED=true
+MIN_MESSAGES=30
+
+if [[ -f ".claude/settings.local.json" ]]; then
+  # Try to parse with jq if available, otherwise use defaults
+  if command -v jq &> /dev/null; then
+    FEEDBACK_ENABLED=$(jq -r '.feedback.enabled // true' .claude/settings.local.json 2>/dev/null)
+    MIN_MESSAGES=$(jq -r '.feedback.min_messages // 30' .claude/settings.local.json 2>/dev/null)
+  fi
+fi
+
+# Trigger feedback prompt at threshold
+if [[ "$FEEDBACK_ENABLED" == "true" && $COUNT -eq $MIN_MESSAGES ]]; then
+  echo "<system-reminder>"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "📊 Invar: Auto-triggering usage feedback ($COUNT messages)"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Session has reached $COUNT messages. Consider running /invar-reflect"
+  echo "to generate usage feedback."
+  echo ""
+  echo "To disable: Set feedback.enabled=false in .claude/settings.local.json"
+  echo "</system-reminder>"
+fi

invar/templates/hooks/pi/invar.ts.jinja

@@ -2,13 +2,16 @@
  * Invar Pi Hook
  * Protocol: v{{ protocol_version }} | Generated: {{ generated_date }}
  * LX-04: Full feature parity with Claude Code hooks
+ * DX-79: Automatic feedback trigger via message count
  *
  * Features:
  * - pytest/crosshair blocking via tool_call
  * - Protocol injection via pi.send() for long conversations
+ * - Automatic /invar-reflect trigger at message threshold
  */
 
 import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
+import * as fs from "fs";
 
 // Blocked commands (same as Claude Code)
 {% if language == "python" -%}
@@ -22,6 +25,21 @@ const ALLOWED_FLAGS = [/--inspect/, /--coverage/, /--debug/];
 // Protocol content for injection (escaped for JS)
 const INVAR_PROTOCOL = `{{ invar_protocol_escaped }}`;
 
+// DX-79: Helper to read feedback configuration
+function readFeedbackConfig() {
+  try {
+    const settingsPath = ".claude/settings.local.json";
+    const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    return {
+      enabled: settings.feedback?.enabled ?? true,
+      min_messages: settings.feedback?.min_messages ?? 30,
+    };
+  } catch {
+    // File doesn't exist or other error, use defaults
+  }
+  return { enabled: true, min_messages: 30 };
+}
+
 export default function (pi: HookAPI) {
   let msgCount = 0;
 
@@ -53,6 +71,21 @@ export default function (pi: HookAPI) {
       pi.send(`<system-reminder>
 === Protocol Refresh (message ${msgCount}) ===
 ${INVAR_PROTOCOL}
+</system-reminder>`);
+    }
+
+    // DX-79: Feedback trigger at threshold
+    const feedbackConfig = readFeedbackConfig();
+    if (msgCount === feedbackConfig.min_messages && feedbackConfig.enabled) {
+      pi.send(`<system-reminder>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Invar: Auto-triggering usage feedback (${msgCount} messages)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Session has reached ${msgCount} messages. Consider running /invar-reflect
+to generate usage feedback.
+
+To disable: Set feedback.enabled=false in .claude/settings.local.json
 </system-reminder>`);
     }
   });
@@ -62,7 +95,8 @@ ${INVAR_PROTOCOL}
   // ============================================
   pi.on("tool_call", async (event) => {
     if (event.toolName !== "bash") return;
-    const cmd = ((event.input as Record<string, unknown>).command as string || "").trim();
+    const input = event.input as Record<string, unknown>;
+    const cmd = (typeof input?.command === "string" ? input.command : "").trim();
 
     // Skip if not a blocked command
     if (!BLOCKED_CMDS.some((p) => p.test(cmd))) return;

invar/templates/manifest.toml

@@ -64,6 +64,11 @@ extensions = { action = "preserve" }
 ".claude/skills/propose/SKILL.md" = { src = "skills/propose/SKILL.md.jinja", type = "jinja" }
 ".claude/skills/review/SKILL.md" = { src = "skills/review/SKILL.md.jinja", type = "jinja" }
 
+# DX-79: Invar usage feedback skill
+".claude/skills/invar-reflect/SKILL.md" = { src = "skills/invar-reflect/SKILL.md", type = "copy" }
+".claude/skills/invar-reflect/template.md" = { src = "skills/invar-reflect/template.md", type = "copy" }
+".claude/skills/invar-reflect/CONFIG.md" = { src = "skills/invar-reflect/CONFIG.md", type = "copy" }
+
 # Commands (Jinja2 templates for language-specific content)
 ".claude/commands/audit.md" = { src = "commands/audit.md.jinja", type = "jinja" }
 ".claude/commands/guard.md" = { src = "commands/guard.md", type = "copy" }
@@ -136,4 +141,7 @@ create_only = [
     ".pre-commit-config.yaml",
     ".claude/commands/audit.md",
     ".claude/commands/guard.md",
+    ".claude/skills/invar-reflect/SKILL.md",
+    ".claude/skills/invar-reflect/template.md",
+    ".claude/skills/invar-reflect/CONFIG.md",
 ]