aircana 4.0.0.rc1 → 4.0.0.rc3

data/lib/aircana/cli/commands/generate.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "../../generators/plan_command_generator"
-require_relative "../../generators/record_command_generator"
-require_relative "../../generators/execute_command_generator"
-require_relative "../../generators/review_command_generator"
-require_relative "../../generators/apply_feedback_command_generator"
-require_relative "../../generators/ask_expert_command_generator"
+# Commands that reference old agent system - commented out for now
+# require_relative "../../generators/plan_command_generator"
+# require_relative "../../generators/record_command_generator"
+# require_relative "../../generators/execute_command_generator"
+# require_relative "../../generators/review_command_generator"
+# require_relative "../../generators/apply_feedback_command_generator"
+# require_relative "../../generators/ask_expert_command_generator"
 require_relative "../../generators/hooks_generator"
 
 module Aircana
@@ -13,14 +14,18 @@ module Aircana
     module Generate
       class << self
         def generators
-          @generators ||= [
-            Aircana::Generators::PlanCommandGenerator.new,
-            Aircana::Generators::RecordCommandGenerator.new,
-            Aircana::Generators::ExecuteCommandGenerator.new,
-            Aircana::Generators::ReviewCommandGenerator.new,
-            Aircana::Generators::ApplyFeedbackCommandGenerator.new,
-            Aircana::Generators::AskExpertCommandGenerator.new
-          ]
+          # No default commands for now - they referenced the old agent system
+          @generators ||= []
+
+          # TODO: Re-enable these when we have a new command system
+          # @generators ||= [
+          #   Aircana::Generators::PlanCommandGenerator.new,
+          #   Aircana::Generators::RecordCommandGenerator.new,
+          #   Aircana::Generators::ExecuteCommandGenerator.new,
+          #   Aircana::Generators::ReviewCommandGenerator.new,
+          #   Aircana::Generators::ApplyFeedbackCommandGenerator.new,
+          #   Aircana::Generators::AskExpertCommandGenerator.new
+          # ]
         end
 
         def run

data/lib/aircana/cli/commands/init.rb

@@ -132,7 +132,6 @@ module Aircana
           Aircana.create_dir_if_needed(commands_dir)
 
           copy_command_files(commands_dir)
-          install_default_agents
         end
 
         def copy_command_files(destination_dir)
@@ -142,33 +141,6 @@ module Aircana
           end
         end
 
-        def install_default_agents
-          agents_dir = Aircana.configuration.agents_dir
-          Aircana.create_dir_if_needed(agents_dir)
-
-          copy_agent_files(agents_dir)
-        end
-
-        def copy_agent_files(destination_dir)
-          agent_files_pattern = File.join(Aircana.configuration.output_dir, "agents", "*.md")
-          Dir.glob(agent_files_pattern).each do |file|
-            agent_name = File.basename(file, ".md")
-            next unless default_agent?(agent_name)
-
-            destination_file = File.join(destination_dir, File.basename(file))
-            # Skip copying if source and destination are the same
-            next if File.expand_path(file) == File.expand_path(destination_file)
-
-            Aircana.human_logger.success("Installing default agent: #{agent_name}")
-            FileUtils.cp(file, destination_dir)
-          end
-        end
-
-        def default_agent?(agent_name)
-          require_relative "../../generators/agents_generator"
-          Aircana::Generators::AgentsGenerator.available_default_agents.include?(agent_name)
-        end
-
         def install_hooks
           scripts_dir = Aircana.configuration.scripts_dir
           return unless Dir.exist?(scripts_dir)
@@ -201,7 +173,7 @@ module Aircana
             "post_tool_use" => { event: "PostToolUse", matcher: nil },
             "user_prompt_submit" => { event: "UserPromptSubmit", matcher: nil },
             "session_start" => { event: "SessionStart", matcher: nil },
-            "refresh_agents" => { event: "SessionStart", matcher: nil },
+            "refresh_skills" => { event: "SessionStart", matcher: nil },
             "notification_sqs" => { event: "Notification", matcher: nil },
             "rubocop_pre_commit" => { event: "PreToolUse", matcher: "Bash" },
             "rspec_test" => { event: "PostToolUse", matcher: "Bash" },
@@ -265,11 +237,11 @@ module Aircana
           Aircana.human_logger.info("\nPlugin structure:")
           Aircana.human_logger.info("  .claude-plugin/plugin.json  - Plugin metadata")
           Aircana.human_logger.info("  commands/                   - Slash commands")
-          Aircana.human_logger.info("  agents/                     - Specialized agents")
+          Aircana.human_logger.info("  agents/                     - Knowledge bases")
           Aircana.human_logger.info("  hooks/                      - Event hook configurations")
           Aircana.human_logger.info("  scripts/                    - Hook scripts and utilities")
           Aircana.human_logger.info("\nNext steps:")
-          Aircana.human_logger.info("  - Create agents: aircana agents create")
+          Aircana.human_logger.info("  - Create knowledge bases: aircana kb create")
           Aircana.human_logger.info("  - Install plugin in Claude Code")
           Aircana.human_logger.info("  - Run: aircana plugin info")
         end

data/lib/aircana/cli/commands/kb.rb

@@ -29,7 +29,8 @@ module Aircana
         def create # rubocop:disable Metrics/MethodLength
           prompt = TTY::Prompt.new
 
-          kb_name = prompt.ask("Knowledge base name:")
+          kb_name = prompt.ask("What topic should this knowledge base cover?",
+                               default: "e.g., 'Canvas Backend Database', 'API Design'")
           short_description = prompt.ask("Briefly describe what this KB contains:")
 
           # Prompt for knowledge base type
@@ -48,13 +49,14 @@ module Aircana
           normalized_kb_name = normalize_string(kb_name)
 
           # Prompt for knowledge fetching
-          prompt_for_knowledge_fetch(prompt, normalized_kb_name, kb_type, short_description)
+          fetched_confluence = prompt_for_knowledge_fetch(prompt, normalized_kb_name, kb_type, short_description)
 
           # Prompt for web URL fetching
-          prompt_for_url_fetch(prompt, normalized_kb_name, kb_type)
+          fetched_urls = prompt_for_url_fetch(prompt, normalized_kb_name, kb_type)
 
-          # Generate SKILL.md
-          regenerate_skill_md(normalized_kb_name, short_description)
+          # Generate SKILL.md if no content was fetched during the prompts
+          # (the prompt functions already generate it when they successfully fetch content)
+          regenerate_skill_md(normalized_kb_name, short_description) unless fetched_confluence || fetched_urls
 
           # If remote kb_type, ensure SessionStart hook is installed
           ensure_remote_knowledge_refresh_hook if kb_type == "remote"
@@ -326,7 +328,7 @@ module Aircana
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
         # rubocop:disable Metrics/PerceivedComplexity
         def prompt_for_knowledge_fetch(prompt, normalized_kb_name, kb_type, short_description)
-          return unless confluence_configured?
+          return false unless confluence_configured?
 
           if prompt.yes?("Would you like to fetch knowledge for this KB from Confluence now?")
             Aircana.human_logger.info "Fetching knowledge from Confluence..."
@@ -340,8 +342,11 @@ module Aircana
                     end
 
             result = perform_refresh(normalized_kb_name, kb_type, label: label)
-            ensure_gitignore_entry(kb_type) if result[:pages_count]&.positive?
-            regenerate_skill_md(normalized_kb_name, short_description) if result[:pages_count]&.positive?
+            if result[:pages_count]&.positive?
+              ensure_gitignore_entry(kb_type)
+              regenerate_skill_md(normalized_kb_name, short_description)
+              return true
+            end
           else
             refresh_message = if kb_type == "local"
                                 "fetch knowledge"
@@ -352,6 +357,8 @@ module Aircana
               "Skipping knowledge fetch. You can #{refresh_message} later."
             )
           end
+
+          false
         rescue Aircana::Error => e
           Aircana.human_logger.warn "Failed to fetch knowledge: #{e.message}"
           refresh_message = if kb_type == "local"
@@ -360,6 +367,7 @@ module Aircana
                               "try again later with 'aircana kb refresh #{normalized_kb_name}'"
                             end
           Aircana.human_logger.info "You can #{refresh_message}"
+          false
         end
         # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
         # rubocop:enable Metrics/PerceivedComplexity
@@ -367,7 +375,7 @@ module Aircana
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
         # rubocop:disable Metrics/PerceivedComplexity
         def prompt_for_url_fetch(prompt, normalized_kb_name, kb_type)
-          return unless prompt.yes?("Would you like to add web URLs for this KB's knowledge base?")
+          return false unless prompt.yes?("Would you like to add web URLs for this KB's knowledge base?")
 
           urls = []
           loop do
@@ -382,7 +390,7 @@ module Aircana
             end
           end
 
-          return if urls.empty?
+          return false if urls.empty?
 
           begin
             Aircana.human_logger.info "Fetching #{urls.size} URL(s)..."
@@ -393,6 +401,7 @@ module Aircana
               Aircana.human_logger.success "Successfully fetched #{result[:pages_count]} URL(s)"
               ensure_gitignore_entry(kb_type)
               regenerate_skill_md(normalized_kb_name)
+              return true
             else
               Aircana.human_logger.warn "No URLs were successfully fetched"
             end
@@ -402,6 +411,8 @@ module Aircana
               "You can add URLs later with 'aircana kb add-url #{normalized_kb_name} <URL>'"
             )
           end
+
+          false
         end
         # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
         # rubocop:enable Metrics/PerceivedComplexity

data/lib/aircana/cli/help_formatter.rb

@@ -24,8 +24,7 @@ module Aircana
       def command_groups
         {
           "Knowledge Base Management" => %w[kb],
-          "Hook Management" => %w[hooks],
-          "System" => %w[generate init doctor dump-context]
+          "System" => %w[init doctor]
         }
       end
 

data/lib/aircana/contexts/confluence_content.rb

@@ -14,9 +14,52 @@ module Aircana
       def convert_to_markdown(html_content)
         return "" if html_content.nil? || html_content.empty?
 
-        ReverseMarkdown.convert(html_content, github_flavored: true)
+        # Preprocess Confluence macros before converting to Markdown
+        cleaned_html = preprocess_confluence_macros(html_content)
+        ReverseMarkdown.convert(cleaned_html, github_flavored: true)
       end
 
+      # rubocop:disable Layout/LineLength, Metrics/MethodLength
+      def preprocess_confluence_macros(html)
+        # Process Confluence structured macros to make them compatible with Markdown conversion
+        cleaned = html.dup
+
+        # Remove empty code blocks (common issue with Confluence API)
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*ac:name="code"[^>]*>.*?<ac:plain-text-body>\s*</ac:plain-text-body>.*?</ac:structured-macro>}m, ""
+        )
+
+        # Convert panel macros to blockquotes, preserving inner content
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*ac:name="panel"[^>]*>.*?<ac:rich-text-body>(.*?)</ac:rich-text-body>.*?</ac:structured-macro>}m, '<blockquote>\1</blockquote>'
+        )
+
+        # Convert info/note/warning macros to blockquotes with indicators
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*ac:name="info"[^>]*>.*?<ac:rich-text-body>(.*?)</ac:rich-text-body>.*?</ac:structured-macro>}m, '<blockquote><strong>ℹ️ Info:</strong> \1</blockquote>'
+        )
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*ac:name="note"[^>]*>.*?<ac:rich-text-body>(.*?)</ac:rich-text-body>.*?</ac:structured-macro>}m, '<blockquote><strong>📝 Note:</strong> \1</blockquote>'
+        )
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*ac:name="warning"[^>]*>.*?<ac:rich-text-body>(.*?)</ac:rich-text-body>.*?</ac:structured-macro>}m, '<blockquote><strong>⚠️ Warning:</strong> \1</blockquote>'
+        )
+
+        # Strip other structured macros but preserve rich text body content
+        cleaned.gsub!(
+          %r{<ac:structured-macro[^>]*>.*?<ac:rich-text-body>(.*?)</ac:rich-text-body>.*?</ac:structured-macro>}m, '\1'
+        )
+
+        # Remove any remaining Confluence-specific tags
+        cleaned.gsub!(%r{</?ac:[^>]*>}m, "")
+
+        # Clean up Confluence parameter tags
+        cleaned.gsub!(%r{<ac:parameter[^>]*>.*?</ac:parameter>}m, "")
+
+        cleaned
+      end
+      # rubocop:enable Layout/LineLength, Metrics/MethodLength
+
       def log_pages_found(count, kb_name)
         Aircana.human_logger.info "Found #{count} pages for KB '#{kb_name}'"
       end

data/lib/aircana/generators/hooks_generator.rb

@@ -11,7 +11,7 @@ module Aircana
         post_tool_use
         user_prompt_submit
         session_start
-        refresh_agents
+        refresh_skills
         notification_sqs
         rubocop_pre_commit
         rspec_test
@@ -21,7 +21,7 @@ module Aircana
       # Default hooks that are auto-installed
       DEFAULT_HOOK_TYPES = %w[
         session_start
-        refresh_agents
+        refresh_skills
         notification_sqs
       ].freeze
 

data/lib/aircana/generators/skills_generator.rb

@@ -5,6 +5,7 @@ require_relative "../contexts/manifest"
 
 module Aircana
   module Generators
+    # rubocop:disable Metrics/ClassLength
     class SkillsGenerator < BaseGenerator
       attr_reader :kb_name, :short_description, :skill_description, :knowledge_files
 
@@ -24,11 +25,20 @@ module Aircana
       # rubocop:enable Metrics/ParameterLists
 
       # Generate SKILL.md based on manifest data
+      # rubocop:disable Metrics/MethodLength
       def self.from_manifest(kb_name)
         manifest = Contexts::Manifest.read_manifest(kb_name)
         raise Error, "No manifest found for knowledge base '#{kb_name}'" unless manifest
 
         knowledge_files = extract_knowledge_files_from_manifest(manifest)
+
+        # Warn if no knowledge files were found
+        if knowledge_files.empty?
+          Aircana.human_logger.warn "No knowledge files found for KB '#{kb_name}'. " \
+                                    "SKILL.md will be generated but will be empty. " \
+                                    "Run 'aircana kb refresh #{kb_name}' to fetch knowledge."
+        end
+
         skill_description = generate_skill_description_from_manifest(manifest, kb_name)
 
         new(
@@ -37,11 +47,45 @@ module Aircana
           knowledge_files: knowledge_files
         )
       end
+      # rubocop:enable Metrics/MethodLength
 
       # Class methods for manifest processing
+      def self.extract_knowledge_files_from_manifest(manifest)
+        kb_name = manifest["name"]
+
+        # If kb_dir exists, scan actual files on disk (preferred method)
+        if kb_name && Aircana.configuration.kb_knowledge_dir
+          kb_dir = Aircana.configuration.kb_path(kb_name)
+
+          return extract_files_from_disk(manifest, kb_dir) if Dir.exist?(kb_dir)
+        end
+
+        # Fallback: extract from manifest metadata (for tests or before files are created)
+        extract_files_from_manifest_metadata(manifest)
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def self.extract_files_from_disk(manifest, kb_dir)
+        actual_files = Dir.glob(File.join(kb_dir, "*.md"))
+                          .reject { |f| File.basename(f) == "SKILL.md" }
+                          .sort
+
+        # Build file list with summaries from manifest
+        actual_files.map do |filepath|
+          filename = File.basename(filepath)
+          summary = find_summary_for_file(manifest, filename)
+
+          {
+            summary: summary || File.basename(filename, ".md").tr("-", " ").capitalize,
+            filename: filename
+          }
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
       # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
       # rubocop:disable Metrics/PerceivedComplexity
-      def self.extract_knowledge_files_from_manifest(manifest)
+      def self.extract_files_from_manifest_metadata(manifest)
         files = []
 
         manifest["sources"]&.each do |source|
@@ -68,6 +112,29 @@ module Aircana
       # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
       # rubocop:enable Metrics/PerceivedComplexity
 
+      # Find the summary for a given filename from the manifest
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:disable Metrics/PerceivedComplexity
+      def self.find_summary_for_file(manifest, filename)
+        manifest["sources"]&.each do |source|
+          case source["type"]
+          when "confluence"
+            source["pages"]&.each do |page|
+              return page["summary"] if filename.include?(page["id"])
+            end
+          when "web"
+            source["urls"]&.each do |url_entry|
+              sanitized_url_part = sanitize_filename_from_url(url_entry["url"])
+              return url_entry["summary"] if filename.include?(sanitized_url_part)
+            end
+          end
+        end
+
+        nil
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:enable Metrics/PerceivedComplexity
+
       def self.generate_skill_description_from_manifest(manifest, kb_name)
         # Generate a description optimized for Claude's skill discovery
         source_count = manifest["sources"]&.size || 0
@@ -91,6 +158,7 @@ module Aircana
       rescue URI::InvalidURIError
         "web_resource"
       end
+      # rubocop:enable Metrics/ClassLength
 
       protected
 

data/lib/aircana/templates/hooks/refresh_skills.erb

@@ -0,0 +1,121 @@
+#!/bin/bash
+# Auto-refresh remote knowledge bases on session start
+# Runs at most once per 24 hours to avoid API rate limits
+# Only refreshes remote KBs, skips local KBs
+
+set -e
+
+# Create log directory if it doesn't exist
+mkdir -p ~/.aircana
+LOG_FILE="$HOME/.aircana/hooks.log"
+
+# Claude Code provides this environment variable
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT}"
+
+if [ -z "$PLUGIN_ROOT" ]; then
+    echo "$(date): Warning - CLAUDE_PLUGIN_ROOT not set, skipping KB refresh" >> "$LOG_FILE"
+    echo "{}"
+    exit 0
+fi
+
+TIMESTAMP_FILE="${PLUGIN_ROOT}/.last_refresh"
+REFRESH_INTERVAL_SECONDS=86400  # 24 hours
+
+# Check if we've refreshed recently
+if [ -f "$TIMESTAMP_FILE" ]; then
+    LAST_REFRESH=$(cat "$TIMESTAMP_FILE")
+    CURRENT_TIME=$(date +%s)
+    TIME_DIFF=$((CURRENT_TIME - LAST_REFRESH))
+
+    if [ $TIME_DIFF -lt $REFRESH_INTERVAL_SECONDS ]; then
+        HOURS_SINCE=$((TIME_DIFF / 3600))
+        echo "$(date): Knowledge bases refreshed ${HOURS_SINCE}h ago, skipping refresh" >> "$LOG_FILE"
+        echo "{}"
+        exit 0
+    fi
+fi
+
+# Tell aircana where the plugin lives
+export AIRCANA_PLUGIN_ROOT="$PLUGIN_ROOT"
+
+echo "$(date): Starting knowledge base refresh from plugin root: $PLUGIN_ROOT" >> "$LOG_FILE"
+
+# Find all knowledge bases in agents directory
+AGENTS_DIR="${PLUGIN_ROOT}/agents"
+
+if [ ! -d "$AGENTS_DIR" ]; then
+    echo "$(date): No agents directory found, skipping refresh" >> "$LOG_FILE"
+    echo "{}"
+    exit 0
+fi
+
+# Track if we refreshed any KBs
+REFRESHED_COUNT=0
+SKIPPED_COUNT=0
+
+# Iterate through each KB directory
+for kb_dir in "${AGENTS_DIR}"/*/ ; do
+    # Skip if no directories found
+    [ -d "$kb_dir" ] || continue
+
+    kb_name=$(basename "$kb_dir")
+    manifest_file="${kb_dir}manifest.json"
+
+    # Skip if no manifest exists
+    if [ ! -f "$manifest_file" ]; then
+        echo "$(date): No manifest found for KB '$kb_name', skipping" >> "$LOG_FILE"
+        continue
+    fi
+
+    # Determine KB type from manifest (default to remote if not specified)
+    kb_type="remote"
+
+    # Try to parse with jq if available, otherwise use grep
+    if command -v jq >/dev/null 2>&1; then
+        kb_type=$(jq -r '.kb_type // "remote"' "$manifest_file" 2>/dev/null || echo "remote")
+    else
+        # Fallback: grep for kb_type field
+        if grep -q '"kb_type"[[:space:]]*:[[:space:]]*"local"' "$manifest_file" 2>/dev/null; then
+            kb_type="local"
+        fi
+    fi
+
+    # Only refresh remote KBs
+    if [ "$kb_type" = "local" ]; then
+        echo "$(date): Skipping local KB '$kb_name'" >> "$LOG_FILE"
+        SKIPPED_COUNT=$((SKIPPED_COUNT + 1))
+        continue
+    fi
+
+    # Refresh remote KB
+    echo "$(date): Refreshing remote KB '$kb_name'" >> "$LOG_FILE"
+    if aircana kb refresh "$kb_name" >> "$LOG_FILE" 2>&1; then
+        echo "$(date): Successfully refreshed KB '$kb_name'" >> "$LOG_FILE"
+        REFRESHED_COUNT=$((REFRESHED_COUNT + 1))
+    else
+        echo "$(date): Warning - Failed to refresh KB '$kb_name'" >> "$LOG_FILE"
+    fi
+done
+
+# Update timestamp on completion (even if some refreshes failed)
+date +%s > "$TIMESTAMP_FILE"
+
+# Log summary
+echo "$(date): KB refresh completed - refreshed: $REFRESHED_COUNT, skipped (local): $SKIPPED_COUNT" >> "$LOG_FILE"
+
+# Return success with context
+if [ $REFRESHED_COUNT -gt 0 ]; then
+    CONTEXT="Refreshed $REFRESHED_COUNT remote knowledge base(s)"
+else
+    CONTEXT="No remote knowledge bases to refresh"
+fi
+
+ESCAPED_CONTEXT=$(echo -n "$CONTEXT" | sed 's/"/\\"/g')
+cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "$ESCAPED_CONTEXT"
+  }
+}
+EOF

data/lib/aircana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Aircana
-  VERSION = "4.0.0.rc1"
+  VERSION = "4.0.0.rc3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 4.0.0.rc1
+  version: 4.0.0.rc3
 platform: ruby
 authors:
 - Weston Dransfield
 bindir: exe
 cert_chain: []
-date: 2025-10-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -115,15 +115,8 @@ files:
 - README.md
 - Rakefile
 - SECURITY.md
-- commands/apply-feedback.md
-- commands/ask-expert.md
-- commands/execute.md
-- commands/plan.md
-- commands/record.md
-- commands/review.md
 - compose.yml
 - exe/aircana
-- hooks/hooks.json
 - lib/aircana.rb
 - lib/aircana/cli.rb
 - lib/aircana/cli/app.rb
@@ -132,7 +125,6 @@ files:
 - lib/aircana/cli/commands/doctor_helpers.rb
 - lib/aircana/cli/commands/dump_context.rb
 - lib/aircana/cli/commands/generate.rb
-- lib/aircana/cli/commands/hooks.rb
 - lib/aircana/cli/commands/init.rb
 - lib/aircana/cli/commands/kb.rb
 - lib/aircana/cli/commands/plugin.rb
@@ -177,6 +169,7 @@ files:
 - lib/aircana/templates/hooks/notification_sqs.erb
 - lib/aircana/templates/hooks/post_tool_use.erb
 - lib/aircana/templates/hooks/pre_tool_use.erb
+- lib/aircana/templates/hooks/refresh_skills.erb
 - lib/aircana/templates/hooks/rspec_test.erb
 - lib/aircana/templates/hooks/rubocop_pre_commit.erb
 - lib/aircana/templates/hooks/session_start.erb
@@ -207,7 +200,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: CLI for creating and managing Claude Code plugins with per-agent knowledge
   bases

data/commands/apply-feedback.md

@@ -1,15 +0,0 @@
-INSTRUCTIONS : Use the Task tool with subagent_type 'apply-feedback' to apply code review feedback from the previous /air-review command.
-
-Pass the review feedback from the conversation context to the apply-feedback agent.
-
-The apply-feedback agent will:
-1. Parse review feedback from the previous review
-2. Create todo list of changes prioritized by severity
-3. Present plan to user for approval
-4. Apply approved changes
-5. Re-run unit tests to verify changes
-6. Fix any test failures
-7. Amend the HEAD commit with improvements using 'git commit --amend --no-edit'
-8. Summarize changes made
-
-IMPORTANT: This command reads the review output from the conversation context, so it must be run in the same conversation as /air-review.

data/commands/ask-expert.md

@@ -1,42 +0,0 @@
-INSTRUCTIONS : You are coordinating expert consultation to answer a question by leveraging multiple specialized sub-agents. Follow this precise workflow:
-
-STEP 1: QUESTION VALIDATION
-Ask the user: \"What is your question?\" and wait for their response before proceeding.
-
-STEP 2: COORDINATION PHASE
-Use the Task tool with subagent_type 'sub-agent-coordinator' to analyze the question and identify relevant sub-agents. Provide the coordinator with the complete question context.
-
-STEP 3: PARALLEL EXPERT CONSULTATION
-Based on the coordinator's recommendations, use the Task tool to consult each identified relevant sub-agent in parallel. For each agent:
-- Use the appropriate subagent_type for each recommended agent
-- Provide the original question plus any agent-specific context the coordinator suggested
-- Execute multiple Task tool calls in a single message for parallel processing
-
-STEP 4: SYNTHESIS AND RESPONSE
-After receiving responses from all consulted agents:
-- Analyze and synthesize the expert feedback
-- Identify common themes, conflicting viewpoints, and complementary insights
-- Provide a comprehensive answer that leverages the collective expertise
-- Cite which agents contributed specific insights where relevant
-- Note any areas where experts disagreed and provide your assessment
-
-STEP 5: FOLLOW-UP GUIDANCE
-If the question requires further clarification or the expert responses suggest additional considerations:
-- Suggest specific follow-up questions
-- Recommend additional agents to consult if needed
-- Provide guidance on next steps based on the expert consensus
-
-IMPORTANT EXECUTION NOTES:
-- Always start with the sub-agent-coordinator for proper agent selection
-- Use parallel Task tool execution when consulting multiple agents (single message with multiple tool calls)
-- Ensure each agent receives context appropriate to their expertise domain
-- Synthesize responses rather than simply concatenating them
-- Maintain focus on providing actionable, comprehensive answers
-
-EXAMPLE PARALLEL EXECUTION:
-If coordinator recommends agents A, B, and C, send one message with three Task tool calls:
-1. Task(subagent_type='agent-A', prompt='[question + A-specific context]')
-2. Task(subagent_type='agent-B', prompt='[question + B-specific context]')
-3. Task(subagent_type='agent-C', prompt='[question + C-specific context]')
-
-This approach ensures you leverage the full expertise available while maintaining efficient coordination.

data/commands/execute.md

@@ -1,13 +0,0 @@
-INSTRUCTIONS : Use the Task tool with subagent_type 'executor' to execute the implementation plan from a Jira ticket.
-
-INSTRUCTIONS FOR EXECUTOR AGENT:
-Ask the user to provide a Jira ticket key/ID to execute.
-
-The executor agent will:
-1. Read the plan from the Jira ticket via the 'jira' sub-agent
-2. Review and validate the plan structure
-3. Create a detailed execution todo list in Claude Code planning mode
-4. Present the plan for your approval
-5. Execute the approved implementation tasks
-
-IMPORTANT: All Jira operations are delegated to the 'jira' sub-agent using Task tool with subagent_type 'jira'.