feat: explore skill (claude only)

[vidimitrov]

Summary

Introduces context-search — a Claude Code Skill that searches the Buildforce context repository for curated codebase knowledge. Both the user (/context-search) and the agent (proactive invocation) can use
it to enrich agentic search with architecture decisions, conventions, verification standards, and design rationale that source files alone don't capture.

• Dual invocation: User-invocable via /context-search and model-invocable (Claude loads it automatically when the conversation needs curated context)
• Explore agent interception: A PreToolUse hook transparently redirects Claude's built-in Explore sub-agent through the context repository instead of raw file search
• Three parallel Context Explorers searching architecture/, conventions/, and verification/ domains
• Skills + hooks infrastructure: Build script, init, and upgrade now handle .claude/skills/, .claude/hooks/, and settings.local.json hook configuration

Changes

New Files

• src/templates/skills/context-search/SKILL.md — Main skill with intent analysis and explorer dispatch
• src/templates/agents/buildforce-explorer.md — Wrapper sub-agent that replaces built-in Explore
• src/templates/agents/buildforce-structural-explorer.md — Searches architecture/ domain
• src/templates/agents/buildforce-convention-explorer.md — Searches conventions/ domain
• src/templates/agents/buildforce-verification-explorer.md — Searches verification/ domain
• src/templates/hooks/setup-explorer-subagent.sh — PreToolUse hook that intercepts Explore and redirects to buildforce-explorer
• src/utils/hooks.ts — Utility for idempotent settings.local.json hook merging + executable permissions

Modified Files

• .github/workflows/scripts/create-release-packages.sh — Added generate_skills(), hooks copying, template exclusions
• src/commands/init/setup.ts — Calls mergeHooksSettings() after extraction
• src/commands/upgrade/execution.ts — Skills + hooks backup/replace/rollback + settings merge

Context Updates

• Added architecture/context-search-skill.yaml context file
• Updated _index.yaml with new entry

Architecture

  User types /context-search    Claude decides context needed
           |                              |
      Skill invoked              Built-in Explore dispatched
           |                              |
      SKILL.md loaded            PreToolUse hook intercepts
           |                              |
      Intent Analysis            Rewrites -> buildforce-explorer
           |                              |
           +-------------+---------------+
                          |
           +--------------+--------------+
           |              |              |
        Structural   Convention    Verification
         Explorer     Explorer      Explorer
           |              |              |
           +--------------+--------------+
                          |
                   Synthesize Response

With focus example:

Without focus example: