aia 1.0.0.pre.beta → 1.1.0

data/docs/examples/tools/index.md

@@ -129,7 +129,7 @@ Tools that can modify files or system state:
 
 ### Example Tool Template
 ```ruby
-# ~/.aia/tools/example_tool.rb
+# ~/.config/aia/tools/example_tool.rb
 require 'json'
 
 class ExampleTool < RubyLLM::Tool
@@ -205,43 +205,33 @@ end
 ### Local Tool Directory
 ```bash
 # Create tool directory structure
-mkdir -p ~/.aia/tools/{core,development,analysis,web,system}
+mkdir -p ~/.config/aia/tools/{core,development,analysis,web,system}
 
 # Copy tools to appropriate directories
-cp file_analyzer.rb ~/.aia/tools/core/
-cp code_quality.rb ~/.aia/tools/development/
-cp data_analyzer.rb ~/.aia/tools/analysis/
+cp file_analyzer.rb ~/.config/aia/tools/core/
+cp code_quality.rb ~/.config/aia/tools/development/
+cp data_analyzer.rb ~/.config/aia/tools/analysis/
 ```
 
-### Tool Libraries
-```yaml
-# ~/.aia/tool_config.yml
-tool_libraries:
-  core:
-    path: ~/.aia/tools/core
-    security_level: safe
-    
-  development:
-    path: ~/.aia/tools/development
-    security_level: safe
-    
-  web:
-    path: ~/.aia/tools/web
-    security_level: network
-    
-  system:
-    path: ~/.aia/tools/system
-    security_level: system
-    restricted: true
+### Loading Tools by Directory
+```bash
+# Load all tools from a directory
+aia --tools ~/.config/aia/tools/core/ my_prompt
+
+# Load tools from multiple directories
+aia --tools ~/.config/aia/tools/core/ --tools ~/.config/aia/tools/development/ my_prompt
+
+# Filter to specific tools
+aia --tools ~/.config/aia/tools/ --allowed-tools FileAnalyzer,CodeQuality my_prompt
 ```
 
 ### Shared Tool Repositories
 ```bash
 # Clone shared tool repositories
-git clone https://github.com/team/aia-tools.git ~/.aia/shared-tools
+git clone https://github.com/team/aia-tools.git ~/.config/aia/shared-tools
 
 # Use shared tools
-aia --tools ~/.aia/shared-tools/web/ api_analysis
+aia --tools ~/.config/aia/shared-tools/web/ api_analysis
 ```
 
 ## Performance Considerations

data/docs/faq.md

@@ -5,7 +5,7 @@ Common questions and answers about using AIA.
 ## Installation and Setup
 
 ### Q: What Ruby version is required for AIA?
-**A:** AIA requires Ruby 3.0 or higher. You can check your Ruby version with `ruby --version`.
+**A:** AIA requires Ruby 3.2 or higher. You can check your Ruby version with `ruby --version`.
 
 ### Q: How do I install AIA?
 **A:** The easiest way is through RubyGems:
@@ -266,9 +266,9 @@ aia --chat --model gpt-4
 ```
 
 ### Q: How do I save chat conversations?
-**A:** Use the `/save` command within chat:
-```
-You: /save conversation.md
+**A:** Use the `--output` flag to save responses to a file:
+```bash
+aia --chat --output conversation.md
 ```
 
 ### Q: Can I use tools in chat mode?
@@ -434,13 +434,10 @@ which git
 ### Q: Configuration issues
 **A:** Debug your configuration setup:
 ```bash
-# Check current configuration
-aia --config
-
-# Debug configuration loading
-aia --debug --config
+# Dump current configuration to a file for inspection
+aia --dump config_snapshot.yml
 
-# Test with verbose output
+# Test with verbose and debug output
 aia --debug --verbose my_prompt
 ```
 
@@ -479,8 +476,8 @@ aia --debug my_prompt
 # Maximum debugging output
 aia --debug --verbose my_prompt
 
-# Check configuration in debug mode
-aia --debug --config
+# Dump configuration for inspection
+aia --dump config_snapshot.yml
 ```
 
 ### Q: Common error messages and solutions

data/docs/guides/basic-usage.md

@@ -93,13 +93,13 @@ aia write_content --outline outline.md --style "technical" --examples "include"
 Set up different configurations for different environments:
 
 ```yaml
-# ~/.aia/dev_config.yml
+# ~/.config/aia/dev_config.yml
 model: gpt-3.5-turbo
 temperature: 0.7
 verbose: true
 debug: true
 
-# ~/.aia/prod_config.yml  
+# ~/.config/aia/prod_config.yml  
 model: gpt-4
 temperature: 0.3
 verbose: false
@@ -108,8 +108,8 @@ debug: false
 
 ```bash
 # Use environment-specific configs
-aia --config-file ~/.aia/dev_config.yml development_task
-aia --config-file ~/.aia/prod_config.yml production_analysis
+aia --config-file ~/.config/aia/dev_config.yml development_task
+aia --config-file ~/.config/aia/prod_config.yml production_analysis
 ```
 
 ### Task-Specific Model Selection

data/docs/guides/chat.md

@@ -72,6 +72,8 @@ Files in the current directory are:
 which files are over 1 week old?
 ```
 
+> **Security Warning**: The `/ruby` and `/shell` directives execute code directly on your machine with your user permissions. `/ruby` runs arbitrary Ruby via `eval()` and `/shell` invokes system commands. Only use these directives with trusted prompts. Never run prompts from untrusted sources that contain these directives without reviewing them first.
+
 ## Advanced Chat Features
 
 ### Multi-Model Conversations
@@ -461,45 +463,46 @@ AI: Here are comprehensive unit tests...
 ## Customization and Configuration
 
 ### Chat-Specific Configuration
+
+Chat mode uses the same configuration as regular AIA usage. Relevant settings in `~/.config/aia/aia.yml`:
+
 ```yaml
-# ~/.aia/chat_config.yml
-chat:
-  default_model: gpt-4
-  save_conversations: true
-  conversation_dir: ~/aia_conversations
-  auto_save_interval: 300  # seconds
-  max_context_length: 16000
-  show_token_count: true
-
-speech:
-  enabled: false
+# Model selection
+models:
+  - name: gpt-4o
+
+# LLM parameters
+llm:
+  temperature: 0.7
+  max_tokens: 2048
+
+# Audio for /say directive
+audio:
   voice: alloy
-  auto_play: true
+  speak_command: afplay
+```
 
-tools:
-  auto_discover: true
-  default_paths: [~/.aia/tools, ./tools]
-  security_mode: safe
+Start chat with specific options via CLI:
+
+```bash
+aia --chat --model gpt-4o --tools ./tools/ my_system_prompt
+aia --chat --output conversation.md my_prompt  # Save output
 ```
 
-### Custom Chat Commands
-You can define custom chat commands by creating tool functions:
+### Using Tools in Chat
 
-```ruby
-# ~/.aia/tools/chat_commands.rb
-class ChatCommands < RubyLLM::Tool
-  def summarize_conversation
-    # Custom command to summarize the current conversation
-    "<%= AIA.chat.context.summarize %>"
-  end
+Load custom RubyLLM tools into chat sessions:
 
-  def export_code_snippets
-    # Extract and export all code snippets from conversation
-    "<%= AIA.chat.extract_code_blocks %>"
-  end
-end
+```bash
+# Load tools into a chat session
+aia --chat --tools ./tools/file_analyzer.rb my_prompt
+
+# Load tools from a directory
+aia --chat --tools ./tools/ my_prompt
 ```
 
+The AI model can call these tools during the conversation when relevant. See [Tools Guide](tools.md) for details on creating tools.
+
 ## Token Usage and Cost Tracking
 
 ### Displaying Token Usage
@@ -599,10 +602,12 @@ aia --chat --model gpt-3.5-turbo
 5. **Save Progress**: Regular saves prevent loss of valuable insights
 
 ### Security Considerations
-1. **Sensitive Data**: Avoid sharing confidential information
-2. **Tool Access**: Restrict tool permissions appropriately
-3. **Session Management**: Clear sensitive conversations
-4. **API Keys**: Keep credentials secure
+1. **Code Execution Directives**: `/ruby` executes arbitrary Ruby code and `/shell` runs system commands with your user permissions. Only use trusted prompts containing these directives
+2. **Sensitive Data**: Avoid sharing confidential information in prompts or chat
+3. **Tool Access**: Restrict tool permissions with `--allowed-tools` and `--rejected-tools`
+4. **MCP Servers**: Control which MCP servers can run with `--mcp-use` and `--mcp-skip`
+5. **Session Management**: Clear sensitive conversations with `/clear`
+6. **API Keys**: Keep credentials secure; never embed them in prompt files
 
 ### Productivity Tips
 1. **Keyboard Shortcuts**: Learn and use available shortcuts

data/docs/guides/tools.md

@@ -69,7 +69,7 @@ aia --tools ./tools/ tool_discovery_prompt
 
 ### Basic Tool Structure
 ```ruby
-# ~/.aia/tools/file_analyzer.rb
+# ~/.config/aia/tools/file_analyzer.rb
 class FileAnalyzer < RubyLLM::Tool
   description "Analyzes files for structure, content, and metadata"
   
@@ -167,7 +167,7 @@ end
 
 ### Web Integration Tool
 ```ruby
-# ~/.aia/tools/web_client.rb
+# ~/.config/aia/tools/web_client.rb
 require 'net/http'
 require 'json'
 require 'uri'
@@ -257,7 +257,7 @@ end
 
 ### Data Analysis Tool
 ```ruby
-# ~/.aia/tools/data_analyzer.rb
+# ~/.config/aia/tools/data_analyzer.rb
 require 'csv'
 require 'json'
 
@@ -680,7 +680,7 @@ end
 ### Tool Libraries
 ```bash
 # Organize tools in libraries
-~/.aia/tools/
+~/.config/aia/tools/
 ├── core/           # Essential tools
 │   ├── file_ops.rb
 │   ├── web_client.rb

data/docs/index.md

@@ -23,80 +23,48 @@ Welcome to AIA, your powerful CLI tool for dynamic prompt management and AI inte
 
 ---
 
-!!! danger "Breaking Changes in v1.0.0 (from v0.11.2)"
+!!! tip "🚀 New: AI Assistant Scheduler (AIAS)"
 
-    **Version 1.0.0 is a major release with breaking changes. Read this section before upgrading.**
+    **Schedule and automate your AIA prompts!** AIAS is a new Ruby gem that lets you run AIA prompts on a cron-like schedule — perfect for recurring AI tasks, automated reports, and timed workflows.
 
-!!! failure "Prompt File Format (Critical)"
+    **[View AIAS on GitHub →](https://github.com/madbomber/aias)**
 
-    The prompt file format has changed completely. You **must** migrate your prompts.
-
-    - **File extension** — `.txt` is now `.md`
-    - **Parameters** — `[PLACEHOLDER]` is now `<%= placeholder %>`
-    - **Metadata** — Separate `.json` history files are now YAML front matter inside the `.md` file
-    - **Directive embedding** — `//config`, `//pipeline`, etc. are now YAML front matter keys
-
-    **Before (v0.11.2):**
-
-        # ~/.prompts/my_prompt.txt
-        //config temperature 0.7
-        //pipeline next_prompt, another_prompt
-        Tell me about [TOPIC] in [LANGUAGE]
-
-    **After (v1.0.0):**
-
-        ---
-        temperature: 0.7
-        pipeline: [next_prompt, another_prompt]
-        parameters:
-          topic: null
-          language: null
-        ---
-        Tell me about <%= topic %> in <%= language %>
-
-    **Run the migration tool:**
-
-        # Back up first (recommended)
-        cp -r ~/.prompts ~/.prompts.backup
-
-        # Migrate all prompts
-        migrate_prompts --verbose ~/.prompts
-
-        # Review flagged files (*.txt-review), then recover them
-        migrate_prompts --reprocess ~/.prompts
-
-    The `migrate_prompts` script is a standalone program in `bin/`. It handles placeholder conversion, directive migration, history file merging, and flags files with code fences for manual review. See [Migration Guide](guides/migrate-prompts.md) for details.
+---
 
-!!! warning "Removed and Deprecated CLI Options"
+!!! tip "🎭 Roles: Give Your Robot a Personality"
 
-    - **`--adapter` removed** — AIA now exclusively uses `ruby_llm`. Remove `--adapter` from any scripts or aliases.
-    - **`--regex` deprecated** — Parameter extraction uses ERB (`<%= param %>`) instead of regex. The flag prints a warning and has no effect.
-    - **`--terse` deprecated** — No longer supported. The flag prints a warning and has no effect.
-    - **`--metrics` renamed to `--tokens`** — Use `--tokens` to display token usage. `--cost` implies `--tokens`.
+    Roles are plain-text prompt files that define how your AI thinks, talks, and interacts with you. Drop one in `~/.prompts/roles/` and your robot instantly becomes someone new.
 
-!!! warning "Dependency: prompt_manager v0.5 to v1.0"
+    **For fun:**
+    ```bash
+    aia --chat --role pirate           # Arrr, matey!
+    aia --chat --role nyc_cabbie       # opinions about EVERYTHING
+    aia --chat --role stoned_hacker    # solves it anyway, dude
+    ```
 
-    The `prompt_manager` gem has been upgraded from `~> 0.5.8` to `~> 1.0`. This is the root cause of the prompt file format changes above. The new version uses ERB for parameter interpolation and YAML front matter for metadata. All prompt files must be in the new format.
+    **For serious work:**
+    ```bash
+    # Explains quantum physics to your 7-year-old
+    aia --chat --role first_grade_teacher
 
-!!! info "Environment Variables (from v0.10.0)"
+    # Three expert robots on the same design doc, simultaneously
+    aia --model gpt-4o=architect,claude=security,gemini=performance design.md
+    ```
 
-    If upgrading from v0.9.x, environment variable names changed in v0.10.0 to use double underscore (`__`) for nested config sections:
+    Assign a different role to each model and get multiple expert perspectives in one command. **[Full Roles Guide →](guides/models.md)**
 
-    | Old (v0.9.x) | New (v1.0.0) |
-    |---|---|
-    | `AIA_PROMPTS_DIR` | `AIA_PROMPTS__DIR` |
-    | `AIA_OUT_FILE` | `AIA_OUTPUT__FILE` |
-    | `AIA_VERBOSE` | `AIA_FLAGS__VERBOSE` |
-    | `AIA_DEBUG` | `AIA_FLAGS__DEBUG` |
-    | `AIA_CHAT` | `AIA_FLAGS__CHAT` |
-    | `AIA_TEMPERATURE` | `AIA_LLM__TEMPERATURE` |
-    | `AIA_MARKDOWN` | `AIA_OUTPUT__MARKDOWN` |
+!!! tip "🎓 Skills: Teach Your Robot Your Process"
 
-    `AIA_MODEL` is unchanged. See [Environment Variables](configuration.md#environment-variables) for the complete list.
+    Skills are structured instruction sets that tell your robot *exactly how* to approach a task — your workflow, your standards, every single time. Each skill is a directory with a `SKILL.md` file in `~/.prompts/skills/`.
 
-!!! info "Configuration Files (from v0.10.0)"
+    ```bash
+    aia -s code-quality my_prompt                      # one skill
+    aia -s code-quality,security-review my_prompt      # stack them
+    aia --chat --role senior_dev -s code-quality       # role + skill
+    /skill code-quality                                # add mid-chat
+    ```
 
-    If upgrading from v0.9.x, configuration files now use a nested YAML structure with sections (`llm:`, `prompts:`, `output:`, `flags:`, etc.) and follow the XDG Base Directory Specification (`~/.config/aia/aia.yml`). See [Configuration Guide](configuration.md) for details.
+    Combine roles and skills: a pirate who follows your code review process, a first-grade teacher who uses your step-by-step explanation method, or multiple robots each with their own role and skill set — all from the command line. **[Full Skills Guide →](directives-reference.md)**
 
 ---
 
@@ -105,9 +73,15 @@ Welcome to AIA, your powerful CLI tool for dynamic prompt management and AI inte
 ### 🚀 Dynamic Prompt Management
 - **Hierarchical Configuration**: Embedded directives > CLI args > environment variables > config files > defaults
 - **Prompt Sequences and Workflows**: Chain prompts together for complex AI workflows
-- **Role-based Prompts**: Use predefined roles to context your AI interactions
 - **Fuzzy Search**: Find prompts quickly with fuzzy matching (requires `fzf`)
 
+### 🎭 Roles & 🎓 Skills
+- **Robot Personalities**: Give any robot a voice — fun personas like a pirate or NYC cabbie, or professional ones like a senior architect or first-grade teacher
+- **Per-Model Roles**: Assign a different role to each model in a multi-model session — `--model gpt-4o=architect,claude=security`
+- **Reusable Skill Sets**: Encode your exact workflow once in a `SKILL.md` file; apply it to any prompt with `-s skill-name`
+- **Role + Skill Combos**: A robot can be *who you want* (role) and *know exactly what to do* (skill) simultaneously
+- **Mid-Chat Skills**: Add a skill to a running chat session with `/skill skill-name`
+
 ### 🔧 Powerful Integration
 - **Shell Integration**: Execute shell commands directly within prompts
 - **Ruby (ERB) Processing**: Use Ruby code in your prompts for dynamic content

data/docs/installation.md

@@ -5,7 +5,7 @@ This guide will help you install AIA and get it running on your system.
 ## Prerequisites
 
 ### Required
-- **Ruby**: Version 3.0 or higher
+- **Ruby**: Version 3.2 or higher
 - **RubyGems**: Usually comes with Ruby
 
 ### Recommended