aia 0.9.11 → 0.9.12

data/docs/examples/prompts/development/index.md

@@ -0,0 +1,125 @@
+# Development Prompts
+
+Collection of prompts for software development tasks.
+
+## Available Prompts
+
+### Code Review
+- **code_review.txt** - Comprehensive code analysis and review
+- **security_review.txt** - Security-focused code review
+- **performance_review.txt** - Performance analysis and optimization
+
+### Documentation
+- **generate_docs.txt** - Generate code documentation
+- **api_docs.txt** - API documentation generation
+- **readme_generator.txt** - README file creation
+
+### Debugging
+- **debug_analysis.txt** - Systematic bug analysis
+- **error_investigation.txt** - Error investigation and resolution
+- **performance_debug.txt** - Performance issue diagnosis
+
+### Architecture
+- **architecture_analysis.txt** - System architecture review
+- **design_patterns.txt** - Design pattern recommendations
+- **refactoring_guide.txt** - Code refactoring suggestions
+
+### Testing
+- **test_strategy.txt** - Test strategy development
+- **unit_test_generator.txt** - Unit test creation
+- **integration_testing.txt** - Integration test planning
+
+## Usage Examples
+
+```bash
+# Basic code review
+aia code_review my_file.py
+
+# Security-focused review
+aia security_review --severity high auth_module.rb
+
+# Generate comprehensive documentation
+aia generate_docs --format markdown src/
+```
+
+## Detailed Example Prompts
+
+### Code Review Prompt
+```bash
+# ~/.prompts/code_review.txt
+//config model gpt-4o-mini
+//config temperature 0.3
+
+Review this code for:
+- Best practices adherence
+- Security vulnerabilities
+- Performance issues
+- Maintainability concerns
+
+Code to review:
+```
+
+**Usage:** `aia code_review mycode.rb`
+
+### Meeting Notes Processor
+```bash
+# ~/.prompts/meeting_notes.txt
+//config model gpt-4o-mini
+//pipeline format,action_items
+
+Raw meeting notes:
+//include [NOTES_FILE]
+
+Please clean up and structure these meeting notes.
+```
+
+**Usage:** `aia meeting_notes raw_notes.txt`
+
+### Documentation Generator  
+```bash
+# ~/.prompts/document.txt
+//config model gpt-4o-mini
+//shell find [PROJECT_DIR] -name "*.rb" | head -10
+
+Generate documentation for the Ruby project shown above.
+Include: API references, usage examples, and setup instructions.
+```
+
+**Usage:** `aia document --PROJECT_DIR ./my_project`
+
+### Multi-Model Decision Making
+```bash
+# ~/.prompts/decision_maker.txt
+# Compare different AI perspectives on complex decisions
+
+What are the pros and cons of [DECISION_TOPIC]?
+Consider: technical feasibility, business impact, risks, and alternatives.
+
+Analyze this thoroughly and provide actionable recommendations.
+```
+
+**Usage Examples:**
+```bash
+# Get individual perspectives from each model
+aia decision_maker --model "gpt-4o-mini,gpt-3.5-turbo,gpt-5-mini" --no-consensus
+
+# Get a synthesized consensus recommendation  
+aia decision_maker --model "gpt-4o-mini,gpt-3.5-turbo,gpt-5-mini" --consensus
+
+# Use with chat mode for follow-up questions
+aia --chat --model "gpt-4o-mini,gpt-3.5-turbo" --consensus
+```
+
+## Customization
+
+These prompts can be customized with parameters:
+- `--model` - Choose appropriate AI model
+- `--temperature` - Adjust creativity level
+- `--severity` - Focus level for reviews
+- `--format` - Output format preference
+
+## Related
+
+- [Tools Examples](../../tools/index.md) - Development tools
+- [Analysis Prompts](../analysis/index.md) - Data analysis prompts
+- [Automation Prompts](../automation/index.md) - Process automation

data/docs/examples/prompts/index.md

@@ -0,0 +1,333 @@
+# Prompt Examples
+
+This collection contains real-world prompt examples organized by category and complexity level.
+
+## Categories
+
+### [Development](development/index.md)
+Prompts for software development tasks:
+- **Code Review**: Quality analysis and improvement suggestions
+- **Documentation**: Generate comprehensive code documentation
+- **Debugging**: Systematic problem diagnosis and resolution
+- **Architecture**: System design analysis and recommendations
+- **Testing**: Test strategy and implementation guidance
+
+### [Writing](writing/index.md)
+Content creation and editing prompts:
+- **Technical Writing**: API docs, tutorials, technical guides
+- **Blog Posts**: Engaging technical and general content
+- **Creative Writing**: Stories, poetry, creative projects
+- **Editing**: Content improvement and style refinement
+- **Marketing**: Copy, descriptions, promotional content
+
+### [Analysis](analysis/index.md)
+Data analysis and research prompts:
+- **Data Analysis**: Statistical analysis and insights
+- **Research**: Literature review and synthesis
+- **Reports**: Structured analysis and recommendations
+- **Comparison**: Competitive analysis and evaluation
+- **Trends**: Pattern recognition and forecasting
+
+### [Automation](automation/index.md)
+System administration and automation prompts:
+- **System Monitoring**: Health checks and diagnostics
+- **Deployment**: Release and deployment workflows
+- **Log Analysis**: System log interpretation
+- **Maintenance**: Routine system maintenance tasks
+- **Alerting**: Notification and response templates
+
+### [Learning](learning/index.md)
+Educational and knowledge acquisition prompts:
+- **Concept Explanation**: Complex topic simplification
+- **Tutorial Creation**: Step-by-step learning guides
+- **Quiz Generation**: Assessment and evaluation tools
+- **Research Assistance**: Academic and professional research
+- **Skill Development**: Practice exercises and challenges
+
+## Complexity Levels
+
+### Basic
+- Simple, single-purpose prompts
+- Minimal configuration required
+- Clear, straightforward outputs
+- Great for learning AIA basics
+
+### Intermediate
+- Multi-step workflows
+- Dynamic configuration
+- Context-aware processing
+- Suitable for regular use
+
+### Advanced
+- Complex multi-stage pipelines
+- Extensive use of directives
+- Tool and MCP integration
+- Production-ready workflows
+
+## Using These Examples
+
+### 1. Copy to Your Prompts Directory
+```bash
+# Copy individual prompts
+cp docs/examples/prompts/development/code_review.txt ~/.prompts/
+
+# Copy entire categories
+cp -r docs/examples/prompts/development/ ~/.prompts/
+
+# Copy all examples
+cp -r docs/examples/prompts/* ~/.prompts/
+```
+
+### 2. Customize for Your Needs
+Each prompt includes customization sections:
+- **Parameters**: Variables you can adjust
+- **Configuration**: Settings to modify
+- **Extensions**: How to add functionality
+- **Variations**: Alternative approaches
+
+### 3. Run Examples
+```bash
+# Basic usage
+aia code_review my_file.py
+
+# With customization
+aia --model gpt-4 --temperature 0.3 code_review my_file.py
+
+# In workflows
+aia --pipeline "code_review,optimize,test" my_project/
+```
+
+## Featured Examples
+
+### Code Review Prompt
+**File**: `development/code_review.txt`
+```markdown
+//config model gpt-4
+//config temperature 0.3
+
+# Code Review Analysis
+
+Review the following code for:
+- **Bugs**: Logic errors, edge cases, potential crashes
+- **Security**: Vulnerabilities, input validation, data exposure
+- **Performance**: Efficiency, scalability, resource usage
+- **Style**: Conventions, readability, maintainability
+- **Best Practices**: Design patterns, industry standards
+
+## Code to Review:
+//include <%= file %>
+
+## Review Format:
+Provide your analysis in the following structure:
+
+### Summary
+Brief overall assessment and rating (1-10).
+
+### Issues Found
+List specific problems with severity levels:
+- 🔴 **Critical**: Security vulnerabilities, crashes
+- 🟠 **Major**: Performance issues, bugs
+- 🟡 **Minor**: Style, minor improvements
+
+### Recommendations
+Concrete suggestions for improvement with code examples where applicable.
+
+### Positive Aspects
+Highlight what's done well in the code.
+```
+
+### Blog Post Generator
+**File**: `writing/blog_post.txt`
+```markdown
+//config model gpt-4
+//config temperature 1.0
+//config max_tokens 3000
+
+# Technical Blog Post Generator
+
+Create an engaging, well-structured blog post about: **<%= topic %>**
+
+## Requirements:
+- **Target Audience**: <%= audience || "Software developers" %>
+- **Word Count**: <%= word_count || "1000-1500 words" %>
+- **Tone**: <%= tone || "Professional but approachable" %>
+- **Include Code Examples**: <%= code_examples || "Yes" %>
+
+## Context:
+<% if context_file %>
+//include <%= context_file %>
+<% end %>
+
+## Structure:
+1. **Hook**: Engaging opening that grabs attention
+2. **Introduction**: Problem statement and article overview
+3. **Main Content**: 3-4 major sections with headers
+4. **Code Examples**: Practical, runnable code samples
+5. **Best Practices**: Key takeaways and recommendations
+6. **Conclusion**: Summary and call-to-action
+
+## Style Guidelines:
+- Use clear, concise language
+- Include practical examples
+- Add subheadings for readability
+- Include relevant links and resources
+- End with actionable next steps
+
+Please ensure the post is SEO-friendly with good header structure and includes relevant keywords naturally.
+```
+
+### Data Analysis Workflow
+**File**: `analysis/data_pipeline.txt`
+```markdown
+//config model claude-3-sonnet
+//config temperature 0.2
+
+# Data Analysis Pipeline
+
+Analyze the provided dataset and generate comprehensive insights.
+
+## Dataset Information:
+//shell head -5 <%= dataset_file %>
+//shell wc -l <%= dataset_file %>
+//shell file <%= dataset_file %>
+
+## Analysis Steps:
+
+### 1. Data Overview
+- Examine data structure and types
+- Identify columns and their meanings
+- Note data quality issues
+
+### 2. Descriptive Statistics
+- Calculate summary statistics
+- Identify distributions and outliers
+- Examine correlations
+
+### 3. Data Quality Assessment
+- Missing values analysis
+- Duplicate detection
+- Inconsistency identification
+
+### 4. Key Insights
+- Significant patterns and trends
+- Interesting correlations
+- Anomalies or outliers
+
+### 5. Recommendations
+- Data cleaning suggestions
+- Further analysis opportunities
+- Actionable business insights
+
+## Data Sample:
+//include <%= dataset_file %>
+
+Please provide a thorough analysis with specific findings and quantitative metrics where possible.
+```
+
+## Prompt Design Patterns
+
+### Parameterization Pattern
+Make prompts reusable with variables:
+```markdown
+//config model <%= model || "gpt-4" %>
+//config temperature <%= temperature || "0.7" %>
+
+Task: <%= task_description %>
+Context: <%= context || "General" %>
+Output Format: <%= format || "Markdown" %>
+```
+
+### Conditional Inclusion Pattern
+Include different content based on conditions:
+```markdown
+<% if File.exist?('production.yml') %>
+//include production.yml
+<% else %>
+//include development.yml
+<% end %>
+
+<% if ENV['DETAILED_ANALYSIS'] == 'true' %>
+Provide detailed technical analysis.
+<% else %>
+Provide summary analysis.
+<% end %>
+```
+
+### Multi-Stage Pipeline Pattern
+Chain related prompts together:
+```markdown
+//next data_cleaning
+//pipeline analysis,visualization,reporting
+
+Initial data processing completed.
+Ready for next stage: <%= next_stage %>
+```
+
+### Tool Integration Pattern
+Incorporate external tools:
+```markdown
+# Get a list of tools that are available
+//tools
+
+Using advanced analysis tools:
+
+# Tell the LLM which tool to use and its arguments
+use the examine_data tool to review this file '<%= data_file %>')
+```
+
+## Validation and Testing
+
+### Testing Your Prompts
+1. **Syntax Check**: Verify directive syntax
+2. **Parameter Testing**: Test with different inputs
+3. **Output Validation**: Ensure consistent, quality outputs
+4. **Performance Testing**: Check response times and costs
+5. **Edge Case Testing**: Handle unusual inputs gracefully
+
+### Example Test Scripts
+```bash
+# Test basic functionality
+aia --debug code_review test_file.py
+
+# Test with different models
+for model in gpt-3.5-turbo gpt-4 claude-3-sonnet; do
+  echo "Testing with $model"
+  aia --model $model code_review test_file.py
+done
+
+# Test parameter variations
+aia code_review --file test1.py --severity high
+aia code_review --file test2.py --severity low
+```
+
+## Best Practices
+
+### Prompt Structure
+1. **Clear Instructions**: Specific, actionable directions
+2. **Context Setting**: Provide necessary background
+3. **Output Format**: Specify desired response structure
+4. **Examples**: Include sample inputs/outputs when helpful
+5. **Error Handling**: Account for edge cases
+
+### Configuration Management
+1. **Model Selection**: Choose appropriate models for tasks
+2. **Temperature Setting**: Adjust creativity vs. consistency
+3. **Token Limits**: Balance completeness with cost
+4. **Parameter Validation**: Ensure required inputs are provided
+
+### Maintenance
+1. **Version Control**: Track prompt changes
+2. **Documentation**: Keep usage instructions current
+3. **Performance Monitoring**: Track effectiveness over time
+4. **User Feedback**: Incorporate user suggestions
+
+## Related Documentation
+
+- [Directives Reference](../../directives-reference.md) - All available directives
+- [CLI Reference](../../cli-reference.md) - Command-line options
+- [Advanced Prompting](../../advanced-prompting.md) - Expert techniques
+- [Configuration](../../configuration.md) - Setup and customization
+
+---
+
+Explore the specific categories to find prompts that match your needs, or use these as inspiration to create your own custom prompts!

data/docs/examples/prompts/learning/index.md

@@ -0,0 +1,127 @@
+# Learning Prompts
+
+Collection of prompts for educational content, skill development, and knowledge acquisition.
+
+## Available Prompts
+
+### Concept Explanation
+- **explain_concept.txt** - Clear concept explanations
+- **eli5_explainer.txt** - "Explain Like I'm 5" simplifications
+- **technical_concepts.txt** - Technical concept breakdown
+- **analogy_generator.txt** - Concept explanation through analogies
+
+### Tutorial Creation
+- **step_by_step.txt** - Step-by-step tutorial generation
+- **hands_on_guide.txt** - Practical, hands-on learning guides
+- **project_tutorial.txt** - Project-based learning tutorials
+- **troubleshooting_guide.txt** - Problem-solving tutorials
+
+### Skill Development
+- **skill_assessment.txt** - Skill level assessment
+- **learning_path.txt** - Personalized learning path creation
+- **practice_exercises.txt** - Practice exercise generation
+- **progress_tracking.txt** - Learning progress evaluation
+
+### Knowledge Testing
+- **quiz_generator.txt** - Quiz and test creation
+- **flashcard_maker.txt** - Flashcard generation
+- **assessment_rubric.txt** - Assessment criteria creation
+- **knowledge_check.txt** - Knowledge verification questions
+
+### Research and Study
+- **study_guide.txt** - Study guide creation
+- **research_methodology.txt** - Research approach guidance
+- **note_organization.txt** - Note-taking and organization
+- **summary_extraction.txt** - Key point summarization
+
+## Usage Examples
+
+```bash
+# Explain complex concepts simply
+aia explain_concept --topic "blockchain" --level "beginner"
+
+# Create learning tutorial
+aia step_by_step --subject "Python programming" --project "web scraper"
+
+# Generate practice exercises
+aia practice_exercises --skill "data analysis" --difficulty "intermediate"
+```
+
+## Learning Workflows
+
+### Concept Mastery
+1. **concept_introduction.txt** - Introduce new concept
+2. **detailed_explanation.txt** - Provide detailed explanation
+3. **practical_examples.txt** - Show real-world examples
+4. **practice_problems.txt** - Generate practice problems
+5. **concept_assessment.txt** - Assess understanding
+
+### Skill Development
+1. **skill_assessment.txt** - Assess current skill level
+2. **gap_analysis.txt** - Identify skill gaps
+3. **learning_plan.txt** - Create development plan
+4. **resource_recommendation.txt** - Recommend learning resources
+5. **progress_milestones.txt** - Set progress markers
+
+### Project-Based Learning
+1. **project_design.txt** - Design learning project
+2. **requirement_breakdown.txt** - Break down requirements
+3. **implementation_guide.txt** - Step-by-step implementation
+4. **review_and_reflect.txt** - Review and reflection
+5. **next_steps.txt** - Suggest next learning steps
+
+## Educational Approaches
+
+### Different Learning Styles
+- **visual_learner.txt** - Visual learning approaches
+- **auditory_learner.txt** - Audio-based explanations
+- **kinesthetic_learner.txt** - Hands-on learning methods
+- **reading_learner.txt** - Text-based learning materials
+
+### Difficulty Levels
+- **beginner_friendly.txt** - Beginner-level explanations
+- **intermediate_depth.txt** - Intermediate complexity
+- **advanced_topics.txt** - Advanced, detailed coverage
+- **expert_discussion.txt** - Expert-level discourse
+
+## Customization Parameters
+
+- **Learning Level** - beginner, intermediate, advanced, expert
+- **Learning Style** - visual, auditory, kinesthetic, reading
+- **Subject Area** - specific domain or field
+- **Time Constraint** - available time for learning
+- **Goal Orientation** - certification, job skills, general knowledge
+
+## Integration with Other Prompts
+
+### Code Learning
+```bash
+# Combine with development prompts
+aia explain_concept --topic "design patterns" | aia code_review --context -
+```
+
+### Research Learning
+```bash
+# Combine with analysis prompts
+aia research_methodology --topic "market analysis" | aia competitive_analysis --method -
+```
+
+## Assessment and Feedback
+
+### Self-Assessment Tools
+- **knowledge_self_check.txt** - Self-assessment questions
+- **skill_reflection.txt** - Skill reflection prompts
+- **learning_journal.txt** - Learning journal templates
+- **goal_evaluation.txt** - Goal achievement assessment
+
+### Peer Learning
+- **discussion_questions.txt** - Generate discussion topics
+- **peer_review.txt** - Peer review frameworks
+- **group_project.txt** - Collaborative learning projects
+- **knowledge_sharing.txt** - Knowledge sharing formats
+
+## Related
+
+- [Writing Prompts](../writing/index.md) - Educational content creation
+- [Analysis Prompts](../analysis/index.md) - Learning analytics
+- [Development Prompts](../development/index.md) - Technical skill development

data/docs/examples/prompts/writing/index.md

@@ -0,0 +1,62 @@
+# Writing Prompts
+
+Collection of prompts for content creation and writing tasks.
+
+## Available Prompts
+
+### Technical Writing
+- **technical_docs.txt** - Technical documentation creation
+- **api_documentation.txt** - API documentation writing
+- **user_guides.txt** - User guide creation
+- **tutorial_writer.txt** - Step-by-step tutorial generation
+
+### Blog Posts
+- **blog_post.txt** - General blog post creation
+- **technical_blog.txt** - Technical blog posts
+- **how_to_guide.txt** - How-to article creation
+- **listicle_generator.txt** - List-based article creation
+
+### Creative Writing
+- **story_generator.txt** - Creative story writing
+- **character_development.txt** - Character creation and development
+- **dialogue_writer.txt** - Dialogue creation
+- **scene_setting.txt** - Scene and setting description
+
+### Business Writing
+- **proposal_writer.txt** - Business proposal creation
+- **report_generator.txt** - Business report writing
+- **email_composer.txt** - Professional email composition
+- **presentation_outline.txt** - Presentation structure creation
+
+### Editing and Improvement
+- **content_editor.txt** - Content editing and improvement
+- **style_checker.txt** - Writing style analysis
+- **grammar_check.txt** - Grammar and syntax review
+- **readability_improver.txt** - Readability enhancement
+
+## Usage Examples
+
+```bash
+# Create a technical blog post
+aia technical_blog --topic "microservices" --audience "developers"
+
+# Generate user documentation
+aia user_guides --product "API" --level "beginner"
+
+# Edit and improve existing content
+aia content_editor --style "professional" existing_article.md
+```
+
+## Customization Options
+
+- **Topic/Subject** - Specify the main topic
+- **Audience** - Target audience level and type
+- **Style** - Writing style (formal, casual, technical)
+- **Length** - Desired word count or length
+- **Format** - Output format (Markdown, HTML, plain text)
+
+## Related
+
+- [Development Prompts](../development/index.md) - Code-related writing
+- [Analysis Prompts](../analysis/index.md) - Analytical writing
+- [Learning Prompts](../learning/index.md) - Educational content