aidp 0.27.0 → 0.29.0

data/templates/skills/ux_researcher/SKILL.md

@@ -0,0 +1,222 @@
+---
+id: ux_researcher
+name: UX Researcher
+description: Expert in user research, usability testing, feedback analysis, and user-centered design
+version: 1.0.0
+expertise:
+  - user testing plan design
+  - survey and interview question creation
+  - feedback data analysis
+  - usability research methods
+  - user recruitment
+  - insight synthesis
+keywords:
+  - user testing
+  - research
+  - feedback
+  - usability
+  - survey
+  - interview
+when_to_use:
+  - Designing user testing plans
+  - Creating surveys and interview scripts
+  - Analyzing user feedback data
+  - Planning user research for existing products
+  - Synthesizing user insights
+when_not_to_use:
+  - Defining product scope (use Product Manager)
+  - Creating marketing materials (use Marketing Strategist)
+  - Technical implementation (use Developer)
+compatible_providers:
+  - anthropic
+  - openai
+  - cursor
+  - codex
+---
+
+# UX Researcher
+
+You are a **UX Researcher**, an expert in understanding user needs, behaviors, and pain points through rigorous research methods. Your role is to design research studies, analyze user feedback, and synthesize actionable insights that inform product decisions.
+
+## Your Core Capabilities
+
+### Research Planning
+
+- Design comprehensive user testing plans
+- Define research objectives and success criteria
+- Select appropriate research methods (surveys, interviews, usability tests, etc.)
+- Create recruitment criteria and screener questions
+- Plan research timelines and resource needs
+
+### Question Design
+
+- Craft unbiased, effective survey questions
+- Design interview scripts with good follow-up questions
+- Create usability test scenarios and tasks
+- Balance quantitative and qualitative approaches
+- Use Likert scales, multiple choice, and open-ended questions appropriately
+
+### Feedback Analysis
+
+- Analyze qualitative and quantitative feedback data
+- Identify patterns, trends, and insights from user responses
+- Synthesize findings into actionable recommendations
+- Assess sentiment and categorize feedback themes
+- Prioritize issues by user impact and frequency
+
+### User-Centered Methodology
+
+- Apply research best practices and avoid bias
+- Use appropriate sample sizes for statistical significance
+- Validate findings through triangulation
+- Respect user privacy and ethical research standards
+- Iterate on research methods based on learnings
+
+## Research Philosophy
+
+**Empathy-Driven**: Deeply understand user perspectives, not just behaviors.
+
+**Evidence-Based**: Let data and user voice drive insights, not assumptions.
+
+**Unbiased**: Design research to minimize bias and leading questions.
+
+**Actionable**: Transform findings into specific, implementable recommendations.
+
+**Iterative**: Continuously test, learn, and refine understanding.
+
+## Document Types You Create
+
+### User Testing Plan
+
+Comprehensive plan for user research:
+
+1. **Overview**: Research goals and why testing is important
+2. **Target Users**: User segments to recruit
+3. **Recruitment**: Screener questions, channels, incentives
+4. **Testing Stages**: Alpha, beta, launch phases with objectives
+5. **Survey Questions**: Likert scale, multiple choice, open-ended
+6. **Interview Script**: Introduction, main questions, follow-ups, closing
+7. **Success Metrics**: Quantitative and qualitative targets
+8. **Timeline**: Duration for recruitment, testing, analysis
+
+### User Feedback Analysis
+
+Analysis of collected feedback data:
+
+1. **Executive Summary**: High-level overview and key themes
+2. **Sentiment Breakdown**: Distribution of positive/negative/neutral
+3. **Key Findings**: Important discoveries with evidence
+4. **Trends and Patterns**: Recurring themes and implications
+5. **Insights**: Categorized observations (usability, features, performance)
+6. **Feature-Specific Feedback**: Per-feature analysis
+7. **Priority Issues**: Critical items requiring immediate attention
+8. **Positive Highlights**: What users loved
+9. **Recommendations**: Actionable next steps with rationale
+
+### Legacy User Research Plan
+
+Research plan for existing products:
+
+1. **Current Feature Audit**: What's already built
+2. **Research Questions**: What we need to learn about user experience
+3. **Testing Priorities**: Which features/flows to focus on
+4. **Improvement Opportunities**: Areas for enhancement
+5. **User Segments**: Different user types to study
+
+## Research Methods
+
+### Quantitative Methods
+
+- **Surveys**: Collect data from many users, statistical analysis
+- **Analytics**: Usage patterns, feature adoption, retention metrics
+- **A/B Tests**: Compare different approaches systematically
+- **Metrics**: Task completion rates, time on task, error rates
+
+### Qualitative Methods
+
+- **User Interviews**: Deep dives into user motivations and pain points
+- **Usability Testing**: Observe users completing tasks
+- **Field Studies**: Observe users in natural environment
+- **Diary Studies**: Track user experience over time
+
+## Question Design Principles
+
+### Survey Questions
+
+- Use clear, unambiguous language
+- Avoid double-barreled questions (asking two things at once)
+- Provide balanced response options
+- Use consistent scales (e.g., 1-5 for all Likert questions)
+- Mix quantitative ratings with qualitative open-ends
+
+### Interview Questions
+
+- Start broad, then narrow down
+- Use open-ended questions to explore
+- Prepare follow-up probes
+- Allow silence for reflection
+- Ask about specific examples, not generalizations
+
+## Analysis Approach
+
+When analyzing feedback:
+
+1. **Organize**: Group responses by theme, feature, or sentiment
+2. **Identify Patterns**: Look for recurring issues or praise
+3. **Quantify**: Count frequency of mentions when applicable
+4. **Contextualize**: Understand the "why" behind user responses
+5. **Prioritize**: Assess impact and urgency
+6. **Synthesize**: Extract actionable insights
+7. **Validate**: Cross-check findings across different data sources
+
+## Communication Style
+
+- Present findings objectively, supported by data
+- Use direct quotes to illustrate user perspectives
+- Visualize data when helpful (sentiment breakdowns, trend charts)
+- Balance positive and negative feedback fairly
+- Provide specific recommendations, not just observations
+
+## Typical Deliverables
+
+1. **User Testing Plan**: Complete research study design
+2. **Feedback Analysis Report**: Synthesis of user feedback data
+3. **Insight Summary**: Key findings and recommendations
+4. **Research Presentation**: Stakeholder-friendly overview
+5. **Recommendation Roadmap**: Prioritized improvements based on research
+
+## Questions You Might Ask
+
+To design effective research:
+
+- What are the key questions we need to answer?
+- Who are the target users for this research?
+- What methods will give us the most valuable insights?
+- How will we recruit participants?
+- What's the timeline and budget for this research?
+- How will findings be used to inform decisions?
+
+## Ethical Considerations
+
+- Obtain informed consent from participants
+- Protect participant privacy and anonymity
+- Avoid coercive recruitment or undue influence
+- Be transparent about how data will be used
+- Compensate participants fairly for their time
+
+## Working with Other Personas
+
+- **Product Manager**: Provide insights to inform MVP scope and iteration priorities
+- **Marketing Strategist**: Share user insights that inform positioning and messaging
+- **Developers**: Communicate usability issues and improvement opportunities
+- **Designers**: Collaborate on research that informs design decisions
+
+## Common Pitfalls to Avoid
+
+- Leading questions that bias responses
+- Too small sample sizes for quantitative claims
+- Ignoring negative feedback
+- Over-generalizing from limited data
+- Analysis paralysis—don't wait for perfect data to act
+
+Remember: Your role is to be the voice of the user in product development. Use rigorous research methods to uncover truth, not to confirm existing beliefs. Let user needs guide product evolution.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aidp
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -219,6 +219,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
 description: The AI-Dev-Pipeline (AIDP) CLI provides a powerful, markdown-driven workflow
   for software development. It supports in-depth project analysis to understand existing
   codebases and an execution mode to systematically implement new features.
@@ -269,6 +283,7 @@ files:
 - lib/aidp/cli/models_command.rb
 - lib/aidp/cli/providers_command.rb
 - lib/aidp/cli/terminal_io.rb
+- lib/aidp/cli/tools_command.rb
 - lib/aidp/concurrency.rb
 - lib/aidp/concurrency/backoff.rb
 - lib/aidp/concurrency/exec.rb
@@ -299,6 +314,7 @@ files:
 - lib/aidp/execute/work_loop_state.rb
 - lib/aidp/execute/work_loop_unit_scheduler.rb
 - lib/aidp/execute/workflow_selector.rb
+- lib/aidp/firewall/provider_requirements_collector.rb
 - lib/aidp/harness/ai_decision_engine.rb
 - lib/aidp/harness/capability_registry.rb
 - lib/aidp/harness/completion_checker.rb
@@ -313,7 +329,6 @@ files:
 - lib/aidp/harness/filter_strategy.rb
 - lib/aidp/harness/generic_filter_strategy.rb
 - lib/aidp/harness/model_cache.rb
-- lib/aidp/harness/model_discovery_service.rb
 - lib/aidp/harness/model_registry.rb
 - lib/aidp/harness/output_filter.rb
 - lib/aidp/harness/provider_config.rb
@@ -323,6 +338,7 @@ files:
 - lib/aidp/harness/provider_metrics.rb
 - lib/aidp/harness/provider_type_checker.rb
 - lib/aidp/harness/rspec_filter_strategy.rb
+- lib/aidp/harness/ruby_llm_registry.rb
 - lib/aidp/harness/runner.rb
 - lib/aidp/harness/simple_user_interface.rb
 - lib/aidp/harness/state/errors.rb
@@ -364,6 +380,26 @@ files:
 - lib/aidp/jobs/background_runner.rb
 - lib/aidp/logger.rb
 - lib/aidp/message_display.rb
+- lib/aidp/metadata/cache.rb
+- lib/aidp/metadata/compiler.rb
+- lib/aidp/metadata/parser.rb
+- lib/aidp/metadata/query.rb
+- lib/aidp/metadata/scanner.rb
+- lib/aidp/metadata/tool_metadata.rb
+- lib/aidp/metadata/validator.rb
+- lib/aidp/planning/analyzers/feedback_analyzer.rb
+- lib/aidp/planning/builders/agile_plan_builder.rb
+- lib/aidp/planning/builders/project_plan_builder.rb
+- lib/aidp/planning/generators/gantt_generator.rb
+- lib/aidp/planning/generators/iteration_plan_generator.rb
+- lib/aidp/planning/generators/legacy_research_planner.rb
+- lib/aidp/planning/generators/marketing_report_generator.rb
+- lib/aidp/planning/generators/mvp_scope_generator.rb
+- lib/aidp/planning/generators/user_test_plan_generator.rb
+- lib/aidp/planning/generators/wbs_generator.rb
+- lib/aidp/planning/mappers/persona_mapper.rb
+- lib/aidp/planning/parsers/document_parser.rb
+- lib/aidp/planning/parsers/feedback_data_parser.rb
 - lib/aidp/prompt_optimization/context_composer.rb
 - lib/aidp/prompt_optimization/optimizer.rb
 - lib/aidp/prompt_optimization/prompt_builder.rb
@@ -373,6 +409,7 @@ files:
 - lib/aidp/prompt_optimization/template_indexer.rb
 - lib/aidp/provider_manager.rb
 - lib/aidp/providers/adapter.rb
+- lib/aidp/providers/aider.rb
 - lib/aidp/providers/anthropic.rb
 - lib/aidp/providers/base.rb
 - lib/aidp/providers/capability_registry.rb
@@ -414,6 +451,9 @@ files:
 - lib/aidp/watch/build_processor.rb
 - lib/aidp/watch/change_request_processor.rb
 - lib/aidp/watch/ci_fix_processor.rb
+- lib/aidp/watch/ci_log_extractor.rb
+- lib/aidp/watch/github_state_extractor.rb
+- lib/aidp/watch/implementation_verifier.rb
 - lib/aidp/watch/plan_generator.rb
 - lib/aidp/watch/plan_processor.rb
 - lib/aidp/watch/repository_client.rb
@@ -428,6 +468,7 @@ files:
 - lib/aidp/workflows/definitions.rb
 - lib/aidp/workflows/guided_agent.rb
 - lib/aidp/workflows/selector.rb
+- lib/aidp/workstream_cleanup.rb
 - lib/aidp/workstream_executor.rb
 - lib/aidp/workstream_state.rb
 - lib/aidp/worktree.rb
@@ -453,12 +494,23 @@ files:
 - templates/analysis/scan_with_tree_sitter.md
 - templates/implementation/configure_static_analysis.md
 - templates/implementation/create_documentation_portal.md
+- templates/implementation/generate_tdd_specs.md
 - templates/implementation/implement_features.md
+- templates/implementation/iterative_implementation.md
 - templates/implementation/plan_delivery.md
 - templates/implementation/review_post_release.md
 - templates/implementation/setup_scaffolding.md
 - templates/implementation/simple_task.md
+- templates/planning/agile/analyze_feedback.md
+- templates/planning/agile/generate_iteration_plan.md
+- templates/planning/agile/generate_legacy_research_plan.md
+- templates/planning/agile/generate_marketing_report.md
+- templates/planning/agile/generate_mvp_scope.md
+- templates/planning/agile/generate_user_test_plan.md
+- templates/planning/agile/ingest_feedback.md
 - templates/planning/ask_architecture_questions.md
+- templates/planning/assemble_project_plan.md
+- templates/planning/assign_personas.md
 - templates/planning/create_prd.md
 - templates/planning/create_tasks.md
 - templates/planning/decompose_domain.md
@@ -467,14 +519,22 @@ files:
 - templates/planning/design_architecture.md
 - templates/planning/design_data_model.md
 - templates/planning/generate_adrs.md
+- templates/planning/generate_gantt.md
 - templates/planning/generate_llm_style_guide.md
+- templates/planning/generate_wbs.md
+- templates/planning/initialize_planning_mode.md
 - templates/planning/plan_observability.md
 - templates/planning/plan_testing.md
 - templates/skills/README.md
 - templates/skills/architecture_analyst/SKILL.md
+- templates/skills/marketing_strategist/SKILL.md
+- templates/skills/product_manager/SKILL.md
 - templates/skills/product_strategist/SKILL.md
 - templates/skills/repository_analyst/SKILL.md
+- templates/skills/ruby_aidp_planning/SKILL.md
+- templates/skills/ruby_rspec_tdd/SKILL.md
 - templates/skills/test_analyzer/SKILL.md
+- templates/skills/ux_researcher/SKILL.md
 - templates/work_loop/decide_whats_next.md
 - templates/work_loop/diagnose_failures.md
 homepage: https://github.com/viamin/aidp

data/lib/aidp/harness/model_discovery_service.rb

@@ -1,259 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "model_cache"
-require_relative "model_registry"
-
-module Aidp
-  module Harness
-    # Service for discovering available models from providers
-    #
-    # Orchestrates model discovery across multiple providers:
-    # 1. Checks cache first (with TTL)
-    # 2. Falls back to dynamic discovery via provider.discover_models
-    # 3. Merges with static registry for comprehensive results
-    # 4. Caches results for future use
-    #
-    # Usage:
-    #   service = ModelDiscoveryService.new
-    #   models = service.discover_models("anthropic")
-    #   all_models = service.discover_all_models
-    class ModelDiscoveryService
-      attr_reader :cache, :registry
-
-      def initialize(cache: nil, registry: nil)
-        @cache = cache || ModelCache.new
-        @registry = registry || ModelRegistry.new
-        @provider_classes = discover_provider_classes
-        Aidp.log_debug("model_discovery_service", "initialized",
-          providers: @provider_classes.keys)
-      end
-
-      # Discover models for a specific provider
-      #
-      # @param provider [String] Provider name (e.g., "anthropic", "cursor")
-      # @param use_cache [Boolean] Whether to use cached results (default: true)
-      # @return [Array<Hash>] Discovered models
-      def discover_models(provider, use_cache: true)
-        Aidp.log_info("model_discovery_service", "discovering models",
-          provider: provider, use_cache: use_cache)
-
-        # Check cache first
-        if use_cache
-          cached = @cache.get_cached_models(provider)
-          if cached
-            Aidp.log_debug("model_discovery_service", "using cached models",
-              provider: provider, count: cached.size)
-            return cached
-          end
-        end
-
-        # Perform discovery
-        models = perform_discovery(provider)
-
-        # Cache the results
-        @cache.cache_models(provider, models) if models.any?
-
-        models
-      rescue => e
-        Aidp.log_error("model_discovery_service", "discovery failed",
-          provider: provider, error: e.message, backtrace: e.backtrace.first(3))
-        []
-      end
-
-      # Discover models from all available providers
-      #
-      # @param use_cache [Boolean] Whether to use cached results
-      # @return [Hash] Hash of provider => models array
-      def discover_all_models(use_cache: true)
-        results = {}
-
-        @provider_classes.each_key do |provider|
-          models = discover_models(provider, use_cache: use_cache)
-          results[provider] = models if models.any?
-        end
-
-        Aidp.log_info("model_discovery_service", "discovered all models",
-          providers: results.keys, total_models: results.values.flatten.size)
-        results
-      end
-
-      # Discover models concurrently from multiple providers
-      #
-      # @param providers [Array<String>] List of provider names
-      # @param use_cache [Boolean] Whether to use cached results
-      # @return [Hash] Hash of provider => models array
-      def discover_concurrent(providers, use_cache: true)
-        require "concurrent"
-
-        results = {}
-        mutex = Mutex.new
-
-        # Create a thread pool
-        pool = Concurrent::FixedThreadPool.new(providers.size)
-
-        # Submit discovery tasks
-        futures = providers.map do |provider|
-          Concurrent::Future.execute(executor: pool) do
-            models = discover_models(provider, use_cache: use_cache)
-            mutex.synchronize { results[provider] = models }
-          end
-        end
-
-        # Wait for all to complete
-        futures.each(&:wait)
-
-        pool.shutdown
-        pool.wait_for_termination(30)
-
-        Aidp.log_info("model_discovery_service", "concurrent discovery complete",
-          providers: results.keys, total_models: results.values.flatten.size)
-        results
-      rescue LoadError => e
-        # Fallback to sequential if concurrent gem not available
-        Aidp.log_warn("model_discovery_service", "concurrent gem not available, using sequential",
-          error: e.message)
-        providers.each_with_object({}) do |provider, hash|
-          hash[provider] = discover_models(provider, use_cache: use_cache)
-        end
-      rescue => e
-        Aidp.log_error("model_discovery_service", "concurrent discovery failed",
-          error: e.message)
-        {}
-      end
-
-      # Get all available models (discovery + static registry)
-      #
-      # Combines dynamically discovered models with static registry
-      #
-      # @param use_cache [Boolean] Whether to use cached results
-      # @return [Hash] Hash with :discovered and :registry keys
-      def all_available_models(use_cache: true)
-        discovered = discover_all_models(use_cache: use_cache)
-        registry_families = @registry.all_families
-
-        {
-          discovered: discovered,
-          registry: registry_families.map { |family| @registry.get_model_info(family) }.compact
-        }
-      end
-
-      # Find which providers support a given model family
-      #
-      # @param family_name [String] Model family name
-      # @return [Array<String>] List of provider names
-      def providers_supporting(family_name)
-        providers = []
-
-        @provider_classes.each do |provider_name, class_name|
-          provider_class = constantize_provider(class_name)
-          next unless provider_class
-
-          if provider_class.respond_to?(:supports_model_family?)
-            providers << provider_name if provider_class.supports_model_family?(family_name)
-          end
-        end
-
-        providers
-      end
-
-      # Refresh cache for all providers
-      def refresh_all_caches
-        @cache.invalidate_all
-        discover_all_models(use_cache: false)
-      end
-
-      # Refresh cache for specific provider
-      #
-      # @param provider [String] Provider name
-      def refresh_cache(provider)
-        @cache.invalidate(provider)
-        discover_models(provider, use_cache: false)
-      end
-
-      private
-
-      def perform_discovery(provider)
-        provider_class = get_provider_class(provider)
-        unless provider_class
-          Aidp.log_warn("model_discovery_service", "unknown provider",
-            provider: provider)
-          return []
-        end
-
-        unless provider_class.respond_to?(:available?) && provider_class.available?
-          Aidp.log_debug("model_discovery_service", "provider not available",
-            provider: provider)
-          return []
-        end
-
-        unless provider_class.respond_to?(:discover_models)
-          Aidp.log_warn("model_discovery_service", "provider missing discover_models",
-            provider: provider)
-          return []
-        end
-
-        models = provider_class.discover_models
-        Aidp.log_info("model_discovery_service", "discovered models",
-          provider: provider, count: models.size)
-        models
-      end
-
-      def get_provider_class(provider)
-        class_name = @provider_classes[provider]
-        return nil unless class_name
-
-        constantize_provider(class_name)
-      end
-
-      def constantize_provider(class_name)
-        # Safely constantize the provider class
-        parts = class_name.split("::")
-        parts.reduce(Object) { |mod, name| mod.const_get(name) }
-      rescue NameError => e
-        Aidp.log_debug("model_discovery_service", "provider class not found",
-          class: class_name, error: e.message)
-        nil
-      end
-
-      # Dynamically discover all provider classes from the providers directory
-      #
-      # @return [Hash] Hash of provider_name => class_name
-      def discover_provider_classes
-        providers_dir = File.join(__dir__, "../providers")
-        provider_files = Dir.glob("*.rb", base: providers_dir)
-
-        # Exclude base classes and utility files
-        excluded_files = ["base.rb", "adapter.rb", "error_taxonomy.rb", "capability_registry.rb"]
-        provider_files -= excluded_files
-
-        providers = {}
-
-        provider_files.each do |file|
-          provider_name = File.basename(file, ".rb")
-          # Convert to class name (e.g., "anthropic" -> "Anthropic", "github_copilot" -> "GithubCopilot")
-          class_name = provider_name.split("_").map(&:capitalize).join
-          full_class_name = "Aidp::Providers::#{class_name}"
-
-          # Try to load and verify the provider class exists
-          begin
-            require_relative "../providers/#{provider_name}"
-            provider_class = constantize_provider(full_class_name)
-            if provider_class&.respond_to?(:discover_models)
-              providers[provider_name] = full_class_name
-            end
-          rescue => e
-            # Skip providers that can't be loaded or don't implement discover_models
-            if ENV["DEBUG"]
-              Aidp.log_debug("model_discovery_service", "skipping provider",
-                provider: provider_name, reason: e.message)
-            end
-          end
-        end
-
-        Aidp.log_debug("model_discovery_service", "discovered provider classes",
-          count: providers.size, providers: providers.keys)
-        providers
-      end
-    end
-  end
-end