diff --git a/.agent/AGENTS.md b/.agents/AGENTS.md
similarity index 100%
rename from .agent/AGENTS.md
rename to .agents/AGENTS.md
diff --git a/.agent/accounts.md b/.agents/accounts.md
similarity index 100%
rename from .agent/accounts.md
rename to .agents/accounts.md
diff --git a/.agent/aidevops.md b/.agents/aidevops.md
similarity index 93%
rename from .agent/aidevops.md
rename to .agents/aidevops.md
index 928007c1c..8bc969af6 100644
--- a/.agent/aidevops.md
+++ b/.agents/aidevops.md
@@ -53,12 +53,12 @@ subagents:
 - **Purpose**: Manage and extend the aidevops framework
 - **Repo**: `~/Git/aidevops/`
 - **User Install**: `~/.aidevops/agents/`
-- **Scripts**: `.agent/scripts/[service]-helper.sh [command] [account] [target]`
+- **Scripts**: `.agents/scripts/[service]-helper.sh [command] [account] [target]`
 
 **Key Operations**:
 - Setup: `./setup.sh`
-- Quality check: `.agent/scripts/linters-local.sh`
-- Release: `.agent/scripts/version-manager.sh release [major|minor|patch]`
+- Quality check: `.agents/scripts/linters-local.sh`
+- Release: `.agents/scripts/version-manager.sh release [major|minor|patch]`
 
 **Subagents** (`aidevops/`):
 - `setup.md` - AI guide to setup.sh
@@ -100,7 +100,7 @@ AI DevOps provides comprehensive infrastructure management for AI agents:
 All services follow unified patterns:
 
 ```bash
-.agent/scripts/[service]-helper.sh [command] [account] [target] [options]
+.agents/scripts/[service]-helper.sh [command] [account] [target] [options]
 
 # Common commands
 help                    # Show service-specific help
diff --git a/.agent/aidevops/add-new-mcp-to-aidevops.md b/.agents/aidevops/add-new-mcp-to-aidevops.md
similarity index 93%
rename from .agent/aidevops/add-new-mcp-to-aidevops.md
rename to .agents/aidevops/add-new-mcp-to-aidevops.md
index ede06a675..2de14941a 100644
--- a/.agent/aidevops/add-new-mcp-to-aidevops.md
+++ b/.agents/aidevops/add-new-mcp-to-aidevops.md
@@ -31,11 +31,11 @@ tools:
 **Checklist**:
 
 1. Research MCP (official docs, npm/pip package, GitHub)
-2. Create `.agent/tools/{category}/{mcp-name}.md` documentation
+2. Create `.agents/tools/{category}/{mcp-name}.md` documentation
 3. Create `configs/{mcp-name}-config.json.txt` template
 4. Create `configs/mcp-templates/{mcp-name}.json` snippets
-5. Update `.agent/scripts/generate-opencode-agents.sh` (add to selected agents)
-6. Update `.agent/scripts/ai-cli-config.sh` (add configure function)
+5. Update `.agents/scripts/generate-opencode-agents.sh` (add to selected agents)
+6. Update `.agents/scripts/ai-cli-config.sh` (add configure function)
 7. Update `setup.sh` (add setup function if prerequisites needed)
 8. Run quality checks and linters
 9. Test with verification prompt
@@ -179,7 +179,7 @@ Record which agents and why:
 
 ## Step 3: Create Documentation File
 
-Create `.agent/tools/{category}/{mcp-name}.md`:
+Create `.agents/tools/{category}/{mcp-name}.md`:
 
 ### File Location Categories
 
@@ -195,7 +195,7 @@ Create `.agent/tools/{category}/{mcp-name}.md`:
 
 ### Documentation Template
 
-Use `.agent/tools/context/augment-context-engine.md` as a reference template.
+Use `.agents/tools/context/augment-context-engine.md` as a reference template.
 
 **Required Sections**:
 
@@ -239,7 +239,7 @@ Quick-reference snippets organized by tool.
 
 ## Step 5: Update generate-opencode-agents.sh
 
-Edit `.agent/scripts/generate-opencode-agents.sh`:
+Edit `.agents/scripts/generate-opencode-agents.sh`:
 
 ### Add MCP to Selected Agents Only
 
@@ -259,7 +259,7 @@ Based on the agent enablement decision from Step 2:
 
 ## Step 6: Update ai-cli-config.sh
 
-Edit `.agent/scripts/ai-cli-config.sh`:
+Edit `.agents/scripts/ai-cli-config.sh`:
 
 ### Add Configure Function
 
@@ -316,17 +316,17 @@ Add setup function if the MCP has prerequisites to validate.
 
 ```bash
 # ShellCheck for any modified shell scripts
-shellcheck .agent/scripts/ai-cli-config.sh
+shellcheck .agents/scripts/ai-cli-config.sh
 shellcheck setup.sh
 
 # Markdown linting
-npx markdownlint-cli .agent/tools/{category}/{mcp-name}.md
+npx markdownlint-cli .agents/tools/{category}/{mcp-name}.md
 
 # Comprehensive quality check
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 
 # Check for credential leaks
-.agent/scripts/secretlint-helper.sh check
+.agents/scripts/secretlint-helper.sh check
 ```
 
 **Call the secretlint subagent:**
@@ -341,7 +341,7 @@ npx markdownlint-cli .agent/tools/{category}/{mcp-name}.md
 
 ```bash
 # Test OpenCode agent generation
-bash .agent/scripts/generate-opencode-agents.sh
+bash .agents/scripts/generate-opencode-agents.sh
 
 # Verify configuration
 cat ~/.config/opencode/opencode.json | python3 -c "
@@ -440,11 +440,11 @@ For reference, see the Augment Context Engine implementation:
 
 | File | Purpose |
 |------|---------|
-| `.agent/tools/context/augment-context-engine.md` | Documentation |
+| `.agents/tools/context/augment-context-engine.md` | Documentation |
 | `configs/augment-context-engine-config.json.txt` | Config template |
 | `configs/mcp-templates/augment-context-engine.json` | MCP snippets |
-| `.agent/scripts/generate-opencode-agents.sh` | Agent config |
-| `.agent/scripts/ai-cli-config.sh` | CLI config function |
+| `.agents/scripts/generate-opencode-agents.sh` | Agent config |
+| `.agents/scripts/ai-cli-config.sh` | CLI config function |
 | `setup.sh` | Setup function |
 
 Search for `augment-context-engine` in these files to see the patterns.
diff --git a/.agent/aidevops/api-integrations.md b/.agents/aidevops/api-integrations.md
similarity index 84%
rename from .agent/aidevops/api-integrations.md
rename to .agents/aidevops/api-integrations.md
index dc190635f..98821a74b 100644
--- a/.agent/aidevops/api-integrations.md
+++ b/.agents/aidevops/api-integrations.md
@@ -29,10 +29,10 @@ tools:
 - **Email**: Amazon SES
 - **Dev Tools**: Context7, LocalWP, Pandoc, Agno, Playwright/Selenium
 
-**Pattern**: `configs/[service]-config.json` + `.agent/scripts/[service]-helper.sh`
+**Pattern**: `configs/[service]-config.json` + `.agents/scripts/[service]-helper.sh`
 
-**API Key Setup**: `bash .agent/scripts/setup-local-api-keys.sh set [service]-api-key YOUR_KEY`
-**Test All APIs**: `bash .agent/scripts/test-all-apis.sh`
+**API Key Setup**: `bash .agents/scripts/setup-local-api-keys.sh set [service]-api-key YOUR_KEY`
+**Test All APIs**: `bash .agents/scripts/test-all-apis.sh`
 <!-- AI-CONTEXT-END -->
 
 This document provides detailed information about all 28+ API integrations supported by the AI DevOps framework.
@@ -48,7 +48,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Server management, domain operations, hosting control
 - **Authentication**: API Token
 - **Configuration**: `configs/hostinger-config.json`
-- **Helper Script**: `.agent/scripts/hostinger-helper.sh`
+- **Helper Script**: `.agents/scripts/hostinger-helper.sh`
 - **Key Features**: VPS management, domain registration, hosting plans
 
 ### **Hetzner Cloud API**
@@ -56,7 +56,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: VPS management, networking, load balancers
 - **Authentication**: API Token
 - **Configuration**: `configs/hetzner-config.json`
-- **Helper Script**: `.agent/scripts/hetzner-helper.sh`
+- **Helper Script**: `.agents/scripts/hetzner-helper.sh`
 - **Key Features**: Server creation, networking, snapshots, load balancers
 
 ### **Closte API**
@@ -64,7 +64,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Managed hosting, application deployment
 - **Authentication**: API Key
 - **Configuration**: `configs/closte-config.json`
-- **Helper Script**: `.agent/scripts/closte-helper.sh`
+- **Helper Script**: `.agents/scripts/closte-helper.sh`
 - **Key Features**: Application management, deployment automation
 
 ### **Coolify API**
@@ -72,7 +72,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Self-hosted PaaS, application management
 - **Authentication**: API Token
 - **Configuration**: `configs/coolify-config.json`
-- **Helper Script**: `.agent/scripts/coolify-helper.sh`
+- **Helper Script**: `.agents/scripts/coolify-helper.sh`
 - **Key Features**: Docker deployment, service management, monitoring
 
 ## 🌐 **Domain & DNS APIs**
@@ -82,7 +82,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: DNS management, security, performance optimization
 - **Authentication**: API Token (scoped permissions)
 - **Configuration**: `configs/cloudflare-dns-config.json`
-- **Helper Script**: `.agent/scripts/dns-helper.sh`
+- **Helper Script**: `.agents/scripts/dns-helper.sh`
 - **Key Features**: DNS records, security rules, analytics, caching
 
 ### **Spaceship API**
@@ -90,7 +90,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Domain registration, management, transfers
 - **Authentication**: API Key
 - **Configuration**: `configs/spaceship-config.json`
-- **Helper Script**: `.agent/scripts/spaceship-helper.sh`
+- **Helper Script**: `.agents/scripts/spaceship-helper.sh`
 - **Key Features**: Domain search, registration, WHOIS, transfers
 
 ### **101domains API**
@@ -98,7 +98,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Domain purchasing, bulk operations, WHOIS
 - **Authentication**: API Credentials
 - **Configuration**: `configs/101domains-config.json`
-- **Helper Script**: `.agent/scripts/101domains-helper.sh`
+- **Helper Script**: `.agents/scripts/101domains-helper.sh`
 - **Key Features**: Bulk domain operations, pricing, availability
 
 ### **AWS Route 53 API**
@@ -106,7 +106,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: DNS management, health checks
 - **Authentication**: AWS Access Keys
 - **Configuration**: `configs/route53-dns-config.json`
-- **Helper Script**: `.agent/scripts/dns-helper.sh`
+- **Helper Script**: `.agents/scripts/dns-helper.sh`
 - **Key Features**: DNS hosting, health checks, traffic routing
 
 ### **Namecheap API**
@@ -114,7 +114,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Domain registration, DNS management
 - **Authentication**: API Key + Username
 - **Configuration**: `configs/namecheap-dns-config.json`
-- **Helper Script**: `.agent/scripts/dns-helper.sh`
+- **Helper Script**: `.agents/scripts/dns-helper.sh`
 - **Key Features**: Domain management, DNS hosting, SSL certificates
 
 ## 📧 **Communication APIs**
@@ -124,7 +124,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Email delivery, bounce handling, analytics
 - **Authentication**: AWS Access Keys
 - **Configuration**: `configs/ses-config.json`
-- **Helper Script**: `.agent/scripts/ses-helper.sh`
+- **Helper Script**: `.agents/scripts/ses-helper.sh`
 - **Key Features**: Email sending, bounce tracking, reputation monitoring
 
 ### **Twilio API**
@@ -132,7 +132,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: SMS, voice calls, WhatsApp, phone verification, call recording
 - **Authentication**: Account SID + Auth Token
 - **Configuration**: `configs/twilio-config.json`
-- **Helper Script**: `.agent/scripts/twilio-helper.sh`
+- **Helper Script**: `.agents/scripts/twilio-helper.sh`
 - **Key Features**: SMS/MMS, voice calls, WhatsApp Business, Verify (2FA), Lookup, recordings, transcriptions
 - **AUP Compliance**: Must follow Twilio Acceptable Use Policy
 - **Recommended Client**: Telfon app for end-user interface (https://mytelfon.com/)
@@ -142,7 +142,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: WordPress site management, updates, monitoring
 - **Authentication**: API Key
 - **Configuration**: `configs/mainwp-config.json`
-- **Helper Script**: `.agent/scripts/mainwp-helper.sh`
+- **Helper Script**: `.agents/scripts/mainwp-helper.sh`
 - **Key Features**: Site management, updates, backups, monitoring
 
 ## 🔐 **Security & Code Quality APIs**
@@ -152,21 +152,21 @@ Our framework provides standardized access to APIs across all major infrastructu
 - **Purpose**: Password management, secure credential storage
 - **Authentication**: API Token
 - **Configuration**: `configs/vaultwarden-config.json`
-- **Helper Script**: `.agent/scripts/vaultwarden-helper.sh`
+- **Helper Script**: `.agents/scripts/vaultwarden-helper.sh`
 - **Key Features**: Credential storage, secure sharing, audit logs
 
 ### **CodeRabbit API**
 
 - **Purpose**: AI-powered code review, security analysis
 - **Authentication**: API Key
-- **Setup Script**: `.agent/scripts/coderabbit-cli.sh`
+- **Setup Script**: `.agents/scripts/coderabbit-cli.sh`
 - **Key Features**: Automated code review, security scanning, suggestions
 
 ### **Codacy API**
 
 - **Purpose**: Code quality analysis, technical debt tracking
 - **Authentication**: API Token
-- **Setup Script**: `.agent/scripts/codacy-cli.sh`
+- **Setup Script**: `.agents/scripts/codacy-cli.sh`
 - **Key Features**: Quality metrics, security analysis, coverage tracking
 
 ### **SonarCloud API**
@@ -212,21 +212,21 @@ Our framework provides standardized access to APIs across all major infrastructu
 
 - **Purpose**: Repository management, actions, security
 - **Authentication**: Personal Access Token
-- **Helper Script**: `.agent/scripts/git-platforms-helper.sh`
+- **Helper Script**: `.agents/scripts/git-platforms-helper.sh`
 - **Key Features**: Repository operations, workflow management, security scanning
 
 ### **GitLab API**
 
 - **Purpose**: Project management, CI/CD, security scanning
 - **Authentication**: Personal Access Token
-- **Helper Script**: `.agent/scripts/git-platforms-helper.sh`
+- **Helper Script**: `.agents/scripts/git-platforms-helper.sh`
 - **Key Features**: Project management, pipeline automation, security features
 
 ### **Gitea API**
 
 - **Purpose**: Self-hosted Git operations, user management
 - **Authentication**: API Token
-- **Helper Script**: `.agent/scripts/git-platforms-helper.sh`
+- **Helper Script**: `.agents/scripts/git-platforms-helper.sh`
 - **Key Features**: Repository management, user administration, webhooks
 
 ### **Context7 API**
@@ -247,7 +247,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 
 - **Purpose**: Convert various document formats to markdown for AI processing
 - **Authentication**: Local tool (no API key required)
-- **Helper Script**: `.agent/scripts/pandoc-helper.sh`
+- **Helper Script**: `.agents/scripts/pandoc-helper.sh`
 - **Key Features**: Multi-format conversion, batch processing, AI-optimized output
 - **Supported Formats**: Word, PDF, HTML, EPUB, LaTeX, and 20+ other formats
 
@@ -255,7 +255,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 
 - **Purpose**: Local AI agent operating system for DevOps automation
 - **Authentication**: API keys for LLM providers (OpenAI, Anthropic, etc.)
-- **Setup Script**: `.agent/scripts/agno-setup.sh`
+- **Setup Script**: `.agents/scripts/agno-setup.sh`
 - **Key Features**: Multi-agent framework, production runtime, complete privacy
 - **Agents**: DevOps Assistant, Code Review Agent, Documentation Agent
 - **Interface**: Agent-UI web interface and REST API
@@ -264,7 +264,7 @@ Our framework provides standardized access to APIs across all major infrastructu
 
 - **Purpose**: LOCAL web automation and browser-based task automation (privacy-first)
 - **Authentication**: Website credentials (stored securely in local environment only)
-- **Setup Script**: Included in `.agent/scripts/agno-setup.sh`
+- **Setup Script**: Included in `.agents/scripts/agno-setup.sh`
 - **Key Features**: LOCAL LinkedIn automation, web scraping, form filling, social media management
 - **Privacy**: Complete local operation - no cloud services or external browsers
 - **Agents**: LinkedIn Automation Assistant (local), Web Automation Assistant (local)
@@ -310,26 +310,26 @@ cp configs/[service]-config.json.txt configs/[service]-config.json
 # Edit with your API credentials
 
 # Test API connection
-./.agent/scripts/[service]-helper.sh test-connection
+./.agents/scripts/[service]-helper.sh test-connection
 ```
 
 ### **API Key Management**
 
 ```bash
 # Secure API key setup
-bash .agent/scripts/setup-local-api-keys.sh set [service]-api-key YOUR_API_KEY
+bash .agents/scripts/setup-local-api-keys.sh set [service]-api-key YOUR_API_KEY
 
 # List configured APIs
-bash .agent/scripts/setup-local-api-keys.sh list
+bash .agents/scripts/setup-local-api-keys.sh list
 
 # Test all API connections
-bash .agent/scripts/test-all-apis.sh
+bash .agents/scripts/test-all-apis.sh
 ```
 
 ## 📚 **Additional Resources**
 
 - [MCP Integration Guide](MCP-INTEGRATIONS.md)
-- [Security Best Practices](.agent/spec/security.md)
+- [Security Best Practices](.agents/spec/security.md)
 - [Configuration Templates](../configs/)
-- [Helper Scripts](../.agent/scripts/)
-- [API Testing Scripts](.agent/scripts/)
+- [Helper Scripts](../.agents/scripts/)
+- [API Testing Scripts](.agents/scripts/)
diff --git a/.agent/aidevops/architecture.md b/.agents/aidevops/architecture.md
similarity index 85%
rename from .agent/aidevops/architecture.md
rename to .agents/aidevops/architecture.md
index 498872ad7..7c7d92ea8 100644
--- a/.agent/aidevops/architecture.md
+++ b/.agents/aidevops/architecture.md
@@ -18,7 +18,7 @@ tools:
 ## Quick Reference
 
 - **Services**: 25+ integrated (hosting, DNS, Git, code quality, email, etc.)
-- **Pattern**: `./.agent/scripts/[service]-helper.sh [command] [account] [target] [options]`
+- **Pattern**: `./.agents/scripts/[service]-helper.sh [command] [account] [target] [options]`
 - **Config**: `configs/[service]-config.json.txt` (template) → `configs/[service]-config.json` (gitignored)
 
 **Categories**:
@@ -32,7 +32,7 @@ tools:
 
 **MCP Ports**: 3001 (LocalWP), 3002 (Vaultwarden), 3003+ (code audit, git platforms)
 
-**Extension**: Follow standard patterns in `.agent/spec/extension.md`
+**Extension**: Follow standard patterns in `.agents/spec/extension.md`
 
 **Design Patterns**: aidevops implements industry-standard agent design patterns (see below)
 <!-- AI-CONTEXT-END -->
@@ -46,8 +46,8 @@ This file provides comprehensive context for AI assistants to understand, manage
 Key integrations:
 - **Agents**: Generated via `generate-opencode-agents.sh` with per-agent MCP tool filtering
 - **Commands**: 41 slash commands deployed to `~/.config/opencode/commands/`
-- **Plugins**: Compaction plugin at `.agent/plugins/opencode-aidevops/`
-- **Prompts**: Custom system prompt at `.agent/prompts/build.txt`
+- **Plugins**: Compaction plugin at `.agents/plugins/opencode-aidevops/`
+- **Prompts**: Custom system prompt at `.agents/prompts/build.txt`
 
 ## Agent Architecture
 
@@ -212,19 +212,19 @@ The AI DevOps Framework provides unified management across:
 All services follow consistent patterns for AI assistant efficiency:
 
 ```bash
-# Standard pattern: ./.agent/scripts/[service]-helper.sh [command] [account/instance] [target] [options]
+# Standard pattern: ./.agents/scripts/[service]-helper.sh [command] [account/instance] [target] [options]
 
 # List/Status Commands
-./.agent/scripts/[service]-helper.sh [accounts|instances|servers|sites]
+./.agents/scripts/[service]-helper.sh [accounts|instances|servers|sites]
 
 # Management Commands
-./.agent/scripts/[service]-helper.sh [action] [account/instance] [target] [options]
+./.agents/scripts/[service]-helper.sh [action] [account/instance] [target] [options]
 
 # Monitoring Commands
-./.agent/scripts/[service]-helper.sh [monitor|audit|status] [account/instance]
+./.agents/scripts/[service]-helper.sh [monitor|audit|status] [account/instance]
 
 # Help Commands
-./.agent/scripts/[service]-helper.sh help
+./.agents/scripts/[service]-helper.sh help
 ```
 
 ### **Configuration Structure**
@@ -251,9 +251,9 @@ configs/[service]-config.json      # Working config (gitignored)
 ### **Documentation Structure**
 
 ```bash
-.agent/AGENTS.md                      # AI assistant framework context
-.agent/[SERVICE].md                   # Complete service guide
-.agent/recommendations.md             # Provider selection guide
+.agents/AGENTS.md                      # AI assistant framework context
+.agents/[SERVICE].md                   # Complete service guide
+.agents/recommendations.md             # Provider selection guide
 ```
 
 ## 🚀 **Framework Usage Examples**
@@ -262,33 +262,33 @@ configs/[service]-config.json      # Working config (gitignored)
 
 ```bash
 # 1. Setup wizard for intelligent guidance
-./.agent/scripts/setup-wizard-helper.sh full-setup
+./.agents/scripts/setup-wizard-helper.sh full-setup
 
 # 2. Domain research and purchase
-./.agent/scripts/spaceship-helper.sh bulk-check personal myproject.com myproject.dev
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.com 1 true
+./.agents/scripts/spaceship-helper.sh bulk-check personal myproject.com myproject.dev
+./.agents/scripts/spaceship-helper.sh purchase personal myproject.com 1 true
 
 # 3. Git repository creation
-./.agent/scripts/git-platforms-helper.sh github-create personal myproject "Description" false
-./.agent/scripts/git-platforms-helper.sh local-init ~/projects myproject
+./.agents/scripts/git-platforms-helper.sh github-create personal myproject "Description" false
+./.agents/scripts/git-platforms-helper.sh local-init ~/projects myproject
 
 # 4. Infrastructure provisioning
-./.agent/scripts/hetzner-helper.sh create-server production myproject
+./.agents/scripts/hetzner-helper.sh create-server production myproject
 
 # 5. DNS configuration
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
+./.agents/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
 
 # 6. Application deployment
-./.agent/scripts/coolify-helper.sh deploy production myproject
+./.agents/scripts/coolify-helper.sh deploy production myproject
 
 # 7. Security setup
-./.agent/scripts/vaultwarden-helper.sh create production "MyProject Creds" user pass
+./.agents/scripts/vaultwarden-helper.sh create production "MyProject Creds" user pass
 
 # 8. Code quality setup
-./.agent/scripts/code-audit-helper.sh audit myproject
+./.agents/scripts/code-audit-helper.sh audit myproject
 
 # 9. Monitoring setup
-./.agent/scripts/ses-helper.sh monitor production
+./.agents/scripts/ses-helper.sh monitor production
 ```
 
 ### **Multi-Service Operations**
@@ -296,16 +296,16 @@ configs/[service]-config.json      # Working config (gitignored)
 ```bash
 # Comprehensive infrastructure audit
 for service in hostinger hetzner coolify mainwp; do
-    ./.agent/scripts/${service}-helper.sh monitor production
+    ./.agents/scripts/${service}-helper.sh monitor production
 done
 
 # Bulk domain management
-./.agent/scripts/spaceship-helper.sh bulk-check personal \
+./.agents/scripts/spaceship-helper.sh bulk-check personal \
   project1.com project2.com project3.com
 
 # Cross-platform Git management
-./.agent/scripts/git-platforms-helper.sh audit github personal
-./.agent/scripts/git-platforms-helper.sh audit gitlab personal
+./.agents/scripts/git-platforms-helper.sh audit github personal
+./.agents/scripts/git-platforms-helper.sh audit gitlab personal
 ```
 
 ## 🔧 **MCP Server Ecosystem**
@@ -314,14 +314,14 @@ done
 
 ```bash
 # Complete MCP server stack for AI assistants:
-./.agent/scripts/localhost-helper.sh start-mcp          # Port 3001 - LocalWP access
-./.agent/scripts/vaultwarden-helper.sh start-mcp production 3002  # Secure credentials
-./.agent/scripts/code-audit-helper.sh start-mcp coderabbit 3003   # Code analysis
-./.agent/scripts/code-audit-helper.sh start-mcp codacy 3004       # Quality metrics
-./.agent/scripts/code-audit-helper.sh start-mcp sonarcloud 3005   # Security analysis
-./.agent/scripts/git-platforms-helper.sh start-mcp github 3006    # Git management
-./.agent/scripts/git-platforms-helper.sh start-mcp gitlab 3007    # GitLab access
-./.agent/scripts/git-platforms-helper.sh start-mcp gitea 3008     # Gitea access
+./.agents/scripts/localhost-helper.sh start-mcp          # Port 3001 - LocalWP access
+./.agents/scripts/vaultwarden-helper.sh start-mcp production 3002  # Secure credentials
+./.agents/scripts/code-audit-helper.sh start-mcp coderabbit 3003   # Code analysis
+./.agents/scripts/code-audit-helper.sh start-mcp codacy 3004       # Quality metrics
+./.agents/scripts/code-audit-helper.sh start-mcp sonarcloud 3005   # Security analysis
+./.agents/scripts/git-platforms-helper.sh start-mcp github 3006    # Git management
+./.agents/scripts/git-platforms-helper.sh start-mcp gitlab 3007    # GitLab access
+./.agents/scripts/git-platforms-helper.sh start-mcp gitea 3008     # Gitea access
 ```
 
 ### **MCP Integration Benefits**
@@ -339,7 +339,7 @@ done
 #### **1. Create Helper Script**
 
 ```bash
-# File: .agent/scripts/[service-name]-helper.sh
+# File: .agents/scripts/[service-name]-helper.sh
 #!/bin/bash
 
 # [Service Name] Helper Script
@@ -399,7 +399,7 @@ CONFIG_FILE="../configs/[service-name]-config.json"
 #### **3. Create Comprehensive Documentation**
 
 ```bash
-# File: .agent/[SERVICE-NAME].md
+# File: .agents/[SERVICE-NAME].md
 # [Service Name] Guide
 
 ## 🏢 **Provider Overview**
diff --git a/.agent/aidevops/claude-flow-comparison.md b/.agents/aidevops/claude-flow-comparison.md
similarity index 100%
rename from .agent/aidevops/claude-flow-comparison.md
rename to .agents/aidevops/claude-flow-comparison.md
diff --git a/.agent/aidevops/configs.md b/.agents/aidevops/configs.md
similarity index 92%
rename from .agent/aidevops/configs.md
rename to .agents/aidevops/configs.md
index 9f43c0b02..d23f9f9bd 100644
--- a/.agent/aidevops/configs.md
+++ b/.agents/aidevops/configs.md
@@ -19,9 +19,9 @@ tools:
 
 - **Templates**: `configs/[service]-config.json.txt` (safe to commit)
 - **Working files**: `configs/[service]-config.json` (gitignored, contains credentials)
-- **Setup wizard**: `.agent/scripts/setup-wizard-helper.sh full-setup`
-- **Generate configs**: `.agent/scripts/setup-wizard-helper.sh generate-configs`
-- **Test connections**: `.agent/scripts/setup-wizard-helper.sh test-connections`
+- **Setup wizard**: `.agents/scripts/setup-wizard-helper.sh full-setup`
+- **Generate configs**: `.agents/scripts/setup-wizard-helper.sh generate-configs`
+- **Test connections**: `.agents/scripts/setup-wizard-helper.sh test-connections`
 - **Validate JSON**: `jq '.' [service]-config.json`
 - **Secure permissions**: `chmod 600 configs/*-config.json`
 - **Structure**: `{"accounts": {...}, "default_settings": {...}, "mcp_servers": {...}}`
@@ -179,7 +179,7 @@ cp [service]-config.json.txt [service]-config.json
 nano [service]-config.json
 
 # 3. Test configuration
-../.agent/scripts/[service]-helper.sh accounts
+../.agents/scripts/[service]-helper.sh accounts
 
 # 4. Verify security
 chmod 600 [service]-config.json
@@ -189,13 +189,13 @@ chmod 600 [service]-config.json
 
 ```bash
 # Automated setup with guidance
-../.agent/scripts/setup-wizard-helper.sh full-setup
+../.agents/scripts/setup-wizard-helper.sh full-setup
 
 # Generate all config files from templates
-../.agent/scripts/setup-wizard-helper.sh generate-configs
+../.agents/scripts/setup-wizard-helper.sh generate-configs
 
 # Test all connections
-../.agent/scripts/setup-wizard-helper.sh test-connections
+../.agents/scripts/setup-wizard-helper.sh test-connections
 ```
 
 ## Validation & Testing
@@ -207,10 +207,10 @@ chmod 600 [service]-config.json
 jq '.' [service]-config.json
 
 # Test service connectivity
-../.agent/scripts/[service]-helper.sh accounts
+../.agents/scripts/[service]-helper.sh accounts
 
 # Verify API permissions
-../.agent/scripts/[service]-helper.sh help
+../.agents/scripts/[service]-helper.sh help
 ```
 
 ### Security Validation
diff --git a/.agent/aidevops/docs.md b/.agents/aidevops/docs.md
similarity index 97%
rename from .agent/aidevops/docs.md
rename to .agents/aidevops/docs.md
index 301f26f11..05c291e01 100644
--- a/.agent/aidevops/docs.md
+++ b/.agents/aidevops/docs.md
@@ -17,7 +17,7 @@ tools:
 
 ## Quick Reference
 
-- **Location**: All docs in `.agent/*.md` (lowercase filenames)
+- **Location**: All docs in `.agents/*.md` (lowercase filenames)
 - **Service guides**: hostinger.md, hetzner.md, coolify.md, mainwp.md, etc.
 - **Standard structure**: Overview, Configuration, Usage, Security, Troubleshooting, MCP Integration
 - **AI Context blocks**: `<!-- AI-CONTEXT-START -->` sections for quick reference
@@ -219,16 +219,16 @@ Each service guide includes:
 
 ```bash
 # Service-specific information
-.agent/[SERVICE-NAME].md
+.agents/[SERVICE-NAME].md
 
 # Framework overview
-.agent/AGENTS.md
+.agents/AGENTS.md
 
 # Provider selection guidance
-.agent/recommendations.md
+.agents/recommendations.md
 
 # Setup procedures
-.agent/[SERVICE]-SETUP.md
+.agents/[SERVICE]-SETUP.md
 ```
 
 ### **Search Patterns**
diff --git a/.agent/aidevops/extension.md b/.agents/aidevops/extension.md
similarity index 96%
rename from .agent/aidevops/extension.md
rename to .agents/aidevops/extension.md
index 45a77cd17..babf70849 100644
--- a/.agent/aidevops/extension.md
+++ b/.agents/aidevops/extension.md
@@ -19,9 +19,9 @@ tools:
 ## Quick Reference
 
 - **New service steps**: Research -> Helper script -> Config template -> Documentation -> Update framework files
-- **Helper location**: `.agent/scripts/[service-name]-helper.sh`
+- **Helper location**: `.agents/scripts/[service-name]-helper.sh`
 - **Config template**: `configs/[service-name]-config.json.txt`
-- **Documentation**: `.agent/[service-name].md`
+- **Documentation**: `.agents/[service-name].md`
 - **Required functions**: check_dependencies, load_config, get_account_config, api_request, list_accounts, show_help, main
 - **Security checklist**: Token validation, input sanitization, no credential exposure, rate limiting, confirmation prompts
 - **Testing**: Functional, integration, and security testing required
@@ -63,7 +63,7 @@ tools:
 ### Step 2: Create Helper Script
 
 ```bash
-# File: .agent/scripts/[service-name]-helper.sh
+# File: .agents/scripts/[service-name]-helper.sh
 #!/bin/bash
 
 # [Service Name] Helper Script
@@ -142,7 +142,7 @@ main "$@"
 ### Step 4: Create Comprehensive Documentation
 
 ```bash
-# File: .agent/[SERVICE-NAME].md
+# File: .agents/[SERVICE-NAME].md
 # [Service Name] Guide
 
 ## 🏢 **Provider Overview**
@@ -191,10 +191,10 @@ echo "configs/[service-name]-config.json" >> .gitignore
 # - Add to appropriate service category
 # - Update service count
 
-# Update .agent/recommendations-opinionated.md
+# Update .agents/recommendations-opinionated.md
 # - Add to appropriate category with description
 
-# Update .agent/scripts/setup-wizard-helper.sh
+# Update .agents/scripts/setup-wizard-helper.sh
 # - Add to service recommendations logic
 # - Add to API keys guide
 # - Add to configuration generation
diff --git a/.agent/aidevops/mcp-integrations.md b/.agents/aidevops/mcp-integrations.md
similarity index 95%
rename from .agent/aidevops/mcp-integrations.md
rename to .agents/aidevops/mcp-integrations.md
index a5ec625d3..1056368a6 100644
--- a/.agent/aidevops/mcp-integrations.md
+++ b/.agents/aidevops/mcp-integrations.md
@@ -17,8 +17,8 @@ tools:
 
 ## Quick Reference
 
-**Setup All**: `bash .agent/scripts/setup-mcp-integrations.sh all`
-**Validate**: `bash .agent/scripts/validate-mcp-integrations.sh`
+**Setup All**: `bash .agents/scripts/setup-mcp-integrations.sh all`
+**Validate**: `bash .agents/scripts/validate-mcp-integrations.sh`
 
 **Browser & Web**:
 - Chrome DevTools MCP: `claude mcp add chrome-devtools npx chrome-devtools-mcp@latest`
@@ -356,19 +356,19 @@ export UNSTRACT_IMAGE_TAG="latest"
 
 ```bash
 # Install all MCP integrations
-bash .agent/scripts/setup-mcp-integrations.sh all
+bash .agents/scripts/setup-mcp-integrations.sh all
 
 # Validate setup
-bash .agent/scripts/validate-mcp-integrations.sh
+bash .agents/scripts/validate-mcp-integrations.sh
 ```
 
 ### **Individual Integration Setup**
 
 ```bash
 # Install specific integration
-bash .agent/scripts/setup-mcp-integrations.sh chrome-devtools
-bash .agent/scripts/setup-mcp-integrations.sh playwright
-bash .agent/scripts/setup-mcp-integrations.sh ahrefs
+bash .agents/scripts/setup-mcp-integrations.sh chrome-devtools
+bash .agents/scripts/setup-mcp-integrations.sh playwright
+bash .agents/scripts/setup-mcp-integrations.sh ahrefs
 ```
 
 ### **Configuration Steps**
@@ -404,7 +404,7 @@ bash .agent/scripts/setup-mcp-integrations.sh ahrefs
 Run the validation script to see your current setup status:
 
 ```bash
-bash .agent/scripts/validate-mcp-integrations.sh
+bash .agents/scripts/validate-mcp-integrations.sh
 ```
 
 Expected output for fully configured setup:
@@ -416,8 +416,8 @@ Expected output for fully configured setup:
 
 ## 📚 **Additional Resources**
 
-- [MCP Integration Setup Script](.agent/scripts/setup-mcp-integrations.sh)
-- [MCP Validation Script](.agent/scripts/validate-mcp-integrations.sh)
+- [MCP Integration Setup Script](.agents/scripts/setup-mcp-integrations.sh)
+- [MCP Validation Script](.agents/scripts/validate-mcp-integrations.sh)
 - [MCP Configuration Templates](configs/mcp-templates/)
 - [Chrome DevTools Examples](docs/mcp-examples/chrome-devtools-examples.md)
 - [Playwright Automation Examples](docs/mcp-examples/playwright-automation-examples.md)
diff --git a/.agent/aidevops/mcp-troubleshooting.md b/.agents/aidevops/mcp-troubleshooting.md
similarity index 100%
rename from .agent/aidevops/mcp-troubleshooting.md
rename to .agents/aidevops/mcp-troubleshooting.md
diff --git a/.agent/aidevops/memory-patterns.md b/.agents/aidevops/memory-patterns.md
similarity index 97%
rename from .agent/aidevops/memory-patterns.md
rename to .agents/aidevops/memory-patterns.md
index 5df86bf36..e09f2a8f0 100644
--- a/.agent/aidevops/memory-patterns.md
+++ b/.agents/aidevops/memory-patterns.md
@@ -22,7 +22,7 @@ tools:
 - **Project Files**: `CLAUDE.md`, `GEMINI.md`, `.cursorrules` in project root
 - **Key Instruction**: "At the beginning of each session, read ~/AGENTS.md"
 - **Setup Script**: `setup.sh` includes automatic creation
-- **Config Script**: `.agent/scripts/ai-cli-config.sh`
+- **Config Script**: `.agents/scripts/ai-cli-config.sh`
 - **Supported Tools**: Qwen CLI, Claude Code, Gemini CLI, Cursor AI, GitHub Copilot, Factory.ai Droid
 - **Note**: Warp AI and Amp Code use project context (no specific memory files)
 <!-- AI-CONTEXT-END -->
@@ -113,7 +113,7 @@ At the beginning of each session, read ~/AGENTS.md to get additional context and
 ### **✅ AUTOMATIC CREATION:**
 
 - **Setup Script**: `setup.sh` includes AI memory file creation
-- **Configuration Script**: `.agent/scripts/ai-cli-config.sh` handles all memory files
+- **Configuration Script**: `.agents/scripts/ai-cli-config.sh` handles all memory files
 - **Detection Logic**: Automatically detects installed AI tools and creates appropriate files
 - **Preservation**: Existing files are preserved, new ones created as needed
 
diff --git a/.agent/aidevops/providers.md b/.agents/aidevops/providers.md
similarity index 99%
rename from .agent/aidevops/providers.md
rename to .agents/aidevops/providers.md
index abf1c66c4..8799243e5 100644
--- a/.agent/aidevops/providers.md
+++ b/.agents/aidevops/providers.md
@@ -17,7 +17,7 @@ tools:
 
 ## Quick Reference
 
-- **Location**: `.agent/scripts/[service]-helper.sh`
+- **Location**: `.agents/scripts/[service]-helper.sh`
 - **Pattern**: `./[service]-helper.sh [command] [account] [target] [options]`
 - **Standard commands**: `help | accounts | monitor | audit | status`
 - **Config**: `configs/[service]-config.json`
diff --git a/.agent/aidevops/recommendations.md b/.agents/aidevops/recommendations.md
similarity index 97%
rename from .agent/aidevops/recommendations.md
rename to .agents/aidevops/recommendations.md
index ef8c01e8f..8c9027be5 100644
--- a/.agent/aidevops/recommendations.md
+++ b/.agents/aidevops/recommendations.md
@@ -210,13 +210,13 @@ This guide outlines proven best practices for infrastructure management and help
 
 ```bash
 # List LocalWP sites
-./.agent/scripts/localhost-helper.sh list-localwp
+./.agents/scripts/localhost-helper.sh list-localwp
 
 # Setup custom domain for LocalWP site
-./.agent/scripts/localhost-helper.sh setup-localwp-domain plugin-testing plugin-testing.local
+./.agents/scripts/localhost-helper.sh setup-localwp-domain plugin-testing plugin-testing.local
 
 # Generate SSL certificate
-./.agent/scripts/localhost-helper.sh generate-cert plugin-testing.local
+./.agents/scripts/localhost-helper.sh generate-cert plugin-testing.local
 ```
 
 ### **Docker Development**
@@ -282,7 +282,7 @@ This guide outlines proven best practices for infrastructure management and help
 - **Helper scripts**: Root level for easy access
 - **Configuration samples**: In `configs/` directory
 - **Documentation**: In `docs/` directory
-- **Provider scripts**: In `.agent/scripts/` directory
+- **Provider scripts**: In `.agents/scripts/` directory
 
 ## 🔍 **Monitoring & Maintenance**
 
diff --git a/.agent/aidevops/requirements.md b/.agents/aidevops/requirements.md
similarity index 98%
rename from .agent/aidevops/requirements.md
rename to .agents/aidevops/requirements.md
index c666d5340..09ec027f6 100644
--- a/.agent/aidevops/requirements.md
+++ b/.agents/aidevops/requirements.md
@@ -25,7 +25,7 @@ tools:
 - **MCP**: Real-time data access via MCP servers
 - **Categories**: Infrastructure, Deployment, Content, Security, Quality, Git, Email, DNS, Local
 - **Quality check**: `curl -s "https://sonarcloud.io/api/measures/component?component=marcusquinn_aidevops&metricKeys=bugs,vulnerabilities,code_smells"`
-- **ShellCheck**: `find .agent/scripts/ -name "*.sh" -exec shellcheck {} \;`
+- **ShellCheck**: `find .agents/scripts/ -name "*.sh" -exec shellcheck {} \;`
 <!-- AI-CONTEXT-END -->
 
 ## Core Requirements
@@ -87,7 +87,7 @@ curl -s "https://sonarcloud.io/api/measures/component?component=marcusquinn_aide
 curl -s "https://www.codefactor.io/repository/github/marcusquinn/aidevops"
 
 # ShellCheck validation
-find .agent/scripts/ -name "*.sh" -exec shellcheck {} \;
+find .agents/scripts/ -name "*.sh" -exec shellcheck {} \;
 ```
 
 ## 🏗️ **Service Categories & Capabilities**
diff --git a/.agent/aidevops/resources.md b/.agents/aidevops/resources.md
similarity index 93%
rename from .agent/aidevops/resources.md
rename to .agents/aidevops/resources.md
index 8decc406c..2a013961c 100644
--- a/.agent/aidevops/resources.md
+++ b/.agents/aidevops/resources.md
@@ -40,12 +40,12 @@ tools:
 
 ### Deployment & Orchestration
 
-- **Coolify API**: https://coolify.io/.agent/api
+- **Coolify API**: https://coolify.io/.agents/api
 - **Coolify GitHub**: https://github.com/coollabsio/coolify
 
 ### Content Management
 
-- **MainWP API**: https://mainwp.com/help/.agent/mainwp-rest-api/
+- **MainWP API**: https://mainwp.com/help/.agents/mainwp-rest-api/
 - **MainWP Extensions**: https://mainwp.com/extensions/
 
 ### Security & Secrets
@@ -105,19 +105,19 @@ tools:
 ### CLI Tools
 
 - **jq (JSON processor)**: https://jqlang.github.io/jq/
-- **curl (HTTP client)**: https://curl.se/.agent/
+- **curl (HTTP client)**: https://curl.se/.agents/
 - **git (Version control)**: https://git-scm.com/docs
 - **Bitwarden CLI**: https://bitwarden.com/help/cli/
 
 ### Package Managers
 
 - **Homebrew (macOS)**: https://brew.sh/
-- **APT (Ubuntu/Debian)**: https://ubuntu.com/server/.agent/package-management
+- **APT (Ubuntu/Debian)**: https://ubuntu.com/server/.agents/package-management
 - **npm (Node.js)**: https://docs.npmjs.com/
 
 ### Security Tools
 
-- **OpenSSL**: https://www.openssl.org/.agent/
+- **OpenSSL**: https://www.openssl.org/.agents/
 - **GPG**: https://gnupg.org/documentation/
 - **SSH**: https://www.openssh.com/manual.html
 
@@ -145,8 +145,8 @@ tools:
 
 ### Monitoring Tools
 
-- **Prometheus**: https://prometheus.io/.agent/
-- **Grafana**: https://grafana.com/.agent/
+- **Prometheus**: https://prometheus.io/.agents/
+- **Grafana**: https://grafana.com/.agents/
 - **Uptime Robot**: https://uptimerobot.com/api/
 
 ### Log Management
@@ -171,7 +171,7 @@ tools:
 
 ### Container Orchestration
 
-- **Kubernetes**: https://kubernetes.io/.agent/
+- **Kubernetes**: https://kubernetes.io/.agents/
 - **Docker Compose**: https://docs.docker.com/compose/
 - **Portainer**: https://docs.portainer.io/
 
diff --git a/.agent/aidevops/security-requirements.md b/.agents/aidevops/security-requirements.md
similarity index 100%
rename from .agent/aidevops/security-requirements.md
rename to .agents/aidevops/security-requirements.md
diff --git a/.agent/aidevops/security.md b/.agents/aidevops/security.md
similarity index 97%
rename from .agent/aidevops/security.md
rename to .agents/aidevops/security.md
index 6dea21165..9a3d24264 100644
--- a/.agent/aidevops/security.md
+++ b/.agents/aidevops/security.md
@@ -222,7 +222,7 @@ chmod 600 ~/.ssh/*_password
 
 # Scripts
 chmod 755 *.sh
-chmod 755 .agent/scripts/*.sh
+chmod 755 .agents/scripts/*.sh
 chmod 755 ssh/*.sh
 ```
 
@@ -242,7 +242,7 @@ echo "*.pem" >> .gitignore
 ### Directory Structure
 
 ```text
-.agent/
+.agents/
 ├── scripts/              # Shared (committed to Git)
 │   └── [helper].sh       # Use placeholders: YOUR_API_KEY_HERE
 └── scripts-private/      # Private (gitignored, never committed)
@@ -253,7 +253,7 @@ echo "*.pem" >> .gitignore
 
 **Shared scripts (`scripts/`):**
 - Use placeholders: `readonly API_TOKEN="YOUR_API_TOKEN_HERE"`
-- Load from secure storage: `api_key=$(.agent/scripts/setup-local-api-keys.sh get service)`
+- Load from secure storage: `api_key=$(.agents/scripts/setup-local-api-keys.sh get service)`
 - Never hardcode actual credentials
 
 **Private scripts (`scripts-private/`):**
@@ -266,7 +266,7 @@ echo "*.pem" >> .gitignore
 ```bash
 # Verify private scripts are gitignored
 git status --ignored | grep scripts-private
-# Should show: .agent/scripts-private/ (ignored)
+# Should show: .agents/scripts-private/ (ignored)
 ```
 
 ## 🌐 **Network Security**
diff --git a/.agent/aidevops/self-improving-agents.md b/.agents/aidevops/self-improving-agents.md
similarity index 99%
rename from .agent/aidevops/self-improving-agents.md
rename to .agents/aidevops/self-improving-agents.md
index b4c370ea1..a53841446 100644
--- a/.agent/aidevops/self-improving-agents.md
+++ b/.agents/aidevops/self-improving-agents.md
@@ -94,7 +94,7 @@ self-improve-helper.sh refine [--dry-run]
 
 ```json
 {
-  "file": ".agent/workflows/git-workflow.md",
+  "file": ".agents/workflows/git-workflow.md",
   "change_type": "edit",
   "description": "Add guidance for handling merge conflicts",
   "diff": "...",
diff --git a/.agent/aidevops/service-links.md b/.agents/aidevops/service-links.md
similarity index 100%
rename from .agent/aidevops/service-links.md
rename to .agents/aidevops/service-links.md
diff --git a/.agent/aidevops/services.md b/.agents/aidevops/services.md
similarity index 91%
rename from .agent/aidevops/services.md
rename to .agents/aidevops/services.md
index 9f2684ff4..aeb50b255 100644
--- a/.agent/aidevops/services.md
+++ b/.agents/aidevops/services.md
@@ -41,7 +41,7 @@ tools:
 - **Use Cases**: Small websites, WordPress sites, budget hosting
 - **Helper**: `hostinger-helper.sh`
 - **Config**: `hostinger-config.json`
-- **Docs**: `.agent/hostinger.md`
+- **Docs**: `.agents/hostinger.md`
 
 ### Hetzner Cloud
 
@@ -51,7 +51,7 @@ tools:
 - **Use Cases**: VPS hosting, cloud infrastructure, European hosting
 - **Helper**: `hetzner-helper.sh`
 - **Config**: `hetzner-config.json`
-- **Docs**: `.agent/hetzner.md`
+- **Docs**: `.agents/hetzner.md`
 
 ### Closte
 
@@ -61,7 +61,7 @@ tools:
 - **Use Cases**: VPS hosting, application hosting, development servers
 - **Helper**: `closte-helper.sh`
 - **Config**: `closte-config.json`
-- **Docs**: `.agent/closte.md`
+- **Docs**: `.agents/closte.md`
 
 ### Cloudron
 
@@ -71,7 +71,7 @@ tools:
 - **Use Cases**: Self-hosted applications, team productivity, app management
 - **Helper**: `cloudron-helper.sh`
 - **Config**: `cloudron-config.json`
-- **Docs**: `.agent/cloudron.md`
+- **Docs**: `.agents/cloudron.md`
 
 ## Deployment & Orchestration (1 Service)
 
@@ -83,7 +83,7 @@ tools:
 - **Use Cases**: Application deployment, CI/CD, container orchestration
 - **Helper**: `coolify-helper.sh`
 - **Config**: `coolify-config.json`
-- **Docs**: `.agent/coolify.md`
+- **Docs**: `.agents/coolify.md`
 
 ## Content Management (1 Service)
 
@@ -95,7 +95,7 @@ tools:
 - **Use Cases**: Multiple WordPress sites, client management, bulk updates
 - **Helper**: `mainwp-helper.sh`
 - **Config**: `mainwp-config.json`
-- **Docs**: `.agent/mainwp.md`
+- **Docs**: `.agents/mainwp.md`
 
 ## Security & Secrets (1 Service)
 
@@ -108,7 +108,7 @@ tools:
 - **Use Cases**: Password management, secure credential storage, team secrets
 - **Helper**: `vaultwarden-helper.sh`
 - **Config**: `vaultwarden-config.json`
-- **Docs**: `.agent/vaultwarden.md`
+- **Docs**: `.agents/vaultwarden.md`
 
 ## Code Quality & Auditing (4 Services)
 
@@ -121,7 +121,7 @@ tools:
 - **Use Cases**: Automated code reviews, quality analysis, security scanning
 - **Helper**: `code-audit-helper.sh` (multi-service)
 - **Config**: `code-audit-config.json`
-- **Docs**: `.agent/code-auditing.md`
+- **Docs**: `.agents/code-auditing.md`
 
 ### CodeFactor
 
@@ -131,7 +131,7 @@ tools:
 - **Use Cases**: Continuous code quality monitoring, technical debt tracking
 - **Helper**: `code-audit-helper.sh` (multi-service)
 - **Config**: `code-audit-config.json`
-- **Docs**: `.agent/code-auditing.md`
+- **Docs**: `.agents/code-auditing.md`
 
 ### Codacy
 
@@ -142,7 +142,7 @@ tools:
 - **Use Cases**: Enterprise code quality, team collaboration, compliance
 - **Helper**: `code-audit-helper.sh` (multi-service)
 - **Config**: `code-audit-config.json`
-- **Docs**: `.agent/code-auditing.md`
+- **Docs**: `.agents/code-auditing.md`
 
 ### SonarCloud
 
@@ -153,7 +153,7 @@ tools:
 - **Use Cases**: Professional development, security compliance, quality gates
 - **Helper**: `code-audit-helper.sh` (multi-service)
 - **Config**: `code-audit-config.json`
-- **Docs**: `.agent/code-auditing.md`
+- **Docs**: `.agents/code-auditing.md`
 
 ## Version Control & Git Platforms (4 Services)
 
@@ -166,7 +166,7 @@ tools:
 - **Use Cases**: Open source projects, team collaboration, enterprise development
 - **Helper**: `git-platforms-helper.sh` (multi-platform)
 - **Config**: `git-platforms-config.json`
-- **Docs**: `.agent/git-platforms.md`
+- **Docs**: `.agents/git-platforms.md`
 
 ### GitLab
 
@@ -177,7 +177,7 @@ tools:
 - **Use Cases**: Enterprise DevOps, self-hosted solutions, integrated workflows
 - **Helper**: `git-platforms-helper.sh` (multi-platform)
 - **Config**: `git-platforms-config.json`
-- **Docs**: `.agent/git-platforms.md`
+- **Docs**: `.agents/git-platforms.md`
 
 ### Gitea
 
@@ -188,7 +188,7 @@ tools:
 - **Use Cases**: Self-hosted Git, private repositories, lightweight deployments
 - **Helper**: `git-platforms-helper.sh` (multi-platform)
 - **Config**: `git-platforms-config.json`
-- **Docs**: `.agent/git-platforms.md`
+- **Docs**: `.agents/git-platforms.md`
 
 ### Local Git
 
@@ -198,7 +198,7 @@ tools:
 - **Use Cases**: Local development, repository initialization, offline work
 - **Helper**: `git-platforms-helper.sh` (multi-platform)
 - **Config**: `git-platforms-config.json`
-- **Docs**: `.agent/git-platforms.md`
+- **Docs**: `.agents/git-platforms.md`
 
 ## Email Services (1 Service)
 
@@ -210,7 +210,7 @@ tools:
 - **Use Cases**: Transactional emails, marketing emails, email monitoring
 - **Helper**: `ses-helper.sh`
 - **Config**: `ses-config.json`
-- **Docs**: `.agent/services/email/ses.md`
+- **Docs**: `.agents/services/email/ses.md`
 
 ## Communications Services (2 Services)
 
@@ -222,7 +222,7 @@ tools:
 - **Use Cases**: SMS notifications, voice calls, 2FA/OTP, WhatsApp Business, call recording
 - **Helper**: `twilio-helper.sh`
 - **Config**: `twilio-config.json`
-- **Docs**: `.agent/services/communications/twilio.md`
+- **Docs**: `.agents/services/communications/twilio.md`
 - **AUP**: Must comply with Twilio Acceptable Use Policy
 
 ### Telfon
@@ -232,7 +232,7 @@ tools:
 - **Website**: https://mytelfon.com/
 - **Use Cases**: Sales teams, customer support, remote teams needing softphone
 - **Apps**: iOS, Android, Chrome Extension, Edge Add-on
-- **Docs**: `.agent/services/communications/telfon.md`
+- **Docs**: `.agents/services/communications/telfon.md`
 - **Note**: Recommended for end users who need a calling/SMS interface
 
 ## Domain & DNS (5 Services)
@@ -245,7 +245,7 @@ tools:
 - **Use Cases**: Domain purchasing, portfolio management, API automation
 - **Helper**: `spaceship-helper.sh`
 - **Config**: `spaceship-config.json`
-- **Docs**: `.agent/spaceship.md`, `.agent/domain-purchasing.md`
+- **Docs**: `.agents/spaceship.md`, `.agents/domain-purchasing.md`
 
 ### 101domains
 
@@ -255,7 +255,7 @@ tools:
 - **Use Cases**: Extensive TLD needs, bulk domain operations, reseller services
 - **Helper**: `101domains-helper.sh`
 - **Config**: `101domains-config.json`
-- **Docs**: `.agent/101DOMAINS.md`
+- **Docs**: `.agents/101DOMAINS.md`
 
 ### Cloudflare DNS
 
@@ -265,7 +265,7 @@ tools:
 - **Use Cases**: DNS management, CDN, security, performance optimization
 - **Helper**: `dns-helper.sh` (multi-provider)
 - **Config**: `cloudflare-dns-config.json`
-- **Docs**: `.agent/dns-providers.md`
+- **Docs**: `.agents/dns-providers.md`
 
 ### Namecheap DNS
 
@@ -275,7 +275,7 @@ tools:
 - **Use Cases**: DNS hosting for Namecheap domains, basic DNS needs
 - **Helper**: `dns-helper.sh` (multi-provider)
 - **Config**: `namecheap-dns-config.json`
-- **Docs**: `.agent/dns-providers.md`
+- **Docs**: `.agents/dns-providers.md`
 
 ### Route 53
 
@@ -285,7 +285,7 @@ tools:
 - **Use Cases**: Advanced DNS routing, health checks, AWS integration
 - **Helper**: `dns-helper.sh` (multi-provider)
 - **Config**: `route53-dns-config.json`
-- **Docs**: `.agent/dns-providers.md`
+- **Docs**: `.agents/dns-providers.md`
 
 ## Development & Local (4 Services)
 
@@ -297,7 +297,7 @@ tools:
 - **Use Cases**: Local development, testing, offline development
 - **Helper**: `localhost-helper.sh`
 - **Config**: `localhost-config.json`
-- **Docs**: `.agent/localhost.md`
+- **Docs**: `.agents/localhost.md`
 
 ### LocalWP
 
@@ -307,7 +307,7 @@ tools:
 - **Use Cases**: WordPress development, local testing, database access
 - **Helper**: `localhost-helper.sh` (includes LocalWP)
 - **Config**: `localhost-config.json`
-- **Docs**: `.agent/localwp-mcp.md`
+- **Docs**: `.agents/localwp-mcp.md`
 
 ### Context7 MCP
 
@@ -317,7 +317,7 @@ tools:
 - **Use Cases**: AI assistant documentation, real-time context, development help
 - **Helper**: Context7 integration in all helpers
 - **Config**: `context7-mcp-config.json`
-- **Docs**: `.agent/context7-mcp-setup.md`
+- **Docs**: `.agents/context7-mcp-setup.md`
 
 ### MCP Servers
 
@@ -327,7 +327,7 @@ tools:
 - **Use Cases**: AI assistant data access, real-time integration, automation
 - **Helper**: MCP integration in all helpers
 - **Config**: `mcp-servers-config.json`
-- **Docs**: `.agent/mcp-servers.md`
+- **Docs**: `.agents/mcp-servers.md`
 
 ### Crawl4AI
 
@@ -338,7 +338,7 @@ tools:
 - **Use Cases**: Web scraping, content research, data extraction, RAG pipelines
 - **Helper**: `crawl4ai-helper.sh`
 - **Config**: `crawl4ai-config.json`
-- **Docs**: `.agent/crawl4ai.md`
+- **Docs**: `.agents/crawl4ai.md`
 
 ## Setup & Configuration (1 Service)
 
diff --git a/.agent/aidevops/setup.md b/.agents/aidevops/setup.md
similarity index 98%
rename from .agent/aidevops/setup.md
rename to .agents/aidevops/setup.md
index c5b948ea0..97a528723 100644
--- a/.agent/aidevops/setup.md
+++ b/.agents/aidevops/setup.md
@@ -24,7 +24,7 @@ tools:
 **What setup.sh does**:
 1. Checks system requirements (jq, curl, ssh)
 2. Checks optional dependencies (sshpass, git CLIs)
-3. Copies `.agent/` contents to `~/.aidevops/agents/`
+3. Copies `.agents/` contents to `~/.aidevops/agents/`
 4. Backs up existing configs to `~/.aidevops/config-backups/[timestamp]/`
 5. Injects reference into AI assistant AGENTS.md files
 6. Updates OpenCode agent paths in `opencode.json`
diff --git a/.agent/aidevops/troubleshooting.md b/.agents/aidevops/troubleshooting.md
similarity index 98%
rename from .agent/aidevops/troubleshooting.md
rename to .agents/aidevops/troubleshooting.md
index bd67ea0a7..cde3904c6 100644
--- a/.agent/aidevops/troubleshooting.md
+++ b/.agents/aidevops/troubleshooting.md
@@ -34,7 +34,7 @@ tools:
 - Playwright: Install browsers (`bunx playwright install`)
 - API Auth: Verify keys with curl, check env vars
 - Debug: `DEBUG=chrome-devtools-mcp bunx chrome-devtools-mcp@latest`
-- Diagnostics: `bash .agent/scripts/collect-mcp-diagnostics.sh`
+- Diagnostics: `bash .agents/scripts/collect-mcp-diagnostics.sh`
 
 **Retry Strategy**: Use exponential backoff for transient failures
 <!-- AI-CONTEXT-END -->
@@ -343,7 +343,7 @@ cp ~/.config/mcp/config.json ~/.config/mcp/config.json.backup
 
 # Reset to defaults
 rm ~/.config/mcp/config.json
-bash .agent/scripts/setup-mcp-integrations.sh all
+bash .agents/scripts/setup-mcp-integrations.sh all
 ```
 
 ### **Clear Cache and Restart**
@@ -371,7 +371,7 @@ npx playwright-mcp@latest --basic-mode
 
 ```bash
 # Collect diagnostic information
-bash .agent/scripts/collect-mcp-diagnostics.sh
+bash .agents/scripts/collect-mcp-diagnostics.sh
 
 # This creates: mcp-diagnostics-$(date +%Y%m%d).tar.gz
 ```
diff --git a/.agent/build-plus.md b/.agents/build-plus.md
similarity index 99%
rename from .agent/build-plus.md
rename to .agents/build-plus.md
index d44bb9041..954a4ea44 100644
--- a/.agent/build-plus.md
+++ b/.agents/build-plus.md
@@ -144,7 +144,7 @@ to Augment Context Engine if osgrep returns insufficient results.
 
 **Quality Integration** (`tools/code-review/`):
 
-- Pre-commit: `.agent/scripts/linters-local.sh`
+- Pre-commit: `.agents/scripts/linters-local.sh`
 - Patterns: `tools/code-review/best-practices.md`
 
 **Testing**: Use OpenCode CLI to test config changes without restarting TUI:
@@ -323,7 +323,7 @@ Before implementing:
 
 ```bash
 # Generate token-efficient codebase context
-.agent/scripts/context-builder-helper.sh compress [path]
+.agents/scripts/context-builder-helper.sh compress [path]
 ```
 
 Use Context7 MCP for library documentation (framework APIs, patterns).
diff --git a/.agent/configs/mainwp-config.json.txt b/.agents/configs/mainwp-config.json.txt
similarity index 92%
rename from .agent/configs/mainwp-config.json.txt
rename to .agents/configs/mainwp-config.json.txt
index 09d4c1783..62adb4cc2 100644
--- a/.agent/configs/mainwp-config.json.txt
+++ b/.agents/configs/mainwp-config.json.txt
@@ -1,6 +1,6 @@
 {
   "_description": "MainWP Dashboard Configuration",
-  "_docs": "See .agent/tools/wordpress/mainwp.md for usage",
+  "_docs": "See .agents/tools/wordpress/mainwp.md for usage",
   "_setup": "Copy to mainwp-config.json and fill in your credentials",
 
   "instances": {
diff --git a/.agent/configs/skill-sources.json b/.agents/configs/skill-sources.json
similarity index 83%
rename from .agent/configs/skill-sources.json
rename to .agents/configs/skill-sources.json
index f79ba2c14..39c4c33ce 100644
--- a/.agent/configs/skill-sources.json
+++ b/.agents/configs/skill-sources.json
@@ -7,7 +7,7 @@
       "name": "animejs",
       "upstream_url": "https://github.com/juliangarnier/anime",
       "upstream_commit": "",
-      "local_path": ".agent/tools/animation/animejs.md",
+      "local_path": ".agents/tools/animation/animejs.md",
       "format_detected": "context7",
       "docs_url": "https://animejs.com/documentation",
       "context7_id": "/websites/animejs",
@@ -20,19 +20,19 @@
       "name": "remotion",
       "upstream_url": "https://github.com/remotion-dev/skills",
       "upstream_commit": "9550e1643dd451d3f8c131579d8ae827b2ce3eea",
-      "local_path": ".agent/tools/video/remotion.md",
+      "local_path": ".agents/tools/video/remotion.md",
       "format_detected": "skill-md",
       "imported_at": "2026-01-21T04:58:00Z",
       "last_checked": "2026-01-21T04:58:00Z",
       "merge_strategy": "added",
-      "notes": "Includes 29 rule files in .agent/tools/video/remotion/",
+      "notes": "Includes 29 rule files in .agents/tools/video/remotion/",
       "context7_id": "/remotion-dev/remotion"
     },
     {
       "name": "video-prompt-design",
       "upstream_url": "https://github.com/snubroot/Veo-3-Meta-Framework",
       "upstream_commit": "",
-      "local_path": ".agent/tools/video/video-prompt-design.md",
+      "local_path": ".agents/tools/video/video-prompt-design.md",
       "format_detected": "readme-distilled",
       "imported_at": "2026-01-23T20:40:00Z",
       "last_checked": "2026-01-23T20:40:00Z",
@@ -43,29 +43,29 @@
       "name": "cloudflare-platform",
       "upstream_url": "https://github.com/dmmulroy/cloudflare-skill",
       "upstream_commit": "c4696d5389f95e9546b075759ff8326deac1fba7",
-      "local_path": ".agent/services/hosting/cloudflare-platform.md",
+      "local_path": ".agents/services/hosting/cloudflare-platform.md",
       "format_detected": "skill-md-nested",
       "imported_at": "2026-01-21T05:12:00Z",
       "last_checked": "2026-01-21T05:12:00Z",
       "merge_strategy": "added",
-      "notes": "Includes 60 product reference directories in .agent/services/hosting/cloudflare-platform/references/"
+      "notes": "Includes 60 product reference directories in .agents/services/hosting/cloudflare-platform/references/"
     },
     {
       "name": "heygen",
       "upstream_url": "https://github.com/heygen-com/skills",
       "upstream_commit": "f11988dc81a6deed557f3d547b24f73627b59ebc",
-      "local_path": ".agent/tools/video/heygen-skill.md",
+      "local_path": ".agents/tools/video/heygen-skill.md",
       "format_detected": "skill-md-nested",
       "imported_at": "2026-01-24T12:00:00Z",
       "last_checked": "2026-01-24T12:00:00Z",
       "merge_strategy": "added",
-      "notes": "Includes 18 rule files in .agent/tools/video/heygen-skill/rules/"
+      "notes": "Includes 18 rule files in .agents/tools/video/heygen-skill/rules/"
     },
     {
       "name": "caldav-calendar",
       "upstream_url": "https://clawdhub.com/Asleep123/caldav-calendar",
       "upstream_commit": "1.0.1",
-      "local_path": ".agent/tools/productivity/caldav-calendar-skill.md",
+      "local_path": ".agents/tools/productivity/caldav-calendar-skill.md",
       "format_detected": "clawdhub",
       "imported_at": "2026-01-24T22:20:00Z",
       "last_checked": "2026-01-24T22:20:00Z",
@@ -76,7 +76,7 @@
       "name": "proxmox-full",
       "upstream_url": "https://clawdhub.com/mSarheed/proxmox-full",
       "upstream_commit": "1.0.0",
-      "local_path": ".agent/services/hosting/proxmox-full-skill.md",
+      "local_path": ".agents/services/hosting/proxmox-full-skill.md",
       "format_detected": "clawdhub",
       "imported_at": "2026-01-24T22:20:00Z",
       "last_checked": "2026-01-24T22:20:00Z",
@@ -87,7 +87,7 @@
       "name": "seo-audit",
       "upstream_url": "https://github.com/coreyhaines31/marketingskills",
       "upstream_commit": "a04cb61a577a20d9ab0f3da2a2d99c17a0476ded",
-      "local_path": ".agent/seo/seo-audit-skill.md",
+      "local_path": ".agents/seo/seo-audit-skill.md",
       "format_detected": "skill-md",
       "imported_at": "2026-01-29T01:37:00Z",
       "last_checked": "2026-01-29T01:37:00Z",
diff --git a/.agent/configs/wordpress-sites.json.txt b/.agents/configs/wordpress-sites.json.txt
similarity index 97%
rename from .agent/configs/wordpress-sites.json.txt
rename to .agents/configs/wordpress-sites.json.txt
index e8365e024..0a37a3036 100644
--- a/.agent/configs/wordpress-sites.json.txt
+++ b/.agents/configs/wordpress-sites.json.txt
@@ -1,6 +1,6 @@
 {
   "_description": "WordPress Sites Registry",
-  "_docs": "See .agent/tools/wordpress/wp-admin.md for usage",
+  "_docs": "See .agents/tools/wordpress/wp-admin.md for usage",
   "_setup": "Copy to ~/.config/aidevops/wordpress-sites.json and fill in your sites",
 
   "sites": {
diff --git a/.agent/content.md b/.agents/content.md
similarity index 100%
rename from .agent/content.md
rename to .agents/content.md
diff --git a/.agent/content/guidelines.md b/.agents/content/guidelines.md
similarity index 100%
rename from .agent/content/guidelines.md
rename to .agents/content/guidelines.md
diff --git a/.agent/content/humanise.md b/.agents/content/humanise.md
similarity index 100%
rename from .agent/content/humanise.md
rename to .agents/content/humanise.md
diff --git a/.agent/health.md b/.agents/health.md
similarity index 100%
rename from .agent/health.md
rename to .agents/health.md
diff --git a/.agent/legal.md b/.agents/legal.md
similarity index 100%
rename from .agent/legal.md
rename to .agents/legal.md
diff --git a/.agent/marketing.md b/.agents/marketing.md
similarity index 98%
rename from .agent/marketing.md
rename to .agents/marketing.md
index 17b8a7e57..2f18550fd 100644
--- a/.agent/marketing.md
+++ b/.agents/marketing.md
@@ -102,7 +102,7 @@ export FLUENTCRM_API_USERNAME="your_username"
 export FLUENTCRM_API_PASSWORD="your_application_password"
 ```
 
-See `.agent/services/crm/fluentcrm.md` for detailed setup instructions.
+See `.agents/services/crm/fluentcrm.md` for detailed setup instructions.
 
 ## Campaign Management
 
@@ -465,4 +465,4 @@ After each campaign:
 
 - FluentCRM Docs: https://fluentcrm.com/docs/
 - FluentCRM REST API: https://rest-api.fluentcrm.com/
-- See `.agent/services/crm/fluentcrm.md` for detailed troubleshooting
+- See `.agents/services/crm/fluentcrm.md` for detailed troubleshooting
diff --git a/.agent/memory/README.md b/.agents/memory/README.md
similarity index 100%
rename from .agent/memory/README.md
rename to .agents/memory/README.md
diff --git a/.agent/onboarding.md b/.agents/onboarding.md
similarity index 100%
rename from .agent/onboarding.md
rename to .agents/onboarding.md
diff --git a/.agent/plan-plus.md b/.agents/plan-plus.md
similarity index 99%
rename from .agent/plan-plus.md
rename to .agents/plan-plus.md
index 42604e6e4..521c157d1 100644
--- a/.agent/plan-plus.md
+++ b/.agents/plan-plus.md
@@ -261,7 +261,7 @@ Use context tools for deep understanding:
 
 ```bash
 # Generate token-efficient codebase context (read-only)
-.agent/scripts/context-builder-helper.sh compress [path]
+.agents/scripts/context-builder-helper.sh compress [path]
 ```
 
 ### Phase 3: Synthesis
diff --git a/.agent/plugins/opencode-aidevops/index.mjs b/.agents/plugins/opencode-aidevops/index.mjs
similarity index 100%
rename from .agent/plugins/opencode-aidevops/index.mjs
rename to .agents/plugins/opencode-aidevops/index.mjs
diff --git a/.agent/plugins/opencode-aidevops/package.json b/.agents/plugins/opencode-aidevops/package.json
similarity index 100%
rename from .agent/plugins/opencode-aidevops/package.json
rename to .agents/plugins/opencode-aidevops/package.json
diff --git a/.agent/prompts/build.txt b/.agents/prompts/build.txt
similarity index 100%
rename from .agent/prompts/build.txt
rename to .agents/prompts/build.txt
diff --git a/.agent/research.md b/.agents/research.md
similarity index 100%
rename from .agent/research.md
rename to .agents/research.md
diff --git a/.agent/sales.md b/.agents/sales.md
similarity index 97%
rename from .agent/sales.md
rename to .agents/sales.md
index 04f6b72d0..dcc97faf8 100644
--- a/.agent/sales.md
+++ b/.agents/sales.md
@@ -100,7 +100,7 @@ export FLUENTCRM_API_USERNAME="your_username"
 export FLUENTCRM_API_PASSWORD="your_application_password"
 ```
 
-See `.agent/services/crm/fluentcrm.md` for detailed setup instructions.
+See `.agents/services/crm/fluentcrm.md` for detailed setup instructions.
 
 ## Lead Management
 
@@ -262,7 +262,7 @@ fluentcrm_create_smart_link with:
 3. **Convert to invoice** via QuickFile integration
 4. **Track payment** status
 
-See `.agent/services/accounting/quickfile.md` for invoice generation.
+See `.agents/services/accounting/quickfile.md` for invoice generation.
 
 ## Sales Reporting
 
@@ -355,4 +355,4 @@ When marketing qualifies a lead:
 
 - FluentCRM Docs: https://fluentcrm.com/docs/
 - FluentCRM REST API: https://rest-api.fluentcrm.com/
-- See `.agent/services/crm/fluentcrm.md` for detailed troubleshooting
+- See `.agents/services/crm/fluentcrm.md` for detailed troubleshooting
diff --git a/.agent/scripts/101domains-helper.sh b/.agents/scripts/101domains-helper.sh
similarity index 100%
rename from .agent/scripts/101domains-helper.sh
rename to .agents/scripts/101domains-helper.sh
diff --git a/.agent/scripts/add-missing-returns.sh b/.agents/scripts/add-missing-returns.sh
similarity index 100%
rename from .agent/scripts/add-missing-returns.sh
rename to .agents/scripts/add-missing-returns.sh
diff --git a/.agent/scripts/add-skill-helper.sh b/.agents/scripts/add-skill-helper.sh
similarity index 97%
rename from .agent/scripts/add-skill-helper.sh
rename to .agents/scripts/add-skill-helper.sh
index 47e0c2131..80511ffb9 100755
--- a/.agent/scripts/add-skill-helper.sh
+++ b/.agents/scripts/add-skill-helper.sh
@@ -107,7 +107,7 @@ SUPPORTED FORMATS:
     - .cursorrules (Cursor format)
     - Raw markdown files
 
-The skill will be converted to aidevops format and placed in .agent/
+The skill will be converted to aidevops format and placed in .agents/
 with symlinks created to other AI assistant locations by setup.sh.
 EOF
     return 0
@@ -256,7 +256,7 @@ to_kebab_case() {
     return 0
 }
 
-# Determine target path in .agent/ based on skill content
+# Determine target path in .agents/ based on skill content
 determine_target_path() {
     local skill_name="$1"
     local _description="$2"  # Reserved for future category detection
@@ -566,7 +566,7 @@ cmd_add() {
             skill_name=$(to_kebab_case "$skill_name")
             # openskills installs to ~/.config/opencode/skills/<name>/SKILL.md
             # Register with -skill suffix for consistency with direct imports
-            register_skill "$skill_name" "https://github.com/$owner/$repo" ".agent/skills/${skill_name}-skill.md" "skill-md" "" "openskills" "Installed via openskills CLI"
+            register_skill "$skill_name" "https://github.com/$owner/$repo" ".agents/skills/${skill_name}-skill.md" "skill-md" "" "openskills" "Installed via openskills CLI"
             return 0
         fi
         log_warning "openskills failed, falling back to direct fetch"
@@ -626,7 +626,7 @@ cmd_add() {
     # Determine target path
     local target_path
     target_path=$(determine_target_path "$skill_name" "$description" "$skill_source_dir")
-    log_info "Target path: .agent/$target_path"
+    log_info "Target path: .agents/$target_path"
     
     # Check for conflicts (check_conflicts returns 1 when conflicts exist)
     local conflicts
@@ -697,20 +697,20 @@ cmd_add() {
     
     if [[ "$dry_run" == true ]]; then
         log_info "DRY RUN - Would create:"
-        echo "  .agent/${target_path}.md"
+        echo "  .agents/${target_path}.md"
         if [[ -d "$skill_source_dir/scripts" || -d "$skill_source_dir/references" ]]; then
-            echo "  .agent/${target_path}/"
+            echo "  .agents/${target_path}/"
         fi
         return 0
     fi
     
     # Create target directory
     local target_dir
-    target_dir=".agent/$(dirname "$target_path")"
+    target_dir=".agents/$(dirname "$target_path")"
     mkdir -p "$target_dir"
     
     # Convert and copy files
-    local target_file=".agent/${target_path}.md"
+    local target_file=".agents/${target_path}.md"
     
     case "$format" in
         skill-md|skill-md-nested)
@@ -750,7 +750,7 @@ cmd_add() {
     # Copy additional resources (scripts, references, assets)
     for resource_dir in scripts references assets; do
         if [[ -d "$skill_source_dir/$resource_dir" ]]; then
-            local target_resource_dir=".agent/${target_path}/$resource_dir"
+            local target_resource_dir=".agents/${target_path}/$resource_dir"
             mkdir -p "$target_resource_dir"
             cp -r "$skill_source_dir/$resource_dir/"* "$target_resource_dir/" 2>/dev/null || true
             log_success "Copied: $resource_dir/"
@@ -764,7 +764,7 @@ cmd_add() {
     fi
     
     # Register in skill-sources.json
-    register_skill "$skill_name" "https://github.com/$owner/$repo${subpath:+/$subpath}" ".agent/${target_path}.md" "$format" "$commit_hash" "added" ""
+    register_skill "$skill_name" "https://github.com/$owner/$repo${subpath:+/$subpath}" ".agents/${target_path}.md" "$format" "$commit_hash" "added" ""
     
     log_success "Skill '$skill_name' imported successfully"
     
@@ -821,7 +821,7 @@ cmd_add_clawdhub() {
     # Determine target path
     local target_path
     target_path=$(determine_target_path "$skill_name" "$summary" ".")
-    log_info "Target path: .agent/$target_path"
+    log_info "Target path: .agents/$target_path"
     
     # Check for conflicts
     local conflicts
@@ -857,7 +857,7 @@ cmd_add_clawdhub() {
     
     if [[ "$dry_run" == true ]]; then
         log_info "DRY RUN - Would create:"
-        echo "  .agent/${target_path}.md"
+        echo "  .agents/${target_path}.md"
         return 0
     fi
     
@@ -886,11 +886,11 @@ cmd_add_clawdhub() {
     
     # Create target directory
     local target_dir
-    target_dir=".agent/$(dirname "$target_path")"
+    target_dir=".agents/$(dirname "$target_path")"
     mkdir -p "$target_dir"
     
     # Convert to aidevops format
-    local target_file=".agent/${target_path}.md"
+    local target_file=".agents/${target_path}.md"
     
     # Write aidevops-style header
     local safe_summary
@@ -921,7 +921,7 @@ EOF
     
     # Register in skill-sources.json
     local upstream_url="https://clawdhub.com/${owner_handle}/${slug}"
-    register_skill "$skill_name" "$upstream_url" ".agent/${target_path}.md" "clawdhub" "$version" "added" "ClawdHub v${version} by @${owner_handle}"
+    register_skill "$skill_name" "$upstream_url" ".agents/${target_path}.md" "clawdhub" "$version" "added" "ClawdHub v${version} by @${owner_handle}"
     
     # Cleanup
     rm -rf "$fetch_dir"
diff --git a/.agent/scripts/agent-browser-helper.sh b/.agents/scripts/agent-browser-helper.sh
similarity index 100%
rename from .agent/scripts/agent-browser-helper.sh
rename to .agents/scripts/agent-browser-helper.sh
diff --git a/.agent/scripts/agent-test-helper.sh b/.agents/scripts/agent-test-helper.sh
similarity index 100%
rename from .agent/scripts/agent-test-helper.sh
rename to .agents/scripts/agent-test-helper.sh
diff --git a/.agent/scripts/agno-setup.sh b/.agents/scripts/agno-setup.sh
similarity index 100%
rename from .agent/scripts/agno-setup.sh
rename to .agents/scripts/agno-setup.sh
diff --git a/.agent/scripts/ahrefs-mcp-wrapper.js b/.agents/scripts/ahrefs-mcp-wrapper.js
similarity index 100%
rename from .agent/scripts/ahrefs-mcp-wrapper.js
rename to .agents/scripts/ahrefs-mcp-wrapper.js
diff --git a/.agent/scripts/aidevops-update-check.sh b/.agents/scripts/aidevops-update-check.sh
similarity index 100%
rename from .agent/scripts/aidevops-update-check.sh
rename to .agents/scripts/aidevops-update-check.sh
diff --git a/.agent/scripts/ampcode-cli.sh b/.agents/scripts/ampcode-cli.sh
similarity index 99%
rename from .agent/scripts/ampcode-cli.sh
rename to .agents/scripts/ampcode-cli.sh
index bb6cc421f..5f2c2d2e8 100755
--- a/.agent/scripts/ampcode-cli.sh
+++ b/.agents/scripts/ampcode-cli.sh
@@ -29,7 +29,7 @@ readonly NC='\033[0m' # No Color
 readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
 # Configuration
 readonly AMPCODE_API_CONFIG="configs/ampcode-config.json"
-readonly AMPCODE_RESULTS_DIR=".agent/tmp/ampcode"
+readonly AMPCODE_RESULTS_DIR=".agents/tmp/ampcode"
 readonly ALLOWED_OUTPUT_FORMATS="json text csv html md"
 
 # Print functions
@@ -494,7 +494,7 @@ main() {
     local command="${1:-help}"
 
     # Ensure temp directory exists
-    mkdir -p .agent/tmp
+    mkdir -p .agents/tmp
 
     case "$command" in
         "install")
diff --git a/.agent/scripts/anti-detect-helper.sh b/.agents/scripts/anti-detect-helper.sh
similarity index 100%
rename from .agent/scripts/anti-detect-helper.sh
rename to .agents/scripts/anti-detect-helper.sh
diff --git a/.agent/scripts/auto-version-bump.sh b/.agents/scripts/auto-version-bump.sh
similarity index 98%
rename from .agent/scripts/auto-version-bump.sh
rename to .agents/scripts/auto-version-bump.sh
index b369f5ee3..cbc0d9d2c 100755
--- a/.agent/scripts/auto-version-bump.sh
+++ b/.agents/scripts/auto-version-bump.sh
@@ -33,7 +33,7 @@ sed_inplace() {
 
 # Repository root directory
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" || exit
-VERSION_MANAGER="$REPO_ROOT/.agent/scripts/version-manager.sh"
+VERSION_MANAGER="$REPO_ROOT/.agents/scripts/version-manager.sh"
 
 # Function to determine version bump type from commit message
 determine_bump_type() {
diff --git a/.agent/scripts/autogen-helper.sh b/.agents/scripts/autogen-helper.sh
similarity index 99%
rename from .agent/scripts/autogen-helper.sh
rename to .agents/scripts/autogen-helper.sh
index 0ebb6f215..34c58233c 100755
--- a/.agent/scripts/autogen-helper.sh
+++ b/.agents/scripts/autogen-helper.sh
@@ -5,7 +5,7 @@
 # Microsoft AutoGen agentic AI framework setup and management
 #
 # Usage:
-#   bash .agent/scripts/autogen-helper.sh [action]
+#   bash .agents/scripts/autogen-helper.sh [action]
 #
 # Actions:
 #   setup     Complete setup of AutoGen
@@ -340,7 +340,7 @@ if [[ -d "$AUTOGEN_DIR/venv" ]]; then
     echo "Use 'stop-autogen-studio.sh' to stop"
 else
     echo "AutoGen not set up. Run setup first:"
-    echo "  bash .agent/scripts/autogen-helper.sh setup"
+    echo "  bash .agents/scripts/autogen-helper.sh setup"
     exit 1
 fi
 EOF
diff --git a/.agent/scripts/beads-sync-helper.sh b/.agents/scripts/beads-sync-helper.sh
similarity index 100%
rename from .agent/scripts/beads-sync-helper.sh
rename to .agents/scripts/beads-sync-helper.sh
diff --git a/.agent/scripts/clawdhub-helper.sh b/.agents/scripts/clawdhub-helper.sh
similarity index 100%
rename from .agent/scripts/clawdhub-helper.sh
rename to .agents/scripts/clawdhub-helper.sh
diff --git a/.agent/scripts/closte-helper.sh b/.agents/scripts/closte-helper.sh
similarity index 100%
rename from .agent/scripts/closte-helper.sh
rename to .agents/scripts/closte-helper.sh
diff --git a/.agent/scripts/cloudron-helper.sh b/.agents/scripts/cloudron-helper.sh
similarity index 100%
rename from .agent/scripts/cloudron-helper.sh
rename to .agents/scripts/cloudron-helper.sh
diff --git a/.agent/scripts/cloudron-package-helper.sh b/.agents/scripts/cloudron-package-helper.sh
similarity index 99%
rename from .agent/scripts/cloudron-package-helper.sh
rename to .agents/scripts/cloudron-package-helper.sh
index 91148d6c7..a5287c8f0 100755
--- a/.agent/scripts/cloudron-package-helper.sh
+++ b/.agents/scripts/cloudron-package-helper.sh
@@ -153,7 +153,7 @@ DOCKERFILE
 .cloudron/
 
 # aidevops
-.agent/loop-state/
+.agents/loop-state/
 *.local.md
 
 # Build artifacts
diff --git a/.agent/scripts/codacy-cli-chunked.sh b/.agents/scripts/codacy-cli-chunked.sh
similarity index 94%
rename from .agent/scripts/codacy-cli-chunked.sh
rename to .agents/scripts/codacy-cli-chunked.sh
index ab002c5c1..972b92170 100755
--- a/.agent/scripts/codacy-cli-chunked.sh
+++ b/.agents/scripts/codacy-cli-chunked.sh
@@ -38,8 +38,8 @@ readonly TIMEOUT=120    # Timeout per chunk in seconds
 TOOL_CATEGORIES_fast="shellcheck pylint pycodestyle flake8"
 
 # Progress tracking
-PROGRESS_FILE=".agent/tmp/codacy-progress.log"
-TIMESTAMP_FILE=".agent/tmp/codacy-timestamp.log"
+PROGRESS_FILE=".agents/tmp/codacy-progress.log"
+TIMESTAMP_FILE=".agents/tmp/codacy-timestamp.log"
 
 # Print functions
 print_success() {
@@ -134,7 +134,7 @@ check_codacy_ready() {
 
     if [[ ! -f "$CODACY_CONFIG_FILE" ]]; then
         print_error "Codacy configuration not found"
-        print_info "Run: bash .agent/scripts/codacy-cli.sh init"
+        print_info "Run: bash .agents/scripts/codacy-cli.sh init"
         return 1
     fi
 
@@ -231,7 +231,7 @@ run_quick_analysis() {
     
     local start_time
     start_time=$(date +%s)
-    local results_file=".agent/tmp/codacy-quick-results.sarif"
+    local results_file=".agents/tmp/codacy-quick-results.sarif"
 
     for tool in $fast_tools; do
         if get_configured_tools | grep -q "^$tool$"; then
@@ -243,7 +243,7 @@ run_quick_analysis() {
             
             local tool_start
             tool_start=$(date +%s)
-            local cmd="codacy-cli analyze --tool $tool --format sarif --output .agent/tmp/codacy-$tool.sarif"
+            local cmd="codacy-cli analyze --tool $tool --format sarif --output .agents/tmp/codacy-$tool.sarif"
             
             # Run with timeout
             timeout $TIMEOUT bash -c "$cmd" 2>/dev/null
@@ -262,12 +262,12 @@ run_quick_analysis() {
                 update_progress "$tool completed successfully in ${tool_duration}s"
                 
                 # Merge results if file exists
-                if [[ -f ".agent/tmp/codacy-$tool.sarif" ]]; then
+                if [[ -f ".agents/tmp/codacy-$tool.sarif" ]]; then
                     if [[ ! -f "$results_file" ]]; then
-                        cp ".agent/tmp/codacy-$tool.sarif" "$results_file"
+                        cp ".agents/tmp/codacy-$tool.sarif" "$results_file"
                     else
                         # Simple merge (in production, use proper SARIF merge)
-                        cat ".agent/tmp/codacy-$tool.sarif" >> "$results_file"
+                        cat ".agents/tmp/codacy-$tool.sarif" >> "$results_file"
                     fi
                 fi
             else
@@ -314,7 +314,7 @@ run_chunked_analysis() {
     
     local start_time
     start_time=$(date +%s)
-    local results_file=".agent/tmp/codacy-chunked-results.sarif"
+    local results_file=".agents/tmp/codacy-chunked-results.sarif"
     local chunk_num=1
 
     # Process tools in chunks
@@ -344,7 +344,7 @@ run_chunked_analysis() {
         
         local chunk_start_time
         chunk_start_time=$(date +%s)
-        local chunk_result_file=".agent/tmp/codacy-chunk-$chunk_num.sarif"
+        local chunk_result_file=".agents/tmp/codacy-chunk-$chunk_num.sarif"
         
         # Run chunk with extended timeout
         local cmd="codacy-cli analyze --tools $(echo $chunk_tools | tr ' ' ',') --format sarif --output $chunk_result_file"
@@ -430,7 +430,7 @@ run_tool_analysis() {
 
     local start_time
     start_time=$(date +%s)
-    local result_file=".agent/tmp/codacy-$tool-single.sarif"
+    local result_file=".agents/tmp/codacy-$tool-single.sarif"
 
     local cmd="codacy-cli analyze --tool $tool --format sarif --output $result_file"
     print_info "Executing: $cmd"
@@ -475,7 +475,7 @@ show_status() {
     
     echo ""
     print_info "Recent Analysis Files:"
-    find .agent/tmp -name "codacy-*.sarif" -newer "$TIMESTAMP_FILE" 2>/dev/null | head -5 | while read -r file; do
+    find .agents/tmp -name "codacy-*.sarif" -newer "$TIMESTAMP_FILE" 2>/dev/null | head -5 | while read -r file; do
         local age
         age=$(find "$file" -mmin +1 2>/dev/null || echo "0")
         local size
@@ -493,7 +493,7 @@ show_status() {
 # Clean up temporary files
 cleanup() {
     print_info "Cleaning up temporary files..."
-    rm -f .agent/tmp/codacy-*.sarif
+    rm -f .agents/tmp/codacy-*.sarif
     rm -f "$PROGRESS_FILE" "$TIMESTAMP_FILE"
     print_success "Cleanup completed"
     return 0
@@ -536,7 +536,7 @@ main() {
     local command="${1:-help}"
 
     # Ensure temp directory exists
-    mkdir -p .agent/tmp
+    mkdir -p .agents/tmp
 
     case "$command" in
         "quick")
diff --git a/.agent/scripts/codacy-cli.sh b/.agents/scripts/codacy-cli.sh
similarity index 100%
rename from .agent/scripts/codacy-cli.sh
rename to .agents/scripts/codacy-cli.sh
diff --git a/.agent/scripts/code-audit-helper.sh b/.agents/scripts/code-audit-helper.sh
similarity index 100%
rename from .agent/scripts/code-audit-helper.sh
rename to .agents/scripts/code-audit-helper.sh
diff --git a/.agent/scripts/coderabbit-cli.sh b/.agents/scripts/coderabbit-cli.sh
similarity index 100%
rename from .agent/scripts/coderabbit-cli.sh
rename to .agents/scripts/coderabbit-cli.sh
diff --git a/.agent/scripts/coderabbit-pro-analysis.sh b/.agents/scripts/coderabbit-pro-analysis.sh
similarity index 100%
rename from .agent/scripts/coderabbit-pro-analysis.sh
rename to .agents/scripts/coderabbit-pro-analysis.sh
diff --git a/.agent/scripts/commands/add-skill.md b/.agents/scripts/commands/add-skill.md
similarity index 90%
rename from .agent/scripts/commands/add-skill.md
rename to .agents/scripts/commands/add-skill.md
index 6feee9ce5..415ae7caa 100644
--- a/.agent/scripts/commands/add-skill.md
+++ b/.agents/scripts/commands/add-skill.md
@@ -13,22 +13,22 @@ URL/Repo: $ARGUMENTS
 ```bash
 # Import skill from GitHub (saved as *-skill.md)
 /add-skill dmmulroy/cloudflare-skill
-# → .agent/services/hosting/cloudflare-skill.md
+# → .agents/services/hosting/cloudflare-skill.md
 
 # Import specific skill from multi-skill repo
 /add-skill anthropics/skills/pdf
-# → .agent/tools/pdf-skill.md
+# → .agents/tools/pdf-skill.md
 
 # Import from ClawdHub (shorthand)
 /add-skill clawdhub:caldav-calendar
-# → .agent/tools/productivity/caldav-calendar-skill.md
+# → .agents/tools/productivity/caldav-calendar-skill.md
 
 # Import from ClawdHub (full URL)
 /add-skill https://clawdhub.com/Asleep123/caldav-calendar
 
 # Import with custom name
 /add-skill vercel-labs/agent-skills --name vercel-deploy
-# → .agent/tools/deployment/vercel-deploy-skill.md
+# → .agents/tools/deployment/vercel-deploy-skill.md
 
 # List imported skills
 /add-skill list
@@ -95,8 +95,8 @@ If the skill conflicts with existing files, the helper will prompt:
 
 After successful import:
 
-1. The skill is placed in `.agent/` following aidevops conventions
-2. Registered in `.agent/configs/skill-sources.json` for update tracking
+1. The skill is placed in `.agents/` following aidevops conventions
+2. Registered in `.agents/configs/skill-sources.json` for update tracking
 3. Run `./setup.sh` to create symlinks for other AI assistants
 
 ## Supported Sources & Formats
@@ -139,7 +139,7 @@ After successful import:
 
 ## Update Tracking
 
-Imported skills are tracked in `.agent/configs/skill-sources.json`:
+Imported skills are tracked in `.agents/configs/skill-sources.json`:
 
 ```json
 {
@@ -148,7 +148,7 @@ Imported skills are tracked in `.agent/configs/skill-sources.json`:
       "name": "cloudflare",
       "upstream_url": "https://github.com/dmmulroy/cloudflare-skill",
       "upstream_commit": "abc123...",
-      "local_path": ".agent/services/hosting/cloudflare-skill.md",
+      "local_path": ".agents/services/hosting/cloudflare-skill.md",
       "format_detected": "skill-md",
       "imported_at": "2026-01-21T00:00:00Z",
       "last_checked": "2026-01-21T00:00:00Z",
diff --git a/.agent/scripts/commands/code-simplifier.md b/.agents/scripts/commands/code-simplifier.md
similarity index 100%
rename from .agent/scripts/commands/code-simplifier.md
rename to .agents/scripts/commands/code-simplifier.md
diff --git a/.agent/scripts/commands/email-health-check.md b/.agents/scripts/commands/email-health-check.md
similarity index 100%
rename from .agent/scripts/commands/email-health-check.md
rename to .agents/scripts/commands/email-health-check.md
diff --git a/.agent/scripts/commands/full-loop.md b/.agents/scripts/commands/full-loop.md
similarity index 99%
rename from .agent/scripts/commands/full-loop.md
rename to .agents/scripts/commands/full-loop.md
index 5e1a2ae20..4e715a6d8 100644
--- a/.agent/scripts/commands/full-loop.md
+++ b/.agents/scripts/commands/full-loop.md
@@ -128,7 +128,7 @@ This starts the loop in the background and returns immediately. Use these comman
 
 This will:
 1. Initialize the Ralph loop for task development
-2. Set up state tracking in `.agent/loop-state/full-loop.local.md`
+2. Set up state tracking in `.agents/loop-state/full-loop.local.md`
 3. Begin iterating on the task
 
 **Note**: Foreground mode may timeout when called via MCP Bash tool (default 120s timeout). Use `--background` for long-running tasks.
diff --git a/.agent/scripts/commands/humanise.md b/.agents/scripts/commands/humanise.md
similarity index 100%
rename from .agent/scripts/commands/humanise.md
rename to .agents/scripts/commands/humanise.md
diff --git a/.agent/scripts/commands/list-todo.md b/.agents/scripts/commands/list-todo.md
similarity index 100%
rename from .agent/scripts/commands/list-todo.md
rename to .agents/scripts/commands/list-todo.md
diff --git a/.agent/scripts/commands/log-issue-aidevops.md b/.agents/scripts/commands/log-issue-aidevops.md
similarity index 100%
rename from .agent/scripts/commands/log-issue-aidevops.md
rename to .agents/scripts/commands/log-issue-aidevops.md
diff --git a/.agent/scripts/commands/memory-log.md b/.agents/scripts/commands/memory-log.md
similarity index 100%
rename from .agent/scripts/commands/memory-log.md
rename to .agents/scripts/commands/memory-log.md
diff --git a/.agent/scripts/commands/neuronwriter.md b/.agents/scripts/commands/neuronwriter.md
similarity index 100%
rename from .agent/scripts/commands/neuronwriter.md
rename to .agents/scripts/commands/neuronwriter.md
diff --git a/.agent/scripts/commands/patterns.md b/.agents/scripts/commands/patterns.md
similarity index 100%
rename from .agent/scripts/commands/patterns.md
rename to .agents/scripts/commands/patterns.md
diff --git a/.agent/scripts/commands/performance.md b/.agents/scripts/commands/performance.md
similarity index 100%
rename from .agent/scripts/commands/performance.md
rename to .agents/scripts/commands/performance.md
diff --git a/.agent/scripts/commands/postflight-loop.md b/.agents/scripts/commands/postflight-loop.md
similarity index 97%
rename from .agent/scripts/commands/postflight-loop.md
rename to .agents/scripts/commands/postflight-loop.md
index 807b8fe48..657cc9d99 100644
--- a/.agent/scripts/commands/postflight-loop.md
+++ b/.agents/scripts/commands/postflight-loop.md
@@ -71,7 +71,7 @@ When all checks pass: `<promise>RELEASE_HEALTHY</promise>`
 
 ## State Tracking
 
-Progress is tracked in `.agent/loop-state/quality-loop.local.md`:
+Progress is tracked in `.agents/loop-state/quality-loop.local.md`:
 
 ```markdown
 ## Postflight Loop State
diff --git a/.agent/scripts/commands/pr-loop.md b/.agents/scripts/commands/pr-loop.md
similarity index 98%
rename from .agent/scripts/commands/pr-loop.md
rename to .agents/scripts/commands/pr-loop.md
index 0962006a7..b47e6eb41 100644
--- a/.agent/scripts/commands/pr-loop.md
+++ b/.agents/scripts/commands/pr-loop.md
@@ -111,7 +111,7 @@ The loop uses evidence-based timing for different CI services:
 
 ## State Tracking
 
-Progress is tracked in `.agent/loop-state/quality-loop.local.state`:
+Progress is tracked in `.agents/loop-state/quality-loop.local.state`:
 
 ```markdown
 ## PR Review Loop State
diff --git a/.agent/scripts/commands/readme.md b/.agents/scripts/commands/readme.md
similarity index 100%
rename from .agent/scripts/commands/readme.md
rename to .agents/scripts/commands/readme.md
diff --git a/.agent/scripts/commands/recall.md b/.agents/scripts/commands/recall.md
similarity index 100%
rename from .agent/scripts/commands/recall.md
rename to .agents/scripts/commands/recall.md
diff --git a/.agent/scripts/commands/remember.md b/.agents/scripts/commands/remember.md
similarity index 100%
rename from .agent/scripts/commands/remember.md
rename to .agents/scripts/commands/remember.md
diff --git a/.agent/scripts/commands/route.md b/.agents/scripts/commands/route.md
similarity index 100%
rename from .agent/scripts/commands/route.md
rename to .agents/scripts/commands/route.md
diff --git a/.agent/scripts/commands/runners.md b/.agents/scripts/commands/runners.md
similarity index 100%
rename from .agent/scripts/commands/runners.md
rename to .agents/scripts/commands/runners.md
diff --git a/.agent/scripts/commands/save-todo.md b/.agents/scripts/commands/save-todo.md
similarity index 100%
rename from .agent/scripts/commands/save-todo.md
rename to .agents/scripts/commands/save-todo.md
diff --git a/.agent/scripts/commands/security-analysis.md b/.agents/scripts/commands/security-analysis.md
similarity index 89%
rename from .agent/scripts/commands/security-analysis.md
rename to .agents/scripts/commands/security-analysis.md
index be3c5bac9..c0d38337b 100644
--- a/.agent/scripts/commands/security-analysis.md
+++ b/.agents/scripts/commands/security-analysis.md
@@ -11,7 +11,7 @@ Target: $ARGUMENTS
 ## Quick Reference
 
 - **Purpose**: Deep security analysis with AI-powered vulnerability detection
-- **Helper**: `.agent/scripts/security-helper.sh`
+- **Helper**: `.agents/scripts/security-helper.sh`
 - **Scopes**: `diff` (default), `staged`, `branch`, `full`, or specific path
 - **Output**: `.security-analysis/` directory with reports
 
@@ -28,13 +28,13 @@ Target: $ARGUMENTS
 
    ```bash
    # Default: analyze git diff
-   ./.agent/scripts/security-helper.sh analyze
+   ./.agents/scripts/security-helper.sh analyze
 
    # Full codebase scan
-   ./.agent/scripts/security-helper.sh analyze full
+   ./.agents/scripts/security-helper.sh analyze full
 
    # Specific scope
-   ./.agent/scripts/security-helper.sh analyze $ARGUMENTS
+   ./.agents/scripts/security-helper.sh analyze $ARGUMENTS
    ```
 
 3. **Review findings** by severity (critical > high > medium > low)
@@ -47,7 +47,7 @@ Target: $ARGUMENTS
 5. **Generate report**:
 
    ```bash
-   ./.agent/scripts/security-helper.sh report
+   ./.agents/scripts/security-helper.sh report
    ```
 
 ## Vulnerability Categories
diff --git a/.agent/scripts/commands/security-deps.md b/.agents/scripts/commands/security-deps.md
similarity index 94%
rename from .agent/scripts/commands/security-deps.md
rename to .agents/scripts/commands/security-deps.md
index 9455ea812..bef3a012a 100644
--- a/.agent/scripts/commands/security-deps.md
+++ b/.agents/scripts/commands/security-deps.md
@@ -19,7 +19,7 @@ Target: $ARGUMENTS
 1. **Run dependency scan**:
 
    ```bash
-   ./.agent/scripts/security-helper.sh scan-deps
+   ./.agents/scripts/security-helper.sh scan-deps
    ```
 
 2. **Review findings** by severity
@@ -104,7 +104,7 @@ Add to your pipeline:
 ```yaml
 - name: Dependency Scan
   run: |
-    ./.agent/scripts/security-helper.sh scan-deps --format=sarif > deps.sarif
+    ./.agents/scripts/security-helper.sh scan-deps --format=sarif > deps.sarif
 
 - name: Upload SARIF
   uses: github/codeql-action/upload-sarif@v3
diff --git a/.agent/scripts/commands/security-history.md b/.agents/scripts/commands/security-history.md
similarity index 91%
rename from .agent/scripts/commands/security-history.md
rename to .agents/scripts/commands/security-history.md
index 062acadf9..145c9c9fc 100644
--- a/.agent/scripts/commands/security-history.md
+++ b/.agents/scripts/commands/security-history.md
@@ -27,16 +27,16 @@ Target: $ARGUMENTS
 
    ```bash
    # Last 50 commits (default)
-   ./.agent/scripts/security-helper.sh history
+   ./.agents/scripts/security-helper.sh history
 
    # Last 100 commits
-   ./.agent/scripts/security-helper.sh history 100
+   ./.agents/scripts/security-helper.sh history 100
 
    # Specific range
-   ./.agent/scripts/security-helper.sh history abc123..def456
+   ./.agents/scripts/security-helper.sh history abc123..def456
 
    # Since date
-   ./.agent/scripts/security-helper.sh history --since="2024-01-01"
+   ./.agents/scripts/security-helper.sh history --since="2024-01-01"
    ```
 
 3. **Review findings** with commit context
diff --git a/.agent/scripts/commands/security-scan.md b/.agents/scripts/commands/security-scan.md
similarity index 91%
rename from .agent/scripts/commands/security-scan.md
rename to .agents/scripts/commands/security-scan.md
index d5a0b3a9d..3404afa88 100644
--- a/.agent/scripts/commands/security-scan.md
+++ b/.agents/scripts/commands/security-scan.md
@@ -20,21 +20,21 @@ Target: $ARGUMENTS
 
    ```bash
    # Check for exposed secrets
-   ./.agent/scripts/secretlint-helper.sh scan
+   ./.agents/scripts/secretlint-helper.sh scan
    ```
 
 2. **Run Ferret** for AI CLI config security:
 
    ```bash
    # Scan AI assistant configurations
-   ./.agent/scripts/security-helper.sh ferret
+   ./.agents/scripts/security-helper.sh ferret
    ```
 
 3. **Quick code scan** for obvious issues:
 
    ```bash
    # Fast analysis on staged/diff
-   ./.agent/scripts/security-helper.sh analyze staged
+   ./.agents/scripts/security-helper.sh analyze staged
    ```
 
 4. **Report findings** with severity and location
diff --git a/.agent/scripts/commands/seo-analyze.md b/.agents/scripts/commands/seo-analyze.md
similarity index 100%
rename from .agent/scripts/commands/seo-analyze.md
rename to .agents/scripts/commands/seo-analyze.md
diff --git a/.agent/scripts/commands/seo-audit.md b/.agents/scripts/commands/seo-audit.md
similarity index 100%
rename from .agent/scripts/commands/seo-audit.md
rename to .agents/scripts/commands/seo-audit.md
diff --git a/.agent/scripts/commands/seo-export.md b/.agents/scripts/commands/seo-export.md
similarity index 100%
rename from .agent/scripts/commands/seo-export.md
rename to .agents/scripts/commands/seo-export.md
diff --git a/.agent/scripts/commands/seo-opportunities.md b/.agents/scripts/commands/seo-opportunities.md
similarity index 100%
rename from .agent/scripts/commands/seo-opportunities.md
rename to .agents/scripts/commands/seo-opportunities.md
diff --git a/.agent/scripts/commands/session-review.md b/.agents/scripts/commands/session-review.md
similarity index 100%
rename from .agent/scripts/commands/session-review.md
rename to .agents/scripts/commands/session-review.md
diff --git a/.agent/scripts/commands/show-plan.md b/.agents/scripts/commands/show-plan.md
similarity index 100%
rename from .agent/scripts/commands/show-plan.md
rename to .agents/scripts/commands/show-plan.md
diff --git a/.agent/scripts/commands/yt-dlp.md b/.agents/scripts/commands/yt-dlp.md
similarity index 100%
rename from .agent/scripts/commands/yt-dlp.md
rename to .agents/scripts/commands/yt-dlp.md
diff --git a/.agent/scripts/comprehensive-quality-fix.sh b/.agents/scripts/comprehensive-quality-fix.sh
similarity index 100%
rename from .agent/scripts/comprehensive-quality-fix.sh
rename to .agents/scripts/comprehensive-quality-fix.sh
diff --git a/.agent/scripts/context-builder-helper.sh b/.agents/scripts/context-builder-helper.sh
similarity index 100%
rename from .agent/scripts/context-builder-helper.sh
rename to .agents/scripts/context-builder-helper.sh
diff --git a/.agent/scripts/coolify-cli-helper.sh b/.agents/scripts/coolify-cli-helper.sh
similarity index 99%
rename from .agent/scripts/coolify-cli-helper.sh
rename to .agents/scripts/coolify-cli-helper.sh
index 877737790..e395f2188 100755
--- a/.agent/scripts/coolify-cli-helper.sh
+++ b/.agents/scripts/coolify-cli-helper.sh
@@ -502,7 +502,7 @@ show_help() {
 Coolify CLI Helper - Comprehensive self-hosted deployment and management
 
 USAGE:
-  ./.agent/scripts/coolify-cli-helper.sh [COMMAND] [CONTEXT] [OPTIONS...]
+  ./.agents/scripts/coolify-cli-helper.sh [COMMAND] [CONTEXT] [OPTIONS...]
 
 COMMANDS:
   Local Development (No Context Required):
diff --git a/.agent/scripts/coolify-helper.sh b/.agents/scripts/coolify-helper.sh
similarity index 100%
rename from .agent/scripts/coolify-helper.sh
rename to .agents/scripts/coolify-helper.sh
diff --git a/.agent/scripts/coordinator-helper.sh b/.agents/scripts/coordinator-helper.sh
similarity index 100%
rename from .agent/scripts/coordinator-helper.sh
rename to .agents/scripts/coordinator-helper.sh
diff --git a/.agent/scripts/crawl4ai-examples.sh b/.agents/scripts/crawl4ai-examples.sh
similarity index 98%
rename from .agent/scripts/crawl4ai-examples.sh
rename to .agents/scripts/crawl4ai-examples.sh
index eafa2ef2c..7836bf8d0 100755
--- a/.agent/scripts/crawl4ai-examples.sh
+++ b/.agents/scripts/crawl4ai-examples.sh
@@ -34,8 +34,8 @@ readonly NC='\033[0m' # No Color
 # Constants
 readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
 readonly FRAMEWORK_ROOT="$SCRIPT_DIR/../.."
-readonly CRAWL4AI_HELPER="$FRAMEWORK_ROOT/.agent/scripts/crawl4ai-helper.sh"
-readonly OUTPUT_DIR="$HOME/.agent/tmp/crawl4ai-examples"
+readonly CRAWL4AI_HELPER="$FRAMEWORK_ROOT/.agents/scripts/crawl4ai-helper.sh"
+readonly OUTPUT_DIR="$HOME/.agents/tmp/crawl4ai-examples"
 readonly TEST_URL_HTML="https://httpbin.org/html"
 
 # Print functions
diff --git a/.agent/scripts/crawl4ai-helper.sh b/.agents/scripts/crawl4ai-helper.sh
similarity index 99%
rename from .agent/scripts/crawl4ai-helper.sh
rename to .agents/scripts/crawl4ai-helper.sh
index 3b4e04038..af5012355 100755
--- a/.agent/scripts/crawl4ai-helper.sh
+++ b/.agents/scripts/crawl4ai-helper.sh
@@ -1018,7 +1018,7 @@ show_help() {
     echo "Documentation:"
     echo "  GitHub: https://github.com/unclecode/crawl4ai"
     echo "  Docs: https://docs.crawl4ai.com/"
-    echo "  Framework docs: .agent/CRAWL4AI.md"
+    echo "  Framework docs: .agents/CRAWL4AI.md"
     return 0
 }
 
diff --git a/.agent/scripts/credential-helper.sh b/.agents/scripts/credential-helper.sh
similarity index 100%
rename from .agent/scripts/credential-helper.sh
rename to .agents/scripts/credential-helper.sh
diff --git a/.agent/scripts/crewai-helper.sh b/.agents/scripts/crewai-helper.sh
similarity index 99%
rename from .agent/scripts/crewai-helper.sh
rename to .agents/scripts/crewai-helper.sh
index a7d259790..7972fc3d7 100755
--- a/.agent/scripts/crewai-helper.sh
+++ b/.agents/scripts/crewai-helper.sh
@@ -5,7 +5,7 @@
 # Multi-agent orchestration framework setup and management
 #
 # Usage:
-#   bash .agent/scripts/crewai-helper.sh [action]
+#   bash .agents/scripts/crewai-helper.sh [action]
 #
 # Actions:
 #   setup     Complete setup of CrewAI
@@ -452,7 +452,7 @@ if [[ -f "$CREWAI_DIR/studio_app.py" ]]; then
     echo "Use 'stop-crewai-studio.sh' to stop"
 else
     echo "CrewAI Studio not set up. Run setup first:"
-    echo "  bash .agent/scripts/crewai-helper.sh setup"
+    echo "  bash .agents/scripts/crewai-helper.sh setup"
     exit 1
 fi
 EOF
diff --git a/.agent/scripts/cron-dispatch.sh b/.agents/scripts/cron-dispatch.sh
similarity index 100%
rename from .agent/scripts/cron-dispatch.sh
rename to .agents/scripts/cron-dispatch.sh
diff --git a/.agent/scripts/cron-helper.sh b/.agents/scripts/cron-helper.sh
similarity index 100%
rename from .agent/scripts/cron-helper.sh
rename to .agents/scripts/cron-helper.sh
diff --git a/.agent/scripts/dev-browser-helper.sh b/.agents/scripts/dev-browser-helper.sh
similarity index 100%
rename from .agent/scripts/dev-browser-helper.sh
rename to .agents/scripts/dev-browser-helper.sh
diff --git a/.agent/scripts/dns-helper.sh b/.agents/scripts/dns-helper.sh
similarity index 100%
rename from .agent/scripts/dns-helper.sh
rename to .agents/scripts/dns-helper.sh
diff --git a/.agent/scripts/domain-research-helper.sh b/.agents/scripts/domain-research-helper.sh
similarity index 100%
rename from .agent/scripts/domain-research-helper.sh
rename to .agents/scripts/domain-research-helper.sh
diff --git a/.agent/scripts/dspy-helper.sh b/.agents/scripts/dspy-helper.sh
similarity index 99%
rename from .agent/scripts/dspy-helper.sh
rename to .agents/scripts/dspy-helper.sh
index 1ba421877..526b05898 100755
--- a/.agent/scripts/dspy-helper.sh
+++ b/.agents/scripts/dspy-helper.sh
@@ -9,7 +9,7 @@
 
 # Load shared constants and functions
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=.agent/scripts/shared-constants.sh
+# shellcheck source=.agents/scripts/shared-constants.sh
 source "$SCRIPT_DIR/shared-constants.sh"
 
 # Use shared print functions with fallback for compatibility
diff --git a/.agent/scripts/dspyground-helper.sh b/.agents/scripts/dspyground-helper.sh
similarity index 99%
rename from .agent/scripts/dspyground-helper.sh
rename to .agents/scripts/dspyground-helper.sh
index 0ed1f2c4a..74e8146d5 100755
--- a/.agent/scripts/dspyground-helper.sh
+++ b/.agents/scripts/dspyground-helper.sh
@@ -9,7 +9,7 @@
 
 # Load shared constants and functions
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=.agent/scripts/shared-constants.sh
+# shellcheck source=.agents/scripts/shared-constants.sh
 source "$SCRIPT_DIR/shared-constants.sh"
 
 # Use shared print functions with fallback for compatibility
diff --git a/.agent/scripts/eeat-score-helper.sh b/.agents/scripts/eeat-score-helper.sh
similarity index 100%
rename from .agent/scripts/eeat-score-helper.sh
rename to .agents/scripts/eeat-score-helper.sh
diff --git a/.agent/scripts/efficient-return-fix.sh b/.agents/scripts/efficient-return-fix.sh
similarity index 100%
rename from .agent/scripts/efficient-return-fix.sh
rename to .agents/scripts/efficient-return-fix.sh
diff --git a/.agent/scripts/email-health-check-helper.sh b/.agents/scripts/email-health-check-helper.sh
similarity index 100%
rename from .agent/scripts/email-health-check-helper.sh
rename to .agents/scripts/email-health-check-helper.sh
diff --git a/.agent/scripts/extract-opencode-prompts.sh b/.agents/scripts/extract-opencode-prompts.sh
similarity index 100%
rename from .agent/scripts/extract-opencode-prompts.sh
rename to .agents/scripts/extract-opencode-prompts.sh
diff --git a/.agent/scripts/find-missing-returns.sh b/.agents/scripts/find-missing-returns.sh
similarity index 100%
rename from .agent/scripts/find-missing-returns.sh
rename to .agents/scripts/find-missing-returns.sh
diff --git a/.agent/scripts/fix-auth-headers.sh b/.agents/scripts/fix-auth-headers.sh
similarity index 98%
rename from .agent/scripts/fix-auth-headers.sh
rename to .agents/scripts/fix-auth-headers.sh
index 0b88afc36..2f50d0bdf 100755
--- a/.agent/scripts/fix-auth-headers.sh
+++ b/.agents/scripts/fix-auth-headers.sh
@@ -88,7 +88,7 @@ main() {
     local files_fixed=0
     local files_processed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_processed++))
             if fix_auth_header_in_file "$file"; then
diff --git a/.agent/scripts/fix-common-strings.sh b/.agents/scripts/fix-common-strings.sh
similarity index 99%
rename from .agent/scripts/fix-common-strings.sh
rename to .agents/scripts/fix-common-strings.sh
index 20b4d8c35..742073859 100755
--- a/.agent/scripts/fix-common-strings.sh
+++ b/.agents/scripts/fix-common-strings.sh
@@ -207,7 +207,7 @@ show_help() {
     echo "Usage: $0 [target]"
     echo ""
     echo "Examples:"
-    echo "  $0 .agent/scripts/"
+    echo "  $0 .agents/scripts/"
     echo "  $0 setup.sh"
     echo "  $0 ."
     echo ""
diff --git a/.agent/scripts/fix-content-type.sh b/.agents/scripts/fix-content-type.sh
similarity index 98%
rename from .agent/scripts/fix-content-type.sh
rename to .agents/scripts/fix-content-type.sh
index 26f24254c..40ddb924d 100755
--- a/.agent/scripts/fix-content-type.sh
+++ b/.agents/scripts/fix-content-type.sh
@@ -84,7 +84,7 @@ main() {
     local files_fixed=0
     local files_processed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_processed++))
             if fix_content_type_in_file "$file"; then
diff --git a/.agent/scripts/fix-error-messages.sh b/.agents/scripts/fix-error-messages.sh
similarity index 98%
rename from .agent/scripts/fix-error-messages.sh
rename to .agents/scripts/fix-error-messages.sh
index 0041f74bc..a049e8e4e 100755
--- a/.agent/scripts/fix-error-messages.sh
+++ b/.agents/scripts/fix-error-messages.sh
@@ -114,7 +114,7 @@ main() {
     local files_fixed=0
     local files_processed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_processed++))
             if fix_error_messages_in_file "$file"; then
diff --git a/.agent/scripts/fix-misplaced-returns.sh b/.agents/scripts/fix-misplaced-returns.sh
similarity index 100%
rename from .agent/scripts/fix-misplaced-returns.sh
rename to .agents/scripts/fix-misplaced-returns.sh
diff --git a/.agent/scripts/fix-remaining-literals.sh b/.agents/scripts/fix-remaining-literals.sh
similarity index 99%
rename from .agent/scripts/fix-remaining-literals.sh
rename to .agents/scripts/fix-remaining-literals.sh
index e9c3b6bf9..9a9472582 100755
--- a/.agent/scripts/fix-remaining-literals.sh
+++ b/.agents/scripts/fix-remaining-literals.sh
@@ -121,7 +121,7 @@ readonly CONTENT_TYPE_JSON="Content-Type: application/json"
 
 # Main execution
 main() {
-    local target="${1:-.agent/scripts/}"
+    local target="${1:-.agents/scripts/}"
     
     print_info "Fixing remaining string literals..."
     
diff --git a/.agent/scripts/fix-return-statements.sh b/.agents/scripts/fix-return-statements.sh
similarity index 96%
rename from .agent/scripts/fix-return-statements.sh
rename to .agents/scripts/fix-return-statements.sh
index b54847e8f..5b740b1b9 100755
--- a/.agent/scripts/fix-return-statements.sh
+++ b/.agents/scripts/fix-return-statements.sh
@@ -4,7 +4,7 @@
 # Script to add return statements to functions that need them
 # Based on SonarCloud S7682 issues
 
-FILE=".agent/scripts/101domains-helper.sh"
+FILE=".agents/scripts/101domains-helper.sh"
 
 # Function to add return statement before closing brace
 add_return_statement() {
diff --git a/.agent/scripts/fix-s131-default-cases.sh b/.agents/scripts/fix-s131-default-cases.sh
similarity index 99%
rename from .agent/scripts/fix-s131-default-cases.sh
rename to .agents/scripts/fix-s131-default-cases.sh
index 0b1a89345..308461207 100755
--- a/.agent/scripts/fix-s131-default-cases.sh
+++ b/.agents/scripts/fix-s131-default-cases.sh
@@ -23,7 +23,7 @@ print_error() { echo -e "${RED}[ERROR]${NC} $1" >&2; return 0; }
 DRY_RUN=false
 TARGET_FILE=""
 FIX_ALL=false
-SCRIPTS_DIR=".agent/scripts"
+SCRIPTS_DIR=".agents/scripts"
 
 # Parse arguments
 while [[ $# -gt 0 ]]; do
diff --git a/.agent/scripts/fix-sc2155-simple.sh b/.agents/scripts/fix-sc2155-simple.sh
similarity index 98%
rename from .agent/scripts/fix-sc2155-simple.sh
rename to .agents/scripts/fix-sc2155-simple.sh
index 03d496196..fa376728b 100755
--- a/.agent/scripts/fix-sc2155-simple.sh
+++ b/.agents/scripts/fix-sc2155-simple.sh
@@ -86,7 +86,7 @@ main() {
     local files_fixed=0
     local files_processed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_processed++))
             if fix_sc2155_simple "$file"; then
diff --git a/.agent/scripts/fix-shellcheck-critical.sh b/.agents/scripts/fix-shellcheck-critical.sh
similarity index 99%
rename from .agent/scripts/fix-shellcheck-critical.sh
rename to .agents/scripts/fix-shellcheck-critical.sh
index c491e4a44..967edf30e 100755
--- a/.agent/scripts/fix-shellcheck-critical.sh
+++ b/.agents/scripts/fix-shellcheck-critical.sh
@@ -171,7 +171,7 @@ main() {
     local files_fixed=0
     local files_processed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_processed++))
             if fix_critical_shellcheck_in_file "$file"; then
diff --git a/.agent/scripts/fix-string-literals.sh b/.agents/scripts/fix-string-literals.sh
similarity index 99%
rename from .agent/scripts/fix-string-literals.sh
rename to .agents/scripts/fix-string-literals.sh
index aaae2dcd0..b5b14ee53 100755
--- a/.agent/scripts/fix-string-literals.sh
+++ b/.agents/scripts/fix-string-literals.sh
@@ -206,7 +206,7 @@ show_help() {
     echo ""
     echo "Examples:"
     echo "  $0 analyze ."
-    echo "  $0 fix .agent/scripts/"
+    echo "  $0 fix .agents/scripts/"
     echo "  $0 fix setup.sh"
     echo ""
     echo "This script addresses SonarCloud S1192 violations by:"
diff --git a/.agent/scripts/full-loop-helper.sh b/.agents/scripts/full-loop-helper.sh
similarity index 98%
rename from .agent/scripts/full-loop-helper.sh
rename to .agents/scripts/full-loop-helper.sh
index f4feacb8b..2ab015679 100755
--- a/.agent/scripts/full-loop-helper.sh
+++ b/.agents/scripts/full-loop-helper.sh
@@ -40,7 +40,7 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
 readonly SCRIPT_DIR
-readonly STATE_DIR=".agent/loop-state"
+readonly STATE_DIR=".agents/loop-state"
 readonly STATE_FILE="${STATE_DIR}/full-loop.local.state"
 
 # Legacy state directory (for backward compatibility during migration)
@@ -606,7 +606,7 @@ cmd_run_foreground() {
 
     # Auto-advance when task phase completes in v2.
     # Legacy mode leaves a Ralph state file; in that case we must wait for manual completion.
-    if [[ -f ".agent/loop-state/ralph-loop.local.state" ]] || [[ -f ".claude/ralph-loop.local.state" ]]; then
+    if [[ -f ".agents/loop-state/ralph-loop.local.state" ]] || [[ -f ".claude/ralph-loop.local.state" ]]; then
         print_warning "Task loop still active (legacy mode). Run: full-loop-helper.sh resume when complete."
         return 0
     fi
@@ -628,7 +628,7 @@ cmd_resume() {
     case "$CURRENT_PHASE" in
         "$PHASE_TASK")
             # Check if task is complete (check both new and legacy locations)
-            if [[ -f ".agent/loop-state/ralph-loop.local.state" ]] || [[ -f ".claude/ralph-loop.local.state" ]]; then
+            if [[ -f ".agents/loop-state/ralph-loop.local.state" ]] || [[ -f ".claude/ralph-loop.local.state" ]]; then
                 print_info "Task loop still active. Complete it first."
                 return 0
             fi
@@ -728,8 +728,8 @@ cmd_cancel() {
     clear_state
     
     # Also cancel any sub-loops (both new and legacy locations)
-    rm -f ".agent/loop-state/ralph-loop.local.state" 2>/dev/null
-    rm -f ".agent/loop-state/quality-loop.local.state" 2>/dev/null
+    rm -f ".agents/loop-state/ralph-loop.local.state" 2>/dev/null
+    rm -f ".agents/loop-state/quality-loop.local.state" 2>/dev/null
     rm -f ".claude/ralph-loop.local.state" 2>/dev/null
     rm -f ".claude/quality-loop.local.state" 2>/dev/null
     
diff --git a/.agent/scripts/generate-opencode-agents.sh b/.agents/scripts/generate-opencode-agents.sh
similarity index 100%
rename from .agent/scripts/generate-opencode-agents.sh
rename to .agents/scripts/generate-opencode-agents.sh
diff --git a/.agent/scripts/generate-opencode-commands.sh b/.agents/scripts/generate-opencode-commands.sh
similarity index 99%
rename from .agent/scripts/generate-opencode-commands.sh
rename to .agents/scripts/generate-opencode-commands.sh
index af4d495db..b76374dab 100755
--- a/.agent/scripts/generate-opencode-commands.sh
+++ b/.agents/scripts/generate-opencode-commands.sh
@@ -173,7 +173,7 @@ Release type: $ARGUMENTS (valid: major, minor, patch)
    - Any `BREAKING CHANGE:` or `!` → major
 3. Run the single release command:
    ```bash
-   .agent/scripts/version-manager.sh release [type] --skip-preflight --force
+   .agents/scripts/version-manager.sh release [type] --skip-preflight --force
    ```
 4. Report the result with the GitHub release URL
 
@@ -1166,7 +1166,7 @@ Cancel the active Ralph loop.
 ~/.aidevops/agents/scripts/ralph-loop-helper.sh cancel
 ```
 
-This removes the state file at `.agent/loop-state/ralph-loop.local.state` and stops the loop.
+This removes the state file at `.agents/loop-state/ralph-loop.local.state` and stops the loop.
 
 If no loop is active, it will report "No active Ralph loop found."
 EOF
@@ -1367,7 +1367,7 @@ Task ID: $ARGUMENTS
 ```markdown
 - [ ] t042 Fix all ShellCheck violations #ralph ~2h
   ralph-promise: "SHELLCHECK_CLEAN"
-  ralph-verify: "shellcheck .agent/scripts/*.sh"
+  ralph-verify: "shellcheck .agents/scripts/*.sh"
   ralph-max: 10
 ```
 
@@ -1561,7 +1561,7 @@ echo -e "  ${GREEN}✓${NC} Created /recall command"
 # =============================================================================
 # AUTO-DISCOVERED COMMANDS FROM scripts/commands/
 # =============================================================================
-# Commands in .agent/scripts/commands/*.md are auto-generated
+# Commands in .agents/scripts/commands/*.md are auto-generated
 # Each file should have frontmatter with description and agent
 # This prevents needing to manually add new commands to this script
 
diff --git a/.agent/scripts/generate-skills.sh b/.agents/scripts/generate-skills.sh
similarity index 100%
rename from .agent/scripts/generate-skills.sh
rename to .agents/scripts/generate-skills.sh
diff --git a/.agent/scripts/git-platforms-helper.sh b/.agents/scripts/git-platforms-helper.sh
similarity index 100%
rename from .agent/scripts/git-platforms-helper.sh
rename to .agents/scripts/git-platforms-helper.sh
diff --git a/.agent/scripts/gitea-cli-helper.sh b/.agents/scripts/gitea-cli-helper.sh
similarity index 100%
rename from .agent/scripts/gitea-cli-helper.sh
rename to .agents/scripts/gitea-cli-helper.sh
diff --git a/.agent/scripts/github-cli-helper.sh b/.agents/scripts/github-cli-helper.sh
similarity index 100%
rename from .agent/scripts/github-cli-helper.sh
rename to .agents/scripts/github-cli-helper.sh
diff --git a/.agent/scripts/gitlab-cli-helper.sh b/.agents/scripts/gitlab-cli-helper.sh
similarity index 100%
rename from .agent/scripts/gitlab-cli-helper.sh
rename to .agents/scripts/gitlab-cli-helper.sh
diff --git a/.agent/scripts/gsc-add-user-helper.sh b/.agents/scripts/gsc-add-user-helper.sh
similarity index 100%
rename from .agent/scripts/gsc-add-user-helper.sh
rename to .agents/scripts/gsc-add-user-helper.sh
diff --git a/.agent/scripts/gsc-sitemap-helper.sh b/.agents/scripts/gsc-sitemap-helper.sh
similarity index 100%
rename from .agent/scripts/gsc-sitemap-helper.sh
rename to .agents/scripts/gsc-sitemap-helper.sh
diff --git a/.agent/scripts/hetzner-helper.sh b/.agents/scripts/hetzner-helper.sh
similarity index 100%
rename from .agent/scripts/hetzner-helper.sh
rename to .agents/scripts/hetzner-helper.sh
diff --git a/.agent/scripts/hostinger-helper.sh b/.agents/scripts/hostinger-helper.sh
similarity index 100%
rename from .agent/scripts/hostinger-helper.sh
rename to .agents/scripts/hostinger-helper.sh
diff --git a/.agent/scripts/humanise-update-helper.sh b/.agents/scripts/humanise-update-helper.sh
similarity index 98%
rename from .agent/scripts/humanise-update-helper.sh
rename to .agents/scripts/humanise-update-helper.sh
index 0f6efb2a4..e2d8db852 100755
--- a/.agent/scripts/humanise-update-helper.sh
+++ b/.agents/scripts/humanise-update-helper.sh
@@ -171,7 +171,7 @@ cmd_check() {
         echo ""
         echo "  1. Run: humanise-update-helper.sh diff"
         echo "  2. Review changes at: https://github.com/${UPSTREAM_REPO}/commits/main"
-        echo "  3. Update .agent/content/humanise.md with relevant changes"
+        echo "  3. Update .agents/content/humanise.md with relevant changes"
         echo "  4. Update upstream_version in frontmatter to: ${upstream_latest}"
         echo ""
         return 1
@@ -235,7 +235,7 @@ cmd_help() {
     echo ""
     echo "When updates are available:"
     echo "  1. Review the diff and upstream commits"
-    echo "  2. Incorporate relevant changes into .agent/content/humanise.md"
+    echo "  2. Incorporate relevant changes into .agents/content/humanise.md"
     echo "  3. Update the upstream_version field in frontmatter"
 }
 
diff --git a/.agent/scripts/keyword-research-helper.sh b/.agents/scripts/keyword-research-helper.sh
similarity index 100%
rename from .agent/scripts/keyword-research-helper.sh
rename to .agents/scripts/keyword-research-helper.sh
diff --git a/.agent/scripts/langflow-helper.sh b/.agents/scripts/langflow-helper.sh
similarity index 99%
rename from .agent/scripts/langflow-helper.sh
rename to .agents/scripts/langflow-helper.sh
index 65078a94a..f4c26f920 100755
--- a/.agent/scripts/langflow-helper.sh
+++ b/.agents/scripts/langflow-helper.sh
@@ -5,7 +5,7 @@
 # Visual AI workflow builder setup and management
 #
 # Usage:
-#   bash .agent/scripts/langflow-helper.sh [action]
+#   bash .agents/scripts/langflow-helper.sh [action]
 #
 # Actions:
 #   setup     Complete setup of Langflow
@@ -300,7 +300,7 @@ if [[ -f "$LANGFLOW_DIR/start_langflow.sh" ]]; then
     fi
 else
     echo "Langflow not set up. Run setup first:"
-    echo "  bash .agent/scripts/langflow-helper.sh setup"
+    echo "  bash .agents/scripts/langflow-helper.sh setup"
     exit 1
 fi
 EOF
diff --git a/.agent/scripts/linkedin-automation.py b/.agents/scripts/linkedin-automation.py
similarity index 100%
rename from .agent/scripts/linkedin-automation.py
rename to .agents/scripts/linkedin-automation.py
diff --git a/.agent/scripts/linter-manager.sh b/.agents/scripts/linter-manager.sh
similarity index 100%
rename from .agent/scripts/linter-manager.sh
rename to .agents/scripts/linter-manager.sh
diff --git a/.agent/scripts/linters-local.sh b/.agents/scripts/linters-local.sh
similarity index 96%
rename from .agent/scripts/linters-local.sh
rename to .agents/scripts/linters-local.sh
index 3439e1633..aad64f268 100755
--- a/.agent/scripts/linters-local.sh
+++ b/.agents/scripts/linters-local.sh
@@ -103,7 +103,7 @@ check_return_statements() {
     local violations=0
     local files_checked=0
 
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             ((files_checked++))
 
@@ -162,7 +162,7 @@ check_positional_parameters() {
     tmp_file=$(mktemp)
 
     # Only check inside function bodies, exclude heredocs, awk/sed patterns, and comments
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             # Use awk to find $1-$9 usage inside functions, excluding:
             # - local assignments (local var="$1")
@@ -227,7 +227,7 @@ check_string_literals() {
 
     local violations=0
 
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             # Find strings that appear 3 or more times
             local repeated_strings
@@ -255,7 +255,7 @@ run_shellcheck() {
 
     local violations=0
 
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             # Only count errors and warnings, not info-level (SC1091, SC2329, etc.)
             # Use severity filter to exclude info-level messages
@@ -282,7 +282,7 @@ run_shellcheck() {
 check_secrets() {
     echo -e "${BLUE}Checking for Exposed Secrets (Secretlint)...${NC}"
 
-    local secretlint_script=".agent/scripts/secretlint-helper.sh"
+    local secretlint_script=".agents/scripts/secretlint-helper.sh"
     local violations=0
 
     # Check if secretlint is available
@@ -367,7 +367,7 @@ check_markdown_lint() {
     # Get markdown files to check:
     # 1. Uncommitted changes (staged + unstaged) - BLOCKING
     # 2. If no uncommitted, check files changed in current branch vs main - BLOCKING
-    # 3. Fallback to all tracked .md files in .agent/ - NON-BLOCKING (advisory)
+    # 3. Fallback to all tracked .md files in .agents/ - NON-BLOCKING (advisory)
     local check_mode="changed"  # "changed" = blocking, "all" = advisory
     if git rev-parse --git-dir > /dev/null 2>&1; then
         # First try uncommitted changes
@@ -382,9 +382,9 @@ check_markdown_lint() {
             fi
         fi
         
-        # Fallback: check all .agent/*.md files (advisory only)
+        # Fallback: check all .agents/*.md files (advisory only)
         if [[ -z "$md_files" ]]; then
-            md_files=$(git ls-files '.agent/**/*.md' 2>/dev/null)
+            md_files=$(git ls-files '.agents/**/*.md' 2>/dev/null)
             check_mode="all"
         fi
     else
@@ -504,7 +504,7 @@ check_remote_cli_status() {
     print_info "Remote Audit CLIs Status (use /code-audit-remote for full analysis)..."
 
     # Secretlint
-    local secretlint_script=".agent/scripts/secretlint-helper.sh"
+    local secretlint_script=".agents/scripts/secretlint-helper.sh"
     if [[ -f "$secretlint_script" ]]; then
         if command -v secretlint &> /dev/null || [[ -f "node_modules/.bin/secretlint" ]]; then
             print_success "Secretlint: Ready"
@@ -514,7 +514,7 @@ check_remote_cli_status() {
     fi
 
     # CodeRabbit CLI
-    local coderabbit_script=".agent/scripts/coderabbit-cli.sh"
+    local coderabbit_script=".agents/scripts/coderabbit-cli.sh"
     if [[ -f "$coderabbit_script" ]]; then
         if bash "$coderabbit_script" status > /dev/null 2>&1; then
             print_success "CodeRabbit CLI: Ready"
@@ -524,7 +524,7 @@ check_remote_cli_status() {
     fi
 
     # Codacy CLI
-    local codacy_script=".agent/scripts/codacy-cli.sh"
+    local codacy_script=".agents/scripts/codacy-cli.sh"
     if [[ -f "$codacy_script" ]]; then
         if bash "$codacy_script" status > /dev/null 2>&1; then
             print_success "Codacy CLI: Ready"
@@ -534,7 +534,7 @@ check_remote_cli_status() {
     fi
 
     # SonarScanner CLI
-    local sonar_script=".agent/scripts/sonarscanner-cli.sh"
+    local sonar_script=".agents/scripts/sonarscanner-cli.sh"
     if [[ -f "$sonar_script" ]]; then
         if bash "$sonar_script" status > /dev/null 2>&1; then
             print_success "SonarScanner CLI: Ready"
diff --git a/.agent/scripts/list-keys-helper.sh b/.agents/scripts/list-keys-helper.sh
similarity index 100%
rename from .agent/scripts/list-keys-helper.sh
rename to .agents/scripts/list-keys-helper.sh
diff --git a/.agent/scripts/list-todo-helper.sh b/.agents/scripts/list-todo-helper.sh
similarity index 100%
rename from .agent/scripts/list-todo-helper.sh
rename to .agents/scripts/list-todo-helper.sh
diff --git a/.agent/scripts/local-browser-automation.py b/.agents/scripts/local-browser-automation.py
similarity index 100%
rename from .agent/scripts/local-browser-automation.py
rename to .agents/scripts/local-browser-automation.py
diff --git a/.agent/scripts/localhost-helper.sh b/.agents/scripts/localhost-helper.sh
similarity index 100%
rename from .agent/scripts/localhost-helper.sh
rename to .agents/scripts/localhost-helper.sh
diff --git a/.agent/scripts/log-issue-helper.sh b/.agents/scripts/log-issue-helper.sh
similarity index 100%
rename from .agent/scripts/log-issue-helper.sh
rename to .agents/scripts/log-issue-helper.sh
diff --git a/.agent/scripts/loop-common.sh b/.agents/scripts/loop-common.sh
similarity index 99%
rename from .agent/scripts/loop-common.sh
rename to .agents/scripts/loop-common.sh
index 7b38ada2d..1cd1bfb55 100755
--- a/.agent/scripts/loop-common.sh
+++ b/.agents/scripts/loop-common.sh
@@ -29,7 +29,7 @@ readonly LOOP_COMMON_DIR
 readonly LOOP_MAIL_HELPER="${LOOP_COMMON_DIR}/mail-helper.sh"
 readonly LOOP_MEMORY_HELPER="${LOOP_COMMON_DIR}/memory-helper.sh"
 
-readonly LOOP_STATE_DIR="${LOOP_STATE_DIR:-.agent/loop-state}"
+readonly LOOP_STATE_DIR="${LOOP_STATE_DIR:-.agents/loop-state}"
 readonly LOOP_STATE_FILE="${LOOP_STATE_DIR}/loop-state.json"
 readonly LOOP_RECEIPTS_DIR="${LOOP_STATE_DIR}/receipts"
 readonly LOOP_REANCHOR_FILE="${LOOP_STATE_DIR}/re-anchor.md"
diff --git a/.agent/scripts/mail-helper.sh b/.agents/scripts/mail-helper.sh
similarity index 100%
rename from .agent/scripts/mail-helper.sh
rename to .agents/scripts/mail-helper.sh
diff --git a/.agent/scripts/mainwp-helper.sh b/.agents/scripts/mainwp-helper.sh
similarity index 100%
rename from .agent/scripts/mainwp-helper.sh
rename to .agents/scripts/mainwp-helper.sh
diff --git a/.agent/scripts/markdown-formatter.sh b/.agents/scripts/markdown-formatter.sh
similarity index 99%
rename from .agent/scripts/markdown-formatter.sh
rename to .agents/scripts/markdown-formatter.sh
index 8b28dd21e..7e5c439b4 100755
--- a/.agent/scripts/markdown-formatter.sh
+++ b/.agents/scripts/markdown-formatter.sh
@@ -260,7 +260,7 @@ show_help() {
     echo ""
     echo "Examples:"
     echo "  $0 README.md"
-    echo "  $0 format .agent/"
+    echo "  $0 format .agents/"
     echo "  $0 advanced ."
     echo "  $0 cleanup"
     echo ""
diff --git a/.agent/scripts/markdown-lint-fix.sh b/.agents/scripts/markdown-lint-fix.sh
similarity index 99%
rename from .agent/scripts/markdown-lint-fix.sh
rename to .agents/scripts/markdown-lint-fix.sh
index 7678063a5..5e34a740d 100755
--- a/.agent/scripts/markdown-lint-fix.sh
+++ b/.agents/scripts/markdown-lint-fix.sh
@@ -245,7 +245,7 @@ show_help() {
     echo ""
     echo "Examples:"
     echo "  $0 README.md"
-    echo "  $0 fix .agent/"
+    echo "  $0 fix .agents/"
     echo "  $0 manual ."
     echo "  $0 install"
     echo ""
diff --git a/.agent/scripts/mass-fix-returns.sh b/.agents/scripts/mass-fix-returns.sh
similarity index 100%
rename from .agent/scripts/mass-fix-returns.sh
rename to .agents/scripts/mass-fix-returns.sh
diff --git a/.agent/scripts/matrix-dispatch-helper.sh b/.agents/scripts/matrix-dispatch-helper.sh
similarity index 100%
rename from .agent/scripts/matrix-dispatch-helper.sh
rename to .agents/scripts/matrix-dispatch-helper.sh
diff --git a/.agent/scripts/mcp-diagnose.sh b/.agents/scripts/mcp-diagnose.sh
similarity index 100%
rename from .agent/scripts/mcp-diagnose.sh
rename to .agents/scripts/mcp-diagnose.sh
diff --git a/.agent/scripts/mcp-index-helper.sh b/.agents/scripts/mcp-index-helper.sh
similarity index 99%
rename from .agent/scripts/mcp-index-helper.sh
rename to .agents/scripts/mcp-index-helper.sh
index b145e09c5..9f601024d 100755
--- a/.agent/scripts/mcp-index-helper.sh
+++ b/.agents/scripts/mcp-index-helper.sh
@@ -202,7 +202,7 @@ for mcp_name, mcp_config in mcp_servers.items():
         'osgrep': ['search', 'trace', 'skeleton'],
         'augment-context-engine': ['codebase-retrieval'],
         'dataforseo': ['serp', 'keywords', 'backlinks', 'domain-analytics'],
-        # serper - REMOVED: Uses curl subagent (.agent/seo/serper.md)
+        # serper - REMOVED: Uses curl subagent (.agents/seo/serper.md)
         'gsc': ['query', 'sitemaps', 'inspect'],
         'shadcn': ['browse', 'search', 'install'],
         'playwriter': ['navigate', 'click', 'type', 'screenshot'],
diff --git a/.agent/scripts/mcp-inspector-helper.sh b/.agents/scripts/mcp-inspector-helper.sh
similarity index 100%
rename from .agent/scripts/mcp-inspector-helper.sh
rename to .agents/scripts/mcp-inspector-helper.sh
diff --git a/.agent/scripts/memory-embeddings-helper.sh b/.agents/scripts/memory-embeddings-helper.sh
similarity index 100%
rename from .agent/scripts/memory-embeddings-helper.sh
rename to .agents/scripts/memory-embeddings-helper.sh
diff --git a/.agent/scripts/memory-helper.sh b/.agents/scripts/memory-helper.sh
similarity index 100%
rename from .agent/scripts/memory-helper.sh
rename to .agents/scripts/memory-helper.sh
diff --git a/.agent/scripts/monitor-code-review.sh b/.agents/scripts/monitor-code-review.sh
similarity index 91%
rename from .agent/scripts/monitor-code-review.sh
rename to .agents/scripts/monitor-code-review.sh
index 2628281ff..66a8303d5 100755
--- a/.agent/scripts/monitor-code-review.sh
+++ b/.agents/scripts/monitor-code-review.sh
@@ -23,11 +23,11 @@ print_header() { local msg="$1"; echo -e "${PURPLE}[MONITOR]${NC} $msg"; return
 
 # Configuration
 readonly REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-readonly MONITOR_LOG="$REPO_ROOT/.agent/tmp/code-review-monitor.log"
-readonly STATUS_FILE="$REPO_ROOT/.agent/tmp/quality-status.json"
+readonly MONITOR_LOG="$REPO_ROOT/.agents/tmp/code-review-monitor.log"
+readonly STATUS_FILE="$REPO_ROOT/.agents/tmp/quality-status.json"
 
 # Create directories
-mkdir -p "$REPO_ROOT/.agent/tmp"
+mkdir -p "$REPO_ROOT/.agents/tmp"
 
 # Initialize monitoring log
 init_monitoring() {
@@ -73,13 +73,13 @@ run_qlty_analysis() {
     print_info "Running Qlty analysis and auto-fixes..."
     
     # Run analysis with sample to get quick feedback
-    if bash "$REPO_ROOT/.agent/scripts/qlty-cli.sh" check 5 > "$REPO_ROOT/.agent/tmp/qlty-results.txt" 2>&1; then
+    if bash "$REPO_ROOT/.agents/scripts/qlty-cli.sh" check 5 > "$REPO_ROOT/.agents/tmp/qlty-results.txt" 2>&1; then
         local issues
-        issues=$(grep -o "ISSUES: [0-9]*" "$REPO_ROOT/.agent/tmp/qlty-results.txt" | grep -o "[0-9]*" || echo "0")
+        issues=$(grep -o "ISSUES: [0-9]*" "$REPO_ROOT/.agents/tmp/qlty-results.txt" | grep -o "[0-9]*" || echo "0")
         print_success "Qlty Analysis: $issues issues found"
         
         # Apply auto-formatting
-        if bash "$REPO_ROOT/.agent/scripts/qlty-cli.sh" fmt --all > "$REPO_ROOT/.agent/tmp/qlty-fmt.txt" 2>&1; then
+        if bash "$REPO_ROOT/.agents/scripts/qlty-cli.sh" fmt --all > "$REPO_ROOT/.agents/tmp/qlty-fmt.txt" 2>&1; then
             print_success "Qlty auto-formatting completed"
         fi
         
@@ -96,10 +96,10 @@ run_qlty_analysis() {
 run_codacy_analysis() {
     print_info "Running Codacy analysis (timeout: 5m)..."
     
-    local log_file="$REPO_ROOT/.agent/tmp/codacy-results.txt"
+    local log_file="$REPO_ROOT/.agents/tmp/codacy-results.txt"
     
     # Run in background
-    bash "$REPO_ROOT/.agent/scripts/codacy-cli.sh" analyze --fix > "$log_file" 2>&1 &
+    bash "$REPO_ROOT/.agents/scripts/codacy-cli.sh" analyze --fix > "$log_file" 2>&1 &
     local pid=$!
     
     # Wait loop with timeout (300 seconds)
@@ -156,7 +156,7 @@ apply_automatic_fixes() {
     local fixes_applied=0
     
     # Fix shellcheck issues in new files
-    for file in .agent/scripts/*.sh .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh .agents/scripts/*.sh; do
         # Check if file exists and has been modified recently (within last hour)
         if [[ -f "$file" ]] && [[ $(find "$file" -mmin -60 2>/dev/null) ]]; then
             print_info "Checking recent file: $file"
diff --git a/.agent/scripts/onboarding-helper.sh b/.agents/scripts/onboarding-helper.sh
similarity index 100%
rename from .agent/scripts/onboarding-helper.sh
rename to .agents/scripts/onboarding-helper.sh
diff --git a/.agent/scripts/opencode-github-setup-helper.sh b/.agents/scripts/opencode-github-setup-helper.sh
similarity index 99%
rename from .agent/scripts/opencode-github-setup-helper.sh
rename to .agents/scripts/opencode-github-setup-helper.sh
index bbd2a14e3..49c84ef60 100755
--- a/.agent/scripts/opencode-github-setup-helper.sh
+++ b/.agents/scripts/opencode-github-setup-helper.sh
@@ -538,7 +538,7 @@ cmd_create_secure_workflow() {
 create_secure_workflow_inline() {
     cat > .github/workflows/opencode-agent.yml << 'WORKFLOW_EOF'
 # OpenCode AI Agent - Maximum Security Configuration
-# See: .agent/tools/git/opencode-github-security.md for documentation
+# See: .agents/tools/git/opencode-github-security.md for documentation
 name: OpenCode AI Agent
 
 on:
diff --git a/.agent/scripts/opencode-prompt-drift-check.sh b/.agents/scripts/opencode-prompt-drift-check.sh
similarity index 97%
rename from .agent/scripts/opencode-prompt-drift-check.sh
rename to .agents/scripts/opencode-prompt-drift-check.sh
index f9e8d3ea9..40663ef13 100755
--- a/.agent/scripts/opencode-prompt-drift-check.sh
+++ b/.agents/scripts/opencode-prompt-drift-check.sh
@@ -72,7 +72,7 @@ main() {
             echo "  Upstream: $upstream_hash"
             echo ""
             echo "  View diff: https://github.com/${UPSTREAM_REPO}/compare/${local_hash}...${upstream_hash}"
-            echo "  To update: review changes and update .agent/prompts/build.txt"
+            echo "  To update: review changes and update .agents/prompts/build.txt"
         fi
         return 1
     fi
diff --git a/.agent/scripts/opencode-test-helper.sh b/.agents/scripts/opencode-test-helper.sh
similarity index 100%
rename from .agent/scripts/opencode-test-helper.sh
rename to .agents/scripts/opencode-test-helper.sh
diff --git a/.agent/scripts/pagespeed-helper.sh b/.agents/scripts/pagespeed-helper.sh
similarity index 100%
rename from .agent/scripts/pagespeed-helper.sh
rename to .agents/scripts/pagespeed-helper.sh
diff --git a/.agent/scripts/pandoc-helper.sh b/.agents/scripts/pandoc-helper.sh
similarity index 100%
rename from .agent/scripts/pandoc-helper.sh
rename to .agents/scripts/pandoc-helper.sh
diff --git a/.agent/scripts/pattern-tracker-helper.sh b/.agents/scripts/pattern-tracker-helper.sh
similarity index 100%
rename from .agent/scripts/pattern-tracker-helper.sh
rename to .agents/scripts/pattern-tracker-helper.sh
diff --git a/.agent/scripts/pdf-helper.sh b/.agents/scripts/pdf-helper.sh
similarity index 100%
rename from .agent/scripts/pdf-helper.sh
rename to .agents/scripts/pdf-helper.sh
diff --git a/.agent/scripts/peekaboo-helper.sh b/.agents/scripts/peekaboo-helper.sh
similarity index 100%
rename from .agent/scripts/peekaboo-helper.sh
rename to .agents/scripts/peekaboo-helper.sh
diff --git a/.agent/scripts/planning-commit-helper.sh b/.agents/scripts/planning-commit-helper.sh
similarity index 100%
rename from .agent/scripts/planning-commit-helper.sh
rename to .agents/scripts/planning-commit-helper.sh
diff --git a/.agent/scripts/postflight-check.sh b/.agents/scripts/postflight-check.sh
similarity index 98%
rename from .agent/scripts/postflight-check.sh
rename to .agents/scripts/postflight-check.sh
index fb39611b2..e8afc1248 100755
--- a/.agent/scripts/postflight-check.sh
+++ b/.agents/scripts/postflight-check.sh
@@ -290,7 +290,7 @@ check_sonarcloud() {
 check_codacy() {
     print_section "Codacy Analysis"
     
-    local codacy_script="$REPO_ROOT/.agent/scripts/codacy-cli.sh"
+    local codacy_script="$REPO_ROOT/.agents/scripts/codacy-cli.sh"
     
     if [[ -f "$codacy_script" ]]; then
         if bash "$codacy_script" status &> /dev/null; then
@@ -411,7 +411,7 @@ check_npm_audit() {
 check_local_quality() {
     print_section "Local Quality Checks"
     
-    local quality_script="$REPO_ROOT/.agent/scripts/linters-local.sh"
+    local quality_script="$REPO_ROOT/.agents/scripts/linters-local.sh"
     
     if [[ -f "$quality_script" ]]; then
         print_info "Running linters-local.sh..."
@@ -449,7 +449,7 @@ print_summary() {
         echo "Recommended actions:"
         echo "  1. Review failed checks above"
         echo "  2. Consider rollback if critical issues found"
-        echo "  3. See: .agent/workflows/postflight.md#rollback-procedures"
+        echo "  3. See: .agents/workflows/postflight.md#rollback-procedures"
         return 1
     elif [[ $WARNINGS -gt 0 ]]; then
         echo -e "${YELLOW}POSTFLIGHT VERIFICATION PASSED WITH WARNINGS${NC}"
diff --git a/.agent/scripts/pre-commit-hook.sh b/.agents/scripts/pre-commit-hook.sh
similarity index 95%
rename from .agent/scripts/pre-commit-hook.sh
rename to .agents/scripts/pre-commit-hook.sh
index 19af06be4..aae02dd7c 100755
--- a/.agent/scripts/pre-commit-hook.sh
+++ b/.agents/scripts/pre-commit-hook.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
 # Pre-commit hook for multi-platform quality validation
-# Install with: cp .agent/scripts/pre-commit-hook.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
+# Install with: cp .agents/scripts/pre-commit-hook.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
 
 set -euo pipefail
 
@@ -226,9 +226,9 @@ main() {
     echo ""
 
     # Optional CodeRabbit CLI review (if available)
-    if [[ -f ".agent/scripts/coderabbit-cli.sh" ]] && command -v coderabbit &> /dev/null; then
+    if [[ -f ".agents/scripts/coderabbit-cli.sh" ]] && command -v coderabbit &> /dev/null; then
         print_info "🤖 Running CodeRabbit CLI review..."
-        if bash .agent/scripts/coderabbit-cli.sh review > /dev/null 2>&1; then
+        if bash .agents/scripts/coderabbit-cli.sh review > /dev/null 2>&1; then
             print_success "CodeRabbit CLI review completed"
         else
             print_info "CodeRabbit CLI review skipped (setup required)"
@@ -244,10 +244,10 @@ main() {
         print_error "❌ Quality violations detected ($total_violations total)"
         echo ""
         print_info "To fix issues automatically, run:"
-        print_info "  ./.agent/scripts/quality-fix.sh"
+        print_info "  ./.agents/scripts/quality-fix.sh"
         echo ""
         print_info "To check current status, run:"
-        print_info "  ./.agent/scripts/linters-local.sh"
+        print_info "  ./.agents/scripts/linters-local.sh"
         echo ""
         print_info "To bypass this check (not recommended), use:"
         print_info "  git commit --no-verify"
diff --git a/.agent/scripts/pre-edit-check.sh b/.agents/scripts/pre-edit-check.sh
similarity index 100%
rename from .agent/scripts/pre-edit-check.sh
rename to .agents/scripts/pre-edit-check.sh
diff --git a/.agent/scripts/privacy-filter-helper.sh b/.agents/scripts/privacy-filter-helper.sh
similarity index 100%
rename from .agent/scripts/privacy-filter-helper.sh
rename to .agents/scripts/privacy-filter-helper.sh
diff --git a/.agent/scripts/qlty-cli.sh b/.agents/scripts/qlty-cli.sh
similarity index 100%
rename from .agent/scripts/qlty-cli.sh
rename to .agents/scripts/qlty-cli.sh
diff --git a/.agent/scripts/quality-cli-manager.sh b/.agents/scripts/quality-cli-manager.sh
similarity index 98%
rename from .agent/scripts/quality-cli-manager.sh
rename to .agents/scripts/quality-cli-manager.sh
index 290553bdf..2bd03bb76 100755
--- a/.agent/scripts/quality-cli-manager.sh
+++ b/.agents/scripts/quality-cli-manager.sh
@@ -34,10 +34,10 @@ readonly NC='\033[0m' # No Color
 # Common constants
 readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
 # CLI Scripts
-readonly CODERABBIT_SCRIPT=".agent/scripts/coderabbit-cli.sh"
-readonly CODACY_SCRIPT=".agent/scripts/codacy-cli.sh"
-readonly SONAR_SCRIPT=".agent/scripts/sonarscanner-cli.sh"
-readonly SNYK_SCRIPT=".agent/scripts/snyk-helper.sh"
+readonly CODERABBIT_SCRIPT=".agents/scripts/coderabbit-cli.sh"
+readonly CODACY_SCRIPT=".agents/scripts/codacy-cli.sh"
+readonly SONAR_SCRIPT=".agents/scripts/sonarscanner-cli.sh"
+readonly SNYK_SCRIPT=".agents/scripts/snyk-helper.sh"
 
 # CLI Names
 readonly CLI_CODERABBIT="coderabbit"
diff --git a/.agent/scripts/quality-feedback-helper.sh b/.agents/scripts/quality-feedback-helper.sh
similarity index 100%
rename from .agent/scripts/quality-feedback-helper.sh
rename to .agents/scripts/quality-feedback-helper.sh
diff --git a/.agent/scripts/quality-fix.sh b/.agents/scripts/quality-fix.sh
similarity index 97%
rename from .agent/scripts/quality-fix.sh
rename to .agents/scripts/quality-fix.sh
index 369c08030..d1e43d8ca 100755
--- a/.agent/scripts/quality-fix.sh
+++ b/.agents/scripts/quality-fix.sh
@@ -48,7 +48,7 @@ backup_files() {
     local backup_dir="backups/$(date +%Y%m%d_%H%M%S)"
     mkdir -p "$backup_dir"
 
-    cp .agent/scripts/*.sh "$backup_dir/"
+    cp .agents/scripts/*.sh "$backup_dir/"
     print_success "Backup created in $backup_dir"
     return 0
 }
@@ -58,7 +58,7 @@ fix_return_statements() {
     
     local files_fixed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             # Find functions that don't end with return statement
             local temp_file
@@ -134,7 +134,7 @@ fix_positional_parameters() {
     
     local files_fixed=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             local temp_file
             temp_file=$(mktemp)
@@ -176,7 +176,7 @@ analyze_string_literals() {
     local constants_file
     constants_file=$(mktemp)
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]]; then
             echo "=== $file ===" >> "$constants_file"
             
@@ -213,7 +213,7 @@ validate_fixes() {
     
     local validation_errors=0
     
-    for file in .agent/scripts/*.sh; do
+    for file in .agents/scripts/*.sh; do
         if [[ -f "$file" ]] && ! shellcheck "$file" > /dev/null 2>&1; then
             ((validation_errors++))
             print_warning "ShellCheck issues remain in $file"
diff --git a/.agent/scripts/quality-loop-helper.sh b/.agents/scripts/quality-loop-helper.sh
similarity index 99%
rename from .agent/scripts/quality-loop-helper.sh
rename to .agents/scripts/quality-loop-helper.sh
index 248597b82..b3daac8bb 100755
--- a/.agent/scripts/quality-loop-helper.sh
+++ b/.agents/scripts/quality-loop-helper.sh
@@ -31,7 +31,7 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
 readonly SCRIPT_DIR
-readonly STATE_DIR=".agent/loop-state"
+readonly STATE_DIR=".agents/loop-state"
 readonly STATE_FILE="${STATE_DIR}/quality-loop.local.state"
 
 # Legacy state directory (for backward compatibility during migration)
@@ -232,7 +232,7 @@ get_pending_checks() {
 #   $2 - Max iterations
 #   $3 - Options string (key=value pairs separated by commas)
 # Returns: 0
-# Side effects: Creates .agent/loop-state/quality-loop.local.state
+# Side effects: Creates .agents/loop-state/quality-loop.local.state
 create_state() {
     local loop_type="$1"
     local max_iterations="$2"
@@ -417,7 +417,7 @@ run_preflight_checks() {
     # Keep this aligned with linters-local.sh which checks warnings+errors.
     # Otherwise, info-level shellcheck findings can fail preflight even though
     # the repo's accepted local-linter gate passes.
-    if find .agent/scripts -name "*.sh" -exec shellcheck --severity=warning {} \; >/dev/null 2>&1; then
+    if find .agents/scripts -name "*.sh" -exec shellcheck --severity=warning {} \; >/dev/null 2>&1; then
         results="${results}shellcheck:pass\n"
         print_success "    ShellCheck: PASS"
     else
diff --git a/.agent/scripts/ralph-loop-helper.sh b/.agents/scripts/ralph-loop-helper.sh
similarity index 98%
rename from .agent/scripts/ralph-loop-helper.sh
rename to .agents/scripts/ralph-loop-helper.sh
index 13ac5eadd..7759c3657 100755
--- a/.agent/scripts/ralph-loop-helper.sh
+++ b/.agents/scripts/ralph-loop-helper.sh
@@ -43,7 +43,7 @@ if [[ -f "$SCRIPT_DIR/loop-common.sh" ]]; then
 fi
 
 # State directories
-readonly RALPH_STATE_DIR=".agent/loop-state"
+readonly RALPH_STATE_DIR=".agents/loop-state"
 readonly RALPH_STATE_FILE="${RALPH_STATE_DIR}/ralph-loop.local.state"
 
 # Legacy state directory (for backward compatibility during migration)
@@ -597,9 +597,9 @@ show_status_all() {
             local worktree_path="${BASH_REMATCH[1]}"
             
             # Check for v2 state (new location first, then legacy)
-            local v2_state="$worktree_path/.agent/loop-state/loop-state.json"
+            local v2_state="$worktree_path/.agents/loop-state/loop-state.json"
             local v2_state_legacy="$worktree_path/.claude/loop-state.json"
-            local legacy_state="$worktree_path/.agent/loop-state/ralph-loop.local.state"
+            local legacy_state="$worktree_path/.agents/loop-state/ralph-loop.local.state"
             local legacy_state_old="$worktree_path/.claude/ralph-loop.local.state"
             
             # Check any of the state file locations
@@ -669,9 +669,9 @@ check_other_loops() {
             fi
 
             # Check all possible state file locations (new and legacy)
-            local v2_state="$worktree_path/.agent/loop-state/loop-state.json"
+            local v2_state="$worktree_path/.agents/loop-state/loop-state.json"
             local v2_state_legacy="$worktree_path/.claude/loop-state.json"
-            local legacy_state="$worktree_path/.agent/loop-state/ralph-loop.local.state"
+            local legacy_state="$worktree_path/.agents/loop-state/ralph-loop.local.state"
             local legacy_state_old="$worktree_path/.claude/ralph-loop.local.state"
 
             if [[ -f "$v2_state" ]] || [[ -f "$v2_state_legacy" ]] || [[ -f "$legacy_state" ]] || [[ -f "$legacy_state_old" ]]; then
diff --git a/.agent/scripts/ralph-upstream-check.sh b/.agents/scripts/ralph-upstream-check.sh
similarity index 100%
rename from .agent/scripts/ralph-upstream-check.sh
rename to .agents/scripts/ralph-upstream-check.sh
diff --git a/.agent/scripts/readme-helper.sh b/.agents/scripts/readme-helper.sh
similarity index 99%
rename from .agent/scripts/readme-helper.sh
rename to .agents/scripts/readme-helper.sh
index 1fd165247..5e1875840 100755
--- a/.agent/scripts/readme-helper.sh
+++ b/.agents/scripts/readme-helper.sh
@@ -22,7 +22,7 @@ print_error() { local msg="$1"; echo -e "\033[31m[ERROR]\033[0m $msg"; return 0;
 print_warning() { local msg="$1"; echo -e "\033[33m[WARNING]\033[0m $msg"; return 0; }
 print_info() { local msg="$1"; echo -e "\033[34m[INFO]\033[0m $msg"; return 0; }
 
-# Count main agents (*.md files in .agent/ root, excluding AGENTS.md)
+# Count main agents (*.md files in .agents/ root, excluding AGENTS.md)
 count_main_agents() {
     if [[ -n "$_CACHED_MAIN_AGENTS" ]]; then
         echo "$_CACHED_MAIN_AGENTS"
diff --git a/.agent/scripts/runner-helper.sh b/.agents/scripts/runner-helper.sh
similarity index 100%
rename from .agent/scripts/runner-helper.sh
rename to .agents/scripts/runner-helper.sh
diff --git a/.agent/scripts/schema-validator-helper.sh b/.agents/scripts/schema-validator-helper.sh
similarity index 100%
rename from .agent/scripts/schema-validator-helper.sh
rename to .agents/scripts/schema-validator-helper.sh
diff --git a/.agent/scripts/secretlint-helper.sh b/.agents/scripts/secretlint-helper.sh
similarity index 100%
rename from .agent/scripts/secretlint-helper.sh
rename to .agents/scripts/secretlint-helper.sh
diff --git a/.agent/scripts/security-helper.sh b/.agents/scripts/security-helper.sh
similarity index 100%
rename from .agent/scripts/security-helper.sh
rename to .agents/scripts/security-helper.sh
diff --git a/.agent/scripts/self-improve-helper.sh b/.agents/scripts/self-improve-helper.sh
similarity index 100%
rename from .agent/scripts/self-improve-helper.sh
rename to .agents/scripts/self-improve-helper.sh
diff --git a/.agent/scripts/seo-analysis-helper.sh b/.agents/scripts/seo-analysis-helper.sh
similarity index 100%
rename from .agent/scripts/seo-analysis-helper.sh
rename to .agents/scripts/seo-analysis-helper.sh
diff --git a/.agent/scripts/seo-export-ahrefs.sh b/.agents/scripts/seo-export-ahrefs.sh
similarity index 100%
rename from .agent/scripts/seo-export-ahrefs.sh
rename to .agents/scripts/seo-export-ahrefs.sh
diff --git a/.agent/scripts/seo-export-bing.sh b/.agents/scripts/seo-export-bing.sh
similarity index 100%
rename from .agent/scripts/seo-export-bing.sh
rename to .agents/scripts/seo-export-bing.sh
diff --git a/.agent/scripts/seo-export-dataforseo.sh b/.agents/scripts/seo-export-dataforseo.sh
similarity index 100%
rename from .agent/scripts/seo-export-dataforseo.sh
rename to .agents/scripts/seo-export-dataforseo.sh
diff --git a/.agent/scripts/seo-export-gsc.sh b/.agents/scripts/seo-export-gsc.sh
similarity index 100%
rename from .agent/scripts/seo-export-gsc.sh
rename to .agents/scripts/seo-export-gsc.sh
diff --git a/.agent/scripts/seo-export-helper.sh b/.agents/scripts/seo-export-helper.sh
similarity index 100%
rename from .agent/scripts/seo-export-helper.sh
rename to .agents/scripts/seo-export-helper.sh
diff --git a/.agent/scripts/servers-helper.sh b/.agents/scripts/servers-helper.sh
similarity index 83%
rename from .agent/scripts/servers-helper.sh
rename to .agents/scripts/servers-helper.sh
index 750a0bb00..466a11bdb 100755
--- a/.agent/scripts/servers-helper.sh
+++ b/.agents/scripts/servers-helper.sh
@@ -129,39 +129,39 @@ case "$server" in
             "connect"|"ssh"|"")
                 if [[ "$auth_type" == "hostinger" ]]; then
                     print_info "Use Hostinger helper for site management..."
-                    ./.agent/scripts/hostinger-helper.sh list
+                    ./.agents/scripts/hostinger-helper.sh list
                 elif [[ "$auth_type" == "hetzner" ]]; then
                     print_info "Use Hetzner helper for server management..."
-                    ./.agent/scripts/hetzner-helper.sh list
+                    ./.agents/scripts/hetzner-helper.sh list
                 elif [[ "$auth_type" == "closte" ]]; then
                     print_info "Use Closte helper for server management..."
-                    ./.agent/scripts/closte-helper.sh list
+                    ./.agents/scripts/closte-helper.sh list
                 elif [[ "$auth_type" == "cloudron" ]]; then
                     print_info "Use Cloudron helper for server management..."
-                    ./.agent/scripts/cloudron-helper.sh list
+                    ./.agents/scripts/cloudron-helper.sh list
                 elif [[ "$auth_type" == "dns" ]]; then
                     print_info "Use DNS helper for domain management..."
-                    ./.agent/scripts/dns-helper.sh list
+                    ./.agents/scripts/dns-helper.sh list
                 elif [[ "$auth_type" == "localhost" ]]; then
                     print_info "Use Localhost helper for local development..."
-                    ./.agent/scripts/localhost-helper.sh list
+                    ./.agents/scripts/localhost-helper.sh list
                 elif [[ "$auth_type" == "aws" ]]; then
                     print_info "Use AWS helper for instance management..."
-                    ./.agent/scripts/aws-helper.sh list
+                    ./.agents/scripts/aws-helper.sh list
                 elif [[ "$auth_type" == "github" ]]; then
                     print_info "Use GitHub CLI helper for repository management..."
-                    ./.agent/scripts/github-cli-helper.sh list-accounts
+                    ./.agents/scripts/github-cli-helper.sh list-accounts
                 elif [[ "$auth_type" == "gitlab" ]]; then
                     print_info "Use GitLab CLI helper for project management..."
-                    ./.agent/scripts/gitlab-cli-helper.sh list-accounts
+                    ./.agents/scripts/gitlab-cli-helper.sh list-accounts
                 elif [[ "$auth_type" == "gitea" ]]; then
                     print_info "Use Gitea CLI helper for repository management..."
-                    ./.agent/scripts/gitea-cli-helper.sh list-accounts
+                    ./.agents/scripts/gitea-cli-helper.sh list-accounts
                 fi
                 ;;
             *)
                 print_info "Delegating to provider-specific helper..."
-                ./.agent/scripts/"${auth_type}"-helper.sh "$command" "$args"
+                ./.agents/scripts/"${auth_type}"-helper.sh "$command" "$args"
                 ;;
         esac
         ;;
@@ -220,16 +220,16 @@ case "$server" in
                 echo "  $0 hetzner connect"
                 echo ""
                 echo "Provider-Specific Helpers:"
-                echo "  ./.agent/scripts/hostinger-helper.sh      - Hostinger shared hosting"
-                echo "  ./.agent/scripts/hetzner-helper.sh        - Hetzner Cloud VPS"
-                echo "  ./.agent/scripts/closte-helper.sh         - Closte.com VPS servers"
-                echo "  ./.agent/scripts/cloudron-helper.sh       - Cloudron server management"
-                echo "  ./.agent/scripts/dns-helper.sh            - DNS management across providers"
-                echo "  ./.agent/scripts/localhost-helper.sh      - Local development with .local domains"
-                echo "  ./.agent/scripts/aws-helper.sh            - AWS EC2 instances"
-                echo "  ./.agent/scripts/github-cli-helper.sh     - GitHub CLI repository management"
-                echo "  ./.agent/scripts/gitlab-cli-helper.sh     - GitLab CLI project management"
-                echo "  ./.agent/scripts/gitea-cli-helper.sh      - Gitea CLI repository management"
+                echo "  ./.agents/scripts/hostinger-helper.sh      - Hostinger shared hosting"
+                echo "  ./.agents/scripts/hetzner-helper.sh        - Hetzner Cloud VPS"
+                echo "  ./.agents/scripts/closte-helper.sh         - Closte.com VPS servers"
+                echo "  ./.agents/scripts/cloudron-helper.sh       - Cloudron server management"
+                echo "  ./.agents/scripts/dns-helper.sh            - DNS management across providers"
+                echo "  ./.agents/scripts/localhost-helper.sh      - Local development with .local domains"
+                echo "  ./.agents/scripts/aws-helper.sh            - AWS EC2 instances"
+                echo "  ./.agents/scripts/github-cli-helper.sh     - GitHub CLI repository management"
+                echo "  ./.agents/scripts/gitlab-cli-helper.sh     - GitLab CLI project management"
+                echo "  ./.agents/scripts/gitea-cli-helper.sh      - Gitea CLI repository management"
                 ;;
             *)
                 print_error "$ERROR_UNKNOWN_COMMAND $command"
diff --git a/.agent/scripts/ses-helper.sh b/.agents/scripts/ses-helper.sh
similarity index 100%
rename from .agent/scripts/ses-helper.sh
rename to .agents/scripts/ses-helper.sh
diff --git a/.agent/scripts/session-distill-helper.sh b/.agents/scripts/session-distill-helper.sh
similarity index 100%
rename from .agent/scripts/session-distill-helper.sh
rename to .agents/scripts/session-distill-helper.sh
diff --git a/.agent/scripts/session-review-helper.sh b/.agents/scripts/session-review-helper.sh
similarity index 99%
rename from .agent/scripts/session-review-helper.sh
rename to .agents/scripts/session-review-helper.sh
index 25a179115..b275ccd78 100755
--- a/.agent/scripts/session-review-helper.sh
+++ b/.agents/scripts/session-review-helper.sh
@@ -90,7 +90,7 @@ get_todo_status() {
 get_ralph_status() {
     local project_root="$1"
     # Check new location first, then legacy
-    local ralph_file="$project_root/.agent/loop-state/ralph-loop.local.state"
+    local ralph_file="$project_root/.agents/loop-state/ralph-loop.local.state"
     local ralph_file_legacy="$project_root/.claude/ralph-loop.local.state"
     
     local active_file=""
diff --git a/.agent/scripts/session-time-helper.sh b/.agents/scripts/session-time-helper.sh
similarity index 100%
rename from .agent/scripts/session-time-helper.sh
rename to .agents/scripts/session-time-helper.sh
diff --git a/.agent/scripts/setup-linters-wizard.sh b/.agents/scripts/setup-linters-wizard.sh
similarity index 96%
rename from .agent/scripts/setup-linters-wizard.sh
rename to .agents/scripts/setup-linters-wizard.sh
index 0f263bc46..4ac5f4eea 100755
--- a/.agent/scripts/setup-linters-wizard.sh
+++ b/.agents/scripts/setup-linters-wizard.sh
@@ -298,10 +298,10 @@ install_selected_linters() {
     print_info "- Installed linters: ${languages[*]}"
     echo ""
     print_info "📚 Available Commands:"
-    print_info "- Run analysis: bash .agent/scripts/quality-cli-manager.sh analyze all"
-    print_info "- Auto-fix issues: bash .agent/scripts/codacy-cli.sh analyze --fix"
-    print_info "- Universal formatting: bash .agent/scripts/qlty-cli.sh fmt --all"
-    print_info "- Install additional linters: bash .agent/scripts/linter-manager.sh install LANGUAGE"
+    print_info "- Run analysis: bash .agents/scripts/quality-cli-manager.sh analyze all"
+    print_info "- Auto-fix issues: bash .agents/scripts/codacy-cli.sh analyze --fix"
+    print_info "- Universal formatting: bash .agents/scripts/qlty-cli.sh fmt --all"
+    print_info "- Install additional linters: bash .agents/scripts/linter-manager.sh install LANGUAGE"
     echo ""
     print_info "🔧 CodeFactor Integration:"
     print_info "- Your setup follows CodeFactor's professional linter collection"
diff --git a/.agent/scripts/setup-local-api-keys.sh b/.agents/scripts/setup-local-api-keys.sh
similarity index 100%
rename from .agent/scripts/setup-local-api-keys.sh
rename to .agents/scripts/setup-local-api-keys.sh
diff --git a/.agent/scripts/setup-mcp-integrations.sh b/.agents/scripts/setup-mcp-integrations.sh
similarity index 94%
rename from .agent/scripts/setup-mcp-integrations.sh
rename to .agents/scripts/setup-mcp-integrations.sh
index 939b16abe..d84245c38 100755
--- a/.agent/scripts/setup-mcp-integrations.sh
+++ b/.agents/scripts/setup-mcp-integrations.sh
@@ -42,7 +42,7 @@ get_mcp_command() {
         "stagehand-python") echo "${HOME}/.aidevops/stagehand-python/.venv/bin/python ${HOME}/.aidevops/stagehand-python/examples/basic_example.py" ;;
         "stagehand-both") echo "both" ;;
         "dataforseo") echo "npx dataforseo-mcp-server" ;;
-        # serper - REMOVED: Uses curl subagent (.agent/seo/serper.md), no MCP needed
+        # serper - REMOVED: Uses curl subagent (.agents/seo/serper.md), no MCP needed
         "unstract") echo "docker:unstract/mcp-server" ;;
         *) echo "" ;;
     esac
@@ -173,7 +173,7 @@ install_mcp() {
             fi
 
             print_success "PageSpeed Insights MCP setup complete!"
-            print_info "Use: ./.agent/scripts/pagespeed-helper.sh for CLI access"
+            print_info "Use: ./.agents/scripts/pagespeed-helper.sh for CLI access"
             ;;
         "grep-vercel")
             print_info "Grep by Vercel MCP (grep.app) is no longer installed by aidevops"
@@ -199,9 +199,9 @@ install_mcp() {
             print_info "Setting up Stagehand AI Browser Automation MCP integration..."
 
             # First ensure Stagehand JavaScript is installed
-            if ! bash "${SCRIPT_DIR}/../../.agent/scripts/stagehand-helper.sh" status &> /dev/null; then
+            if ! bash "${SCRIPT_DIR}/../../.agents/scripts/stagehand-helper.sh" status &> /dev/null; then
                 print_info "Installing Stagehand JavaScript first..."
-                bash "${SCRIPT_DIR}/../../.agent/scripts/stagehand-helper.sh" install
+                bash "${SCRIPT_DIR}/../../.agents/scripts/stagehand-helper.sh" install
             fi
 
             # Setup advanced configuration
@@ -214,15 +214,15 @@ install_mcp() {
 
             print_success "Stagehand JavaScript MCP integration completed"
             print_info "Try: 'Ask Claude to help with browser automation using Stagehand'"
-            print_info "Use: ./.agent/scripts/stagehand-helper.sh for CLI access"
+            print_info "Use: ./.agents/scripts/stagehand-helper.sh for CLI access"
             ;;
         "stagehand-python")
             print_info "Setting up Stagehand Python AI Browser Automation MCP integration..."
 
             # First ensure Stagehand Python is installed
-            if ! bash "${SCRIPT_DIR}/../../.agent/scripts/stagehand-python-helper.sh" status &> /dev/null; then
+            if ! bash "${SCRIPT_DIR}/../../.agents/scripts/stagehand-python-helper.sh" status &> /dev/null; then
                 print_info "Installing Stagehand Python first..."
-                bash "${SCRIPT_DIR}/../../.agent/scripts/stagehand-python-helper.sh" install
+                bash "${SCRIPT_DIR}/../../.agents/scripts/stagehand-python-helper.sh" install
             fi
 
             # Setup advanced configuration
@@ -236,7 +236,7 @@ install_mcp() {
 
             print_success "Stagehand Python MCP integration completed"
             print_info "Try: 'Ask Claude to help with Python browser automation using Stagehand'"
-            print_info "Use: ./.agent/scripts/stagehand-python-helper.sh for CLI access"
+            print_info "Use: ./.agents/scripts/stagehand-python-helper.sh for CLI access"
             ;;
         "stagehand-both")
             print_info "Setting up both Stagehand JavaScript and Python MCP integrations..."
@@ -248,8 +248,8 @@ install_mcp() {
             bash "$0" stagehand-python
 
             print_success "Both Stagehand integrations completed"
-            print_info "JavaScript: ./.agent/scripts/stagehand-helper.sh"
-            print_info "Python: ./.agent/scripts/stagehand-python-helper.sh"
+            print_info "JavaScript: ./.agents/scripts/stagehand-helper.sh"
+            print_info "Python: ./.agents/scripts/stagehand-python-helper.sh"
             ;;
         "dataforseo")
             print_info "Setting up DataForSEO MCP for comprehensive SEO data..."
@@ -274,7 +274,7 @@ install_mcp() {
             print_info "Available modules: SERP, KEYWORDS_DATA, BACKLINKS, ONPAGE, DATAFORSEO_LABS, BUSINESS_DATA, DOMAIN_ANALYTICS, CONTENT_ANALYSIS, AI_OPTIMIZATION"
             print_info "Docs: https://docs.dataforseo.com/v3/"
             ;;
-        # "serper" - REMOVED: Uses curl subagent (.agent/seo/serper.md), no MCP needed
+        # "serper" - REMOVED: Uses curl subagent (.agents/seo/serper.md), no MCP needed
         # Get API key from https://serper.dev/ and set SERPER_API_KEY in mcp-env.sh
         "unstract")
             print_info "Setting up Unstract self-hosted document processing platform..."
@@ -473,7 +473,7 @@ main() {
     print_info "1. Configure API keys in your environment"
     print_info "2. Review configuration templates in configs/mcp-templates/"
     print_info "3. Test integrations with your AI assistant"
-    print_info "4. Check .agent/MCP-INTEGRATIONS.md for usage examples"
+    print_info "4. Check .agents/MCP-INTEGRATIONS.md for usage examples"
     return 0
 }
 
diff --git a/.agent/scripts/shared-constants.sh b/.agents/scripts/shared-constants.sh
similarity index 99%
rename from .agent/scripts/shared-constants.sh
rename to .agents/scripts/shared-constants.sh
index c0bcfb617..109a3ec14 100755
--- a/.agent/scripts/shared-constants.sh
+++ b/.agents/scripts/shared-constants.sh
@@ -5,7 +5,7 @@
 # This file contains common strings, error messages, and configuration constants
 # to reduce duplication and improve maintainability across provider scripts.
 #
-# Usage: source .agent/scripts/shared-constants.sh
+# Usage: source .agents/scripts/shared-constants.sh
 #
 # Author: AI DevOps Framework
 # Version: 1.6.0
diff --git a/.agent/scripts/show-plan-helper.sh b/.agents/scripts/show-plan-helper.sh
similarity index 100%
rename from .agent/scripts/show-plan-helper.sh
rename to .agents/scripts/show-plan-helper.sh
diff --git a/.agent/scripts/site-crawler-helper.sh b/.agents/scripts/site-crawler-helper.sh
similarity index 100%
rename from .agent/scripts/site-crawler-helper.sh
rename to .agents/scripts/site-crawler-helper.sh
diff --git a/.agent/scripts/skill-update-helper.sh b/.agents/scripts/skill-update-helper.sh
similarity index 100%
rename from .agent/scripts/skill-update-helper.sh
rename to .agents/scripts/skill-update-helper.sh
diff --git a/.agent/scripts/snyk-helper.sh b/.agents/scripts/snyk-helper.sh
similarity index 100%
rename from .agent/scripts/snyk-helper.sh
rename to .agents/scripts/snyk-helper.sh
diff --git a/.agent/scripts/sonarcloud-autofix.sh b/.agents/scripts/sonarcloud-autofix.sh
similarity index 96%
rename from .agent/scripts/sonarcloud-autofix.sh
rename to .agents/scripts/sonarcloud-autofix.sh
index 37daa1def..8ce32810a 100755
--- a/.agent/scripts/sonarcloud-autofix.sh
+++ b/.agents/scripts/sonarcloud-autofix.sh
@@ -140,10 +140,10 @@ main() {
             
             # Files with known SonarCloud issues
             local files=(
-                ".agent/scripts/setup-mcp-integrations.sh"
-                ".agent/scripts/validate-mcp-integrations.sh"
-                ".agent/scripts/setup-linters-wizard.sh"
-                ".agent/scripts/setup-wizard-helper.sh"
+                ".agents/scripts/setup-mcp-integrations.sh"
+                ".agents/scripts/validate-mcp-integrations.sh"
+                ".agents/scripts/setup-linters-wizard.sh"
+                ".agents/scripts/setup-wizard-helper.sh"
             )
             
             for file in "${files[@]}"; do
diff --git a/.agent/scripts/sonarcloud-cli.sh b/.agents/scripts/sonarcloud-cli.sh
similarity index 100%
rename from .agent/scripts/sonarcloud-cli.sh
rename to .agents/scripts/sonarcloud-cli.sh
diff --git a/.agent/scripts/sonarscanner-cli.sh b/.agents/scripts/sonarscanner-cli.sh
similarity index 100%
rename from .agent/scripts/sonarscanner-cli.sh
rename to .agents/scripts/sonarscanner-cli.sh
diff --git a/.agent/scripts/spaceship-helper.sh b/.agents/scripts/spaceship-helper.sh
similarity index 100%
rename from .agent/scripts/spaceship-helper.sh
rename to .agents/scripts/spaceship-helper.sh
diff --git a/.agent/scripts/stagehand-helper.sh b/.agents/scripts/stagehand-helper.sh
similarity index 99%
rename from .agent/scripts/stagehand-helper.sh
rename to .agents/scripts/stagehand-helper.sh
index 384e5b23e..784d0bc51 100755
--- a/.agent/scripts/stagehand-helper.sh
+++ b/.agents/scripts/stagehand-helper.sh
@@ -246,7 +246,7 @@ EXAMPLES:
     $0 status               # Check installation
 
 DOCUMENTATION:
-    For detailed documentation, see: .agent/STAGEHAND.md
+    For detailed documentation, see: .agents/STAGEHAND.md
     Official docs: https://docs.stagehand.dev
     GitHub: https://github.com/browserbase/stagehand
 
diff --git a/.agent/scripts/stagehand-python-helper.sh b/.agents/scripts/stagehand-python-helper.sh
similarity index 99%
rename from .agent/scripts/stagehand-python-helper.sh
rename to .agents/scripts/stagehand-python-helper.sh
index 619d0e396..611c69eef 100755
--- a/.agent/scripts/stagehand-python-helper.sh
+++ b/.agents/scripts/stagehand-python-helper.sh
@@ -244,7 +244,7 @@ VIRTUAL ENVIRONMENT:
     source ~/.aidevops/stagehand-python/.venv/bin/activate
 
 DOCUMENTATION:
-    For detailed documentation, see: .agent/STAGEHAND-PYTHON.md
+    For detailed documentation, see: .agents/STAGEHAND-PYTHON.md
     Official docs: https://docs.stagehand.dev
     GitHub: https://github.com/browserbase/stagehand-python
 
diff --git a/.agent/scripts/stagehand-python-setup.sh b/.agents/scripts/stagehand-python-setup.sh
similarity index 98%
rename from .agent/scripts/stagehand-python-setup.sh
rename to .agents/scripts/stagehand-python-setup.sh
index 262f1c4b2..ba2999446 100755
--- a/.agent/scripts/stagehand-python-setup.sh
+++ b/.agents/scripts/stagehand-python-setup.sh
@@ -6,7 +6,7 @@
 
 # Source shared constants
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
+source "${SCRIPT_DIR}/../../.agents/scripts/shared-constants.sh"
 
 # Colors for output
 readonly BLUE='\033[0;34m'
@@ -402,7 +402,7 @@ main() {
             create_requirements_file
             print_success "Stagehand Python advanced setup completed!"
             print_info "Next steps:"
-            print_info "1. Run: bash .agent/scripts/stagehand-python-helper.sh install"
+            print_info "1. Run: bash .agents/scripts/stagehand-python-helper.sh install"
             print_info "2. Configure API keys in ~/.aidevops/stagehand-python/.env"
             print_info "3. Activate venv: source ~/.aidevops/stagehand-python/.venv/bin/activate"
             print_info "4. Try examples: cd ~/.aidevops/stagehand-python && python examples/basic_example.py" || exit
diff --git a/.agent/scripts/stagehand-setup.sh b/.agents/scripts/stagehand-setup.sh
similarity index 98%
rename from .agent/scripts/stagehand-setup.sh
rename to .agents/scripts/stagehand-setup.sh
index 10d733feb..714da76dd 100755
--- a/.agent/scripts/stagehand-setup.sh
+++ b/.agents/scripts/stagehand-setup.sh
@@ -6,7 +6,7 @@
 
 # Source shared constants
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
+source "${SCRIPT_DIR}/../../.agents/scripts/shared-constants.sh"
 
 # Colors for output
 readonly BLUE='\033[0;34m'
@@ -401,7 +401,7 @@ main() {
             setup_mcp_integration
             print_success "Stagehand advanced setup completed!"
             print_info "Next steps:"
-            print_info "1. Run: bash .agent/scripts/stagehand-helper.sh install"
+            print_info "1. Run: bash .agents/scripts/stagehand-helper.sh install"
             print_info "2. Configure API keys in ~/.aidevops/stagehand/.env"
             print_info "3. Try examples: cd ~/.aidevops/stagehand && npm run search-products" || exit
             ;;
diff --git a/.agent/scripts/supervisor-helper.sh b/.agents/scripts/supervisor-helper.sh
similarity index 100%
rename from .agent/scripts/supervisor-helper.sh
rename to .agents/scripts/supervisor-helper.sh
diff --git a/.agent/scripts/system-cleanup.sh b/.agents/scripts/system-cleanup.sh
similarity index 99%
rename from .agent/scripts/system-cleanup.sh
rename to .agents/scripts/system-cleanup.sh
index d346006bb..ebe1b70c7 100755
--- a/.agent/scripts/system-cleanup.sh
+++ b/.agents/scripts/system-cleanup.sh
@@ -18,10 +18,10 @@ set -euo pipefail
 readonly SCRIPT_NAME="system-cleanup"
 # VERSION is kept for reference and future use
 readonly VERSION="1.0.0"
-readonly LOG_DIR="$HOME/.agent/logs"
+readonly LOG_DIR="$HOME/.agents/logs"
 readonly LOG_FILE="${LOG_DIR}/operations.log"
 readonly LOCK_FILE="/tmp/aidevops-${SCRIPT_NAME}.lock"
-readonly TMP_DIR="$HOME/.agent/tmp"
+readonly TMP_DIR="$HOME/.agents/tmp"
 readonly AGENT_DIR="$HOME/.agent"
 readonly PROJECT_DIR="$HOME/git/aidevops"
 readonly RETENTION_DAYS_LOGS=90
diff --git a/.agent/scripts/terminal-title-helper.sh b/.agents/scripts/terminal-title-helper.sh
similarity index 100%
rename from .agent/scripts/terminal-title-helper.sh
rename to .agents/scripts/terminal-title-helper.sh
diff --git a/.agent/scripts/terminal-title-setup.sh b/.agents/scripts/terminal-title-setup.sh
similarity index 100%
rename from .agent/scripts/terminal-title-setup.sh
rename to .agents/scripts/terminal-title-setup.sh
diff --git a/.agent/scripts/test-stagehand-both-integration.sh b/.agents/scripts/test-stagehand-both-integration.sh
similarity index 92%
rename from .agent/scripts/test-stagehand-both-integration.sh
rename to .agents/scripts/test-stagehand-both-integration.sh
index 3c5d1a5b8..d877e1f13 100755
--- a/.agent/scripts/test-stagehand-both-integration.sh
+++ b/.agents/scripts/test-stagehand-both-integration.sh
@@ -6,7 +6,7 @@
 
 # Source shared constants
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
+source "${SCRIPT_DIR}/../../.agents/scripts/shared-constants.sh"
 
 # Colors for output
 readonly BLUE='\033[0;34m'
@@ -41,7 +41,7 @@ print_error() {
 }
 
 # Test configuration
-readonly TEST_RESULTS_DIR="${HOME}/.agent/tmp/stagehand-both-tests"
+readonly TEST_RESULTS_DIR="${HOME}/.agents/tmp/stagehand-both-tests"
 readonly TEST_LOG="${TEST_RESULTS_DIR}/test-results.log"
 
 # Create test directory
@@ -124,9 +124,9 @@ test_documentation_completeness() {
     print_info "Testing documentation completeness..."
     
     local docs=(
-        "${SCRIPT_DIR}/../../.agent/STAGEHAND.md"
-        "${SCRIPT_DIR}/../../.agent/STAGEHAND-PYTHON.md"
-        "${SCRIPT_DIR}/../../.agent/BROWSER-AUTOMATION.md"
+        "${SCRIPT_DIR}/../../.agents/STAGEHAND.md"
+        "${SCRIPT_DIR}/../../.agents/STAGEHAND-PYTHON.md"
+        "${SCRIPT_DIR}/../../.agents/BROWSER-AUTOMATION.md"
         "${SCRIPT_DIR}/../../README.md"
     )
     
@@ -161,8 +161,8 @@ test_documentation_completeness() {
 test_helper_consistency() {
     print_info "Testing helper script consistency..."
     
-    local js_helper="${SCRIPT_DIR}/../../.agent/scripts/stagehand-helper.sh"
-    local python_helper="${SCRIPT_DIR}/../../.agent/scripts/stagehand-python-helper.sh"
+    local js_helper="${SCRIPT_DIR}/../../.agents/scripts/stagehand-helper.sh"
+    local python_helper="${SCRIPT_DIR}/../../.agents/scripts/stagehand-python-helper.sh"
     
     if [[ -f "$js_helper" ]] && [[ -f "$python_helper" ]]; then
         # Check if both have similar command structure
@@ -234,15 +234,15 @@ $(if [[ -f "${TEST_RESULTS_DIR}/python-test.log" ]]; then echo "See: python-test
 ## Next Steps
 
 ### JavaScript Setup
-1. Run: \`bash .agent/scripts/stagehand-helper.sh setup\`
-2. Test: \`bash .agent/scripts/setup-mcp-integrations.sh stagehand\`
+1. Run: \`bash .agents/scripts/stagehand-helper.sh setup\`
+2. Test: \`bash .agents/scripts/setup-mcp-integrations.sh stagehand\`
 
 ### Python Setup
-1. Run: \`bash .agent/scripts/stagehand-python-helper.sh setup\`
-2. Test: \`bash .agent/scripts/setup-mcp-integrations.sh stagehand-python\`
+1. Run: \`bash .agents/scripts/stagehand-python-helper.sh setup\`
+2. Test: \`bash .agents/scripts/setup-mcp-integrations.sh stagehand-python\`
 
 ### Both Versions
-1. Run: \`bash .agent/scripts/setup-mcp-integrations.sh stagehand-both\`
+1. Run: \`bash .agents/scripts/setup-mcp-integrations.sh stagehand-both\`
 
 ## Files Created
 
diff --git a/.agent/scripts/test-stagehand-integration.sh b/.agents/scripts/test-stagehand-integration.sh
similarity index 93%
rename from .agent/scripts/test-stagehand-integration.sh
rename to .agents/scripts/test-stagehand-integration.sh
index 7bbd1f47d..cd31e71e0 100755
--- a/.agent/scripts/test-stagehand-integration.sh
+++ b/.agents/scripts/test-stagehand-integration.sh
@@ -6,7 +6,7 @@
 
 # Source shared constants
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
+source "${SCRIPT_DIR}/../../.agents/scripts/shared-constants.sh"
 
 # Colors for output
 readonly BLUE='\033[0;34m'
@@ -41,7 +41,7 @@ print_error() {
 }
 
 # Test configuration
-readonly TEST_RESULTS_DIR="${HOME}/.agent/tmp/stagehand-tests"
+readonly TEST_RESULTS_DIR="${HOME}/.agents/tmp/stagehand-tests"
 readonly TEST_LOG="${TEST_RESULTS_DIR}/test-results.log"
 
 # Create test directory
@@ -56,7 +56,7 @@ setup_test_environment() {
 test_helper_script() {
     print_info "Testing Stagehand helper script..."
     
-    local helper_script="${SCRIPT_DIR}/../../.agent/scripts/stagehand-helper.sh"
+    local helper_script="${SCRIPT_DIR}/../../.agents/scripts/stagehand-helper.sh"
     
     if [[ -f "$helper_script" ]]; then
         print_success "✅ Stagehand helper script exists"
@@ -84,8 +84,8 @@ test_documentation() {
     print_info "Testing Stagehand documentation..."
     
     local docs=(
-        "${SCRIPT_DIR}/../../.agent/STAGEHAND.md"
-        "${SCRIPT_DIR}/../../.agent/mcp-examples/stagehand-automation-examples.md"
+        "${SCRIPT_DIR}/../../.agents/STAGEHAND.md"
+        "${SCRIPT_DIR}/../../.agents/mcp-examples/stagehand-automation-examples.md"
     )
     
     for doc in "${docs[@]}"; do
@@ -131,7 +131,7 @@ test_mcp_integration() {
 test_helper_commands() {
     print_info "Testing Stagehand helper commands..."
     
-    local helper_script="${SCRIPT_DIR}/../../.agent/scripts/stagehand-helper.sh"
+    local helper_script="${SCRIPT_DIR}/../../.agents/scripts/stagehand-helper.sh"
     
     # Test help command
     if bash "$helper_script" help > /dev/null 2>&1; then
@@ -237,8 +237,8 @@ $(cat "$TEST_LOG")
 
 ## Next Steps
 
-1. Run full installation: \`bash .agent/scripts/stagehand-helper.sh setup\`
-2. Test MCP integration: \`bash .agent/scripts/setup-mcp-integrations.sh stagehand\`
+1. Run full installation: \`bash .agents/scripts/stagehand-helper.sh setup\`
+2. Test MCP integration: \`bash .agents/scripts/setup-mcp-integrations.sh stagehand\`
 3. Try examples: \`cd ~/.aidevops/stagehand && npm run search-products\` || exit
 
 ## Files Created
diff --git a/.agent/scripts/test-stagehand-python-integration.sh b/.agents/scripts/test-stagehand-python-integration.sh
similarity index 95%
rename from .agent/scripts/test-stagehand-python-integration.sh
rename to .agents/scripts/test-stagehand-python-integration.sh
index 1ca7e6067..68c5231c6 100755
--- a/.agent/scripts/test-stagehand-python-integration.sh
+++ b/.agents/scripts/test-stagehand-python-integration.sh
@@ -6,7 +6,7 @@
 
 # Source shared constants
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
+source "${SCRIPT_DIR}/../../.agents/scripts/shared-constants.sh"
 
 # Colors for output
 readonly BLUE='\033[0;34m'
@@ -41,7 +41,7 @@ print_error() {
 }
 
 # Test configuration
-readonly TEST_RESULTS_DIR="${HOME}/.agent/tmp/stagehand-python-tests"
+readonly TEST_RESULTS_DIR="${HOME}/.agents/tmp/stagehand-python-tests"
 readonly TEST_LOG="${TEST_RESULTS_DIR}/test-results.log"
 
 # Create test directory
@@ -56,7 +56,7 @@ setup_test_environment() {
 test_python_helper_script() {
     print_info "Testing Stagehand Python helper script..."
     
-    local helper_script="${SCRIPT_DIR}/../../.agent/scripts/stagehand-python-helper.sh"
+    local helper_script="${SCRIPT_DIR}/../../.agents/scripts/stagehand-python-helper.sh"
     
     if [[ -f "$helper_script" ]]; then
         print_success "✅ Stagehand Python helper script exists"
@@ -84,7 +84,7 @@ test_python_documentation() {
     print_info "Testing Stagehand Python documentation..."
     
     local docs=(
-        "${SCRIPT_DIR}/../../.agent/STAGEHAND-PYTHON.md"
+        "${SCRIPT_DIR}/../../.agents/STAGEHAND-PYTHON.md"
     )
     
     for doc in "${docs[@]}"; do
@@ -192,7 +192,7 @@ test_python_mcp_integration() {
 test_python_helper_commands() {
     print_info "Testing Stagehand Python helper commands..."
     
-    local helper_script="${SCRIPT_DIR}/../../.agent/scripts/stagehand-python-helper.sh"
+    local helper_script="${SCRIPT_DIR}/../../.agents/scripts/stagehand-python-helper.sh"
     
     # Test help command
     if bash "$helper_script" help > /dev/null 2>&1; then
@@ -269,8 +269,8 @@ $(cat "$TEST_LOG")
 
 ## Next Steps
 
-1. Run full installation: \`bash .agent/scripts/stagehand-python-helper.sh setup\`
-2. Test MCP integration: \`bash .agent/scripts/setup-mcp-integrations.sh stagehand-python\`
+1. Run full installation: \`bash .agents/scripts/stagehand-python-helper.sh setup\`
+2. Test MCP integration: \`bash .agents/scripts/setup-mcp-integrations.sh stagehand-python\`
 3. Try examples: \`source ~/.aidevops/stagehand-python/.venv/bin/activate && python examples/basic_example.py\`
 
 ## Files Created
diff --git a/.agent/scripts/todo-ready.sh b/.agents/scripts/todo-ready.sh
similarity index 100%
rename from .agent/scripts/todo-ready.sh
rename to .agents/scripts/todo-ready.sh
diff --git a/.agent/scripts/tool-version-check.sh b/.agents/scripts/tool-version-check.sh
similarity index 100%
rename from .agent/scripts/tool-version-check.sh
rename to .agents/scripts/tool-version-check.sh
diff --git a/.agent/scripts/toon-helper.sh b/.agents/scripts/toon-helper.sh
similarity index 100%
rename from .agent/scripts/toon-helper.sh
rename to .agents/scripts/toon-helper.sh
diff --git a/.agent/scripts/twilio-helper.sh b/.agents/scripts/twilio-helper.sh
similarity index 99%
rename from .agent/scripts/twilio-helper.sh
rename to .agents/scripts/twilio-helper.sh
index 5dffc198b..51f3432b1 100755
--- a/.agent/scripts/twilio-helper.sh
+++ b/.agents/scripts/twilio-helper.sh
@@ -821,7 +821,7 @@ CONFIGURATION:
   Config file: configs/twilio-config.json
   Template: configs/twilio-config.json.txt
 
-For more information, see: .agent/services/communications/twilio.md
+For more information, see: .agents/services/communications/twilio.md
 EOF
     return 0
 }
diff --git a/.agent/scripts/unstract-helper.sh b/.agents/scripts/unstract-helper.sh
similarity index 100%
rename from .agent/scripts/unstract-helper.sh
rename to .agents/scripts/unstract-helper.sh
diff --git a/.agent/scripts/updown-helper.sh b/.agents/scripts/updown-helper.sh
similarity index 100%
rename from .agent/scripts/updown-helper.sh
rename to .agents/scripts/updown-helper.sh
diff --git a/.agent/scripts/validate-mcp-integrations.sh b/.agents/scripts/validate-mcp-integrations.sh
similarity index 96%
rename from .agent/scripts/validate-mcp-integrations.sh
rename to .agents/scripts/validate-mcp-integrations.sh
index 3f8af62da..31ba38e58 100755
--- a/.agent/scripts/validate-mcp-integrations.sh
+++ b/.agents/scripts/validate-mcp-integrations.sh
@@ -210,12 +210,12 @@ generate_report() {
     if [[ $failed_tests -gt 0 ]]; then
         print_info "Next steps:"
         print_info "1. Review failed tests above"
-        print_info "2. Check .agent/MCP-TROUBLESHOOTING.md for solutions"
-        print_info "3. Run setup script: bash .agent/scripts/setup-mcp-integrations.sh"
+        print_info "2. Check .agents/MCP-TROUBLESHOOTING.md for solutions"
+        print_info "3. Run setup script: bash .agents/scripts/setup-mcp-integrations.sh"
         print_info "4. Configure missing API keys"
     else
         print_success "All MCP integrations are ready to use!"
-        print_info "Check .agent/MCP-INTEGRATIONS.md for usage examples"
+        print_info "Check .agents/MCP-INTEGRATIONS.md for usage examples"
     fi
     return 0
 }
diff --git a/.agent/scripts/validate-version-consistency.sh b/.agents/scripts/validate-version-consistency.sh
similarity index 100%
rename from .agent/scripts/validate-version-consistency.sh
rename to .agents/scripts/validate-version-consistency.sh
diff --git a/.agent/scripts/vaultwarden-helper.sh b/.agents/scripts/vaultwarden-helper.sh
similarity index 100%
rename from .agent/scripts/vaultwarden-helper.sh
rename to .agents/scripts/vaultwarden-helper.sh
diff --git a/.agent/scripts/vercel-cli-helper.sh b/.agents/scripts/vercel-cli-helper.sh
similarity index 99%
rename from .agent/scripts/vercel-cli-helper.sh
rename to .agents/scripts/vercel-cli-helper.sh
index 783c5139f..145a26f8c 100755
--- a/.agent/scripts/vercel-cli-helper.sh
+++ b/.agents/scripts/vercel-cli-helper.sh
@@ -606,7 +606,7 @@ show_help() {
 Vercel CLI Helper - Comprehensive Vercel deployment and project management
 
 USAGE:
-  ./.agent/scripts/vercel-cli-helper.sh [COMMAND] [ACCOUNT] [OPTIONS...]
+  ./.agents/scripts/vercel-cli-helper.sh [COMMAND] [ACCOUNT] [OPTIONS...]
 
 COMMANDS:
   Project Management:
@@ -666,7 +666,7 @@ REQUIREMENTS:
   - Node.js (for local development server)
   - Valid Vercel authentication token (for deployment commands only)
 
-For more information, see the Vercel CLI documentation: https://vercel.com/.agent/cli
+For more information, see the Vercel CLI documentation: https://vercel.com/.agents/cli
 EOF
     return 0
 }
diff --git a/.agent/scripts/verify-mirrors.sh b/.agents/scripts/verify-mirrors.sh
similarity index 97%
rename from .agent/scripts/verify-mirrors.sh
rename to .agents/scripts/verify-mirrors.sh
index 5dbe6337c..6d3305ec1 100755
--- a/.agent/scripts/verify-mirrors.sh
+++ b/.agents/scripts/verify-mirrors.sh
@@ -1,9 +1,9 @@
 #!/bin/bash
 
 # Verify AI Assistant Mirror Symlinks
-# Ensures all mirror directories are properly symlinked to .agent/
+# Ensures all mirror directories are properly symlinked to .agents/
 #
-# Usage: ./.agent/scripts/verify-mirrors.sh [--fix]
+# Usage: ./.agents/scripts/verify-mirrors.sh [--fix]
 #
 # Options:
 #   --fix      Create missing symlinks (default: report only)
@@ -46,7 +46,7 @@ FIX_MODE=false
 usage() {
     echo "Usage: $0 [OPTIONS]"
     echo ""
-    echo "Verifies AI assistant mirror symlinks point to .agent/"
+    echo "Verifies AI assistant mirror symlinks point to .agents/"
     echo ""
     echo "Options:"
     echo "  --fix      Create missing symlinks"
diff --git a/.agent/scripts/version-manager.sh b/.agents/scripts/version-manager.sh
similarity index 99%
rename from .agent/scripts/version-manager.sh
rename to .agents/scripts/version-manager.sh
index ddf99813c..b7df6f926 100755
--- a/.agent/scripts/version-manager.sh
+++ b/.agents/scripts/version-manager.sh
@@ -345,7 +345,7 @@ EOF
 run_preflight_checks() {
     print_info "Running preflight quality checks..."
     
-    local preflight_script="$REPO_ROOT/.agent/scripts/linters-local.sh"
+    local preflight_script="$REPO_ROOT/.agents/scripts/linters-local.sh"
     
     if [[ -f "$preflight_script" ]]; then
         if bash "$preflight_script"; then
@@ -365,7 +365,7 @@ run_preflight_checks() {
 # Delegates to the standalone validator script for single source of truth
 validate_version_consistency() {
     local expected_version="$1"
-    local validator_script="${REPO_ROOT}/.agent/scripts/validate-version-consistency.sh"
+    local validator_script="${REPO_ROOT}/.agents/scripts/validate-version-consistency.sh"
     
     print_info "Validating version consistency across files..."
     
@@ -879,8 +879,8 @@ aidevops repos
 ### Documentation
 
 - **[Setup Guide](README.md)**: Complete framework setup
-- **[User Guide](.agent/AGENTS.md)**: AI assistant integration
-- **[API Integrations](.agent/aidevops/api-integrations.md)**: Service APIs
+- **[User Guide](.agents/AGENTS.md)**: AI assistant integration
+- **[API Integrations](.agents/aidevops/api-integrations.md)**: Service APIs
 
 ### Links
 
diff --git a/.agent/scripts/watercrawl-helper.sh b/.agents/scripts/watercrawl-helper.sh
similarity index 99%
rename from .agent/scripts/watercrawl-helper.sh
rename to .agents/scripts/watercrawl-helper.sh
index a9b376dc2..dd0acfd48 100755
--- a/.agent/scripts/watercrawl-helper.sh
+++ b/.agents/scripts/watercrawl-helper.sh
@@ -353,7 +353,7 @@ coolify_deploy() {
     print_info "  https://docs.watercrawl.dev/self-hosted/installation"
     print_info ""
     print_info "Or use coolify-helper.sh for automated deployment:"
-    print_info "  bash .agent/scripts/coolify-helper.sh deploy watercrawl"
+    print_info "  bash .agents/scripts/coolify-helper.sh deploy watercrawl"
     
     return 0
 }
@@ -984,7 +984,7 @@ show_help() {
     echo "  Self-hosted docs: https://docs.watercrawl.dev/self-hosted/"
     echo "  Cloud dashboard: https://app.watercrawl.dev"
     echo "  GitHub: https://github.com/watercrawl/WaterCrawl"
-    echo "  Framework docs: .agent/tools/browser/watercrawl.md"
+    echo "  Framework docs: .agents/tools/browser/watercrawl.md"
     return 0
 }
 
diff --git a/.agent/scripts/webhosting-helper.sh b/.agents/scripts/webhosting-helper.sh
similarity index 100%
rename from .agent/scripts/webhosting-helper.sh
rename to .agents/scripts/webhosting-helper.sh
diff --git a/.agent/scripts/webhosting-verify.sh b/.agents/scripts/webhosting-verify.sh
similarity index 100%
rename from .agent/scripts/webhosting-verify.sh
rename to .agents/scripts/webhosting-verify.sh
diff --git a/.agent/scripts/wordpress-mcp-helper.sh b/.agents/scripts/wordpress-mcp-helper.sh
similarity index 99%
rename from .agent/scripts/wordpress-mcp-helper.sh
rename to .agents/scripts/wordpress-mcp-helper.sh
index ec3a25fd3..4ffef1791 100755
--- a/.agent/scripts/wordpress-mcp-helper.sh
+++ b/.agents/scripts/wordpress-mcp-helper.sh
@@ -214,7 +214,7 @@ generate_http_config() {
       ],
       "env": {
         "WP_API_URL": "$api_url/wp-json/mcp/$server",
-        "LOG_FILE": "$HOME/.agent/tmp/mcp-$site_name.log",
+        "LOG_FILE": "$HOME/.agents/tmp/mcp-$site_name.log",
         "WP_API_USERNAME": "$username",
         "WP_API_PASSWORD": "$app_password"
       }
diff --git a/.agent/scripts/worktree-helper.sh b/.agents/scripts/worktree-helper.sh
similarity index 96%
rename from .agent/scripts/worktree-helper.sh
rename to .agents/scripts/worktree-helper.sh
index 778106180..71e0bfc3c 100755
--- a/.agent/scripts/worktree-helper.sh
+++ b/.agents/scripts/worktree-helper.sh
@@ -106,11 +106,11 @@ worktree_has_changes() {
     local worktree_path="$1"
     if [[ -d "$worktree_path" ]]; then
         local changes
-        # Exclude aidevops runtime files: .agent/loop-state/, .agent/tmp/, .DS_Store
+        # Exclude aidevops runtime files: .agents/loop-state/, .agents/tmp/, .DS_Store
         changes=$(git -C "$worktree_path" status --porcelain 2>/dev/null | \
-            grep -v '^\?\? \.agent/loop-state/' | \
-            grep -v '^\?\? \.agent/tmp/' | \
-            grep -v '^\?\? \.agent/$' | \
+            grep -v '^\?\? \.agents/loop-state/' | \
+            grep -v '^\?\? \.agents/tmp/' | \
+            grep -v '^\?\? \.agents/$' | \
             grep -v '^\?\? \.DS_Store' | \
             head -1)
         [[ -n "$changes" ]]
@@ -318,9 +318,9 @@ cmd_remove() {
     fi
     
     # Clean up aidevops runtime files before removal (prevents "contains untracked files" error)
-    rm -rf "$path_to_remove/.agent/loop-state" 2>/dev/null || true
-    rm -rf "$path_to_remove/.agent/tmp" 2>/dev/null || true
-    rm -f "$path_to_remove/.agent/.DS_Store" 2>/dev/null || true
+    rm -rf "$path_to_remove/.agents/loop-state" 2>/dev/null || true
+    rm -rf "$path_to_remove/.agents/tmp" 2>/dev/null || true
+    rm -f "$path_to_remove/.agents/.DS_Store" 2>/dev/null || true
     rmdir "$path_to_remove/.agent" 2>/dev/null || true  # Only removes if empty
     
     echo -e "${BLUE}Removing worktree: $path_to_remove${NC}"
@@ -489,9 +489,9 @@ cmd_clean() {
                     if [[ "$should_remove" == "true" ]]; then
                         echo -e "${BLUE}Removing $worktree_branch...${NC}"
                         # Clean up aidevops runtime files before removal
-                        rm -rf "$worktree_path/.agent/loop-state" 2>/dev/null || true
-                        rm -rf "$worktree_path/.agent/tmp" 2>/dev/null || true
-                        rm -f "$worktree_path/.agent/.DS_Store" 2>/dev/null || true
+                        rm -rf "$worktree_path/.agents/loop-state" 2>/dev/null || true
+                        rm -rf "$worktree_path/.agents/tmp" 2>/dev/null || true
+                        rm -f "$worktree_path/.agents/.DS_Store" 2>/dev/null || true
                         rmdir "$worktree_path/.agent" 2>/dev/null || true
                         # Don't use --force to prevent data loss
                         if ! git worktree remove "$worktree_path" 2>/dev/null; then
diff --git a/.agent/scripts/worktree-sessions.sh b/.agents/scripts/worktree-sessions.sh
similarity index 99%
rename from .agent/scripts/worktree-sessions.sh
rename to .agents/scripts/worktree-sessions.sh
index 77aa8494c..26d39abd7 100755
--- a/.agent/scripts/worktree-sessions.sh
+++ b/.agents/scripts/worktree-sessions.sh
@@ -103,7 +103,7 @@ epoch_to_date() {
 get_ralph_loop_status() {
     local worktree_path="$1"
     # Check new location first, then legacy
-    local state_file="$worktree_path/.agent/loop-state/ralph-loop.local.state"
+    local state_file="$worktree_path/.agents/loop-state/ralph-loop.local.state"
     local state_file_legacy="$worktree_path/.claude/ralph-loop.local.state"
     
     local active_file=""
diff --git a/.agent/scripts/wp-helper.sh b/.agents/scripts/wp-helper.sh
similarity index 100%
rename from .agent/scripts/wp-helper.sh
rename to .agents/scripts/wp-helper.sh
diff --git a/.agent/scripts/yt-dlp-helper.sh b/.agents/scripts/yt-dlp-helper.sh
similarity index 100%
rename from .agent/scripts/yt-dlp-helper.sh
rename to .agents/scripts/yt-dlp-helper.sh
diff --git a/.agent/seo.md b/.agents/seo.md
similarity index 100%
rename from .agent/seo.md
rename to .agents/seo.md
diff --git a/.agent/seo/ahrefs.md b/.agents/seo/ahrefs.md
similarity index 100%
rename from .agent/seo/ahrefs.md
rename to .agents/seo/ahrefs.md
diff --git a/.agent/seo/analytics-tracking.md b/.agents/seo/analytics-tracking.md
similarity index 100%
rename from .agent/seo/analytics-tracking.md
rename to .agents/seo/analytics-tracking.md
diff --git a/.agent/seo/bing-webmaster-tools.md b/.agents/seo/bing-webmaster-tools.md
similarity index 100%
rename from .agent/seo/bing-webmaster-tools.md
rename to .agents/seo/bing-webmaster-tools.md
diff --git a/.agent/seo/contentking.md b/.agents/seo/contentking.md
similarity index 100%
rename from .agent/seo/contentking.md
rename to .agents/seo/contentking.md
diff --git a/.agent/seo/data-export.md b/.agents/seo/data-export.md
similarity index 100%
rename from .agent/seo/data-export.md
rename to .agents/seo/data-export.md
diff --git a/.agent/seo/dataforseo.md b/.agents/seo/dataforseo.md
similarity index 100%
rename from .agent/seo/dataforseo.md
rename to .agents/seo/dataforseo.md
diff --git a/.agent/seo/debug-favicon.md b/.agents/seo/debug-favicon.md
similarity index 100%
rename from .agent/seo/debug-favicon.md
rename to .agents/seo/debug-favicon.md
diff --git a/.agent/seo/debug-opengraph.md b/.agents/seo/debug-opengraph.md
similarity index 100%
rename from .agent/seo/debug-opengraph.md
rename to .agents/seo/debug-opengraph.md
diff --git a/.agent/seo/domain-research.md b/.agents/seo/domain-research.md
similarity index 100%
rename from .agent/seo/domain-research.md
rename to .agents/seo/domain-research.md
diff --git a/.agent/seo/eeat-score.md b/.agents/seo/eeat-score.md
similarity index 100%
rename from .agent/seo/eeat-score.md
rename to .agents/seo/eeat-score.md
diff --git a/.agent/seo/google-search-console.md b/.agents/seo/google-search-console.md
similarity index 100%
rename from .agent/seo/google-search-console.md
rename to .agents/seo/google-search-console.md
diff --git a/.agent/seo/gsc-sitemaps.md b/.agents/seo/gsc-sitemaps.md
similarity index 100%
rename from .agent/seo/gsc-sitemaps.md
rename to .agents/seo/gsc-sitemaps.md
diff --git a/.agent/seo/keyword-research.md b/.agents/seo/keyword-research.md
similarity index 100%
rename from .agent/seo/keyword-research.md
rename to .agents/seo/keyword-research.md
diff --git a/.agent/seo/neuronwriter.md b/.agents/seo/neuronwriter.md
similarity index 100%
rename from .agent/seo/neuronwriter.md
rename to .agents/seo/neuronwriter.md
diff --git a/.agent/seo/programmatic-seo.md b/.agents/seo/programmatic-seo.md
similarity index 100%
rename from .agent/seo/programmatic-seo.md
rename to .agents/seo/programmatic-seo.md
diff --git a/.agent/seo/ranking-opportunities.md b/.agents/seo/ranking-opportunities.md
similarity index 100%
rename from .agent/seo/ranking-opportunities.md
rename to .agents/seo/ranking-opportunities.md
diff --git a/.agent/seo/rich-results.md b/.agents/seo/rich-results.md
similarity index 100%
rename from .agent/seo/rich-results.md
rename to .agents/seo/rich-results.md
diff --git a/.agent/seo/schema-validator.md b/.agents/seo/schema-validator.md
similarity index 100%
rename from .agent/seo/schema-validator.md
rename to .agents/seo/schema-validator.md
diff --git a/.agent/seo/screaming-frog.md b/.agents/seo/screaming-frog.md
similarity index 100%
rename from .agent/seo/screaming-frog.md
rename to .agents/seo/screaming-frog.md
diff --git a/.agent/seo/semrush.md b/.agents/seo/semrush.md
similarity index 100%
rename from .agent/seo/semrush.md
rename to .agents/seo/semrush.md
diff --git a/.agent/seo/seo-audit-skill.md b/.agents/seo/seo-audit-skill.md
similarity index 100%
rename from .agent/seo/seo-audit-skill.md
rename to .agents/seo/seo-audit-skill.md
diff --git a/.agent/seo/seo-audit-skill/references/aeo-geo-patterns.md b/.agents/seo/seo-audit-skill/references/aeo-geo-patterns.md
similarity index 100%
rename from .agent/seo/seo-audit-skill/references/aeo-geo-patterns.md
rename to .agents/seo/seo-audit-skill/references/aeo-geo-patterns.md
diff --git a/.agent/seo/seo-audit-skill/references/ai-writing-detection.md b/.agents/seo/seo-audit-skill/references/ai-writing-detection.md
similarity index 100%
rename from .agent/seo/seo-audit-skill/references/ai-writing-detection.md
rename to .agents/seo/seo-audit-skill/references/ai-writing-detection.md
diff --git a/.agent/seo/serper.md b/.agents/seo/serper.md
similarity index 100%
rename from .agent/seo/serper.md
rename to .agents/seo/serper.md
diff --git a/.agent/seo/site-crawler.md b/.agents/seo/site-crawler.md
similarity index 100%
rename from .agent/seo/site-crawler.md
rename to .agents/seo/site-crawler.md
diff --git a/.agent/services/accounting/quickfile.md b/.agents/services/accounting/quickfile.md
similarity index 100%
rename from .agent/services/accounting/quickfile.md
rename to .agents/services/accounting/quickfile.md
diff --git a/.agent/services/analytics/google-analytics.md b/.agents/services/analytics/google-analytics.md
similarity index 100%
rename from .agent/services/analytics/google-analytics.md
rename to .agents/services/analytics/google-analytics.md
diff --git a/.agent/services/communications/matrix-bot.md b/.agents/services/communications/matrix-bot.md
similarity index 100%
rename from .agent/services/communications/matrix-bot.md
rename to .agents/services/communications/matrix-bot.md
diff --git a/.agent/services/communications/telfon.md b/.agents/services/communications/telfon.md
similarity index 100%
rename from .agent/services/communications/telfon.md
rename to .agents/services/communications/telfon.md
diff --git a/.agent/services/communications/twilio.md b/.agents/services/communications/twilio.md
similarity index 79%
rename from .agent/services/communications/twilio.md
rename to .agents/services/communications/twilio.md
index 40cc2cc0f..e4a560f6f 100644
--- a/.agent/services/communications/twilio.md
+++ b/.agents/services/communications/twilio.md
@@ -175,122 +175,122 @@ export TWILIO_AUTH_TOKEN="your_auth_token_here"
 
 ```bash
 # Send SMS
-./.agent/scripts/twilio-helper.sh sms production "+1234567890" "Hello from aidevops!"
+./.agents/scripts/twilio-helper.sh sms production "+1234567890" "Hello from aidevops!"
 
 # Send SMS with status callback
-./.agent/scripts/twilio-helper.sh sms production "+1234567890" "Order confirmed" --callback "https://your-webhook.com/status"
+./.agents/scripts/twilio-helper.sh sms production "+1234567890" "Order confirmed" --callback "https://your-webhook.com/status"
 
 # List recent messages
-./.agent/scripts/twilio-helper.sh messages production --limit 20
+./.agents/scripts/twilio-helper.sh messages production --limit 20
 
 # Get message status
-./.agent/scripts/twilio-helper.sh message-status production "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+./.agents/scripts/twilio-helper.sh message-status production "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 ```
 
 ### Voice Operations
 
 ```bash
 # Make outbound call with TwiML
-./.agent/scripts/twilio-helper.sh call production "+1234567890" --twiml "<Response><Say>Hello!</Say></Response>"
+./.agents/scripts/twilio-helper.sh call production "+1234567890" --twiml "<Response><Say>Hello!</Say></Response>"
 
 # Make call with URL
-./.agent/scripts/twilio-helper.sh call production "+1234567890" --url "https://your-server.com/voice.xml"
+./.agents/scripts/twilio-helper.sh call production "+1234567890" --url "https://your-server.com/voice.xml"
 
 # List recent calls
-./.agent/scripts/twilio-helper.sh calls production --limit 20
+./.agents/scripts/twilio-helper.sh calls production --limit 20
 
 # Get call details
-./.agent/scripts/twilio-helper.sh call-details production "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+./.agents/scripts/twilio-helper.sh call-details production "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 ```
 
 ### Call Recording & Transcription
 
 ```bash
 # List recordings for account
-./.agent/scripts/twilio-helper.sh recordings production
+./.agents/scripts/twilio-helper.sh recordings production
 
 # Get recording details
-./.agent/scripts/twilio-helper.sh recording production "RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+./.agents/scripts/twilio-helper.sh recording production "RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
 # Download recording
-./.agent/scripts/twilio-helper.sh download-recording production "RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ./recordings/
+./.agents/scripts/twilio-helper.sh download-recording production "RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ./recordings/
 
 # Get transcription
-./.agent/scripts/twilio-helper.sh transcription production "TRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+./.agents/scripts/twilio-helper.sh transcription production "TRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
 # List all transcriptions
-./.agent/scripts/twilio-helper.sh transcriptions production
+./.agents/scripts/twilio-helper.sh transcriptions production
 ```
 
 ### Phone Number Management
 
 ```bash
 # List owned numbers
-./.agent/scripts/twilio-helper.sh numbers production
+./.agents/scripts/twilio-helper.sh numbers production
 
 # Search available numbers
-./.agent/scripts/twilio-helper.sh search-numbers production US --area-code 415
+./.agents/scripts/twilio-helper.sh search-numbers production US --area-code 415
 
 # Search by capabilities
-./.agent/scripts/twilio-helper.sh search-numbers production GB --sms --voice
+./.agents/scripts/twilio-helper.sh search-numbers production GB --sms --voice
 
 # Purchase number (requires confirmation)
-./.agent/scripts/twilio-helper.sh buy-number production "+14155551234"
+./.agents/scripts/twilio-helper.sh buy-number production "+14155551234"
 
 # Release number (requires confirmation)
-./.agent/scripts/twilio-helper.sh release-number production "+14155551234"
+./.agents/scripts/twilio-helper.sh release-number production "+14155551234"
 ```
 
 ### Verify (2FA/OTP)
 
 ```bash
 # Create verification service (one-time setup)
-./.agent/scripts/twilio-helper.sh verify-create-service production "MyApp Verification"
+./.agents/scripts/twilio-helper.sh verify-create-service production "MyApp Verification"
 
 # Send verification code
-./.agent/scripts/twilio-helper.sh verify-send production "+1234567890" --channel sms
+./.agents/scripts/twilio-helper.sh verify-send production "+1234567890" --channel sms
 
 # Check verification code
-./.agent/scripts/twilio-helper.sh verify-check production "+1234567890" "123456"
+./.agents/scripts/twilio-helper.sh verify-check production "+1234567890" "123456"
 ```
 
 ### Lookup (Phone Validation)
 
 ```bash
 # Basic lookup
-./.agent/scripts/twilio-helper.sh lookup production "+1234567890"
+./.agents/scripts/twilio-helper.sh lookup production "+1234567890"
 
 # Carrier lookup
-./.agent/scripts/twilio-helper.sh lookup production "+1234567890" --type carrier
+./.agents/scripts/twilio-helper.sh lookup production "+1234567890" --type carrier
 
 # Caller name lookup
-./.agent/scripts/twilio-helper.sh lookup production "+1234567890" --type caller-name
+./.agents/scripts/twilio-helper.sh lookup production "+1234567890" --type caller-name
 ```
 
 ### WhatsApp
 
 ```bash
 # Send WhatsApp message (requires approved template or 24h window)
-./.agent/scripts/twilio-helper.sh whatsapp production "+1234567890" "Hello via WhatsApp!"
+./.agents/scripts/twilio-helper.sh whatsapp production "+1234567890" "Hello via WhatsApp!"
 
 # Send WhatsApp template
-./.agent/scripts/twilio-helper.sh whatsapp-template production "+1234567890" "appointment_reminder" '{"1":"John","2":"Tomorrow 3pm"}'
+./.agents/scripts/twilio-helper.sh whatsapp-template production "+1234567890" "appointment_reminder" '{"1":"John","2":"Tomorrow 3pm"}'
 ```
 
 ### Account Status & Audit
 
 ```bash
 # List all configured accounts
-./.agent/scripts/twilio-helper.sh accounts
+./.agents/scripts/twilio-helper.sh accounts
 
 # Get account balance
-./.agent/scripts/twilio-helper.sh balance production
+./.agents/scripts/twilio-helper.sh balance production
 
 # Get usage summary
-./.agent/scripts/twilio-helper.sh usage production
+./.agents/scripts/twilio-helper.sh usage production
 
 # Full account audit
-./.agent/scripts/twilio-helper.sh audit production
+./.agents/scripts/twilio-helper.sh audit production
 ```
 
 ## Number Acquisition
@@ -301,8 +301,8 @@ Most numbers can be purchased directly via the API:
 
 ```bash
 # Search and purchase
-./.agent/scripts/twilio-helper.sh search-numbers production US --area-code 212
-./.agent/scripts/twilio-helper.sh buy-number production "+12125551234"
+./.agents/scripts/twilio-helper.sh search-numbers production US --area-code 212
+./.agents/scripts/twilio-helper.sh buy-number production "+12125551234"
 ```
 
 ### Via Telfon App (Recommended for End Users)
@@ -326,7 +326,7 @@ Some numbers are not available via API and require contacting Twilio support:
 
 ```bash
 # If search returns empty
-./.agent/scripts/twilio-helper.sh search-numbers production GB --area-code 020
+./.agents/scripts/twilio-helper.sh search-numbers production GB --area-code 020
 # Result: No numbers available
 
 # AI should offer to help contact support
@@ -367,7 +367,7 @@ Configure webhooks for receiving messages and calls:
 
 ```bash
 # Update number webhook URLs
-./.agent/scripts/twilio-helper.sh configure-webhooks production "+1234567890" \
+./.agents/scripts/twilio-helper.sh configure-webhooks production "+1234567890" \
   --sms-url "https://your-server.com/sms" \
   --voice-url "https://your-server.com/voice"
 ```
@@ -435,7 +435,7 @@ app.post('/webhooks/twilio/sms-status', (req, res) => {
 
 ```bash
 # Enable recording on calls
-./.agent/scripts/twilio-helper.sh call production "+1234567890" \
+./.agents/scripts/twilio-helper.sh call production "+1234567890" \
   --record \
   --transcribe \
   --transcription-callback "https://your-server.com/webhooks/twilio/transcription"
@@ -493,7 +493,7 @@ const valid = twilio.validateRequest(
 
 ```bash
 # Verify credentials
-./.agent/scripts/twilio-helper.sh status production
+./.agents/scripts/twilio-helper.sh status production
 
 # Check environment variables
 echo $TWILIO_ACCOUNT_SID
@@ -503,7 +503,7 @@ echo $TWILIO_ACCOUNT_SID
 
 ```bash
 # Check message status
-./.agent/scripts/twilio-helper.sh message-status production "SMxxxxxxxx"
+./.agents/scripts/twilio-helper.sh message-status production "SMxxxxxxxx"
 
 # Common status codes:
 # - queued: Message queued for sending
@@ -517,7 +517,7 @@ echo $TWILIO_ACCOUNT_SID
 
 ```bash
 # Search returns empty - try different criteria
-./.agent/scripts/twilio-helper.sh search-numbers production US --contains "555"
+./.agents/scripts/twilio-helper.sh search-numbers production US --contains "555"
 
 # If still unavailable, contact Twilio support (see above)
 ```
@@ -538,10 +538,10 @@ curl -X POST https://your-server.com/webhooks/twilio/sms -d "test=1"
 
 ```bash
 # Daily usage summary
-./.agent/scripts/twilio-helper.sh usage production --period day
+./.agents/scripts/twilio-helper.sh usage production --period day
 
 # Monthly costs
-./.agent/scripts/twilio-helper.sh usage production --period month
+./.agents/scripts/twilio-helper.sh usage production --period month
 
 # Set up alerts in Twilio console for:
 # - Balance threshold
@@ -553,10 +553,10 @@ curl -X POST https://your-server.com/webhooks/twilio/sms -d "test=1"
 
 ```bash
 # Message delivery rates
-./.agent/scripts/twilio-helper.sh analytics production messages --days 7
+./.agents/scripts/twilio-helper.sh analytics production messages --days 7
 
 # Call completion rates
-./.agent/scripts/twilio-helper.sh analytics production calls --days 7
+./.agents/scripts/twilio-helper.sh analytics production calls --days 7
 ```
 
 ## Related Documentation
diff --git a/.agent/services/crm/fluentcrm.md b/.agents/services/crm/fluentcrm.md
similarity index 100%
rename from .agent/services/crm/fluentcrm.md
rename to .agents/services/crm/fluentcrm.md
diff --git a/.agent/services/database/postgres-drizzle-skill.md b/.agents/services/database/postgres-drizzle-skill.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill.md
rename to .agents/services/database/postgres-drizzle-skill.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/CHEATSHEET.md b/.agents/services/database/postgres-drizzle-skill/references/CHEATSHEET.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/CHEATSHEET.md
rename to .agents/services/database/postgres-drizzle-skill/references/CHEATSHEET.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/MIGRATIONS.md b/.agents/services/database/postgres-drizzle-skill/references/MIGRATIONS.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/MIGRATIONS.md
rename to .agents/services/database/postgres-drizzle-skill/references/MIGRATIONS.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/PERFORMANCE.md b/.agents/services/database/postgres-drizzle-skill/references/PERFORMANCE.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/PERFORMANCE.md
rename to .agents/services/database/postgres-drizzle-skill/references/PERFORMANCE.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/POSTGRES.md b/.agents/services/database/postgres-drizzle-skill/references/POSTGRES.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/POSTGRES.md
rename to .agents/services/database/postgres-drizzle-skill/references/POSTGRES.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/QUERIES.md b/.agents/services/database/postgres-drizzle-skill/references/QUERIES.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/QUERIES.md
rename to .agents/services/database/postgres-drizzle-skill/references/QUERIES.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/RELATIONS.md b/.agents/services/database/postgres-drizzle-skill/references/RELATIONS.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/RELATIONS.md
rename to .agents/services/database/postgres-drizzle-skill/references/RELATIONS.md
diff --git a/.agent/services/database/postgres-drizzle-skill/references/SCHEMA.md b/.agents/services/database/postgres-drizzle-skill/references/SCHEMA.md
similarity index 100%
rename from .agent/services/database/postgres-drizzle-skill/references/SCHEMA.md
rename to .agents/services/database/postgres-drizzle-skill/references/SCHEMA.md
diff --git a/.agent/services/document-processing/unstract.md b/.agents/services/document-processing/unstract.md
similarity index 99%
rename from .agent/services/document-processing/unstract.md
rename to .agents/services/document-processing/unstract.md
index 494aabde8..84c958567 100644
--- a/.agent/services/document-processing/unstract.md
+++ b/.agents/services/document-processing/unstract.md
@@ -198,5 +198,5 @@ This subagent is referenced by agents that need document extraction capabilities
 ## Related
 
 - `tools/context/mcp-discovery.md` - On-demand MCP loading pattern
-- `.agent/aidevops/mcp-integrations.md` - All MCP integrations
+- `.agents/aidevops/mcp-integrations.md` - All MCP integrations
 - `configs/mcp-templates/unstract.json` - OpenCode config template
diff --git a/.agent/services/email/email-health-check.md b/.agents/services/email/email-health-check.md
similarity index 92%
rename from .agent/services/email/email-health-check.md
rename to .agents/services/email/email-health-check.md
index 858c554c1..8726e4c1e 100644
--- a/.agent/services/email/email-health-check.md
+++ b/.agents/services/email/email-health-check.md
@@ -88,7 +88,7 @@ dig MX example.com +short
 
 ```bash
 # Run comprehensive check
-./.agent/scripts/email-health-check-helper.sh check example.com
+./.agents/scripts/email-health-check-helper.sh check example.com
 
 # Output includes:
 # - SPF record and validity
@@ -102,21 +102,21 @@ dig MX example.com +short
 
 ```bash
 # SPF only
-./.agent/scripts/email-health-check-helper.sh spf example.com
+./.agents/scripts/email-health-check-helper.sh spf example.com
 
 # DKIM with specific selector
-./.agent/scripts/email-health-check-helper.sh dkim example.com google
-./.agent/scripts/email-health-check-helper.sh dkim example.com selector1
-./.agent/scripts/email-health-check-helper.sh dkim example.com k1  # Mailchimp
+./.agents/scripts/email-health-check-helper.sh dkim example.com google
+./.agents/scripts/email-health-check-helper.sh dkim example.com selector1
+./.agents/scripts/email-health-check-helper.sh dkim example.com k1  # Mailchimp
 
 # DMARC only
-./.agent/scripts/email-health-check-helper.sh dmarc example.com
+./.agents/scripts/email-health-check-helper.sh dmarc example.com
 
 # MX records
-./.agent/scripts/email-health-check-helper.sh mx example.com
+./.agents/scripts/email-health-check-helper.sh mx example.com
 
 # Blacklist check
-./.agent/scripts/email-health-check-helper.sh blacklist example.com
+./.agents/scripts/email-health-check-helper.sh blacklist example.com
 ```
 
 ### Using checkdmarc Directly
@@ -284,7 +284,7 @@ For comprehensive deliverability testing:
 
 ```bash
 # The helper script can guide you through this
-./.agent/scripts/email-health-check-helper.sh mail-tester
+./.agents/scripts/email-health-check-helper.sh mail-tester
 ```
 
 ### mxtoolbox.com
diff --git a/.agent/services/email/ses.md b/.agents/services/email/ses.md
similarity index 80%
rename from .agent/services/email/ses.md
rename to .agents/services/email/ses.md
index ebc55b44e..982e93ffe 100644
--- a/.agent/services/email/ses.md
+++ b/.agents/services/email/ses.md
@@ -107,81 +107,81 @@ aws --version
 
 ```bash
 # List all SES accounts
-./.agent/scripts/ses-helper.sh accounts
+./.agents/scripts/ses-helper.sh accounts
 
 # Get sending quota
-./.agent/scripts/ses-helper.sh quota production
+./.agents/scripts/ses-helper.sh quota production
 
 # Get sending statistics
-./.agent/scripts/ses-helper.sh stats production
+./.agents/scripts/ses-helper.sh stats production
 
 # Monitor email delivery
-./.agent/scripts/ses-helper.sh monitor production
+./.agents/scripts/ses-helper.sh monitor production
 ```
 
 ### **Identity Management:**
 
 ```bash
 # List verified email addresses
-./.agent/scripts/ses-helper.sh verified-emails production
+./.agents/scripts/ses-helper.sh verified-emails production
 
 # List verified domains
-./.agent/scripts/ses-helper.sh verified-domains production
+./.agents/scripts/ses-helper.sh verified-domains production
 
 # Verify new email address
-./.agent/scripts/ses-helper.sh verify-email production newuser@yourdomain.com
+./.agents/scripts/ses-helper.sh verify-email production newuser@yourdomain.com
 
 # Verify new domain
-./.agent/scripts/ses-helper.sh verify-domain production newdomain.com
+./.agents/scripts/ses-helper.sh verify-domain production newdomain.com
 
 # Check identity verification status
-./.agent/scripts/ses-helper.sh verify-identity production yourdomain.com
+./.agents/scripts/ses-helper.sh verify-identity production yourdomain.com
 ```
 
 ### **DKIM Configuration:**
 
 ```bash
 # Get DKIM attributes
-./.agent/scripts/ses-helper.sh dkim production yourdomain.com
+./.agents/scripts/ses-helper.sh dkim production yourdomain.com
 
 # Enable DKIM for domain
-./.agent/scripts/ses-helper.sh enable-dkim production yourdomain.com
+./.agents/scripts/ses-helper.sh enable-dkim production yourdomain.com
 
 # Check DKIM status for email
-./.agent/scripts/ses-helper.sh dkim production noreply@yourdomain.com
+./.agents/scripts/ses-helper.sh dkim production noreply@yourdomain.com
 ```
 
 ### **Reputation & Deliverability:**
 
 ```bash
 # Check account reputation
-./.agent/scripts/ses-helper.sh reputation production
+./.agents/scripts/ses-helper.sh reputation production
 
 # List suppressed destinations (bounces/complaints)
-./.agent/scripts/ses-helper.sh suppressed production
+./.agents/scripts/ses-helper.sh suppressed production
 
 # Get details for suppressed email
-./.agent/scripts/ses-helper.sh suppression-details production user@example.com
+./.agents/scripts/ses-helper.sh suppression-details production user@example.com
 
 # Remove email from suppression list
-./.agent/scripts/ses-helper.sh remove-suppression production user@example.com
+./.agents/scripts/ses-helper.sh remove-suppression production user@example.com
 ```
 
 ### **Testing & Debugging:**
 
 ```bash
 # Send test email
-./.agent/scripts/ses-helper.sh send-test production noreply@yourdomain.com test@example.com "Test Subject" "Test message body"
+./.agents/scripts/ses-helper.sh send-test production noreply@yourdomain.com test@example.com "Test Subject" "Test message body"
 
 # Debug delivery issues for specific email
-./.agent/scripts/ses-helper.sh debug production problematic@example.com
+./.agents/scripts/ses-helper.sh debug production problematic@example.com
 
 # Audit complete SES configuration
-./.agent/scripts/ses-helper.sh audit production
+./.agents/scripts/ses-helper.sh audit production
 
 # Test with SES simulator addresses
-./.agent/scripts/ses-helper.sh send-test production noreply@yourdomain.com success@simulator.amazonses.com "Success Test"
-./.agent/scripts/ses-helper.sh send-test production noreply@yourdomain.com bounce@simulator.amazonses.com "Bounce Test"
+./.agents/scripts/ses-helper.sh send-test production noreply@yourdomain.com success@simulator.amazonses.com "Success Test"
+./.agents/scripts/ses-helper.sh send-test production noreply@yourdomain.com bounce@simulator.amazonses.com "Bounce Test"
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -245,17 +245,17 @@ aws sts get-caller-identity
 aws configure get region
 
 # Test SES access
-./.agent/scripts/ses-helper.sh quota production
+./.agents/scripts/ses-helper.sh quota production
 ```
 
 #### **Sending Limits:**
 
 ```bash
 # Check current quota
-./.agent/scripts/ses-helper.sh quota production
+./.agents/scripts/ses-helper.sh quota production
 
 # Monitor sending rate
-./.agent/scripts/ses-helper.sh stats production
+./.agents/scripts/ses-helper.sh stats production
 
 # Request limit increase through AWS Support if needed
 ```
@@ -264,26 +264,26 @@ aws configure get region
 
 ```bash
 # Check reputation
-./.agent/scripts/ses-helper.sh reputation production
+./.agents/scripts/ses-helper.sh reputation production
 
 # Look for suppressed destinations
-./.agent/scripts/ses-helper.sh suppressed production
+./.agents/scripts/ses-helper.sh suppressed production
 
 # Debug specific email
-./.agent/scripts/ses-helper.sh debug production problematic@example.com
+./.agents/scripts/ses-helper.sh debug production problematic@example.com
 
 # Check bounce/complaint rates
-./.agent/scripts/ses-helper.sh monitor production
+./.agents/scripts/ses-helper.sh monitor production
 ```
 
 #### **Verification Problems:**
 
 ```bash
 # Check verification status
-./.agent/scripts/ses-helper.sh verify-identity production yourdomain.com
+./.agents/scripts/ses-helper.sh verify-identity production yourdomain.com
 
 # Re-verify domain
-./.agent/scripts/ses-helper.sh verify-domain production yourdomain.com
+./.agents/scripts/ses-helper.sh verify-domain production yourdomain.com
 
 # Check DNS records
 dig TXT _amazonses.yourdomain.com
@@ -295,7 +295,7 @@ dig TXT _amazonses.yourdomain.com
 
 ```bash
 # Daily monitoring routine
-./.agent/scripts/ses-helper.sh monitor production
+./.agents/scripts/ses-helper.sh monitor production
 
 # Key metrics include:
 # - Send quota utilization
@@ -315,7 +315,7 @@ BOUNCE_THRESHOLD=5.0
 COMPLAINT_THRESHOLD=0.1
 
 # Get current stats
-STATS=$(./.agent/scripts/ses-helper.sh stats $ACCOUNT)
+STATS=$(./.agents/scripts/ses-helper.sh stats $ACCOUNT)
 
 # Parse and alert if thresholds exceeded
 # (Add your alerting logic here)
@@ -335,11 +335,11 @@ STATS=$(./.agent/scripts/ses-helper.sh stats $ACCOUNT)
 
 ```bash
 # Export SES configuration
-./.agent/scripts/ses-helper.sh audit production > ses-config-backup-$(date +%Y%m%d).txt
+./.agents/scripts/ses-helper.sh audit production > ses-config-backup-$(date +%Y%m%d).txt
 
 # Backup verified identities
-./.agent/scripts/ses-helper.sh verified-emails production > verified-emails-backup.txt
-./.agent/scripts/ses-helper.sh verified-domains production > verified-domains-backup.txt
+./.agents/scripts/ses-helper.sh verified-emails production > verified-emails-backup.txt
+./.agents/scripts/ses-helper.sh verified-domains production > verified-domains-backup.txt
 ```
 
 ### **Compliance Considerations:**
diff --git a/.agent/services/hosting/101domains.md b/.agents/services/hosting/101domains.md
similarity index 70%
rename from .agent/services/hosting/101domains.md
rename to .agents/services/hosting/101domains.md
index 9585a290c..bb0e9a788 100644
--- a/.agent/services/hosting/101domains.md
+++ b/.agents/services/hosting/101domains.md
@@ -101,90 +101,90 @@ cp configs/101domains-config.json.txt configs/101domains-config.json
 
 ```bash
 # List all 101domains accounts
-./.agent/scripts/101domains-helper.sh accounts
+./.agents/scripts/101domains-helper.sh accounts
 
 # List domains for account
-./.agent/scripts/101domains-helper.sh domains personal
+./.agents/scripts/101domains-helper.sh domains personal
 
 # Get domain details
-./.agent/scripts/101domains-helper.sh domain-details personal example.com
+./.agents/scripts/101domains-helper.sh domain-details personal example.com
 
 # Audit complete domain configuration
-./.agent/scripts/101domains-helper.sh audit personal example.com
+./.agents/scripts/101domains-helper.sh audit personal example.com
 ```
 
 ### **DNS Management:**
 
 ```bash
 # List DNS records
-./.agent/scripts/101domains-helper.sh dns-records personal example.com
+./.agents/scripts/101domains-helper.sh dns-records personal example.com
 
 # Add DNS record
-./.agent/scripts/101domains-helper.sh add-dns personal example.com www A 192.168.1.100 3600
+./.agents/scripts/101domains-helper.sh add-dns personal example.com www A 192.168.1.100 3600
 
 # Update DNS record
-./.agent/scripts/101domains-helper.sh update-dns personal example.com record-id www A 192.168.1.101 3600
+./.agents/scripts/101domains-helper.sh update-dns personal example.com record-id www A 192.168.1.101 3600
 
 # Delete DNS record
-./.agent/scripts/101domains-helper.sh delete-dns personal example.com record-id
+./.agents/scripts/101domains-helper.sh delete-dns personal example.com record-id
 ```
 
 ### **Nameserver Management:**
 
 ```bash
 # Get current nameservers
-./.agent/scripts/101domains-helper.sh nameservers personal example.com
+./.agents/scripts/101domains-helper.sh nameservers personal example.com
 
 # Update to Cloudflare nameservers
-./.agent/scripts/101domains-helper.sh update-ns personal example.com ns1.cloudflare.com ns2.cloudflare.com
+./.agents/scripts/101domains-helper.sh update-ns personal example.com ns1.cloudflare.com ns2.cloudflare.com
 
 # Update to Route 53 nameservers
-./.agent/scripts/101domains-helper.sh update-ns personal example.com ns-1.awsdns-01.com ns-2.awsdns-02.net ns-3.awsdns-03.org ns-4.awsdns-04.co.uk
+./.agents/scripts/101domains-helper.sh update-ns personal example.com ns-1.awsdns-01.com ns-2.awsdns-02.net ns-3.awsdns-03.org ns-4.awsdns-04.co.uk
 ```
 
 ### **Domain Management:**
 
 ```bash
 # Check domain availability
-./.agent/scripts/101domains-helper.sh check-availability personal newdomain.com
+./.agents/scripts/101domains-helper.sh check-availability personal newdomain.com
 
 # Get domain contacts
-./.agent/scripts/101domains-helper.sh contacts personal example.com
+./.agents/scripts/101domains-helper.sh contacts personal example.com
 
 # Lock domain
-./.agent/scripts/101domains-helper.sh lock personal example.com
+./.agents/scripts/101domains-helper.sh lock personal example.com
 
 # Unlock domain
-./.agent/scripts/101domains-helper.sh unlock personal example.com
+./.agents/scripts/101domains-helper.sh unlock personal example.com
 
 # Check transfer status
-./.agent/scripts/101domains-helper.sh transfer-status personal example.com
+./.agents/scripts/101domains-helper.sh transfer-status personal example.com
 ```
 
 ### **Privacy Management:**
 
 ```bash
 # Check privacy status
-./.agent/scripts/101domains-helper.sh privacy-status personal example.com
+./.agents/scripts/101domains-helper.sh privacy-status personal example.com
 
 # Enable domain privacy
-./.agent/scripts/101domains-helper.sh enable-privacy personal example.com
+./.agents/scripts/101domains-helper.sh enable-privacy personal example.com
 
 # Disable domain privacy
-./.agent/scripts/101domains-helper.sh disable-privacy personal example.com
+./.agents/scripts/101domains-helper.sh disable-privacy personal example.com
 ```
 
 ### **Monitoring & Automation:**
 
 ```bash
 # Monitor domain expiration (30 days warning)
-./.agent/scripts/101domains-helper.sh monitor-expiration personal 30
+./.agents/scripts/101domains-helper.sh monitor-expiration personal 30
 
 # Monitor domain expiration (60 days warning)
-./.agent/scripts/101domains-helper.sh monitor-expiration personal 60
+./.agents/scripts/101domains-helper.sh monitor-expiration personal 60
 
 # Comprehensive domain audit
-./.agent/scripts/101domains-helper.sh audit personal example.com
+./.agents/scripts/101domains-helper.sh audit personal example.com
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -201,16 +201,16 @@ cp configs/101domains-config.json.txt configs/101domains-config.json
 
 ```bash
 # Enable domain lock
-./.agent/scripts/101domains-helper.sh lock personal example.com
+./.agents/scripts/101domains-helper.sh lock personal example.com
 
 # Enable privacy protection
-./.agent/scripts/101domains-helper.sh enable-privacy personal example.com
+./.agents/scripts/101domains-helper.sh enable-privacy personal example.com
 
 # Monitor transfer status
-./.agent/scripts/101domains-helper.sh transfer-status personal example.com
+./.agents/scripts/101domains-helper.sh transfer-status personal example.com
 
 # Regular security audit
-./.agent/scripts/101domains-helper.sh audit personal example.com
+./.agents/scripts/101domains-helper.sh audit personal example.com
 ```
 
 ### **Privacy Protection:**
@@ -228,7 +228,7 @@ cp configs/101domains-config.json.txt configs/101domains-config.json
 
 ```bash
 # Verify API credentials
-./.agent/scripts/101domains-helper.sh accounts
+./.agents/scripts/101domains-helper.sh accounts
 
 # Check API permissions in 101domains control panel
 # Ensure username and API key are correct
@@ -238,10 +238,10 @@ cp configs/101domains-config.json.txt configs/101domains-config.json
 
 ```bash
 # Check DNS records
-./.agent/scripts/101domains-helper.sh dns-records personal example.com
+./.agents/scripts/101domains-helper.sh dns-records personal example.com
 
 # Verify nameservers
-./.agent/scripts/101domains-helper.sh nameservers personal example.com
+./.agents/scripts/101domains-helper.sh nameservers personal example.com
 
 # Check DNS propagation
 dig @8.8.8.8 example.com
@@ -252,13 +252,13 @@ nslookup example.com 8.8.8.8
 
 ```bash
 # Check domain lock status
-./.agent/scripts/101domains-helper.sh audit personal example.com
+./.agents/scripts/101domains-helper.sh audit personal example.com
 
 # Verify transfer status
-./.agent/scripts/101domains-helper.sh transfer-status personal example.com
+./.agents/scripts/101domains-helper.sh transfer-status personal example.com
 
 # Check domain contacts
-./.agent/scripts/101domains-helper.sh contacts personal example.com
+./.agents/scripts/101domains-helper.sh contacts personal example.com
 ```
 
 ## 📊 **Monitoring & Analytics**
@@ -267,11 +267,11 @@ nslookup example.com 8.8.8.8
 
 ```bash
 # Monitor all domains for expiration
-./.agent/scripts/101domains-helper.sh monitor-expiration personal 30
+./.agents/scripts/101domains-helper.sh monitor-expiration personal 30
 
 # Audit multiple domains
 for domain in example.com another.com; do
-    ./.agent/scripts/101domains-helper.sh audit personal $domain
+    ./.agents/scripts/101domains-helper.sh audit personal $domain
 done
 ```
 
@@ -279,9 +279,9 @@ done
 
 ```bash
 # Check privacy status for all domains
-for domain in $(./.agent/scripts/101domains-helper.sh domains personal | awk '{print $1}'); do
+for domain in $(./.agents/scripts/101domains-helper.sh domains personal | awk '{print $1}'); do
     echo "Privacy status for $domain:"
-    ./.agent/scripts/101domains-helper.sh privacy-status personal $domain
+    ./.agents/scripts/101domains-helper.sh privacy-status personal $domain
 done
 ```
 
@@ -295,12 +295,12 @@ THRESHOLD=30
 
 # Check expiring domains
 echo "=== EXPIRING DOMAINS ==="
-./.agent/scripts/101domains-helper.sh monitor-expiration $ACCOUNT $THRESHOLD
+./.agents/scripts/101domains-helper.sh monitor-expiration $ACCOUNT $THRESHOLD
 
 # Check privacy settings
 echo "=== PRIVACY AUDIT ==="
-for domain in $(./.agent/scripts/101domains-helper.sh domains $ACCOUNT | awk '{print $1}'); do
-    privacy_status=$(./.agent/scripts/101domains-helper.sh privacy-status $ACCOUNT $domain)
+for domain in $(./.agents/scripts/101domains-helper.sh domains $ACCOUNT | awk '{print $1}'); do
+    privacy_status=$(./.agents/scripts/101domains-helper.sh privacy-status $ACCOUNT $domain)
     echo "$domain: $privacy_status"
 done
 ```
@@ -311,21 +311,21 @@ done
 
 ```bash
 # Backup DNS records
-./.agent/scripts/101domains-helper.sh dns-records personal example.com > dns-backup-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/101domains-helper.sh dns-records personal example.com > dns-backup-example.com-$(date +%Y%m%d).txt
 
 # Backup domain configuration
-./.agent/scripts/101domains-helper.sh audit personal example.com > domain-audit-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/101domains-helper.sh audit personal example.com > domain-audit-example.com-$(date +%Y%m%d).txt
 
 # Backup privacy settings
-./.agent/scripts/101domains-helper.sh privacy-status personal example.com > privacy-backup-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/101domains-helper.sh privacy-status personal example.com > privacy-backup-example.com-$(date +%Y%m%d).txt
 ```
 
 ### **Bulk Operations:**
 
 ```bash
 # Backup all domains
-for domain in $(./.agent/scripts/101domains-helper.sh domains personal | awk '{print $1}'); do
-    ./.agent/scripts/101domains-helper.sh audit personal $domain > "backup-$domain-$(date +%Y%m%d).txt"
+for domain in $(./.agents/scripts/101domains-helper.sh domains personal | awk '{print $1}'); do
+    ./.agents/scripts/101domains-helper.sh audit personal $domain > "backup-$domain-$(date +%Y%m%d).txt"
 done
 ```
 
diff --git a/.agent/services/hosting/closte.md b/.agents/services/hosting/closte.md
similarity index 100%
rename from .agent/services/hosting/closte.md
rename to .agents/services/hosting/closte.md
diff --git a/.agent/services/hosting/cloudflare-platform.md b/.agents/services/hosting/cloudflare-platform.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform.md
rename to .agents/services/hosting/cloudflare-platform.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/agents-sdk/README.md b/.agents/services/hosting/cloudflare-platform/references/agents-sdk/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/agents-sdk/README.md
rename to .agents/services/hosting/cloudflare-platform/references/agents-sdk/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/agents-sdk/api.md b/.agents/services/hosting/cloudflare-platform/references/agents-sdk/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/agents-sdk/api.md
rename to .agents/services/hosting/cloudflare-platform/references/agents-sdk/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/agents-sdk/configuration.md b/.agents/services/hosting/cloudflare-platform/references/agents-sdk/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/agents-sdk/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/agents-sdk/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/agents-sdk/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/agents-sdk/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/agents-sdk/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/agents-sdk/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/agents-sdk/patterns.md b/.agents/services/hosting/cloudflare-platform/references/agents-sdk/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/agents-sdk/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/agents-sdk/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-gateway/README.md b/.agents/services/hosting/cloudflare-platform/references/ai-gateway/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-gateway/README.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-gateway/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-search/README.md b/.agents/services/hosting/cloudflare-platform/references/ai-search/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-search/README.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-search/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-search/api.md b/.agents/services/hosting/cloudflare-platform/references/ai-search/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-search/api.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-search/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-search/configuration.md b/.agents/services/hosting/cloudflare-platform/references/ai-search/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-search/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-search/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-search/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/ai-search/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-search/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-search/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ai-search/patterns.md b/.agents/services/hosting/cloudflare-platform/references/ai-search/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ai-search/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/ai-search/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/analytics-engine/README.md b/.agents/services/hosting/cloudflare-platform/references/analytics-engine/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/analytics-engine/README.md
rename to .agents/services/hosting/cloudflare-platform/references/analytics-engine/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/analytics-engine/api.md b/.agents/services/hosting/cloudflare-platform/references/analytics-engine/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/analytics-engine/api.md
rename to .agents/services/hosting/cloudflare-platform/references/analytics-engine/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/analytics-engine/configuration.md b/.agents/services/hosting/cloudflare-platform/references/analytics-engine/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/analytics-engine/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/analytics-engine/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/analytics-engine/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/analytics-engine/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/analytics-engine/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/analytics-engine/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/analytics-engine/patterns.md b/.agents/services/hosting/cloudflare-platform/references/analytics-engine/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/analytics-engine/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/analytics-engine/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api-shield/README.md b/.agents/services/hosting/cloudflare-platform/references/api-shield/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api-shield/README.md
rename to .agents/services/hosting/cloudflare-platform/references/api-shield/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api-shield/api.md b/.agents/services/hosting/cloudflare-platform/references/api-shield/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api-shield/api.md
rename to .agents/services/hosting/cloudflare-platform/references/api-shield/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api-shield/configuration.md b/.agents/services/hosting/cloudflare-platform/references/api-shield/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api-shield/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/api-shield/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api-shield/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/api-shield/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api-shield/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/api-shield/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api-shield/patterns.md b/.agents/services/hosting/cloudflare-platform/references/api-shield/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api-shield/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/api-shield/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api/README.md b/.agents/services/hosting/cloudflare-platform/references/api/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api/README.md
rename to .agents/services/hosting/cloudflare-platform/references/api/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api/api.md b/.agents/services/hosting/cloudflare-platform/references/api/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api/api.md
rename to .agents/services/hosting/cloudflare-platform/references/api/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api/configuration.md b/.agents/services/hosting/cloudflare-platform/references/api/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/api/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/api/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/api/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/api/patterns.md b/.agents/services/hosting/cloudflare-platform/references/api/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/api/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/api/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/argo-smart-routing/README.md b/.agents/services/hosting/cloudflare-platform/references/argo-smart-routing/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/argo-smart-routing/README.md
rename to .agents/services/hosting/cloudflare-platform/references/argo-smart-routing/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/argo-smart-routing/api.md b/.agents/services/hosting/cloudflare-platform/references/argo-smart-routing/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/argo-smart-routing/api.md
rename to .agents/services/hosting/cloudflare-platform/references/argo-smart-routing/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/argo-smart-routing/configuration.md b/.agents/services/hosting/cloudflare-platform/references/argo-smart-routing/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/argo-smart-routing/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/argo-smart-routing/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/argo-smart-routing/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/argo-smart-routing/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/argo-smart-routing/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/argo-smart-routing/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/argo-smart-routing/patterns.md b/.agents/services/hosting/cloudflare-platform/references/argo-smart-routing/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/argo-smart-routing/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/argo-smart-routing/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bindings/README.md b/.agents/services/hosting/cloudflare-platform/references/bindings/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bindings/README.md
rename to .agents/services/hosting/cloudflare-platform/references/bindings/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bindings/api.md b/.agents/services/hosting/cloudflare-platform/references/bindings/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bindings/api.md
rename to .agents/services/hosting/cloudflare-platform/references/bindings/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bindings/configuration.md b/.agents/services/hosting/cloudflare-platform/references/bindings/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bindings/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/bindings/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bindings/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/bindings/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bindings/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/bindings/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bindings/patterns.md b/.agents/services/hosting/cloudflare-platform/references/bindings/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bindings/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/bindings/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bot-management/README.md b/.agents/services/hosting/cloudflare-platform/references/bot-management/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bot-management/README.md
rename to .agents/services/hosting/cloudflare-platform/references/bot-management/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bot-management/api.md b/.agents/services/hosting/cloudflare-platform/references/bot-management/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bot-management/api.md
rename to .agents/services/hosting/cloudflare-platform/references/bot-management/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bot-management/configuration.md b/.agents/services/hosting/cloudflare-platform/references/bot-management/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bot-management/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/bot-management/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bot-management/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/bot-management/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bot-management/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/bot-management/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/bot-management/patterns.md b/.agents/services/hosting/cloudflare-platform/references/bot-management/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/bot-management/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/bot-management/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/browser-rendering/README.md b/.agents/services/hosting/cloudflare-platform/references/browser-rendering/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/browser-rendering/README.md
rename to .agents/services/hosting/cloudflare-platform/references/browser-rendering/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/browser-rendering/api.md b/.agents/services/hosting/cloudflare-platform/references/browser-rendering/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/browser-rendering/api.md
rename to .agents/services/hosting/cloudflare-platform/references/browser-rendering/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/browser-rendering/configuration.md b/.agents/services/hosting/cloudflare-platform/references/browser-rendering/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/browser-rendering/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/browser-rendering/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/browser-rendering/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/browser-rendering/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/browser-rendering/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/browser-rendering/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/browser-rendering/patterns.md b/.agents/services/hosting/cloudflare-platform/references/browser-rendering/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/browser-rendering/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/browser-rendering/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/c3/README.md b/.agents/services/hosting/cloudflare-platform/references/c3/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/c3/README.md
rename to .agents/services/hosting/cloudflare-platform/references/c3/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cache-reserve/README.md b/.agents/services/hosting/cloudflare-platform/references/cache-reserve/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cache-reserve/README.md
rename to .agents/services/hosting/cloudflare-platform/references/cache-reserve/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cache-reserve/api.md b/.agents/services/hosting/cloudflare-platform/references/cache-reserve/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cache-reserve/api.md
rename to .agents/services/hosting/cloudflare-platform/references/cache-reserve/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cache-reserve/configuration.md b/.agents/services/hosting/cloudflare-platform/references/cache-reserve/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cache-reserve/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/cache-reserve/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cache-reserve/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/cache-reserve/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cache-reserve/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/cache-reserve/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cache-reserve/patterns.md b/.agents/services/hosting/cloudflare-platform/references/cache-reserve/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cache-reserve/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/cache-reserve/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/containers/README.md b/.agents/services/hosting/cloudflare-platform/references/containers/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/containers/README.md
rename to .agents/services/hosting/cloudflare-platform/references/containers/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/containers/api.md b/.agents/services/hosting/cloudflare-platform/references/containers/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/containers/api.md
rename to .agents/services/hosting/cloudflare-platform/references/containers/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/containers/configuration.md b/.agents/services/hosting/cloudflare-platform/references/containers/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/containers/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/containers/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/containers/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/containers/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/containers/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/containers/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/containers/patterns.md b/.agents/services/hosting/cloudflare-platform/references/containers/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/containers/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/containers/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cron-triggers/README.md b/.agents/services/hosting/cloudflare-platform/references/cron-triggers/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cron-triggers/README.md
rename to .agents/services/hosting/cloudflare-platform/references/cron-triggers/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cron-triggers/api.md b/.agents/services/hosting/cloudflare-platform/references/cron-triggers/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cron-triggers/api.md
rename to .agents/services/hosting/cloudflare-platform/references/cron-triggers/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cron-triggers/configuration.md b/.agents/services/hosting/cloudflare-platform/references/cron-triggers/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cron-triggers/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/cron-triggers/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cron-triggers/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/cron-triggers/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cron-triggers/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/cron-triggers/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/cron-triggers/patterns.md b/.agents/services/hosting/cloudflare-platform/references/cron-triggers/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/cron-triggers/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/cron-triggers/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/d1/README.md b/.agents/services/hosting/cloudflare-platform/references/d1/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/d1/README.md
rename to .agents/services/hosting/cloudflare-platform/references/d1/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/d1/api.md b/.agents/services/hosting/cloudflare-platform/references/d1/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/d1/api.md
rename to .agents/services/hosting/cloudflare-platform/references/d1/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/d1/configuration.md b/.agents/services/hosting/cloudflare-platform/references/d1/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/d1/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/d1/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/d1/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/d1/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/d1/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/d1/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/d1/patterns.md b/.agents/services/hosting/cloudflare-platform/references/d1/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/d1/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/d1/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ddos/README.md b/.agents/services/hosting/cloudflare-platform/references/ddos/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ddos/README.md
rename to .agents/services/hosting/cloudflare-platform/references/ddos/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ddos/api.md b/.agents/services/hosting/cloudflare-platform/references/ddos/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ddos/api.md
rename to .agents/services/hosting/cloudflare-platform/references/ddos/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ddos/configuration.md b/.agents/services/hosting/cloudflare-platform/references/ddos/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ddos/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/ddos/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ddos/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/ddos/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ddos/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/ddos/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/ddos/patterns.md b/.agents/services/hosting/cloudflare-platform/references/ddos/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/ddos/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/ddos/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/do-storage/README.md b/.agents/services/hosting/cloudflare-platform/references/do-storage/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/do-storage/README.md
rename to .agents/services/hosting/cloudflare-platform/references/do-storage/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/do-storage/api.md b/.agents/services/hosting/cloudflare-platform/references/do-storage/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/do-storage/api.md
rename to .agents/services/hosting/cloudflare-platform/references/do-storage/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/do-storage/configuration.md b/.agents/services/hosting/cloudflare-platform/references/do-storage/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/do-storage/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/do-storage/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/do-storage/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/do-storage/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/do-storage/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/do-storage/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/do-storage/patterns.md b/.agents/services/hosting/cloudflare-platform/references/do-storage/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/do-storage/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/do-storage/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/durable-objects/README.md b/.agents/services/hosting/cloudflare-platform/references/durable-objects/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/durable-objects/README.md
rename to .agents/services/hosting/cloudflare-platform/references/durable-objects/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/durable-objects/api.md b/.agents/services/hosting/cloudflare-platform/references/durable-objects/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/durable-objects/api.md
rename to .agents/services/hosting/cloudflare-platform/references/durable-objects/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/durable-objects/configuration.md b/.agents/services/hosting/cloudflare-platform/references/durable-objects/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/durable-objects/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/durable-objects/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/durable-objects/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/durable-objects/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/durable-objects/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/durable-objects/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/durable-objects/patterns.md b/.agents/services/hosting/cloudflare-platform/references/durable-objects/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/durable-objects/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/durable-objects/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-routing/README.md b/.agents/services/hosting/cloudflare-platform/references/email-routing/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-routing/README.md
rename to .agents/services/hosting/cloudflare-platform/references/email-routing/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-routing/api.md b/.agents/services/hosting/cloudflare-platform/references/email-routing/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-routing/api.md
rename to .agents/services/hosting/cloudflare-platform/references/email-routing/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-routing/configuration.md b/.agents/services/hosting/cloudflare-platform/references/email-routing/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-routing/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/email-routing/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-routing/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/email-routing/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-routing/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/email-routing/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-routing/patterns.md b/.agents/services/hosting/cloudflare-platform/references/email-routing/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-routing/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/email-routing/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/email-workers/README.md b/.agents/services/hosting/cloudflare-platform/references/email-workers/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/email-workers/README.md
rename to .agents/services/hosting/cloudflare-platform/references/email-workers/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/hyperdrive/README.md b/.agents/services/hosting/cloudflare-platform/references/hyperdrive/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/hyperdrive/README.md
rename to .agents/services/hosting/cloudflare-platform/references/hyperdrive/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/hyperdrive/api.md b/.agents/services/hosting/cloudflare-platform/references/hyperdrive/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/hyperdrive/api.md
rename to .agents/services/hosting/cloudflare-platform/references/hyperdrive/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/hyperdrive/configuration.md b/.agents/services/hosting/cloudflare-platform/references/hyperdrive/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/hyperdrive/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/hyperdrive/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/hyperdrive/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/hyperdrive/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/hyperdrive/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/hyperdrive/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/hyperdrive/patterns.md b/.agents/services/hosting/cloudflare-platform/references/hyperdrive/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/hyperdrive/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/hyperdrive/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/images/README.md b/.agents/services/hosting/cloudflare-platform/references/images/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/images/README.md
rename to .agents/services/hosting/cloudflare-platform/references/images/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/images/api.md b/.agents/services/hosting/cloudflare-platform/references/images/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/images/api.md
rename to .agents/services/hosting/cloudflare-platform/references/images/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/images/configuration.md b/.agents/services/hosting/cloudflare-platform/references/images/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/images/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/images/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/images/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/images/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/images/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/images/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/images/patterns.md b/.agents/services/hosting/cloudflare-platform/references/images/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/images/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/images/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/kv/README.md b/.agents/services/hosting/cloudflare-platform/references/kv/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/kv/README.md
rename to .agents/services/hosting/cloudflare-platform/references/kv/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/kv/api.md b/.agents/services/hosting/cloudflare-platform/references/kv/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/kv/api.md
rename to .agents/services/hosting/cloudflare-platform/references/kv/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/kv/configuration.md b/.agents/services/hosting/cloudflare-platform/references/kv/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/kv/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/kv/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/kv/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/kv/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/kv/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/kv/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/kv/patterns.md b/.agents/services/hosting/cloudflare-platform/references/kv/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/kv/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/kv/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/miniflare/README.md b/.agents/services/hosting/cloudflare-platform/references/miniflare/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/miniflare/README.md
rename to .agents/services/hosting/cloudflare-platform/references/miniflare/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/miniflare/api.md b/.agents/services/hosting/cloudflare-platform/references/miniflare/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/miniflare/api.md
rename to .agents/services/hosting/cloudflare-platform/references/miniflare/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/miniflare/configuration.md b/.agents/services/hosting/cloudflare-platform/references/miniflare/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/miniflare/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/miniflare/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/miniflare/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/miniflare/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/miniflare/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/miniflare/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/miniflare/patterns.md b/.agents/services/hosting/cloudflare-platform/references/miniflare/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/miniflare/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/miniflare/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/network-interconnect/README.md b/.agents/services/hosting/cloudflare-platform/references/network-interconnect/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/network-interconnect/README.md
rename to .agents/services/hosting/cloudflare-platform/references/network-interconnect/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/network-interconnect/api.md b/.agents/services/hosting/cloudflare-platform/references/network-interconnect/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/network-interconnect/api.md
rename to .agents/services/hosting/cloudflare-platform/references/network-interconnect/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/network-interconnect/configuration.md b/.agents/services/hosting/cloudflare-platform/references/network-interconnect/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/network-interconnect/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/network-interconnect/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/network-interconnect/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/network-interconnect/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/network-interconnect/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/network-interconnect/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/network-interconnect/patterns.md b/.agents/services/hosting/cloudflare-platform/references/network-interconnect/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/network-interconnect/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/network-interconnect/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/observability/README.md b/.agents/services/hosting/cloudflare-platform/references/observability/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/observability/README.md
rename to .agents/services/hosting/cloudflare-platform/references/observability/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/observability/api.md b/.agents/services/hosting/cloudflare-platform/references/observability/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/observability/api.md
rename to .agents/services/hosting/cloudflare-platform/references/observability/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/observability/configuration.md b/.agents/services/hosting/cloudflare-platform/references/observability/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/observability/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/observability/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/observability/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/observability/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/observability/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/observability/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/observability/patterns.md b/.agents/services/hosting/cloudflare-platform/references/observability/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/observability/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/observability/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages-functions/README.md b/.agents/services/hosting/cloudflare-platform/references/pages-functions/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages-functions/README.md
rename to .agents/services/hosting/cloudflare-platform/references/pages-functions/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages-functions/api.md b/.agents/services/hosting/cloudflare-platform/references/pages-functions/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages-functions/api.md
rename to .agents/services/hosting/cloudflare-platform/references/pages-functions/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages-functions/configuration.md b/.agents/services/hosting/cloudflare-platform/references/pages-functions/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages-functions/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/pages-functions/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages-functions/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/pages-functions/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages-functions/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/pages-functions/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages-functions/patterns.md b/.agents/services/hosting/cloudflare-platform/references/pages-functions/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages-functions/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/pages-functions/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages/README.md b/.agents/services/hosting/cloudflare-platform/references/pages/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages/README.md
rename to .agents/services/hosting/cloudflare-platform/references/pages/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages/api.md b/.agents/services/hosting/cloudflare-platform/references/pages/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages/api.md
rename to .agents/services/hosting/cloudflare-platform/references/pages/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages/configuration.md b/.agents/services/hosting/cloudflare-platform/references/pages/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/pages/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/pages/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/pages/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pages/patterns.md b/.agents/services/hosting/cloudflare-platform/references/pages/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pages/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/pages/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pipelines/README.md b/.agents/services/hosting/cloudflare-platform/references/pipelines/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pipelines/README.md
rename to .agents/services/hosting/cloudflare-platform/references/pipelines/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pulumi/README.md b/.agents/services/hosting/cloudflare-platform/references/pulumi/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pulumi/README.md
rename to .agents/services/hosting/cloudflare-platform/references/pulumi/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pulumi/api.md b/.agents/services/hosting/cloudflare-platform/references/pulumi/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pulumi/api.md
rename to .agents/services/hosting/cloudflare-platform/references/pulumi/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pulumi/configuration.md b/.agents/services/hosting/cloudflare-platform/references/pulumi/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pulumi/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/pulumi/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pulumi/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/pulumi/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pulumi/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/pulumi/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/pulumi/patterns.md b/.agents/services/hosting/cloudflare-platform/references/pulumi/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/pulumi/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/pulumi/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/queues/README.md b/.agents/services/hosting/cloudflare-platform/references/queues/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/queues/README.md
rename to .agents/services/hosting/cloudflare-platform/references/queues/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/queues/api.md b/.agents/services/hosting/cloudflare-platform/references/queues/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/queues/api.md
rename to .agents/services/hosting/cloudflare-platform/references/queues/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/queues/configuration.md b/.agents/services/hosting/cloudflare-platform/references/queues/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/queues/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/queues/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/queues/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/queues/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/queues/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/queues/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/queues/patterns.md b/.agents/services/hosting/cloudflare-platform/references/queues/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/queues/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/queues/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-data-catalog/README.md b/.agents/services/hosting/cloudflare-platform/references/r2-data-catalog/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-data-catalog/README.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-data-catalog/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-data-catalog/api.md b/.agents/services/hosting/cloudflare-platform/references/r2-data-catalog/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-data-catalog/api.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-data-catalog/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-data-catalog/configuration.md b/.agents/services/hosting/cloudflare-platform/references/r2-data-catalog/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-data-catalog/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-data-catalog/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-data-catalog/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/r2-data-catalog/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-data-catalog/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-data-catalog/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-data-catalog/patterns.md b/.agents/services/hosting/cloudflare-platform/references/r2-data-catalog/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-data-catalog/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-data-catalog/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2-sql/README.md b/.agents/services/hosting/cloudflare-platform/references/r2-sql/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2-sql/README.md
rename to .agents/services/hosting/cloudflare-platform/references/r2-sql/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2/README.md b/.agents/services/hosting/cloudflare-platform/references/r2/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2/README.md
rename to .agents/services/hosting/cloudflare-platform/references/r2/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2/api.md b/.agents/services/hosting/cloudflare-platform/references/r2/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2/api.md
rename to .agents/services/hosting/cloudflare-platform/references/r2/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2/configuration.md b/.agents/services/hosting/cloudflare-platform/references/r2/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/r2/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/r2/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/r2/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/r2/patterns.md b/.agents/services/hosting/cloudflare-platform/references/r2/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/r2/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/r2/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtime-sfu/README.md b/.agents/services/hosting/cloudflare-platform/references/realtime-sfu/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtime-sfu/README.md
rename to .agents/services/hosting/cloudflare-platform/references/realtime-sfu/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtime-sfu/api.md b/.agents/services/hosting/cloudflare-platform/references/realtime-sfu/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtime-sfu/api.md
rename to .agents/services/hosting/cloudflare-platform/references/realtime-sfu/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtime-sfu/configuration.md b/.agents/services/hosting/cloudflare-platform/references/realtime-sfu/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtime-sfu/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/realtime-sfu/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtime-sfu/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/realtime-sfu/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtime-sfu/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/realtime-sfu/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtime-sfu/patterns.md b/.agents/services/hosting/cloudflare-platform/references/realtime-sfu/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtime-sfu/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/realtime-sfu/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtimekit/README.md b/.agents/services/hosting/cloudflare-platform/references/realtimekit/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtimekit/README.md
rename to .agents/services/hosting/cloudflare-platform/references/realtimekit/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtimekit/api.md b/.agents/services/hosting/cloudflare-platform/references/realtimekit/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtimekit/api.md
rename to .agents/services/hosting/cloudflare-platform/references/realtimekit/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtimekit/configuration.md b/.agents/services/hosting/cloudflare-platform/references/realtimekit/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtimekit/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/realtimekit/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtimekit/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/realtimekit/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtimekit/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/realtimekit/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/realtimekit/patterns.md b/.agents/services/hosting/cloudflare-platform/references/realtimekit/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/realtimekit/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/realtimekit/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/sandbox/README.md b/.agents/services/hosting/cloudflare-platform/references/sandbox/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/sandbox/README.md
rename to .agents/services/hosting/cloudflare-platform/references/sandbox/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/sandbox/api.md b/.agents/services/hosting/cloudflare-platform/references/sandbox/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/sandbox/api.md
rename to .agents/services/hosting/cloudflare-platform/references/sandbox/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/sandbox/configuration.md b/.agents/services/hosting/cloudflare-platform/references/sandbox/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/sandbox/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/sandbox/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/sandbox/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/sandbox/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/sandbox/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/sandbox/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/sandbox/patterns.md b/.agents/services/hosting/cloudflare-platform/references/sandbox/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/sandbox/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/sandbox/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/smart-placement/README.md b/.agents/services/hosting/cloudflare-platform/references/smart-placement/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/smart-placement/README.md
rename to .agents/services/hosting/cloudflare-platform/references/smart-placement/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/smart-placement/api.md b/.agents/services/hosting/cloudflare-platform/references/smart-placement/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/smart-placement/api.md
rename to .agents/services/hosting/cloudflare-platform/references/smart-placement/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/smart-placement/configuration.md b/.agents/services/hosting/cloudflare-platform/references/smart-placement/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/smart-placement/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/smart-placement/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/smart-placement/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/smart-placement/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/smart-placement/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/smart-placement/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/smart-placement/patterns.md b/.agents/services/hosting/cloudflare-platform/references/smart-placement/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/smart-placement/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/smart-placement/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/snippets/README.md b/.agents/services/hosting/cloudflare-platform/references/snippets/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/snippets/README.md
rename to .agents/services/hosting/cloudflare-platform/references/snippets/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/snippets/api.md b/.agents/services/hosting/cloudflare-platform/references/snippets/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/snippets/api.md
rename to .agents/services/hosting/cloudflare-platform/references/snippets/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/snippets/configuration.md b/.agents/services/hosting/cloudflare-platform/references/snippets/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/snippets/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/snippets/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/snippets/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/snippets/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/snippets/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/snippets/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/snippets/patterns.md b/.agents/services/hosting/cloudflare-platform/references/snippets/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/snippets/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/snippets/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/spectrum/README.md b/.agents/services/hosting/cloudflare-platform/references/spectrum/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/spectrum/README.md
rename to .agents/services/hosting/cloudflare-platform/references/spectrum/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/spectrum/api.md b/.agents/services/hosting/cloudflare-platform/references/spectrum/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/spectrum/api.md
rename to .agents/services/hosting/cloudflare-platform/references/spectrum/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/spectrum/configuration.md b/.agents/services/hosting/cloudflare-platform/references/spectrum/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/spectrum/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/spectrum/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/spectrum/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/spectrum/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/spectrum/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/spectrum/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/spectrum/patterns.md b/.agents/services/hosting/cloudflare-platform/references/spectrum/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/spectrum/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/spectrum/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/static-assets/README.md b/.agents/services/hosting/cloudflare-platform/references/static-assets/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/static-assets/README.md
rename to .agents/services/hosting/cloudflare-platform/references/static-assets/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/static-assets/api.md b/.agents/services/hosting/cloudflare-platform/references/static-assets/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/static-assets/api.md
rename to .agents/services/hosting/cloudflare-platform/references/static-assets/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/static-assets/configuration.md b/.agents/services/hosting/cloudflare-platform/references/static-assets/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/static-assets/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/static-assets/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/static-assets/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/static-assets/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/static-assets/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/static-assets/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/static-assets/patterns.md b/.agents/services/hosting/cloudflare-platform/references/static-assets/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/static-assets/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/static-assets/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/stream/README.md b/.agents/services/hosting/cloudflare-platform/references/stream/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/stream/README.md
rename to .agents/services/hosting/cloudflare-platform/references/stream/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/stream/api.md b/.agents/services/hosting/cloudflare-platform/references/stream/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/stream/api.md
rename to .agents/services/hosting/cloudflare-platform/references/stream/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/stream/configuration.md b/.agents/services/hosting/cloudflare-platform/references/stream/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/stream/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/stream/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/stream/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/stream/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/stream/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/stream/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/stream/patterns.md b/.agents/services/hosting/cloudflare-platform/references/stream/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/stream/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/stream/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tail-workers/README.md b/.agents/services/hosting/cloudflare-platform/references/tail-workers/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tail-workers/README.md
rename to .agents/services/hosting/cloudflare-platform/references/tail-workers/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/terraform/README.md b/.agents/services/hosting/cloudflare-platform/references/terraform/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/terraform/README.md
rename to .agents/services/hosting/cloudflare-platform/references/terraform/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/terraform/api.md b/.agents/services/hosting/cloudflare-platform/references/terraform/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/terraform/api.md
rename to .agents/services/hosting/cloudflare-platform/references/terraform/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/terraform/configuration.md b/.agents/services/hosting/cloudflare-platform/references/terraform/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/terraform/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/terraform/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/terraform/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/terraform/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/terraform/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/terraform/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/terraform/patterns.md b/.agents/services/hosting/cloudflare-platform/references/terraform/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/terraform/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/terraform/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tunnel/README.md b/.agents/services/hosting/cloudflare-platform/references/tunnel/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tunnel/README.md
rename to .agents/services/hosting/cloudflare-platform/references/tunnel/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tunnel/api.md b/.agents/services/hosting/cloudflare-platform/references/tunnel/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tunnel/api.md
rename to .agents/services/hosting/cloudflare-platform/references/tunnel/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tunnel/configuration.md b/.agents/services/hosting/cloudflare-platform/references/tunnel/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tunnel/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/tunnel/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tunnel/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/tunnel/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tunnel/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/tunnel/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/tunnel/patterns.md b/.agents/services/hosting/cloudflare-platform/references/tunnel/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/tunnel/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/tunnel/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turn/README.md b/.agents/services/hosting/cloudflare-platform/references/turn/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turn/README.md
rename to .agents/services/hosting/cloudflare-platform/references/turn/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turnstile/README.md b/.agents/services/hosting/cloudflare-platform/references/turnstile/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turnstile/README.md
rename to .agents/services/hosting/cloudflare-platform/references/turnstile/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turnstile/api.md b/.agents/services/hosting/cloudflare-platform/references/turnstile/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turnstile/api.md
rename to .agents/services/hosting/cloudflare-platform/references/turnstile/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turnstile/configuration.md b/.agents/services/hosting/cloudflare-platform/references/turnstile/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turnstile/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/turnstile/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turnstile/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/turnstile/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turnstile/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/turnstile/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/turnstile/patterns.md b/.agents/services/hosting/cloudflare-platform/references/turnstile/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/turnstile/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/turnstile/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/vectorize/README.md b/.agents/services/hosting/cloudflare-platform/references/vectorize/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/vectorize/README.md
rename to .agents/services/hosting/cloudflare-platform/references/vectorize/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/waf/README.md b/.agents/services/hosting/cloudflare-platform/references/waf/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/waf/README.md
rename to .agents/services/hosting/cloudflare-platform/references/waf/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/waf/api.md b/.agents/services/hosting/cloudflare-platform/references/waf/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/waf/api.md
rename to .agents/services/hosting/cloudflare-platform/references/waf/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/waf/configuration.md b/.agents/services/hosting/cloudflare-platform/references/waf/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/waf/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/waf/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/waf/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/waf/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/waf/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/waf/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/waf/patterns.md b/.agents/services/hosting/cloudflare-platform/references/waf/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/waf/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/waf/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/web-analytics/README.md b/.agents/services/hosting/cloudflare-platform/references/web-analytics/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/web-analytics/README.md
rename to .agents/services/hosting/cloudflare-platform/references/web-analytics/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/web-analytics/api.md b/.agents/services/hosting/cloudflare-platform/references/web-analytics/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/web-analytics/api.md
rename to .agents/services/hosting/cloudflare-platform/references/web-analytics/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/web-analytics/configuration.md b/.agents/services/hosting/cloudflare-platform/references/web-analytics/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/web-analytics/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/web-analytics/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/web-analytics/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/web-analytics/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/web-analytics/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/web-analytics/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/web-analytics/patterns.md b/.agents/services/hosting/cloudflare-platform/references/web-analytics/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/web-analytics/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/web-analytics/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workerd/README.md b/.agents/services/hosting/cloudflare-platform/references/workerd/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workerd/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workerd/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workerd/api.md b/.agents/services/hosting/cloudflare-platform/references/workerd/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workerd/api.md
rename to .agents/services/hosting/cloudflare-platform/references/workerd/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workerd/configuration.md b/.agents/services/hosting/cloudflare-platform/references/workerd/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workerd/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/workerd/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workerd/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/workerd/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workerd/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/workerd/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workerd/patterns.md b/.agents/services/hosting/cloudflare-platform/references/workerd/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workerd/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/workerd/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-ai/README.md b/.agents/services/hosting/cloudflare-platform/references/workers-ai/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-ai/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-ai/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-for-platforms/README.md b/.agents/services/hosting/cloudflare-platform/references/workers-for-platforms/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-for-platforms/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-for-platforms/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-for-platforms/api.md b/.agents/services/hosting/cloudflare-platform/references/workers-for-platforms/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-for-platforms/api.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-for-platforms/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-for-platforms/configuration.md b/.agents/services/hosting/cloudflare-platform/references/workers-for-platforms/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-for-platforms/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-for-platforms/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-for-platforms/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/workers-for-platforms/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-for-platforms/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-for-platforms/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-for-platforms/patterns.md b/.agents/services/hosting/cloudflare-platform/references/workers-for-platforms/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-for-platforms/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-for-platforms/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-playground/README.md b/.agents/services/hosting/cloudflare-platform/references/workers-playground/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-playground/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-playground/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-playground/api.md b/.agents/services/hosting/cloudflare-platform/references/workers-playground/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-playground/api.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-playground/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-playground/configuration.md b/.agents/services/hosting/cloudflare-platform/references/workers-playground/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-playground/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-playground/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-playground/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/workers-playground/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-playground/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-playground/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-playground/patterns.md b/.agents/services/hosting/cloudflare-platform/references/workers-playground/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-playground/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-playground/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers-vpc/README.md b/.agents/services/hosting/cloudflare-platform/references/workers-vpc/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers-vpc/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workers-vpc/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers/README.md b/.agents/services/hosting/cloudflare-platform/references/workers/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workers/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers/api.md b/.agents/services/hosting/cloudflare-platform/references/workers/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers/api.md
rename to .agents/services/hosting/cloudflare-platform/references/workers/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers/configuration.md b/.agents/services/hosting/cloudflare-platform/references/workers/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/workers/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/workers/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/workers/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workers/patterns.md b/.agents/services/hosting/cloudflare-platform/references/workers/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workers/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/workers/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workflows/README.md b/.agents/services/hosting/cloudflare-platform/references/workflows/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workflows/README.md
rename to .agents/services/hosting/cloudflare-platform/references/workflows/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workflows/api.md b/.agents/services/hosting/cloudflare-platform/references/workflows/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workflows/api.md
rename to .agents/services/hosting/cloudflare-platform/references/workflows/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workflows/configuration.md b/.agents/services/hosting/cloudflare-platform/references/workflows/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workflows/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/workflows/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workflows/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/workflows/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workflows/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/workflows/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/workflows/patterns.md b/.agents/services/hosting/cloudflare-platform/references/workflows/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/workflows/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/workflows/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/wrangler/README.md b/.agents/services/hosting/cloudflare-platform/references/wrangler/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/wrangler/README.md
rename to .agents/services/hosting/cloudflare-platform/references/wrangler/README.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/wrangler/api.md b/.agents/services/hosting/cloudflare-platform/references/wrangler/api.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/wrangler/api.md
rename to .agents/services/hosting/cloudflare-platform/references/wrangler/api.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/wrangler/configuration.md b/.agents/services/hosting/cloudflare-platform/references/wrangler/configuration.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/wrangler/configuration.md
rename to .agents/services/hosting/cloudflare-platform/references/wrangler/configuration.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/wrangler/gotchas.md b/.agents/services/hosting/cloudflare-platform/references/wrangler/gotchas.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/wrangler/gotchas.md
rename to .agents/services/hosting/cloudflare-platform/references/wrangler/gotchas.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/wrangler/patterns.md b/.agents/services/hosting/cloudflare-platform/references/wrangler/patterns.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/wrangler/patterns.md
rename to .agents/services/hosting/cloudflare-platform/references/wrangler/patterns.md
diff --git a/.agent/services/hosting/cloudflare-platform/references/zaraz/README.md b/.agents/services/hosting/cloudflare-platform/references/zaraz/README.md
similarity index 100%
rename from .agent/services/hosting/cloudflare-platform/references/zaraz/README.md
rename to .agents/services/hosting/cloudflare-platform/references/zaraz/README.md
diff --git a/.agent/services/hosting/cloudflare.md b/.agents/services/hosting/cloudflare.md
similarity index 95%
rename from .agent/services/hosting/cloudflare.md
rename to .agents/services/hosting/cloudflare.md
index 6fa620054..13565d6e1 100644
--- a/.agent/services/hosting/cloudflare.md
+++ b/.agents/services/hosting/cloudflare.md
@@ -216,13 +216,13 @@ curl -X GET "https://api.cloudflare.com/client/v4/zones" \
 
 ```bash
 # Create development subdomain
-./.agent/scripts/dns-helper.sh create-record personal dev.yourdomain.com A 192.168.1.100
+./.agents/scripts/dns-helper.sh create-record personal dev.yourdomain.com A 192.168.1.100
 
 # Setup SSL for local development
-./.agent/scripts/dns-helper.sh create-record personal local.yourdomain.com CNAME yourdomain.com
+./.agents/scripts/dns-helper.sh create-record personal local.yourdomain.com CNAME yourdomain.com
 
 # Manage staging environments
-./.agent/scripts/dns-helper.sh create-record business staging.company.com A 10.0.1.50
+./.agents/scripts/dns-helper.sh create-record business staging.company.com A 10.0.1.50
 ```
 
 ## 🚨 **Emergency Procedures**
diff --git a/.agent/services/hosting/cloudron.md b/.agents/services/hosting/cloudron.md
similarity index 82%
rename from .agent/services/hosting/cloudron.md
rename to .agents/services/hosting/cloudron.md
index f0d2aa5b6..847ab2619 100644
--- a/.agent/services/hosting/cloudron.md
+++ b/.agents/services/hosting/cloudron.md
@@ -104,67 +104,67 @@ cp configs/cloudron-config.json.txt configs/cloudron-config.json
 
 ```bash
 # List all Cloudron servers
-./.agent/scripts/cloudron-helper.sh servers
+./.agents/scripts/cloudron-helper.sh servers
 
 # Connect to Cloudron server
-./.agent/scripts/cloudron-helper.sh connect production
+./.agents/scripts/cloudron-helper.sh connect production
 
 # Get server status
-./.agent/scripts/cloudron-helper.sh status production
+./.agents/scripts/cloudron-helper.sh status production
 
 # List installed apps
-./.agent/scripts/cloudron-helper.sh apps production
+./.agents/scripts/cloudron-helper.sh apps production
 ```
 
 ### **App Management:**
 
 ```bash
 # Install new app
-./.agent/scripts/cloudron-helper.sh install-app production wordpress blog.yourdomain.com
+./.agents/scripts/cloudron-helper.sh install-app production wordpress blog.yourdomain.com
 
 # Update app
-./.agent/scripts/cloudron-helper.sh update-app production app-id
+./.agents/scripts/cloudron-helper.sh update-app production app-id
 
 # Restart app
-./.agent/scripts/cloudron-helper.sh restart-app production app-id
+./.agents/scripts/cloudron-helper.sh restart-app production app-id
 
 # Get app logs
-./.agent/scripts/cloudron-helper.sh logs production app-id
+./.agents/scripts/cloudron-helper.sh logs production app-id
 
 # Backup app
-./.agent/scripts/cloudron-helper.sh backup-app production app-id
+./.agents/scripts/cloudron-helper.sh backup-app production app-id
 ```
 
 ### **Domain Management:**
 
 ```bash
 # List domains
-./.agent/scripts/cloudron-helper.sh domains production
+./.agents/scripts/cloudron-helper.sh domains production
 
 # Add domain
-./.agent/scripts/cloudron-helper.sh add-domain production newdomain.com
+./.agents/scripts/cloudron-helper.sh add-domain production newdomain.com
 
 # Configure DNS
-./.agent/scripts/cloudron-helper.sh configure-dns production newdomain.com
+./.agents/scripts/cloudron-helper.sh configure-dns production newdomain.com
 
 # Get SSL certificate status
-./.agent/scripts/cloudron-helper.sh ssl-status production newdomain.com
+./.agents/scripts/cloudron-helper.sh ssl-status production newdomain.com
 ```
 
 ### **User Management:**
 
 ```bash
 # List users
-./.agent/scripts/cloudron-helper.sh users production
+./.agents/scripts/cloudron-helper.sh users production
 
 # Add user
-./.agent/scripts/cloudron-helper.sh add-user production newuser@domain.com
+./.agents/scripts/cloudron-helper.sh add-user production newuser@domain.com
 
 # Update user permissions
-./.agent/scripts/cloudron-helper.sh update-user production user-id admin
+./.agents/scripts/cloudron-helper.sh update-user production user-id admin
 
 # Reset user password
-./.agent/scripts/cloudron-helper.sh reset-password production user-id
+./.agents/scripts/cloudron-helper.sh reset-password production user-id
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -189,16 +189,16 @@ cp configs/cloudron-config.json.txt configs/cloudron-config.json
 
 ```bash
 # Check app security status
-./.agent/scripts/cloudron-helper.sh security-status production
+./.agents/scripts/cloudron-helper.sh security-status production
 
 # Update all apps
-./.agent/scripts/cloudron-helper.sh update-all-apps production
+./.agents/scripts/cloudron-helper.sh update-all-apps production
 
 # Check SSL certificates
-./.agent/scripts/cloudron-helper.sh ssl-check production
+./.agents/scripts/cloudron-helper.sh ssl-check production
 
 # Review user access
-./.agent/scripts/cloudron-helper.sh audit-users production
+./.agents/scripts/cloudron-helper.sh audit-users production
 ```
 
 ## 🔍 **Troubleshooting**
@@ -329,13 +329,13 @@ openssl s_client -connect cloudron.yourdomain.com:443
 
 ```bash
 # Check available disk space
-./.agent/scripts/cloudron-helper.sh exec production 'df -h'
+./.agents/scripts/cloudron-helper.sh exec production 'df -h'
 
 # Check system resources
-./.agent/scripts/cloudron-helper.sh exec production 'free -h'
+./.agents/scripts/cloudron-helper.sh exec production 'free -h'
 
 # Review installation logs
-./.agent/scripts/cloudron-helper.sh logs production app-id
+./.agents/scripts/cloudron-helper.sh logs production app-id
 ```
 
 #### **App Startup Failures (Post-Update)**
@@ -358,10 +358,10 @@ dig cloudron.yourdomain.com
 nslookup cloudron.yourdomain.com
 
 # Verify domain ownership
-./.agent/scripts/cloudron-helper.sh verify-domain production yourdomain.com
+./.agents/scripts/cloudron-helper.sh verify-domain production yourdomain.com
 
 # Check SSL certificate status
-./.agent/scripts/cloudron-helper.sh ssl-status production yourdomain.com
+./.agents/scripts/cloudron-helper.sh ssl-status production yourdomain.com
 ```
 
 ### **App-Specific Troubleshooting**
@@ -377,25 +377,25 @@ For app-specific issues, check these subagents:
 
 ```bash
 # Get system status
-./.agent/scripts/cloudron-helper.sh status production
+./.agents/scripts/cloudron-helper.sh status production
 
 # Check resource usage
-./.agent/scripts/cloudron-helper.sh resources production
+./.agents/scripts/cloudron-helper.sh resources production
 
 # Monitor app health
-./.agent/scripts/cloudron-helper.sh health-check production
+./.agents/scripts/cloudron-helper.sh health-check production
 
 # Review system logs
-./.agent/scripts/cloudron-helper.sh system-logs production
+./.agents/scripts/cloudron-helper.sh system-logs production
 ```
 
 ### **App Monitoring:**
 
 ```bash
 # Monitor all apps
-for app_id in $(./.agent/scripts/cloudron-helper.sh apps production | awk '{print $1}'); do
+for app_id in $(./.agents/scripts/cloudron-helper.sh apps production | awk '{print $1}'); do
     echo "App $app_id status:"
-    ./.agent/scripts/cloudron-helper.sh app-status production $app_id
+    ./.agents/scripts/cloudron-helper.sh app-status production $app_id
 done
 ```
 
@@ -405,29 +405,29 @@ done
 
 ```bash
 # Create system backup
-./.agent/scripts/cloudron-helper.sh backup-system production
+./.agents/scripts/cloudron-helper.sh backup-system production
 
 # List backups
-./.agent/scripts/cloudron-helper.sh list-backups production
+./.agents/scripts/cloudron-helper.sh list-backups production
 
 # Restore from backup
-./.agent/scripts/cloudron-helper.sh restore-backup production backup-id
+./.agents/scripts/cloudron-helper.sh restore-backup production backup-id
 
 # Configure backup schedule
-./.agent/scripts/cloudron-helper.sh configure-backups production daily
+./.agents/scripts/cloudron-helper.sh configure-backups production daily
 ```
 
 ### **App-Specific Backups:**
 
 ```bash
 # Backup specific app
-./.agent/scripts/cloudron-helper.sh backup-app production app-id
+./.agents/scripts/cloudron-helper.sh backup-app production app-id
 
 # Restore app from backup
-./.agent/scripts/cloudron-helper.sh restore-app production app-id backup-id
+./.agents/scripts/cloudron-helper.sh restore-app production app-id backup-id
 
 # Export app data
-./.agent/scripts/cloudron-helper.sh export-app production app-id
+./.agents/scripts/cloudron-helper.sh export-app production app-id
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/dns-providers.md b/.agents/services/hosting/dns-providers.md
similarity index 71%
rename from .agent/services/hosting/dns-providers.md
rename to .agents/services/hosting/dns-providers.md
index 9cf746179..bcfbbf6b4 100644
--- a/.agent/services/hosting/dns-providers.md
+++ b/.agents/services/hosting/dns-providers.md
@@ -112,20 +112,20 @@ cp configs/route53-dns-config.json.txt configs/route53-dns-config.json
 
 ```bash
 # List DNS records across providers
-./.agent/scripts/dns-helper.sh records cloudflare personal example.com
-./.agent/scripts/dns-helper.sh records namecheap personal example.com
-./.agent/scripts/dns-helper.sh records route53 production example.com
+./.agents/scripts/dns-helper.sh records cloudflare personal example.com
+./.agents/scripts/dns-helper.sh records namecheap personal example.com
+./.agents/scripts/dns-helper.sh records route53 production example.com
 
 # Add DNS records
-./.agent/scripts/dns-helper.sh add cloudflare personal example.com www A 192.168.1.100
-./.agent/scripts/dns-helper.sh add namecheap personal example.com mail A 192.168.1.101
-./.agent/scripts/dns-helper.sh add route53 production example.com api A 192.168.1.102
+./.agents/scripts/dns-helper.sh add cloudflare personal example.com www A 192.168.1.100
+./.agents/scripts/dns-helper.sh add namecheap personal example.com mail A 192.168.1.101
+./.agents/scripts/dns-helper.sh add route53 production example.com api A 192.168.1.102
 
 # Update DNS records
-./.agent/scripts/dns-helper.sh update cloudflare personal example.com record-id www A 192.168.1.200
+./.agents/scripts/dns-helper.sh update cloudflare personal example.com record-id www A 192.168.1.200
 
 # Delete DNS records
-./.agent/scripts/dns-helper.sh delete cloudflare personal example.com record-id
+./.agents/scripts/dns-helper.sh delete cloudflare personal example.com record-id
 ```
 
 ### **Provider-Specific Features:**
@@ -134,26 +134,26 @@ cp configs/route53-dns-config.json.txt configs/route53-dns-config.json
 
 ```bash
 # Enable Cloudflare proxy
-./.agent/scripts/dns-helper.sh proxy-enable cloudflare personal example.com record-id
+./.agents/scripts/dns-helper.sh proxy-enable cloudflare personal example.com record-id
 
 # Configure page rules
-./.agent/scripts/dns-helper.sh page-rule cloudflare personal example.com "*.example.com/*" cache-everything
+./.agents/scripts/dns-helper.sh page-rule cloudflare personal example.com "*.example.com/*" cache-everything
 
 # Get analytics
-./.agent/scripts/dns-helper.sh analytics cloudflare personal example.com
+./.agents/scripts/dns-helper.sh analytics cloudflare personal example.com
 ```
 
 #### **Route 53 Advanced Features:**
 
 ```bash
 # Create health check
-./.agent/scripts/dns-helper.sh health-check route53 production example.com https://example.com/health
+./.agents/scripts/dns-helper.sh health-check route53 production example.com https://example.com/health
 
 # Configure weighted routing
-./.agent/scripts/dns-helper.sh weighted-routing route53 production example.com www A 192.168.1.100 50
+./.agents/scripts/dns-helper.sh weighted-routing route53 production example.com www A 192.168.1.100 50
 
 # Set up geolocation routing
-./.agent/scripts/dns-helper.sh geo-routing route53 production example.com www A 192.168.1.100 US
+./.agents/scripts/dns-helper.sh geo-routing route53 production example.com www A 192.168.1.100 US
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -170,13 +170,13 @@ cp configs/route53-dns-config.json.txt configs/route53-dns-config.json
 
 ```bash
 # Enable DNSSEC (where supported)
-./.agent/scripts/dns-helper.sh enable-dnssec cloudflare personal example.com
+./.agents/scripts/dns-helper.sh enable-dnssec cloudflare personal example.com
 
 # Configure CAA records
-./.agent/scripts/dns-helper.sh add cloudflare personal example.com @ CAA "0 issue letsencrypt.org"
+./.agents/scripts/dns-helper.sh add cloudflare personal example.com @ CAA "0 issue letsencrypt.org"
 
 # Set up monitoring
-./.agent/scripts/dns-helper.sh monitor cloudflare personal example.com
+./.agents/scripts/dns-helper.sh monitor cloudflare personal example.com
 ```
 
 ### **Access Control:**
@@ -199,35 +199,35 @@ dig @8.8.8.8 example.com
 nslookup example.com 1.1.1.1
 
 # Test from multiple locations
-./.agent/scripts/dns-helper.sh propagation-check example.com
+./.agents/scripts/dns-helper.sh propagation-check example.com
 
 # Check TTL values
-./.agent/scripts/dns-helper.sh ttl-check example.com
+./.agents/scripts/dns-helper.sh ttl-check example.com
 ```
 
 #### **API Authentication:**
 
 ```bash
 # Test API connectivity
-./.agent/scripts/dns-helper.sh test-auth cloudflare personal
-./.agent/scripts/dns-helper.sh test-auth namecheap personal
-./.agent/scripts/dns-helper.sh test-auth route53 production
+./.agents/scripts/dns-helper.sh test-auth cloudflare personal
+./.agents/scripts/dns-helper.sh test-auth namecheap personal
+./.agents/scripts/dns-helper.sh test-auth route53 production
 
 # Verify API permissions
-./.agent/scripts/dns-helper.sh check-permissions cloudflare personal
+./.agents/scripts/dns-helper.sh check-permissions cloudflare personal
 ```
 
 #### **Record Conflicts:**
 
 ```bash
 # Check for conflicting records
-./.agent/scripts/dns-helper.sh conflict-check cloudflare personal example.com
+./.agents/scripts/dns-helper.sh conflict-check cloudflare personal example.com
 
 # Validate DNS configuration
-./.agent/scripts/dns-helper.sh validate cloudflare personal example.com
+./.agents/scripts/dns-helper.sh validate cloudflare personal example.com
 
 # Compare configurations across providers
-./.agent/scripts/dns-helper.sh compare example.com cloudflare:personal namecheap:personal
+./.agents/scripts/dns-helper.sh compare example.com cloudflare:personal namecheap:personal
 ```
 
 ## 📊 **Monitoring & Analytics**
@@ -236,26 +236,26 @@ nslookup example.com 1.1.1.1
 
 ```bash
 # Monitor DNS resolution
-./.agent/scripts/dns-helper.sh monitor-resolution example.com
+./.agents/scripts/dns-helper.sh monitor-resolution example.com
 
 # Check DNS performance
-./.agent/scripts/dns-helper.sh performance-check example.com
+./.agents/scripts/dns-helper.sh performance-check example.com
 
 # Monitor DNS changes
-./.agent/scripts/dns-helper.sh change-log cloudflare personal example.com
+./.agents/scripts/dns-helper.sh change-log cloudflare personal example.com
 ```
 
 ### **Analytics & Reporting:**
 
 ```bash
 # Get DNS query analytics (Cloudflare)
-./.agent/scripts/dns-helper.sh analytics cloudflare personal example.com
+./.agents/scripts/dns-helper.sh analytics cloudflare personal example.com
 
 # Generate DNS report
-./.agent/scripts/dns-helper.sh report cloudflare personal example.com
+./.agents/scripts/dns-helper.sh report cloudflare personal example.com
 
 # Export DNS configuration
-./.agent/scripts/dns-helper.sh export cloudflare personal example.com > dns-backup.json
+./.agents/scripts/dns-helper.sh export cloudflare personal example.com > dns-backup.json
 ```
 
 ## 🔄 **Migration & Backup**
@@ -264,26 +264,26 @@ nslookup example.com 1.1.1.1
 
 ```bash
 # Export DNS records from source
-./.agent/scripts/dns-helper.sh export namecheap personal example.com > source-dns.json
+./.agents/scripts/dns-helper.sh export namecheap personal example.com > source-dns.json
 
 # Import DNS records to destination
-./.agent/scripts/dns-helper.sh import cloudflare personal example.com source-dns.json
+./.agents/scripts/dns-helper.sh import cloudflare personal example.com source-dns.json
 
 # Verify migration
-./.agent/scripts/dns-helper.sh compare example.com namecheap:personal cloudflare:personal
+./.agents/scripts/dns-helper.sh compare example.com namecheap:personal cloudflare:personal
 ```
 
 ### **Backup & Restore:**
 
 ```bash
 # Backup DNS configuration
-./.agent/scripts/dns-helper.sh backup cloudflare personal example.com
+./.agents/scripts/dns-helper.sh backup cloudflare personal example.com
 
 # Restore DNS configuration
-./.agent/scripts/dns-helper.sh restore cloudflare personal example.com backup-file.json
+./.agents/scripts/dns-helper.sh restore cloudflare personal example.com backup-file.json
 
 # Schedule automated backups
-./.agent/scripts/dns-helper.sh schedule-backup cloudflare personal daily
+./.agents/scripts/dns-helper.sh schedule-backup cloudflare personal daily
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/domain-purchasing.md b/.agents/services/hosting/domain-purchasing.md
similarity index 79%
rename from .agent/services/hosting/domain-purchasing.md
rename to .agents/services/hosting/domain-purchasing.md
index cd894e77b..62792c46c 100644
--- a/.agent/services/hosting/domain-purchasing.md
+++ b/.agents/services/hosting/domain-purchasing.md
@@ -97,39 +97,39 @@ Comprehensive domain purchasing, availability checking, and management across mu
 
 ```bash
 # Check single domain availability
-./.agent/scripts/spaceship-helper.sh check-availability personal example.com
+./.agents/scripts/spaceship-helper.sh check-availability personal example.com
 
 # Bulk check multiple domains
-./.agent/scripts/spaceship-helper.sh bulk-check personal example.com example.net example.org
+./.agents/scripts/spaceship-helper.sh bulk-check personal example.com example.net example.org
 
 # Check with pricing information
-./.agent/scripts/spaceship-helper.sh check-availability personal premium-domain.com
+./.agents/scripts/spaceship-helper.sh check-availability personal premium-domain.com
 ```
 
 ### **Domain Purchasing:**
 
 ```bash
 # Purchase domain (with confirmation prompt)
-./.agent/scripts/spaceship-helper.sh purchase personal mynewdomain.com 1 true
+./.agents/scripts/spaceship-helper.sh purchase personal mynewdomain.com 1 true
 
 # Purchase domain for multiple years
-./.agent/scripts/spaceship-helper.sh purchase personal longterm-project.com 3 true
+./.agents/scripts/spaceship-helper.sh purchase personal longterm-project.com 3 true
 
 # Purchase without auto-renewal
-./.agent/scripts/spaceship-helper.sh purchase personal temporary-project.com 1 false
+./.agents/scripts/spaceship-helper.sh purchase personal temporary-project.com 1 false
 ```
 
 ### **Domain Portfolio Management:**
 
 ```bash
 # List all registered domains
-./.agent/scripts/spaceship-helper.sh domains personal
+./.agents/scripts/spaceship-helper.sh domains personal
 
 # Get domain details including expiration
-./.agent/scripts/spaceship-helper.sh domain-details personal mydomain.com
+./.agents/scripts/spaceship-helper.sh domain-details personal mydomain.com
 
 # Monitor domains expiring soon
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 30
+./.agents/scripts/spaceship-helper.sh monitor-expiration personal 30
 ```
 
 ## 🛡️ **Purchasing Security & Best Practices**
@@ -138,7 +138,7 @@ Comprehensive domain purchasing, availability checking, and management across mu
 
 ```bash
 # Example purchase flow with confirmation:
-$ ./.agent/scripts/spaceship-helper.sh purchase personal newproject.com 1 true
+$ ./.agents/scripts/spaceship-helper.sh purchase personal newproject.com 1 true
 
 [INFO] Checking availability before purchase...
 [SUCCESS] Domain newproject.com is available for registration
@@ -178,12 +178,12 @@ y
 
 ```bash
 # Comprehensive domain research
-./.agent/scripts/spaceship-helper.sh bulk-check personal \
+./.agents/scripts/spaceship-helper.sh bulk-check personal \
   myproject.com myproject.net myproject.org \
   myproject.io myproject.app myproject.dev
 
 # Check premium domain pricing
-./.agent/scripts/spaceship-helper.sh check-availability personal premium-name.com
+./.agents/scripts/spaceship-helper.sh check-availability personal premium-name.com
 ```
 
 ### **TLD Recommendations:**
@@ -227,7 +227,7 @@ The AI assistant can help with:
 
 ```bash
 # AI can manage domains by project:
-./.agent/scripts/setup-wizard-helper.sh assess
+./.agents/scripts/setup-wizard-helper.sh assess
 # Based on project type, AI recommends and can purchase:
 # - Primary domain (.com)
 # - Development domain (.dev)
@@ -241,22 +241,22 @@ The AI assistant can help with:
 
 ```bash
 # Get comprehensive portfolio overview
-./.agent/scripts/spaceship-helper.sh domains personal
+./.agents/scripts/spaceship-helper.sh domains personal
 
 # Monitor expiration dates
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 60
+./.agents/scripts/spaceship-helper.sh monitor-expiration personal 60
 
 # Audit domain configuration
-./.agent/scripts/spaceship-helper.sh audit personal mydomain.com
+./.agents/scripts/spaceship-helper.sh audit personal mydomain.com
 ```
 
 ### **Cost Analysis:**
 
 ```bash
 # Calculate total domain costs
-for domain in $(./.agent/scripts/spaceship-helper.sh domains personal | awk '{print $1}'); do
+for domain in $(./.agents/scripts/spaceship-helper.sh domains personal | awk '{print $1}'); do
     echo "Analyzing costs for: $domain"
-    ./.agent/scripts/spaceship-helper.sh domain-details personal $domain | grep -E "(price|renewal|expiration)"
+    ./.agents/scripts/spaceship-helper.sh domain-details personal $domain | grep -E "(price|renewal|expiration)"
 done
 ```
 
@@ -267,32 +267,32 @@ done
 ```bash
 # Complete project setup with domain
 1. Domain research and purchase:
-   ./.agent/scripts/spaceship-helper.sh bulk-check personal myproject.com myproject.dev
-   ./.agent/scripts/spaceship-helper.sh purchase personal myproject.com 1 true
+   ./.agents/scripts/spaceship-helper.sh bulk-check personal myproject.com myproject.dev
+   ./.agents/scripts/spaceship-helper.sh purchase personal myproject.com 1 true
 
 2. DNS configuration:
-   ./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
-   ./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com www CNAME myproject.com
+   ./.agents/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
+   ./.agents/scripts/dns-helper.sh add cloudflare personal myproject.com www CNAME myproject.com
 
 3. SSL certificate setup:
    # Automatic with Cloudflare or manual certificate installation
 
 4. Project deployment:
-   ./.agent/scripts/coolify-helper.sh deploy production myproject myproject.com
+   ./.agents/scripts/coolify-helper.sh deploy production myproject myproject.com
 ```
 
 ### **Multi-Environment Domain Strategy:**
 
 ```bash
 # Purchase domains for different environments
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.com 1 true      # Production
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.dev 1 true     # Development
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.app 1 true     # Mobile app
+./.agents/scripts/spaceship-helper.sh purchase personal myproject.com 1 true      # Production
+./.agents/scripts/spaceship-helper.sh purchase personal myproject.dev 1 true     # Development
+./.agents/scripts/spaceship-helper.sh purchase personal myproject.app 1 true     # Mobile app
 
 # Configure DNS for each environment
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.dev @ A 192.168.1.101
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.app @ A 192.168.1.102
+./.agents/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
+./.agents/scripts/dns-helper.sh add cloudflare personal myproject.dev @ A 192.168.1.101
+./.agents/scripts/dns-helper.sh add cloudflare personal myproject.app @ A 192.168.1.102
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/hetzner.md b/.agents/services/hosting/hetzner.md
similarity index 100%
rename from .agent/services/hosting/hetzner.md
rename to .agents/services/hosting/hetzner.md
diff --git a/.agent/services/hosting/hostinger.md b/.agents/services/hosting/hostinger.md
similarity index 77%
rename from .agent/services/hosting/hostinger.md
rename to .agents/services/hosting/hostinger.md
index cfc9bf90c..3eedcfe61 100644
--- a/.agent/services/hosting/hostinger.md
+++ b/.agents/services/hosting/hostinger.md
@@ -99,42 +99,42 @@ sudo apt-get install sshpass  # Linux
 
 ```bash
 # List all Hostinger sites
-./.agent/scripts/hostinger-helper.sh list
+./.agents/scripts/hostinger-helper.sh list
 
 # Connect to a site
-./.agent/scripts/hostinger-helper.sh connect example.com
+./.agents/scripts/hostinger-helper.sh connect example.com
 
 # Upload files to a site
-./.agent/scripts/hostinger-helper.sh upload example.com /local/path /remote/path
+./.agents/scripts/hostinger-helper.sh upload example.com /local/path /remote/path
 
 # Download files from a site
-./.agent/scripts/hostinger-helper.sh download example.com /remote/path /local/path
+./.agents/scripts/hostinger-helper.sh download example.com /remote/path /local/path
 
 # Execute command on server
-./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la'
+./.agents/scripts/hostinger-helper.sh exec example.com 'ls -la'
 ```
 
 ### **File Management:**
 
 ```bash
 # Upload website files
-./.agent/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
+./.agents/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
 
 # Backup website
-./.agent/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backup/
+./.agents/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backup/
 
 # Update specific files
-./.agent/scripts/hostinger-helper.sh upload example.com ./index.html /domains/example.com/public_html/index.html
+./.agents/scripts/hostinger-helper.sh upload example.com ./index.html /domains/example.com/public_html/index.html
 ```
 
 ### **Database Operations:**
 
 ```bash
 # Access MySQL (if available)
-./.agent/scripts/hostinger-helper.sh exec example.com 'mysql -u username -p database_name'
+./.agents/scripts/hostinger-helper.sh exec example.com 'mysql -u username -p database_name'
 
 # Backup database
-./.agent/scripts/hostinger-helper.sh exec example.com 'mysqldump -u username -p database_name > backup.sql'
+./.agents/scripts/hostinger-helper.sh exec example.com 'mysqldump -u username -p database_name > backup.sql'
 ```
 
 ## 🛡️ **Security Considerations**
@@ -157,8 +157,8 @@ sudo apt-get install sshpass  # Linux
 
 ```bash
 # Set proper permissions for web files
-./.agent/scripts/hostinger-helper.sh exec example.com 'chmod 644 /domains/example.com/public_html/*.html'
-./.agent/scripts/hostinger-helper.sh exec example.com 'chmod 755 /domains/example.com/public_html/scripts/'
+./.agents/scripts/hostinger-helper.sh exec example.com 'chmod 644 /domains/example.com/public_html/*.html'
+./.agents/scripts/hostinger-helper.sh exec example.com 'chmod 755 /domains/example.com/public_html/scripts/'
 ```
 
 ## 🔍 **Troubleshooting**
@@ -185,13 +185,13 @@ sudo apt-get install sshpass  # Linux
 
 ```bash
 # Check destination path exists
-./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/'
+./.agents/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/'
 
 # Verify disk space
-./.agent/scripts/hostinger-helper.sh exec example.com 'df -h'
+./.agents/scripts/hostinger-helper.sh exec example.com 'df -h'
 
 # Check file permissions
-./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
+./.agents/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
 ```
 
 ## 📊 **Performance Optimization**
@@ -200,14 +200,14 @@ sudo apt-get install sshpass  # Linux
 
 ```bash
 # Enable compression (if supported)
-./.agent/scripts/hostinger-helper.sh exec example.com 'echo "gzip on;" >> /domains/example.com/.htaccess'
+./.agents/scripts/hostinger-helper.sh exec example.com 'echo "gzip on;" >> /domains/example.com/.htaccess'
 
 # Optimize images before upload
 # Use tools like imagemin or tinypng before uploading
 
 # Monitor resource usage
-./.agent/scripts/hostinger-helper.sh exec example.com 'top'
-./.agent/scripts/hostinger-helper.sh exec example.com 'df -h'
+./.agents/scripts/hostinger-helper.sh exec example.com 'top'
+./.agents/scripts/hostinger-helper.sh exec example.com 'df -h'
 ```
 
 ### **Caching Strategies:**
@@ -225,7 +225,7 @@ sudo apt-get install sshpass  # Linux
 # Create backup script
 #!/bin/bash
 DATE=$(date +%Y%m%d_%H%M%S)
-./.agent/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backups/example.com_$DATE/
+./.agents/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backups/example.com_$DATE/
 ```
 
 ### **Deployment Workflow:**
@@ -233,10 +233,10 @@ DATE=$(date +%Y%m%d_%H%M%S)
 ```bash
 # Build and deploy
 npm run build
-./.agent/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
+./.agents/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
 
 # Verify deployment
-./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
+./.agents/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/localhost.md b/.agents/services/hosting/localhost.md
similarity index 80%
rename from .agent/services/hosting/localhost.md
rename to .agents/services/hosting/localhost.md
index dd71eaa8c..27c31a3de 100644
--- a/.agent/services/hosting/localhost.md
+++ b/.agents/services/hosting/localhost.md
@@ -168,67 +168,67 @@ cp configs/localhost-config.json.txt configs/localhost-config.json
 
 ```bash
 # List local environments
-./.agent/scripts/localhost-helper.sh environments
+./.agents/scripts/localhost-helper.sh environments
 
 # Start local environment
-./.agent/scripts/localhost-helper.sh start wordpress
+./.agents/scripts/localhost-helper.sh start wordpress
 
 # Stop local environment
-./.agent/scripts/localhost-helper.sh stop wordpress
+./.agents/scripts/localhost-helper.sh stop wordpress
 
 # Get environment status
-./.agent/scripts/localhost-helper.sh status wordpress
+./.agents/scripts/localhost-helper.sh status wordpress
 ```
 
 ### **LocalWP Integration:**
 
 ```bash
 # List LocalWP sites
-./.agent/scripts/localhost-helper.sh localwp-sites
+./.agents/scripts/localhost-helper.sh localwp-sites
 
 # Start LocalWP site
-./.agent/scripts/localhost-helper.sh start-site mysite.local
+./.agents/scripts/localhost-helper.sh start-site mysite.local
 
 # Stop LocalWP site
-./.agent/scripts/localhost-helper.sh stop-site mysite.local
+./.agents/scripts/localhost-helper.sh stop-site mysite.local
 
 # Get site info
-./.agent/scripts/localhost-helper.sh site-info mysite.local
+./.agents/scripts/localhost-helper.sh site-info mysite.local
 
 # Start MCP server for LocalWP
-./.agent/scripts/localhost-helper.sh start-mcp
+./.agents/scripts/localhost-helper.sh start-mcp
 ```
 
 ### **SSL Management:**
 
 ```bash
 # Generate local SSL certificate
-./.agent/scripts/localhost-helper.sh generate-ssl mysite.local
+./.agents/scripts/localhost-helper.sh generate-ssl mysite.local
 
 # Install SSL certificate
-./.agent/scripts/localhost-helper.sh install-ssl mysite.local
+./.agents/scripts/localhost-helper.sh install-ssl mysite.local
 
 # List SSL certificates
-./.agent/scripts/localhost-helper.sh list-ssl
+./.agents/scripts/localhost-helper.sh list-ssl
 
 # Renew SSL certificate
-./.agent/scripts/localhost-helper.sh renew-ssl mysite.local
+./.agents/scripts/localhost-helper.sh renew-ssl mysite.local
 ```
 
 ### **Port Management:**
 
 ```bash
 # List active ports
-./.agent/scripts/localhost-helper.sh list-ports
+./.agents/scripts/localhost-helper.sh list-ports
 
 # Check port availability
-./.agent/scripts/localhost-helper.sh check-port 3000
+./.agents/scripts/localhost-helper.sh check-port 3000
 
 # Kill process on port
-./.agent/scripts/localhost-helper.sh kill-port 3000
+./.agents/scripts/localhost-helper.sh kill-port 3000
 
 # Forward port
-./.agent/scripts/localhost-helper.sh forward-port 3000 8080
+./.agents/scripts/localhost-helper.sh forward-port 3000 8080
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -245,16 +245,16 @@ cp configs/localhost-config.json.txt configs/localhost-config.json
 
 ```bash
 # Generate development CA
-./.agent/scripts/localhost-helper.sh generate-ca
+./.agents/scripts/localhost-helper.sh generate-ca
 
 # Create site certificate
-./.agent/scripts/localhost-helper.sh create-cert mysite.local
+./.agents/scripts/localhost-helper.sh create-cert mysite.local
 
 # Trust certificate in system
-./.agent/scripts/localhost-helper.sh trust-cert mysite.local
+./.agents/scripts/localhost-helper.sh trust-cert mysite.local
 
 # Verify certificate
-./.agent/scripts/localhost-helper.sh verify-cert mysite.local
+./.agents/scripts/localhost-helper.sh verify-cert mysite.local
 ```
 
 ## 🔍 **Troubleshooting**
@@ -282,10 +282,10 @@ ping mysite.local
 openssl x509 -in cert.pem -text -noout
 
 # Verify certificate chain
-./.agent/scripts/localhost-helper.sh verify-chain mysite.local
+./.agents/scripts/localhost-helper.sh verify-chain mysite.local
 
 # Regenerate certificate
-./.agent/scripts/localhost-helper.sh regenerate-ssl mysite.local
+./.agents/scripts/localhost-helper.sh regenerate-ssl mysite.local
 ```
 
 #### **Port Conflicts:**
@@ -296,10 +296,10 @@ lsof -i :3000
 netstat -tulpn | grep :3000
 
 # Kill conflicting process
-./.agent/scripts/localhost-helper.sh kill-port 3000
+./.agents/scripts/localhost-helper.sh kill-port 3000
 
 # Use alternative port
-./.agent/scripts/localhost-helper.sh start-on-port mysite.local 3001
+./.agents/scripts/localhost-helper.sh start-on-port mysite.local 3001
 ```
 
 ## 📊 **Development Workflow**
@@ -308,32 +308,32 @@ netstat -tulpn | grep :3000
 
 ```bash
 # Start development stack
-./.agent/scripts/localhost-helper.sh start-stack development
+./.agents/scripts/localhost-helper.sh start-stack development
 
 # Stop development stack
-./.agent/scripts/localhost-helper.sh stop-stack development
+./.agents/scripts/localhost-helper.sh stop-stack development
 
 # Restart services
-./.agent/scripts/localhost-helper.sh restart-services
+./.agents/scripts/localhost-helper.sh restart-services
 
 # Check service health
-./.agent/scripts/localhost-helper.sh health-check
+./.agents/scripts/localhost-helper.sh health-check
 ```
 
 ### **Project Management:**
 
 ```bash
 # Create new project
-./.agent/scripts/localhost-helper.sh create-project myproject
+./.agents/scripts/localhost-helper.sh create-project myproject
 
 # Clone project template
-./.agent/scripts/localhost-helper.sh clone-template react-app myproject
+./.agents/scripts/localhost-helper.sh clone-template react-app myproject
 
 # Set up project environment
-./.agent/scripts/localhost-helper.sh setup-env myproject
+./.agents/scripts/localhost-helper.sh setup-env myproject
 
 # Start project services
-./.agent/scripts/localhost-helper.sh start-project myproject
+./.agents/scripts/localhost-helper.sh start-project myproject
 ```
 
 ## 🔄 **Integration & Automation**
@@ -342,32 +342,32 @@ netstat -tulpn | grep :3000
 
 ```bash
 # Start LocalWP MCP server
-./.agent/scripts/localhost-helper.sh start-mcp
+./.agents/scripts/localhost-helper.sh start-mcp
 
 # Test MCP connection
-./.agent/scripts/localhost-helper.sh test-mcp
+./.agents/scripts/localhost-helper.sh test-mcp
 
 # Query WordPress database via MCP
-./.agent/scripts/localhost-helper.sh mcp-query "SELECT * FROM wp_posts LIMIT 5"
+./.agents/scripts/localhost-helper.sh mcp-query "SELECT * FROM wp_posts LIMIT 5"
 
 # Stop MCP server
-./.agent/scripts/localhost-helper.sh stop-mcp
+./.agents/scripts/localhost-helper.sh stop-mcp
 ```
 
 ### **Docker Integration:**
 
 ```bash
 # Start Docker development environment
-./.agent/scripts/localhost-helper.sh docker-up myproject
+./.agents/scripts/localhost-helper.sh docker-up myproject
 
 # Stop Docker environment
-./.agent/scripts/localhost-helper.sh docker-down myproject
+./.agents/scripts/localhost-helper.sh docker-down myproject
 
 # View Docker logs
-./.agent/scripts/localhost-helper.sh docker-logs myproject
+./.agents/scripts/localhost-helper.sh docker-logs myproject
 
 # Execute command in container
-./.agent/scripts/localhost-helper.sh docker-exec myproject "npm test"
+./.agents/scripts/localhost-helper.sh docker-exec myproject "npm test"
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/proxmox-full-skill.md b/.agents/services/hosting/proxmox-full-skill.md
similarity index 100%
rename from .agent/services/hosting/proxmox-full-skill.md
rename to .agents/services/hosting/proxmox-full-skill.md
diff --git a/.agent/services/hosting/spaceship.md b/.agents/services/hosting/spaceship.md
similarity index 74%
rename from .agent/services/hosting/spaceship.md
rename to .agents/services/hosting/spaceship.md
index 49c7557ab..c40f501d3 100644
--- a/.agent/services/hosting/spaceship.md
+++ b/.agents/services/hosting/spaceship.md
@@ -89,7 +89,7 @@ cp configs/spaceship-config.json.txt configs/spaceship-config.json
 1. **Login to Spaceship Dashboard**
 2. **Navigate to API Settings**
 3. **Generate API Key and Secret**
-4. **Store securely**: `bash .agent/scripts/setup-local-api-keys.sh set spaceship YOUR_API_KEY`
+4. **Store securely**: `bash .agents/scripts/setup-local-api-keys.sh set spaceship YOUR_API_KEY`
 5. **Test access** with the helper script
 
 ## 🚀 **Usage Examples**
@@ -98,77 +98,77 @@ cp configs/spaceship-config.json.txt configs/spaceship-config.json
 
 ```bash
 # List all Spaceship accounts
-./.agent/scripts/spaceship-helper.sh accounts
+./.agents/scripts/spaceship-helper.sh accounts
 
 # List domains for account
-./.agent/scripts/spaceship-helper.sh domains personal
+./.agents/scripts/spaceship-helper.sh domains personal
 
 # Get domain details
-./.agent/scripts/spaceship-helper.sh domain-details personal example.com
+./.agents/scripts/spaceship-helper.sh domain-details personal example.com
 
 # Audit complete domain configuration
-./.agent/scripts/spaceship-helper.sh audit personal example.com
+./.agents/scripts/spaceship-helper.sh audit personal example.com
 ```
 
 ### **DNS Management:**
 
 ```bash
 # List DNS records
-./.agent/scripts/spaceship-helper.sh dns-records personal example.com
+./.agents/scripts/spaceship-helper.sh dns-records personal example.com
 
 # Add DNS record
-./.agent/scripts/spaceship-helper.sh add-dns personal example.com www A 192.168.1.100 3600
+./.agents/scripts/spaceship-helper.sh add-dns personal example.com www A 192.168.1.100 3600
 
 # Update DNS record
-./.agent/scripts/spaceship-helper.sh update-dns personal example.com record-id www A 192.168.1.101 3600
+./.agents/scripts/spaceship-helper.sh update-dns personal example.com record-id www A 192.168.1.101 3600
 
 # Delete DNS record
-./.agent/scripts/spaceship-helper.sh delete-dns personal example.com record-id
+./.agents/scripts/spaceship-helper.sh delete-dns personal example.com record-id
 ```
 
 ### **Nameserver Management:**
 
 ```bash
 # Get current nameservers
-./.agent/scripts/spaceship-helper.sh nameservers personal example.com
+./.agents/scripts/spaceship-helper.sh nameservers personal example.com
 
 # Update to Cloudflare nameservers
-./.agent/scripts/spaceship-helper.sh update-ns personal example.com ns1.cloudflare.com ns2.cloudflare.com
+./.agents/scripts/spaceship-helper.sh update-ns personal example.com ns1.cloudflare.com ns2.cloudflare.com
 
 # Update to Route 53 nameservers
-./.agent/scripts/spaceship-helper.sh update-ns personal example.com ns-1.awsdns-01.com ns-2.awsdns-02.net ns-3.awsdns-03.org ns-4.awsdns-04.co.uk
+./.agents/scripts/spaceship-helper.sh update-ns personal example.com ns-1.awsdns-01.com ns-2.awsdns-02.net ns-3.awsdns-03.org ns-4.awsdns-04.co.uk
 ```
 
 ### **Domain Management:**
 
 ```bash
 # Check domain availability
-./.agent/scripts/spaceship-helper.sh check-availability personal newdomain.com
+./.agents/scripts/spaceship-helper.sh check-availability personal newdomain.com
 
 # Get domain contacts
-./.agent/scripts/spaceship-helper.sh contacts personal example.com
+./.agents/scripts/spaceship-helper.sh contacts personal example.com
 
 # Lock domain
-./.agent/scripts/spaceship-helper.sh lock personal example.com
+./.agents/scripts/spaceship-helper.sh lock personal example.com
 
 # Unlock domain
-./.agent/scripts/spaceship-helper.sh unlock personal example.com
+./.agents/scripts/spaceship-helper.sh unlock personal example.com
 
 # Check transfer status
-./.agent/scripts/spaceship-helper.sh transfer-status personal example.com
+./.agents/scripts/spaceship-helper.sh transfer-status personal example.com
 ```
 
 ### **Monitoring & Automation:**
 
 ```bash
 # Monitor domain expiration (30 days warning)
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 30
+./.agents/scripts/spaceship-helper.sh monitor-expiration personal 30
 
 # Monitor domain expiration (60 days warning)
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 60
+./.agents/scripts/spaceship-helper.sh monitor-expiration personal 60
 
 # Audit all aspects of a domain
-./.agent/scripts/spaceship-helper.sh audit personal example.com
+./.agents/scripts/spaceship-helper.sh audit personal example.com
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -186,13 +186,13 @@ cp configs/spaceship-config.json.txt configs/spaceship-config.json
 
 ```bash
 # Enable domain lock for protection
-./.agent/scripts/spaceship-helper.sh lock personal example.com
+./.agents/scripts/spaceship-helper.sh lock personal example.com
 
 # Monitor transfer status
-./.agent/scripts/spaceship-helper.sh transfer-status personal example.com
+./.agents/scripts/spaceship-helper.sh transfer-status personal example.com
 
 # Regular security audit
-./.agent/scripts/spaceship-helper.sh audit personal example.com
+./.agents/scripts/spaceship-helper.sh audit personal example.com
 ```
 
 ### **DNS Security:**
@@ -210,7 +210,7 @@ cp configs/spaceship-config.json.txt configs/spaceship-config.json
 
 ```bash
 # Verify API credentials
-./.agent/scripts/spaceship-helper.sh accounts
+./.agents/scripts/spaceship-helper.sh accounts
 
 # Check API key permissions in Spaceship dashboard
 # Ensure API key has required permissions for operations
@@ -220,10 +220,10 @@ cp configs/spaceship-config.json.txt configs/spaceship-config.json
 
 ```bash
 # Check DNS records
-./.agent/scripts/spaceship-helper.sh dns-records personal example.com
+./.agents/scripts/spaceship-helper.sh dns-records personal example.com
 
 # Verify nameservers
-./.agent/scripts/spaceship-helper.sh nameservers personal example.com
+./.agents/scripts/spaceship-helper.sh nameservers personal example.com
 
 # Check DNS propagation externally
 dig @8.8.8.8 example.com
@@ -234,13 +234,13 @@ nslookup example.com 8.8.8.8
 
 ```bash
 # Check domain status
-./.agent/scripts/spaceship-helper.sh domain-details personal example.com
+./.agents/scripts/spaceship-helper.sh domain-details personal example.com
 
 # Verify domain lock status
-./.agent/scripts/spaceship-helper.sh audit personal example.com
+./.agents/scripts/spaceship-helper.sh audit personal example.com
 
 # Check transfer status if domain issues persist
-./.agent/scripts/spaceship-helper.sh transfer-status personal example.com
+./.agents/scripts/spaceship-helper.sh transfer-status personal example.com
 ```
 
 ## 📊 **Monitoring & Analytics**
@@ -249,11 +249,11 @@ nslookup example.com 8.8.8.8
 
 ```bash
 # Monitor all domains for expiration
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 30
+./.agents/scripts/spaceship-helper.sh monitor-expiration personal 30
 
 # Audit multiple domains
 for domain in example.com another.com; do
-    ./.agent/scripts/spaceship-helper.sh audit personal $domain
+    ./.agents/scripts/spaceship-helper.sh audit personal $domain
 done
 ```
 
@@ -266,7 +266,7 @@ ACCOUNT="personal"
 THRESHOLD=30
 
 # Check expiring domains
-EXPIRING=$(./.agent/scripts/spaceship-helper.sh monitor-expiration $ACCOUNT $THRESHOLD)
+EXPIRING=$(./.agents/scripts/spaceship-helper.sh monitor-expiration $ACCOUNT $THRESHOLD)
 
 if [[ -n "$EXPIRING" ]]; then
     echo "Domains expiring soon:"
@@ -288,20 +288,20 @@ fi
 
 ```bash
 # Backup DNS records for a domain
-./.agent/scripts/spaceship-helper.sh dns-records personal example.com > dns-backup-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/spaceship-helper.sh dns-records personal example.com > dns-backup-example.com-$(date +%Y%m%d).txt
 
 # Backup all domain configurations
-./.agent/scripts/spaceship-helper.sh audit personal example.com > domain-audit-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/spaceship-helper.sh audit personal example.com > domain-audit-example.com-$(date +%Y%m%d).txt
 ```
 
 ### **Configuration Backup:**
 
 ```bash
 # Export domain list
-./.agent/scripts/spaceship-helper.sh domains personal > domains-backup-$(date +%Y%m%d).txt
+./.agents/scripts/spaceship-helper.sh domains personal > domains-backup-$(date +%Y%m%d).txt
 
 # Backup nameserver configurations
-./.agent/scripts/spaceship-helper.sh nameservers personal example.com > ns-backup-example.com-$(date +%Y%m%d).txt
+./.agents/scripts/spaceship-helper.sh nameservers personal example.com > ns-backup-example.com-$(date +%Y%m%d).txt
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/services/hosting/webhosting.md b/.agents/services/hosting/webhosting.md
similarity index 89%
rename from .agent/services/hosting/webhosting.md
rename to .agents/services/hosting/webhosting.md
index c4022f79a..496b9437f 100644
--- a/.agent/services/hosting/webhosting.md
+++ b/.agents/services/hosting/webhosting.md
@@ -18,12 +18,12 @@ tools:
 ## Quick Reference
 
 - **Purpose**: Local domain management for ~/Git projects with SSL
-- **Script**: `.agent/scripts/webhosting-helper.sh`
+- **Script**: `.agents/scripts/webhosting-helper.sh`
 - **Config**: `configs/webhosting-config.json`
 - **Requires**: LocalWP or nginx, OpenSSL, sudo access
 
 **Commands**: `setup|list|remove`
-**Usage**: `./.agent/scripts/webhosting-helper.sh setup PROJECT_NAME [PORT]`
+**Usage**: `./.agents/scripts/webhosting-helper.sh setup PROJECT_NAME [PORT]`
 
 **Frameworks** (auto-detected):
 - Next.js/React/Vue/Nuxt: port 3000
@@ -73,7 +73,7 @@ The Web Hosting Helper provides seamless local domain management for web applica
 2. **Make script executable**:
 
    ```bash
-   chmod +x .agent/scripts/webhosting-helper.sh
+   chmod +x .agents/scripts/webhosting-helper.sh
    ```
 
 ## 📖 Usage
@@ -82,22 +82,22 @@ The Web Hosting Helper provides seamless local domain management for web applica
 
 ```bash
 # Auto-detect framework and port
-./.agent/scripts/webhosting-helper.sh setup myapp
+./.agents/scripts/webhosting-helper.sh setup myapp
 
 # Specify custom port
-./.agent/scripts/webhosting-helper.sh setup myapp 3001
+./.agents/scripts/webhosting-helper.sh setup myapp 3001
 
 # Examples for different frameworks
-./.agent/scripts/webhosting-helper.sh setup nextjs-app 3000
-./.agent/scripts/webhosting-helper.sh setup vue-project 3000
-./.agent/scripts/webhosting-helper.sh setup svelte-app 5173
-./.agent/scripts/webhosting-helper.sh setup django-api 8000
+./.agents/scripts/webhosting-helper.sh setup nextjs-app 3000
+./.agents/scripts/webhosting-helper.sh setup vue-project 3000
+./.agents/scripts/webhosting-helper.sh setup svelte-app 5173
+./.agents/scripts/webhosting-helper.sh setup django-api 8000
 ```
 
 ### List Configured Domains
 
 ```bash
-./.agent/scripts/webhosting-helper.sh list
+./.agents/scripts/webhosting-helper.sh list
 ```
 
 Output example:
@@ -110,7 +110,7 @@ Output example:
 ### Remove a Domain
 
 ```bash
-./.agent/scripts/webhosting-helper.sh remove myapp
+./.agents/scripts/webhosting-helper.sh remove myapp
 ```
 
 ## 🔧 Framework Support
@@ -182,7 +182,7 @@ When setting up a local domain for an AI agent, follow these exact steps:
 1. **Run the setup command**:
 
    ```bash
-   ./.agent/scripts/webhosting-helper.sh setup PROJECT_NAME PORT
+   ./.agents/scripts/webhosting-helper.sh setup PROJECT_NAME PORT
    ```
 
 2. **⚠️ CRITICAL: Add domain to hosts file**:
@@ -230,7 +230,7 @@ When setting up a local domain for an AI agent, follow these exact steps:
 
 ```bash
 # 1. Setup domain
-./.agent/scripts/webhosting-helper.sh setup myapp 3000
+./.agents/scripts/webhosting-helper.sh setup myapp 3000
 
 # 2. Add to hosts file (REQUIRED - run in separate terminal)
 echo "127.0.0.1 myapp.local" | sudo tee -a /etc/hosts
@@ -269,7 +269,7 @@ open https://localwp.com/
 lsof -i :3000
 
 # Use a different port
-./.agent/scripts/webhosting-helper.sh setup myapp 3001
+./.agents/scripts/webhosting-helper.sh setup myapp 3001
 ```
 
 ### SSL Certificate Issues
@@ -277,7 +277,7 @@ lsof -i :3000
 ```bash
 # Regenerate certificates
 rm ~/.localhost-setup/certs/myapp.local.*
-./.agent/scripts/webhosting-helper.sh setup myapp
+./.agents/scripts/webhosting-helper.sh setup myapp
 ```
 
 ### Build Errors (Framework-Specific)
@@ -307,7 +307,7 @@ PORT=PORT_NUMBER pnpm dev
 
    ```bash
    cd ~/Git/aidevops
-   ./.agent/scripts/webhosting-helper.sh setup myapp
+   ./.agents/scripts/webhosting-helper.sh setup myapp
    ```
 
 3. **Start development server**:
diff --git a/.agent/services/monitoring/sentry.md b/.agents/services/monitoring/sentry.md
similarity index 100%
rename from .agent/services/monitoring/sentry.md
rename to .agents/services/monitoring/sentry.md
diff --git a/.agent/services/monitoring/socket.md b/.agents/services/monitoring/socket.md
similarity index 100%
rename from .agent/services/monitoring/socket.md
rename to .agents/services/monitoring/socket.md
diff --git a/.agent/social-media.md b/.agents/social-media.md
similarity index 100%
rename from .agent/social-media.md
rename to .agents/social-media.md
diff --git a/.agent/subagent-index.toon b/.agents/subagent-index.toon
similarity index 100%
rename from .agent/subagent-index.toon
rename to .agents/subagent-index.toon
diff --git a/.agent/templates/plans-template.md b/.agents/templates/plans-template.md
similarity index 100%
rename from .agent/templates/plans-template.md
rename to .agents/templates/plans-template.md
diff --git a/.agent/templates/prd-template.md b/.agents/templates/prd-template.md
similarity index 100%
rename from .agent/templates/prd-template.md
rename to .agents/templates/prd-template.md
diff --git a/.agent/templates/tasks-template.md b/.agents/templates/tasks-template.md
similarity index 98%
rename from .agent/templates/tasks-template.md
rename to .agents/templates/tasks-template.md
index 72a749497..fa03f403e 100644
--- a/.agent/templates/tasks-template.md
+++ b/.agents/templates/tasks-template.md
@@ -63,7 +63,7 @@ Update after completing each sub-task, not just parent tasks.
   - [ ] 5.3 Update CHANGELOG.md ~{Xm}
 
 - [ ] 6.0 Quality & Review ~{Xm} (ai:{Xm} test:{Xm})
-  - [ ] 6.1 Run linters: `.agent/scripts/linters-local.sh` ~{Xm}
+  - [ ] 6.1 Run linters: `.agents/scripts/linters-local.sh` ~{Xm}
   - [ ] 6.2 Self-review code changes ~{Xm}
   - [ ] 6.3 Commit with descriptive message ~{Xm}
   - [ ] 6.4 Push branch and create PR ~{Xm}
diff --git a/.agent/templates/todo-template.md b/.agents/templates/todo-template.md
similarity index 100%
rename from .agent/templates/todo-template.md
rename to .agents/templates/todo-template.md
diff --git a/.agent/tools/ai-assistants/agno.md b/.agents/tools/ai-assistants/agno.md
similarity index 95%
rename from .agent/tools/ai-assistants/agno.md
rename to .agents/tools/ai-assistants/agno.md
index 525406152..d0762f41d 100644
--- a/.agent/tools/ai-assistants/agno.md
+++ b/.agents/tools/ai-assistants/agno.md
@@ -19,7 +19,7 @@ tools:
 ## Quick Reference
 
 - Agno: Enterprise AI agent operating system (AgentOS) running locally
-- Setup: `bash .agent/scripts/agno-setup.sh setup`
+- Setup: `bash .agents/scripts/agno-setup.sh setup`
 - Start: `~/.aidevops/scripts/start-agno-stack.sh`
 - Stop: `~/.aidevops/scripts/stop-agno-stack.sh`
 - Status: `~/.aidevops/scripts/agno-status.sh`
@@ -74,7 +74,7 @@ npm --version      # Requires npm
 
 ```bash
 # Run the setup script
-bash .agent/scripts/agno-setup.sh setup
+bash .agents/scripts/agno-setup.sh setup
 
 # Configure API keys
 nano ~/.aidevops/agno/.env
@@ -222,7 +222,7 @@ PORT=3000
 
 ```bash
 # Convert documents for agent processing
-bash .agent/scripts/pandoc-helper.sh batch ./docs ./agent-ready "*.{docx,pdf}"
+bash .agents/scripts/pandoc-helper.sh batch ./docs ./agent-ready "*.{docx,pdf}"
 
 # Start Agno agents
 ~/.aidevops/scripts/start-agno-stack.sh
@@ -315,7 +315,7 @@ devops_agent.knowledge_base = kb
 
 ```bash
 # Setup (one-time)
-bash .agent/scripts/agno-setup.sh setup
+bash .agents/scripts/agno-setup.sh setup
 
 # Service control
 ~/.aidevops/scripts/start-agno-stack.sh    # Start services
@@ -323,9 +323,9 @@ bash .agent/scripts/agno-setup.sh setup
 ~/.aidevops/scripts/agno-status.sh         # Check status
 
 # Individual components
-bash .agent/scripts/agno-setup.sh agno          # Setup only AgentOS
-bash .agent/scripts/agno-setup.sh ui            # Setup only Agent-UI
-bash .agent/scripts/agno-setup.sh check         # Check prerequisites
+bash .agents/scripts/agno-setup.sh agno          # Setup only AgentOS
+bash .agents/scripts/agno-setup.sh ui            # Setup only Agent-UI
+bash .agents/scripts/agno-setup.sh check         # Check prerequisites
 ```
 
 ### **Development Commands**
@@ -433,7 +433,7 @@ model = OpenAIChat(
 
 ```bash
 # Convert documents for agent processing
-bash .agent/scripts/pandoc-helper.sh batch ./project-docs ./agent-ready
+bash .agents/scripts/pandoc-helper.sh batch ./project-docs ./agent-ready
 
 # Ask agent to analyze converted docs
 # "Analyze the converted documentation and create a deployment checklist"
@@ -443,7 +443,7 @@ bash .agent/scripts/pandoc-helper.sh batch ./project-docs ./agent-ready
 
 ```bash
 # Get current version for agent context
-VERSION=$(bash .agent/scripts/version-manager.sh get)
+VERSION=$(bash .agents/scripts/version-manager.sh get)
 
 # Ask agent to help with release
 # "Help me prepare release notes for version $VERSION"
diff --git a/.agent/tools/ai-assistants/capsolver.md b/.agents/tools/ai-assistants/capsolver.md
similarity index 90%
rename from .agent/tools/ai-assistants/capsolver.md
rename to .agents/tools/ai-assistants/capsolver.md
index dbcd15399..ccd2d88c9 100644
--- a/.agent/tools/ai-assistants/capsolver.md
+++ b/.agents/tools/ai-assistants/capsolver.md
@@ -19,9 +19,9 @@ tools:
 ## Quick Reference
 
 - CapSolver: Automated CAPTCHA solving service (99.9% accuracy, <10s)
-- Setup: `./.agent/scripts/crawl4ai-helper.sh capsolver-setup`
+- Setup: `./.agents/scripts/crawl4ai-helper.sh capsolver-setup`
 - API key: `export CAPSOLVER_API_KEY="CAP-xxxxx"` from dashboard.capsolver.com
-- Crawl command: `./.agent/scripts/crawl4ai-helper.sh captcha-crawl URL captcha_type site_key`
+- Crawl command: `./.agents/scripts/crawl4ai-helper.sh captcha-crawl URL captcha_type site_key`
 - CAPTCHA types:
   - reCAPTCHA v2/v3: $0.5/1000 req, <9s/<3s
   - reCAPTCHA Enterprise: $1-3/1000 req
@@ -73,13 +73,13 @@ CapSolver is the world's leading automated CAPTCHA solving service that integrat
 
 ```bash
 # Setup CapSolver integration
-./.agent/scripts/crawl4ai-helper.sh capsolver-setup
+./.agents/scripts/crawl4ai-helper.sh capsolver-setup
 
 # Set API key
 export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
 
 # Crawl with CAPTCHA solving
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
 ```
 
 ### **2. Browser Extension Integration**
@@ -104,9 +104,9 @@ export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
 
 ```bash
 # Install Crawl4AI with CapSolver support
-./.agent/scripts/crawl4ai-helper.sh install
-./.agent/scripts/crawl4ai-helper.sh docker-setup
-./.agent/scripts/crawl4ai-helper.sh capsolver-setup
+./.agents/scripts/crawl4ai-helper.sh install
+./.agents/scripts/crawl4ai-helper.sh docker-setup
+./.agents/scripts/crawl4ai-helper.sh capsolver-setup
 
 # Set your API key
 export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
@@ -116,13 +116,13 @@ export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
 
 ```bash
 # Basic CAPTCHA crawling
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
 
 # Cloudflare Turnstile
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://clifford.io/demo/cloudflare-turnstile turnstile 0x4AAAAAAAGlwMzq_9z6S9Mh
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://clifford.io/demo/cloudflare-turnstile turnstile 0x4AAAAAAAGlwMzq_9z6S9Mh
 
 # AWS WAF bypass
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://nft.porsche.com/onboarding@6 aws_waf
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://nft.porsche.com/onboarding@6 aws_waf
 ```
 
 ## 📊 Usage Examples
@@ -265,7 +265,7 @@ except Exception as e:
 
 ```bash
 # Check CapSolver integration status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 
 # Test API key
 curl -X POST https://api.capsolver.com/getBalance \
@@ -286,7 +286,7 @@ docker logs crawl4ai --tail 20
 
 ### **Framework Integration**
 
-- **Helper Script**: `.agent/scripts/crawl4ai-helper.sh`
+- **Helper Script**: `.agents/scripts/crawl4ai-helper.sh`
 - **Configuration**: `configs/capsolver-config.json`
 - **Examples**: `configs/capsolver-example.py`
 - **MCP Tools**: `configs/mcp-templates/crawl4ai-mcp-config.json`
diff --git a/.agent/tools/ai-assistants/claude-code.md b/.agents/tools/ai-assistants/claude-code.md
similarity index 100%
rename from .agent/tools/ai-assistants/claude-code.md
rename to .agents/tools/ai-assistants/claude-code.md
diff --git a/.agent/tools/ai-assistants/configuration.md b/.agents/tools/ai-assistants/configuration.md
similarity index 97%
rename from .agent/tools/ai-assistants/configuration.md
rename to .agents/tools/ai-assistants/configuration.md
index 116ef11c1..ea815ed59 100644
--- a/.agent/tools/ai-assistants/configuration.md
+++ b/.agents/tools/ai-assistants/configuration.md
@@ -23,7 +23,7 @@ tools:
 - Config files: ~/.aider.conf.yml, ~/.openai/config.yaml, ~/.claude/config.json, ~/.ai-shell/config.json, ~/.litellm/config.yaml
 - Aliases: `aider-guided`, `openai-guided`, `claude-guided`, `ai-guided`, `agents`, `agents-home`, `cdai`
 - Universal wrapper: `~/.local/bin/ai-with-context <tool> [args]`
-- Setup script: `bash .agent/scripts/ai-cli-config.sh`
+- Setup script: `bash .agents/scripts/ai-cli-config.sh`
 - Auto-setup: Included in main setup.sh via `configure_ai_clis`
 - Benefits: Consistent guidance, security protocols, unified DevOps approach
 <!-- AI-CONTEXT-END -->
@@ -179,7 +179,7 @@ cdai
 The main `setup.sh` script now includes:
 
 ```bash
-configure_ai_clis    # Runs .agent/scripts/ai-cli-config.sh
+configure_ai_clis    # Runs .agents/scripts/ai-cli-config.sh
 ```
 
 ### **✅ MANUAL CONFIGURATION:**
@@ -187,7 +187,7 @@ configure_ai_clis    # Runs .agent/scripts/ai-cli-config.sh
 ```bash
 # Run AI CLI configuration script
 cd ~/Git/aidevops
-bash .agent/scripts/ai-cli-config.sh
+bash .agents/scripts/ai-cli-config.sh
 
 # Restart shell to load aliases
 source ~/.zshrc  # or ~/.bashrc
diff --git a/.agent/tools/ai-assistants/headless-dispatch.md b/.agents/tools/ai-assistants/headless-dispatch.md
similarity index 100%
rename from .agent/tools/ai-assistants/headless-dispatch.md
rename to .agents/tools/ai-assistants/headless-dispatch.md
diff --git a/.agent/tools/ai-assistants/openclaw.md b/.agents/tools/ai-assistants/openclaw.md
similarity index 100%
rename from .agent/tools/ai-assistants/openclaw.md
rename to .agents/tools/ai-assistants/openclaw.md
diff --git a/.agent/tools/ai-assistants/opencode-server.md b/.agents/tools/ai-assistants/opencode-server.md
similarity index 100%
rename from .agent/tools/ai-assistants/opencode-server.md
rename to .agents/tools/ai-assistants/opencode-server.md
diff --git a/.agent/tools/ai-assistants/overview.md b/.agents/tools/ai-assistants/overview.md
similarity index 100%
rename from .agent/tools/ai-assistants/overview.md
rename to .agents/tools/ai-assistants/overview.md
diff --git a/.agent/tools/ai-assistants/runners/README.md b/.agents/tools/ai-assistants/runners/README.md
similarity index 100%
rename from .agent/tools/ai-assistants/runners/README.md
rename to .agents/tools/ai-assistants/runners/README.md
diff --git a/.agent/tools/ai-assistants/runners/code-reviewer.md b/.agents/tools/ai-assistants/runners/code-reviewer.md
similarity index 100%
rename from .agent/tools/ai-assistants/runners/code-reviewer.md
rename to .agents/tools/ai-assistants/runners/code-reviewer.md
diff --git a/.agent/tools/ai-assistants/runners/seo-analyst.md b/.agents/tools/ai-assistants/runners/seo-analyst.md
similarity index 100%
rename from .agent/tools/ai-assistants/runners/seo-analyst.md
rename to .agents/tools/ai-assistants/runners/seo-analyst.md
diff --git a/.agent/tools/ai-assistants/status.md b/.agents/tools/ai-assistants/status.md
similarity index 97%
rename from .agent/tools/ai-assistants/status.md
rename to .agents/tools/ai-assistants/status.md
index 784a16341..275d32a4b 100644
--- a/.agent/tools/ai-assistants/status.md
+++ b/.agents/tools/ai-assistants/status.md
@@ -25,7 +25,7 @@ tools:
 - Config files: ~/.aider.conf.yml, ~/.claude/config.json, ~/.qwen/config.json, ~/.openai/config.yaml
 - Aliases: aider-guided, claude-guided, qwen-guided, openai-guided, ai-guided
 - Quick access: `agents` (view AGENTS.md), `cdai` (cd to framework)
-- Setup: Automated via setup.sh -> configure_ai_clis -> .agent/scripts/ai-cli-config.sh
+- Setup: Automated via setup.sh -> configure_ai_clis -> .agents/scripts/ai-cli-config.sh
 - Status: All tools verified working with AGENTS.md context
 <!-- AI-CONTEXT-END -->
 
@@ -122,7 +122,7 @@ alias cdai='cd ~/Git/aidevops'
 ### **✅ AUTOMATIC SETUP INTEGRATION:**
 
 - **Setup Script**: `setup.sh` includes `configure_ai_clis` function
-- **Configuration Script**: `.agent/scripts/ai-cli-config.sh`
+- **Configuration Script**: `.agents/scripts/ai-cli-config.sh`
 - **All new installations** get complete AI CLI configuration
 
 ## **🎯 COVERAGE SUMMARY:**
diff --git a/.agent/tools/ai-assistants/windsurf.md b/.agents/tools/ai-assistants/windsurf.md
similarity index 100%
rename from .agent/tools/ai-assistants/windsurf.md
rename to .agents/tools/ai-assistants/windsurf.md
diff --git a/.agent/tools/ai-orchestration/autogen.md b/.agents/tools/ai-orchestration/autogen.md
similarity index 98%
rename from .agent/tools/ai-orchestration/autogen.md
rename to .agents/tools/ai-orchestration/autogen.md
index bd9ea3fef..bc4a1eb5b 100644
--- a/.agent/tools/ai-orchestration/autogen.md
+++ b/.agents/tools/ai-orchestration/autogen.md
@@ -19,7 +19,7 @@ tools:
 
 - **Purpose**: Programming framework for agentic AI with multi-language support
 - **License**: MIT (code) / CC-BY-4.0 (docs)
-- **Setup**: `bash .agent/scripts/autogen-helper.sh setup`
+- **Setup**: `bash .agents/scripts/autogen-helper.sh setup`
 - **Start**: `~/.aidevops/scripts/start-autogen-studio.sh`
 - **Stop**: `~/.aidevops/scripts/stop-autogen-studio.sh`
 - **Status**: `~/.aidevops/scripts/autogen-status.sh`
@@ -55,7 +55,7 @@ AutoGen uses a layered design:
 
 ```bash
 # Run the setup script
-bash .agent/scripts/autogen-helper.sh setup
+bash .agents/scripts/autogen-helper.sh setup
 
 # Configure API keys
 nano ~/.aidevops/autogen/.env
diff --git a/.agent/tools/ai-orchestration/crewai.md b/.agents/tools/ai-orchestration/crewai.md
similarity index 98%
rename from .agent/tools/ai-orchestration/crewai.md
rename to .agents/tools/ai-orchestration/crewai.md
index bc25d7b6e..b24aacc73 100644
--- a/.agent/tools/ai-orchestration/crewai.md
+++ b/.agents/tools/ai-orchestration/crewai.md
@@ -19,7 +19,7 @@ tools:
 
 - **Purpose**: Role-playing autonomous AI agents working as teams
 - **License**: MIT (fully open-source, commercial use permitted)
-- **Setup**: `bash .agent/scripts/crewai-helper.sh setup`
+- **Setup**: `bash .agents/scripts/crewai-helper.sh setup`
 - **Start**: `~/.aidevops/scripts/start-crewai-studio.sh`
 - **Stop**: `~/.aidevops/scripts/stop-crewai-studio.sh`
 - **Status**: `~/.aidevops/scripts/crewai-status.sh`
@@ -74,7 +74,7 @@ Event-driven workflows for precise control over complex automations.
 
 ```bash
 # Run the setup script
-bash .agent/scripts/crewai-helper.sh setup
+bash .agents/scripts/crewai-helper.sh setup
 
 # Configure API keys
 nano ~/.aidevops/crewai/.env
diff --git a/.agent/tools/ai-orchestration/langflow.md b/.agents/tools/ai-orchestration/langflow.md
similarity index 98%
rename from .agent/tools/ai-orchestration/langflow.md
rename to .agents/tools/ai-orchestration/langflow.md
index 93280fb4e..30a4c75c9 100644
--- a/.agent/tools/ai-orchestration/langflow.md
+++ b/.agents/tools/ai-orchestration/langflow.md
@@ -19,7 +19,7 @@ tools:
 
 - **Purpose**: Visual drag-and-drop builder for AI-powered agents and workflows
 - **License**: MIT (fully open-source, commercial use permitted)
-- **Setup**: `bash .agent/scripts/langflow-helper.sh setup`
+- **Setup**: `bash .agents/scripts/langflow-helper.sh setup`
 - **Start**: `~/.aidevops/scripts/start-langflow.sh`
 - **Stop**: `~/.aidevops/scripts/stop-langflow.sh`
 - **Status**: `~/.aidevops/scripts/langflow-status.sh`
@@ -48,7 +48,7 @@ Langflow is a powerful visual tool for building and deploying AI-powered agents
 
 ```bash
 # Run the setup script
-bash .agent/scripts/langflow-helper.sh setup
+bash .agents/scripts/langflow-helper.sh setup
 
 # Configure API keys
 nano ~/.aidevops/langflow/.env
diff --git a/.agent/tools/ai-orchestration/openprose.md b/.agents/tools/ai-orchestration/openprose.md
similarity index 100%
rename from .agent/tools/ai-orchestration/openprose.md
rename to .agents/tools/ai-orchestration/openprose.md
diff --git a/.agent/tools/ai-orchestration/overview.md b/.agents/tools/ai-orchestration/overview.md
similarity index 97%
rename from .agent/tools/ai-orchestration/overview.md
rename to .agents/tools/ai-orchestration/overview.md
index 3bdd46c6a..be35b3bc5 100644
--- a/.agent/tools/ai-orchestration/overview.md
+++ b/.agents/tools/ai-orchestration/overview.md
@@ -26,16 +26,16 @@ tools:
 
 ```bash
 # Langflow (visual flow builder)
-bash .agent/scripts/langflow-helper.sh setup
+bash .agents/scripts/langflow-helper.sh setup
 
 # CrewAI (multi-agent teams)
-bash .agent/scripts/crewai-helper.sh setup
+bash .agents/scripts/crewai-helper.sh setup
 
 # AutoGen (conversational agents)
-bash .agent/scripts/autogen-helper.sh setup
+bash .agents/scripts/autogen-helper.sh setup
 
 # Agno (enterprise agent OS)
-bash .agent/scripts/agno-setup.sh setup
+bash .agents/scripts/agno-setup.sh setup
 
 # OpenProse (multi-agent DSL - no setup required, pattern-based)
 git clone https://github.com/openprose/prose.git ~/.config/opencode/skill/open-prose
@@ -220,7 +220,7 @@ All AI orchestration tools in aidevops follow these patterns:
 
 ### Helper Script Pattern
 
-Each tool has a helper script at `.agent/scripts/{tool}-helper.sh` with:
+Each tool has a helper script at `.agents/scripts/{tool}-helper.sh` with:
 
 ```bash
 # Standard commands
@@ -340,7 +340,7 @@ kill -9 $(lsof -t -i:7860)
 ```bash
 # Recreate venv
 rm -rf ~/.aidevops/{tool}/venv
-bash .agent/scripts/{tool}-helper.sh setup
+bash .agents/scripts/{tool}-helper.sh setup
 ```
 
 **API key errors**:
diff --git a/.agent/tools/ai-orchestration/packaging.md b/.agents/tools/ai-orchestration/packaging.md
similarity index 100%
rename from .agent/tools/ai-orchestration/packaging.md
rename to .agents/tools/ai-orchestration/packaging.md
diff --git a/.agent/tools/animation/animejs.md b/.agents/tools/animation/animejs.md
similarity index 100%
rename from .agent/tools/animation/animejs.md
rename to .agents/tools/animation/animejs.md
diff --git a/.agent/tools/api/better-auth.md b/.agents/tools/api/better-auth.md
similarity index 100%
rename from .agent/tools/api/better-auth.md
rename to .agents/tools/api/better-auth.md
diff --git a/.agent/tools/api/drizzle.md b/.agents/tools/api/drizzle.md
similarity index 100%
rename from .agent/tools/api/drizzle.md
rename to .agents/tools/api/drizzle.md
diff --git a/.agent/tools/api/hono.md b/.agents/tools/api/hono.md
similarity index 100%
rename from .agent/tools/api/hono.md
rename to .agents/tools/api/hono.md
diff --git a/.agent/tools/api/vercel-ai-sdk.md b/.agents/tools/api/vercel-ai-sdk.md
similarity index 100%
rename from .agent/tools/api/vercel-ai-sdk.md
rename to .agents/tools/api/vercel-ai-sdk.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/CHEATSHEET.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/CHEATSHEET.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/CHEATSHEET.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/CHEATSHEET.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/CQRS-EVENTS.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/CQRS-EVENTS.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/CQRS-EVENTS.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/CQRS-EVENTS.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-STRATEGIC.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-STRATEGIC.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-STRATEGIC.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-STRATEGIC.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-TACTICAL.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-TACTICAL.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-TACTICAL.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/DDD-TACTICAL.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/HEXAGONAL.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/HEXAGONAL.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/HEXAGONAL.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/HEXAGONAL.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/LAYERS.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/LAYERS.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/LAYERS.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/LAYERS.md
diff --git a/.agent/tools/architecture/clean-ddd-hexagonal-skill/references/TESTING.md b/.agents/tools/architecture/clean-ddd-hexagonal-skill/references/TESTING.md
similarity index 100%
rename from .agent/tools/architecture/clean-ddd-hexagonal-skill/references/TESTING.md
rename to .agents/tools/architecture/clean-ddd-hexagonal-skill/references/TESTING.md
diff --git a/.agent/tools/architecture/feature-slicing-skill.md b/.agents/tools/architecture/feature-slicing-skill.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill.md
rename to .agents/tools/architecture/feature-slicing-skill.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/CHEATSHEET.md b/.agents/tools/architecture/feature-slicing-skill/references/CHEATSHEET.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/CHEATSHEET.md
rename to .agents/tools/architecture/feature-slicing-skill/references/CHEATSHEET.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/IMPLEMENTATION.md b/.agents/tools/architecture/feature-slicing-skill/references/IMPLEMENTATION.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/IMPLEMENTATION.md
rename to .agents/tools/architecture/feature-slicing-skill/references/IMPLEMENTATION.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/LAYERS.md b/.agents/tools/architecture/feature-slicing-skill/references/LAYERS.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/LAYERS.md
rename to .agents/tools/architecture/feature-slicing-skill/references/LAYERS.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/MIGRATION.md b/.agents/tools/architecture/feature-slicing-skill/references/MIGRATION.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/MIGRATION.md
rename to .agents/tools/architecture/feature-slicing-skill/references/MIGRATION.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/NEXTJS.md b/.agents/tools/architecture/feature-slicing-skill/references/NEXTJS.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/NEXTJS.md
rename to .agents/tools/architecture/feature-slicing-skill/references/NEXTJS.md
diff --git a/.agent/tools/architecture/feature-slicing-skill/references/PUBLIC-API.md b/.agents/tools/architecture/feature-slicing-skill/references/PUBLIC-API.md
similarity index 100%
rename from .agent/tools/architecture/feature-slicing-skill/references/PUBLIC-API.md
rename to .agents/tools/architecture/feature-slicing-skill/references/PUBLIC-API.md
diff --git a/.agent/tools/automation/cron-agent.md b/.agents/tools/automation/cron-agent.md
similarity index 100%
rename from .agent/tools/automation/cron-agent.md
rename to .agents/tools/automation/cron-agent.md
diff --git a/.agent/tools/automation/mac.md b/.agents/tools/automation/mac.md
similarity index 100%
rename from .agent/tools/automation/mac.md
rename to .agents/tools/automation/mac.md
diff --git a/.agent/tools/automation/macos-automator.md b/.agents/tools/automation/macos-automator.md
similarity index 100%
rename from .agent/tools/automation/macos-automator.md
rename to .agents/tools/automation/macos-automator.md
diff --git a/.agent/tools/browser/agent-browser.md b/.agents/tools/browser/agent-browser.md
similarity index 100%
rename from .agent/tools/browser/agent-browser.md
rename to .agents/tools/browser/agent-browser.md
diff --git a/.agent/tools/browser/anti-detect-browser.md b/.agents/tools/browser/anti-detect-browser.md
similarity index 100%
rename from .agent/tools/browser/anti-detect-browser.md
rename to .agents/tools/browser/anti-detect-browser.md
diff --git a/.agent/tools/browser/browser-automation.md b/.agents/tools/browser/browser-automation.md
similarity index 100%
rename from .agent/tools/browser/browser-automation.md
rename to .agents/tools/browser/browser-automation.md
diff --git a/.agent/tools/browser/browser-benchmark.md b/.agents/tools/browser/browser-benchmark.md
similarity index 100%
rename from .agent/tools/browser/browser-benchmark.md
rename to .agents/tools/browser/browser-benchmark.md
diff --git a/.agent/tools/browser/browser-profiles.md b/.agents/tools/browser/browser-profiles.md
similarity index 100%
rename from .agent/tools/browser/browser-profiles.md
rename to .agents/tools/browser/browser-profiles.md
diff --git a/.agent/tools/browser/chrome-devtools.md b/.agents/tools/browser/chrome-devtools.md
similarity index 100%
rename from .agent/tools/browser/chrome-devtools.md
rename to .agents/tools/browser/chrome-devtools.md
diff --git a/.agent/tools/browser/crawl4ai-integration.md b/.agents/tools/browser/crawl4ai-integration.md
similarity index 90%
rename from .agent/tools/browser/crawl4ai-integration.md
rename to .agents/tools/browser/crawl4ai-integration.md
index 855531c9d..f8bc0c631 100644
--- a/.agent/tools/browser/crawl4ai-integration.md
+++ b/.agents/tools/browser/crawl4ai-integration.md
@@ -19,17 +19,17 @@ tools:
 ## Quick Reference
 
 - Crawl4AI: #1 trending open-source web crawler for AI/LLM applications
-- Install: `./.agent/scripts/crawl4ai-helper.sh install`
-- Docker setup: `./.agent/scripts/crawl4ai-helper.sh docker-setup`
-- Start: `./.agent/scripts/crawl4ai-helper.sh docker-start`
-- MCP setup: `./.agent/scripts/crawl4ai-helper.sh mcp-setup`
+- Install: `./.agents/scripts/crawl4ai-helper.sh install`
+- Docker setup: `./.agents/scripts/crawl4ai-helper.sh docker-setup`
+- Start: `./.agents/scripts/crawl4ai-helper.sh docker-start`
+- MCP setup: `./.agents/scripts/crawl4ai-helper.sh mcp-setup`
 - URLs: Dashboard http://localhost:11235/dashboard, Playground /playground, API :11235
-- Crawl: `./.agent/scripts/crawl4ai-helper.sh crawl URL markdown output.json`
-- Extract: `./.agent/scripts/crawl4ai-helper.sh extract URL '{"schema"}' data.json`
+- Crawl: `./.agents/scripts/crawl4ai-helper.sh crawl URL markdown output.json`
+- Extract: `./.agents/scripts/crawl4ai-helper.sh extract URL '{"schema"}' data.json`
 - Features: LLM-ready markdown, CSS/XPath/LLM extraction, async parallel crawling
 - MCP tools: crawl_url, crawl_multiple, extract_structured, take_screenshot, generate_pdf
 - Config: `configs/crawl4ai-config.json.txt`, `configs/mcp-templates/crawl4ai-mcp-config.json`
-- Debug: `./.agent/scripts/crawl4ai-helper.sh status`, `docker logs crawl4ai`
+- Debug: `./.agents/scripts/crawl4ai-helper.sh status`, `docker logs crawl4ai`
 <!-- AI-CONTEXT-END -->
 
 ## Overview
@@ -51,16 +51,16 @@ Crawl4AI is the #1 trending open-source web crawler on GitHub, specifically desi
 
 ```bash
 # Install Python package
-./.agent/scripts/crawl4ai-helper.sh install
+./.agents/scripts/crawl4ai-helper.sh install
 
 # Setup Docker deployment
-./.agent/scripts/crawl4ai-helper.sh docker-setup
+./.agents/scripts/crawl4ai-helper.sh docker-setup
 
 # Start Docker container with monitoring dashboard
-./.agent/scripts/crawl4ai-helper.sh docker-start
+./.agents/scripts/crawl4ai-helper.sh docker-start
 
 # Setup MCP integration for AI assistants
-./.agent/scripts/crawl4ai-helper.sh mcp-setup
+./.agents/scripts/crawl4ai-helper.sh mcp-setup
 ```
 
 ### Docker Deployment
@@ -95,10 +95,10 @@ Crawl4AI provides native MCP (Model Context Protocol) support for AI assistants:
 
 ```bash
 # Basic crawling
-./.agent/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
 
 # With structured extraction
-./.agent/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
+./.agents/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
 ```
 
 ### 2. LLM-Powered Extraction
@@ -394,7 +394,7 @@ browser_config = BrowserConfig(
 
 ```bash
 # Check service status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 
 # View container logs
 docker logs crawl4ai
@@ -407,7 +407,7 @@ curl http://localhost:11235/health
 
 - **Official Documentation**: https://docs.crawl4ai.com/
 - **GitHub Repository**: https://github.com/unclecode/crawl4ai
-- **Framework Integration**: `.agent/scripts/crawl4ai-helper.sh`
+- **Framework Integration**: `.agents/scripts/crawl4ai-helper.sh`
 - **Configuration Templates**: `configs/crawl4ai-config.json.txt`
 - **MCP Configuration**: `configs/mcp-templates/crawl4ai-mcp-config.json`
 
diff --git a/.agent/tools/browser/crawl4ai-resources.md b/.agents/tools/browser/crawl4ai-resources.md
similarity index 95%
rename from .agent/tools/browser/crawl4ai-resources.md
rename to .agents/tools/browser/crawl4ai-resources.md
index bb78b09d9..28a507ac6 100644
--- a/.agent/tools/browser/crawl4ai-resources.md
+++ b/.agents/tools/browser/crawl4ai-resources.md
@@ -26,7 +26,7 @@ tools:
 - **Discord**: https://discord.gg/jP8KfhDhyN
 - **CapSolver**: https://www.capsolver.com/ (CAPTCHA integration)
 - **API Endpoints**: `/crawl`, `/crawl/job`, `/health`, `/metrics`, `/screenshot`, `/pdf`
-- **Framework Files**: `.agent/scripts/crawl4ai-helper.sh`, `configs/crawl4ai-config.json.txt`
+- **Framework Files**: `.agents/scripts/crawl4ai-helper.sh`, `configs/crawl4ai-config.json.txt`
 - **Current Version**: v0.7.7 (November 2024)
 <!-- AI-CONTEXT-END -->
 
@@ -81,17 +81,17 @@ tools:
 
 ### Helper Scripts
 
-- **Main Helper**: `.agent/scripts/crawl4ai-helper.sh`
-- **Examples Script**: `.agent/scripts/crawl4ai-examples.sh`
+- **Main Helper**: `.agents/scripts/crawl4ai-helper.sh`
+- **Examples Script**: `.agents/scripts/crawl4ai-examples.sh`
 - **Configuration Template**: `configs/crawl4ai-config.json.txt`
 - **MCP Configuration**: `configs/mcp-templates/crawl4ai-mcp-config.json`
 
 ### Documentation Files
 
-- **Main Guide**: `.agent/crawl4ai.md`
-- **Integration Guide**: `.agent/wiki/crawl4ai-integration.md`
-- **Usage Guide**: `.agent/spec/crawl4ai-usage.md`
-- **Resources**: `.agent/links/crawl4ai-resources.md` (this file)
+- **Main Guide**: `.agents/crawl4ai.md`
+- **Integration Guide**: `.agents/wiki/crawl4ai-integration.md`
+- **Usage Guide**: `.agents/spec/crawl4ai-usage.md`
+- **Resources**: `.agents/links/crawl4ai-resources.md` (this file)
 
 ## MCP Integration
 
@@ -236,7 +236,7 @@ tools:
 ### Tutorials & Guides
 
 - **Video Tutorial**: Available on documentation homepage
-- **Code Examples**: https://github.com/unclecode/crawl4ai/tree/main/.agent/examples
+- **Code Examples**: https://github.com/unclecode/crawl4ai/tree/main/.agents/examples
 - **Blog Posts**: Check GitHub discussions for community tutorials
 
 ### Community Examples
diff --git a/.agent/tools/browser/crawl4ai-usage.md b/.agents/tools/browser/crawl4ai-usage.md
similarity index 80%
rename from .agent/tools/browser/crawl4ai-usage.md
rename to .agents/tools/browser/crawl4ai-usage.md
index b79cac554..b4389e9ff 100644
--- a/.agent/tools/browser/crawl4ai-usage.md
+++ b/.agents/tools/browser/crawl4ai-usage.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- **Helper**: `.agent/scripts/crawl4ai-helper.sh`
+- **Helper**: `.agents/scripts/crawl4ai-helper.sh`
 - **API Port**: `localhost:11235`
 - **Commands**: `install | docker-setup | docker-start | status | crawl | extract | mcp-setup`
 - **Crawl**: `./crawl4ai-helper.sh crawl URL markdown output.json`
@@ -40,23 +40,23 @@ This guide provides AI assistants with comprehensive instructions for using Craw
 
 ```bash
 # Install Crawl4AI
-./.agent/scripts/crawl4ai-helper.sh install
+./.agents/scripts/crawl4ai-helper.sh install
 
 # Setup Docker deployment
-./.agent/scripts/crawl4ai-helper.sh docker-setup
+./.agents/scripts/crawl4ai-helper.sh docker-setup
 
 # Start services
-./.agent/scripts/crawl4ai-helper.sh docker-start
+./.agents/scripts/crawl4ai-helper.sh docker-start
 
 # Check status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 ```
 
 ### MCP Integration
 
 ```bash
 # Setup MCP server for AI assistants
-./.agent/scripts/crawl4ai-helper.sh mcp-setup
+./.agents/scripts/crawl4ai-helper.sh mcp-setup
 ```
 
 ## Core Operations
@@ -65,23 +65,23 @@ This guide provides AI assistants with comprehensive instructions for using Craw
 
 ```bash
 # Basic crawling - extract markdown
-./.agent/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
 
 # Crawl with specific format
-./.agent/scripts/crawl4ai-helper.sh crawl https://news.com html news.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://news.com html news.json
 
 # Save to file
-./.agent/scripts/crawl4ai-helper.sh crawl https://docs.com markdown ~/Downloads/docs.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://docs.com markdown ~/Downloads/docs.json
 ```
 
 ### 2. Structured Data Extraction
 
 ```bash
 # Extract with CSS selectors
-./.agent/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
+./.agents/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
 
 # Complex schema extraction
-./.agent/scripts/crawl4ai-helper.sh extract https://ecommerce.com '{
+./.agents/scripts/crawl4ai-helper.sh extract https://ecommerce.com '{
   "products": {
     "selector": ".product",
     "fields": [
@@ -159,10 +159,10 @@ response = requests.post("http://localhost:11235/crawl", json={
 
 ```bash
 # Research articles
-./.agent/scripts/crawl4ai-helper.sh crawl https://research-site.com markdown research.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://research-site.com markdown research.json
 
 # Extract key information
-./.agent/scripts/crawl4ai-helper.sh extract https://paper.com '{
+./.agents/scripts/crawl4ai-helper.sh extract https://paper.com '{
   "title": "h1",
   "authors": ".authors",
   "abstract": ".abstract",
@@ -175,7 +175,7 @@ response = requests.post("http://localhost:11235/crawl", json={
 ```bash
 # Multiple news sources
 for url in "https://news1.com" "https://news2.com" "https://news3.com"; do
-    ./.agent/scripts/crawl4ai-helper.sh crawl "$url" markdown "news-$(basename $url).json"
+    ./.agents/scripts/crawl4ai-helper.sh crawl "$url" markdown "news-$(basename $url).json"
 done
 ```
 
@@ -183,7 +183,7 @@ done
 
 ```bash
 # Product information
-./.agent/scripts/crawl4ai-helper.sh extract https://shop.com/product '{
+./.agents/scripts/crawl4ai-helper.sh extract https://shop.com/product '{
   "name": "h1.product-title",
   "price": ".price-current",
   "description": ".product-description",
@@ -201,7 +201,7 @@ done
 
 ```bash
 # API documentation
-./.agent/scripts/crawl4ai-helper.sh extract https://api-docs.com '{
+./.agents/scripts/crawl4ai-helper.sh extract https://api-docs.com '{
   "endpoints": {
     "selector": ".endpoint",
     "fields": [
@@ -230,7 +230,7 @@ urls=(
 
 for url in "${urls[@]}"; do
     echo "Processing: $url"
-    ./.agent/scripts/crawl4ai-helper.sh crawl "$url" markdown "output-$(date +%s).json"
+    ./.agents/scripts/crawl4ai-helper.sh crawl "$url" markdown "output-$(date +%s).json"
     sleep 2  # Rate limiting
 done
 ```
@@ -245,10 +245,10 @@ URL="https://example.com"
 TIMESTAMP=$(date +%Y%m%d_%H%M%S)
 
 # 1. Basic crawl
-./.agent/scripts/crawl4ai-helper.sh crawl "$URL" markdown "raw-$TIMESTAMP.json"
+./.agents/scripts/crawl4ai-helper.sh crawl "$URL" markdown "raw-$TIMESTAMP.json"
 
 # 2. Extract structured data
-./.agent/scripts/crawl4ai-helper.sh extract "$URL" '{
+./.agents/scripts/crawl4ai-helper.sh extract "$URL" '{
   "title": "h1",
   "headings": "h2, h3",
   "links": {"selector": "a", "type": "attribute", "attribute": "href"},
@@ -288,7 +288,7 @@ export CRAWL4AI_MEMORY_THRESHOLD=90
 
 ```bash
 # Comprehensive status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 
 # Docker container status
 docker ps | grep crawl4ai
@@ -313,8 +313,8 @@ curl -s http://localhost:11235/metrics
 docker logs crawl4ai --tail 50
 
 # Restart services
-./.agent/scripts/crawl4ai-helper.sh docker-stop
-./.agent/scripts/crawl4ai-helper.sh docker-start
+./.agents/scripts/crawl4ai-helper.sh docker-stop
+./.agents/scripts/crawl4ai-helper.sh docker-start
 
 # Test basic functionality
 curl -X POST http://localhost:11235/crawl \
@@ -370,7 +370,7 @@ jq -r '.results[0].links.internal[]' output.json
 
 ```bash
 # Use cache mode for repeated requests
-./.agent/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
 
 # Clear cache when needed
 docker exec crawl4ai redis-cli FLUSHALL
@@ -382,25 +382,25 @@ docker exec crawl4ai redis-cli FLUSHALL
 
 ```bash
 # Combine with quality tools
-./.agent/scripts/crawl4ai-helper.sh crawl https://docs.com markdown docs.json
-cat docs.json | jq -r '.results[0].markdown' | ./.agent/scripts/pandoc-helper.sh convert - pdf docs.pdf
+./.agents/scripts/crawl4ai-helper.sh crawl https://docs.com markdown docs.json
+cat docs.json | jq -r '.results[0].markdown' | ./.agents/scripts/pandoc-helper.sh convert - pdf docs.pdf
 ```
 
 ### With AI Workflows
 
 ```bash
 # Extract content for AI processing
-./.agent/scripts/crawl4ai-helper.sh crawl https://article.com markdown article.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://article.com markdown article.json
 CONTENT=$(jq -r '.results[0].markdown' article.json)
 echo "$CONTENT" | # Process with your AI pipeline
 ```
 
 ## Resources
 
-- **Helper Script**: `.agent/scripts/crawl4ai-helper.sh`
+- **Helper Script**: `.agents/scripts/crawl4ai-helper.sh`
 - **Configuration**: `configs/crawl4ai-config.json.txt`
 - **MCP Setup**: `configs/mcp-templates/crawl4ai-mcp-config.json`
-- **Integration Guide**: `.agent/wiki/crawl4ai-integration.md`
+- **Integration Guide**: `.agents/wiki/crawl4ai-integration.md`
 - **Official Docs**: https://docs.crawl4ai.com/
 
 ## Success Checklist
diff --git a/.agent/tools/browser/crawl4ai.md b/.agents/tools/browser/crawl4ai.md
similarity index 91%
rename from .agent/tools/browser/crawl4ai.md
rename to .agents/tools/browser/crawl4ai.md
index a41ab85cd..cbbe7e1e4 100644
--- a/.agent/tools/browser/crawl4ai.md
+++ b/.agents/tools/browser/crawl4ai.md
@@ -19,9 +19,9 @@ tools:
 ## Quick Reference
 
 - **Purpose**: #1 AI/LLM web crawler - markdown output for RAG pipelines
-- **Install**: `./.agent/scripts/crawl4ai-helper.sh install`
-- **Docker**: `./.agent/scripts/crawl4ai-helper.sh docker-start`
-- **MCP Setup**: `./.agent/scripts/crawl4ai-helper.sh mcp-setup`
+- **Install**: `./.agents/scripts/crawl4ai-helper.sh install`
+- **Docker**: `./.agents/scripts/crawl4ai-helper.sh docker-start`
+- **MCP Setup**: `./.agents/scripts/crawl4ai-helper.sh mcp-setup`
 
 **Endpoints** (Docker):
 - API: http://localhost:11235
@@ -78,36 +78,36 @@ Crawl4AI is the #1 trending open-source web crawler on GitHub, specifically desi
 
 ```bash
 # Install Crawl4AI Python package
-./.agent/scripts/crawl4ai-helper.sh install
+./.agents/scripts/crawl4ai-helper.sh install
 
 # Setup Docker deployment with monitoring
-./.agent/scripts/crawl4ai-helper.sh docker-setup
+./.agents/scripts/crawl4ai-helper.sh docker-setup
 
 # Start Docker container
-./.agent/scripts/crawl4ai-helper.sh docker-start
+./.agents/scripts/crawl4ai-helper.sh docker-start
 
 # Setup MCP integration for AI assistants
-./.agent/scripts/crawl4ai-helper.sh mcp-setup
+./.agents/scripts/crawl4ai-helper.sh mcp-setup
 
 # Setup CapSolver for CAPTCHA solving
-./.agent/scripts/crawl4ai-helper.sh capsolver-setup
+./.agents/scripts/crawl4ai-helper.sh capsolver-setup
 
 # Check status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 ```
 
 ### Basic Usage
 
 ```bash
 # Crawl a single URL
-./.agent/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
+./.agents/scripts/crawl4ai-helper.sh crawl https://example.com markdown output.json
 
 # Extract structured data
-./.agent/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
+./.agents/scripts/crawl4ai-helper.sh extract https://example.com '{"title":"h1","content":".article"}' data.json
 
 # Crawl with CAPTCHA solving (requires CapSolver API key)
 export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9
 ```
 
 ## 🐳 Docker Deployment
@@ -181,13 +181,13 @@ Crawl4AI integrates with CapSolver, the world's leading automated CAPTCHA solvin
 
 ```bash
 # Setup CapSolver integration
-./.agent/scripts/crawl4ai-helper.sh capsolver-setup
+./.agents/scripts/crawl4ai-helper.sh capsolver-setup
 
 # Get API key from https://dashboard.capsolver.com/
 export CAPSOLVER_API_KEY="CAP-xxxxxxxxxxxxxxxxxxxxx"
 
 # Crawl with CAPTCHA solving
-./.agent/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 site_key_here
+./.agents/scripts/crawl4ai-helper.sh captcha-crawl https://example.com recaptcha_v2 site_key_here
 ```
 
 ### Pricing & Performance
@@ -321,7 +321,7 @@ def handle_webhook():
 
 ```bash
 # Research articles and papers
-./.agent/scripts/crawl4ai-helper.sh extract https://research-paper.com '{
+./.agents/scripts/crawl4ai-helper.sh extract https://research-paper.com '{
   "title": "h1",
   "authors": ".authors",
   "abstract": ".abstract", 
@@ -339,7 +339,7 @@ def handle_webhook():
 
 ```bash
 # Product information extraction
-./.agent/scripts/crawl4ai-helper.sh extract https://ecommerce.com/product '{
+./.agents/scripts/crawl4ai-helper.sh extract https://ecommerce.com/product '{
   "name": "h1.product-title",
   "price": ".price-current",
   "description": ".product-description",
@@ -361,7 +361,7 @@ def handle_webhook():
 urls=("https://news1.com" "https://news2.com" "https://news3.com")
 
 for url in "${urls[@]}"; do
-    ./.agent/scripts/crawl4ai-helper.sh extract "$url" '{
+    ./.agents/scripts/crawl4ai-helper.sh extract "$url" '{
       "headline": "h1",
       "summary": ".article-summary",
       "author": ".byline",
@@ -375,7 +375,7 @@ done
 
 ```bash
 # API documentation extraction
-./.agent/scripts/crawl4ai-helper.sh extract https://api-docs.com '{
+./.agents/scripts/crawl4ai-helper.sh extract https://api-docs.com '{
   "endpoints": {
     "selector": ".endpoint",
     "fields": [
@@ -606,7 +606,7 @@ async with AsyncWebCrawler(config=browser_config) as crawler:
 
 ```bash
 # Check comprehensive status
-./.agent/scripts/crawl4ai-helper.sh status
+./.agents/scripts/crawl4ai-helper.sh status
 
 # View container logs
 docker logs crawl4ai --tail 50 --follow
@@ -621,11 +621,11 @@ curl -X POST http://localhost:11235/crawl \
 
 ### Framework Integration
 
-- **Helper Script**: `.agent/scripts/crawl4ai-helper.sh`
+- **Helper Script**: `.agents/scripts/crawl4ai-helper.sh`
 - **Configuration Template**: `configs/crawl4ai-config.json.txt`
 - **MCP Configuration**: `configs/mcp-templates/crawl4ai-mcp-config.json`
-- **Integration Guide**: `.agent/wiki/crawl4ai-integration.md`
-- **Usage Guide**: `.agent/spec/crawl4ai-usage.md`
+- **Integration Guide**: `.agents/wiki/crawl4ai-integration.md`
+- **Usage Guide**: `.agents/spec/crawl4ai-usage.md`
 
 ### Official Resources
 
@@ -636,11 +636,11 @@ curl -X POST http://localhost:11235/crawl \
 
 ## 🎯 Next Steps
 
-1. **Install and Setup**: Run `./.agent/scripts/crawl4ai-helper.sh install`
-2. **Start Docker Services**: Run `./.agent/scripts/crawl4ai-helper.sh docker-start`
+1. **Install and Setup**: Run `./.agents/scripts/crawl4ai-helper.sh install`
+2. **Start Docker Services**: Run `./.agents/scripts/crawl4ai-helper.sh docker-start`
 3. **Explore Dashboard**: Visit http://localhost:11235/dashboard
 4. **Try Playground**: Test crawling at http://localhost:11235/playground
-5. **Setup MCP**: Run `./.agent/scripts/crawl4ai-helper.sh mcp-setup`
+5. **Setup MCP**: Run `./.agents/scripts/crawl4ai-helper.sh mcp-setup`
 6. **Build Applications**: Use the API for your specific use cases
 
 Crawl4AI transforms web data into AI-ready formats, making it perfect for RAG systems, data pipelines, and AI-powered applications within the AI DevOps Framework.
diff --git a/.agent/tools/browser/curl-copy.md b/.agents/tools/browser/curl-copy.md
similarity index 100%
rename from .agent/tools/browser/curl-copy.md
rename to .agents/tools/browser/curl-copy.md
diff --git a/.agent/tools/browser/dev-browser.md b/.agents/tools/browser/dev-browser.md
similarity index 100%
rename from .agent/tools/browser/dev-browser.md
rename to .agents/tools/browser/dev-browser.md
diff --git a/.agent/tools/browser/fingerprint-profiles.md b/.agents/tools/browser/fingerprint-profiles.md
similarity index 100%
rename from .agent/tools/browser/fingerprint-profiles.md
rename to .agents/tools/browser/fingerprint-profiles.md
diff --git a/.agent/tools/browser/pagespeed.md b/.agents/tools/browser/pagespeed.md
similarity index 90%
rename from .agent/tools/browser/pagespeed.md
rename to .agents/tools/browser/pagespeed.md
index c64cf9304..047617d2e 100644
--- a/.agent/tools/browser/pagespeed.md
+++ b/.agents/tools/browser/pagespeed.md
@@ -18,9 +18,9 @@ tools:
 
 ## Quick Reference
 
-- **Helper**: `.agent/scripts/pagespeed-helper.sh`
+- **Helper**: `.agents/scripts/pagespeed-helper.sh`
 - **Commands**: `audit [url]` | `lighthouse [url] [format]` | `wordpress [url]` | `bulk [file]` | `report [json]`
-- **Install**: `brew install lighthouse jq bc` or `.agent/scripts/pagespeed-helper.sh install-deps`
+- **Install**: `brew install lighthouse jq bc` or `.agents/scripts/pagespeed-helper.sh install-deps`
 - **API Key**: Optional but recommended - https://console.cloud.google.com/ → Enable PageSpeed Insights API
 - **Core Web Vitals**: FCP (<1.8s), LCP (<2.5s), CLS (<0.1), FID (<100ms)
 - **Reports**: `~/.ai-devops/reports/pagespeed/`
@@ -47,7 +47,7 @@ This integration provides your AI assistant with powerful website performance au
 ```bash
 # Install required dependencies
 cd ~/Git/aidevops
-./.agent/scripts/pagespeed-helper.sh install-deps
+./.agents/scripts/pagespeed-helper.sh install-deps
 
 # This will install:
 # - jq (JSON parsing)
@@ -86,17 +86,17 @@ npm install -g lighthouse-mcp-server
 
 ```bash
 # Audit a website (desktop & mobile)
-./.agent/scripts/pagespeed-helper.sh audit https://example.com
+./.agents/scripts/pagespeed-helper.sh audit https://example.com
 
 # Lighthouse comprehensive audit
-./.agent/scripts/pagespeed-helper.sh lighthouse https://example.com html
+./.agents/scripts/pagespeed-helper.sh lighthouse https://example.com html
 ```
 
 ### **WordPress-Specific Analysis**
 
 ```bash
 # WordPress performance analysis with specific recommendations
-./.agent/scripts/pagespeed-helper.sh wordpress https://myblog.com
+./.agents/scripts/pagespeed-helper.sh wordpress https://myblog.com
 ```
 
 ### **Bulk Website Auditing**
@@ -110,14 +110,14 @@ https://site3.com
 EOF
 
 # Run bulk audit
-./.agent/scripts/pagespeed-helper.sh bulk websites.txt
+./.agents/scripts/pagespeed-helper.sh bulk websites.txt
 ```
 
 ### **Generate Actionable Reports**
 
 ```bash
 # Generate actionable recommendations from JSON report
-./.agent/scripts/pagespeed-helper.sh report ~/.ai-devops/reports/pagespeed/lighthouse_20241110_143022.json
+./.agents/scripts/pagespeed-helper.sh report ~/.ai-devops/reports/pagespeed/lighthouse_20241110_143022.json
 ```
 
 ## AI Assistant Integration
@@ -128,7 +128,7 @@ Add this to your AI assistant's system prompt:
 
 ```text
 For website performance optimization, use the PageSpeed and Lighthouse tools available in
-~/Git/aidevops/.agent/scripts/pagespeed-helper.sh. Always provide specific,
+~/Git/aidevops/.agents/scripts/pagespeed-helper.sh. Always provide specific,
 actionable recommendations focusing on Core Web Vitals and user experience.
 ```
 
diff --git a/.agent/tools/browser/peekaboo.md b/.agents/tools/browser/peekaboo.md
similarity index 100%
rename from .agent/tools/browser/peekaboo.md
rename to .agents/tools/browser/peekaboo.md
diff --git a/.agent/tools/browser/playwright-cli.md b/.agents/tools/browser/playwright-cli.md
similarity index 100%
rename from .agent/tools/browser/playwright-cli.md
rename to .agents/tools/browser/playwright-cli.md
diff --git a/.agent/tools/browser/playwright-emulation.md b/.agents/tools/browser/playwright-emulation.md
similarity index 100%
rename from .agent/tools/browser/playwright-emulation.md
rename to .agents/tools/browser/playwright-emulation.md
diff --git a/.agent/tools/browser/playwright.md b/.agents/tools/browser/playwright.md
similarity index 100%
rename from .agent/tools/browser/playwright.md
rename to .agents/tools/browser/playwright.md
diff --git a/.agent/tools/browser/playwriter.md b/.agents/tools/browser/playwriter.md
similarity index 100%
rename from .agent/tools/browser/playwriter.md
rename to .agents/tools/browser/playwriter.md
diff --git a/.agent/tools/browser/proxy-integration.md b/.agents/tools/browser/proxy-integration.md
similarity index 100%
rename from .agent/tools/browser/proxy-integration.md
rename to .agents/tools/browser/proxy-integration.md
diff --git a/.agent/tools/browser/remotion-best-practices-skill.md b/.agents/tools/browser/remotion-best-practices-skill.md
similarity index 100%
rename from .agent/tools/browser/remotion-best-practices-skill.md
rename to .agents/tools/browser/remotion-best-practices-skill.md
diff --git a/.agent/tools/browser/stagehand-examples.md b/.agents/tools/browser/stagehand-examples.md
similarity index 100%
rename from .agent/tools/browser/stagehand-examples.md
rename to .agents/tools/browser/stagehand-examples.md
diff --git a/.agent/tools/browser/stagehand-python.md b/.agents/tools/browser/stagehand-python.md
similarity index 93%
rename from .agent/tools/browser/stagehand-python.md
rename to .agents/tools/browser/stagehand-python.md
index d042910b3..d0d028392 100644
--- a/.agent/tools/browser/stagehand-python.md
+++ b/.agents/tools/browser/stagehand-python.md
@@ -19,7 +19,7 @@ tools:
 ## Quick Reference
 
 - Stagehand Python: AI-powered browser automation with Pydantic validation
-- Helper: `bash .agent/scripts/stagehand-python-helper.sh setup|install|status|activate|clean`
+- Helper: `bash .agents/scripts/stagehand-python-helper.sh setup|install|status|activate|clean`
 - Virtual env: `~/.aidevops/stagehand-python/.venv/`
 - Config: `~/.aidevops/stagehand-python/.env`
 - Core primitives:
@@ -64,11 +64,11 @@ Stagehand Python brings the power of AI-driven browser automation to Python deve
 
 ```bash
 # Complete setup (recommended)
-bash .agent/scripts/stagehand-python-helper.sh setup
+bash .agents/scripts/stagehand-python-helper.sh setup
 
 # Or step by step
-bash .agent/scripts/stagehand-python-helper.sh install
-bash .agent/scripts/stagehand-python-setup.sh examples
+bash .agents/scripts/stagehand-python-helper.sh install
+bash .agents/scripts/stagehand-python-setup.sh examples
 ```
 
 ### **Basic Usage**
@@ -354,10 +354,10 @@ async def scrape_news(url: str) -> List[Article]:
 
 ```bash
 # Setup Python MCP integration
-bash .agent/scripts/setup-mcp-integrations.sh stagehand-python
+bash .agents/scripts/setup-mcp-integrations.sh stagehand-python
 
 # Setup both JavaScript and Python
-bash .agent/scripts/setup-mcp-integrations.sh stagehand-both
+bash .agents/scripts/setup-mcp-integrations.sh stagehand-both
 ```
 
 ### **Using MCP with Stagehand Python**
@@ -437,21 +437,21 @@ await agent.execute("Search for information and save it to the database")
 
 ```bash
 # Installation and setup
-bash .agent/scripts/stagehand-python-helper.sh install      # Install Stagehand Python
-bash .agent/scripts/stagehand-python-helper.sh setup       # Complete setup
-bash .agent/scripts/stagehand-python-helper.sh status      # Check installation
+bash .agents/scripts/stagehand-python-helper.sh install      # Install Stagehand Python
+bash .agents/scripts/stagehand-python-helper.sh setup       # Complete setup
+bash .agents/scripts/stagehand-python-helper.sh status      # Check installation
 
 # Virtual environment management
-bash .agent/scripts/stagehand-python-helper.sh activate    # Show activation command
+bash .agents/scripts/stagehand-python-helper.sh activate    # Show activation command
 source ~/.aidevops/stagehand-python/.venv/bin/activate  # Activate venv
 
 # Development and testing
-bash .agent/scripts/stagehand-python-setup.sh examples  # Create examples
+bash .agents/scripts/stagehand-python-setup.sh examples  # Create examples
 python examples/basic_example.py                        # Run basic example
 python examples/ecommerce_automation.py "headphones"    # Run product search
 
 # Maintenance
-bash .agent/scripts/stagehand-python-helper.sh clean       # Clean cache and logs
+bash .agents/scripts/stagehand-python-helper.sh clean       # Clean cache and logs
 ```
 
 ## 📖 **Resources**
@@ -479,5 +479,5 @@ bash .agent/scripts/stagehand-python-helper.sh clean       # Clean cache and log
 **🎉 Ready to revolutionize your browser automation with Python? Get started with Stagehand Python today!**
 
 ```bash
-bash .agent/scripts/stagehand-python-helper.sh setup
+bash .agents/scripts/stagehand-python-helper.sh setup
 ```
diff --git a/.agent/tools/browser/stagehand.md b/.agents/tools/browser/stagehand.md
similarity index 90%
rename from .agent/tools/browser/stagehand.md
rename to .agents/tools/browser/stagehand.md
index ec04ba10a..ba287129d 100644
--- a/.agent/tools/browser/stagehand.md
+++ b/.agents/tools/browser/stagehand.md
@@ -20,9 +20,9 @@ tools:
 
 - **Purpose**: AI-powered browser automation with natural language control
 - **Languages**: JavaScript (npm) + Python (pip)
-- **Setup JS**: `bash .agent/scripts/stagehand-helper.sh setup`
-- **Setup Python**: `bash .agent/scripts/stagehand-python-helper.sh setup`
-- **Setup Both**: `bash .agent/scripts/setup-mcp-integrations.sh stagehand-both`
+- **Setup JS**: `bash .agents/scripts/stagehand-helper.sh setup`
+- **Setup Python**: `bash .agents/scripts/stagehand-python-helper.sh setup`
+- **Setup Both**: `bash .agents/scripts/setup-mcp-integrations.sh stagehand-both`
 
 **Core Primitives**:
 - `act("click login button")` - Natural language actions
@@ -69,13 +69,13 @@ Slowest tool due to AI model overhead. Without API key, works as a Playwright wr
 
 ```bash
 # JavaScript Version
-bash .agent/scripts/stagehand-helper.sh setup
+bash .agents/scripts/stagehand-helper.sh setup
 
 # Python Version
-bash .agent/scripts/stagehand-python-helper.sh setup
+bash .agents/scripts/stagehand-python-helper.sh setup
 
 # Both Versions
-bash .agent/scripts/setup-mcp-integrations.sh stagehand-both
+bash .agents/scripts/setup-mcp-integrations.sh stagehand-both
 ```
 
 ## 🎯 **Overview**
@@ -107,11 +107,11 @@ Stagehand is a revolutionary browser automation framework that combines the powe
 
 ```bash
 # Complete setup (recommended)
-bash .agent/scripts/stagehand-helper.sh setup
+bash .agents/scripts/stagehand-helper.sh setup
 
 # Or step by step
-bash .agent/scripts/stagehand-helper.sh install
-bash .agent/scripts/stagehand-helper.sh create-example
+bash .agents/scripts/stagehand-helper.sh install
+bash .agents/scripts/stagehand-helper.sh create-example
 ```
 
 ### **Basic Usage**
@@ -338,7 +338,7 @@ Stagehand can be integrated with the framework's MCP system:
 
 ```bash
 # Add Stagehand MCP server (if available)
-bash .agent/scripts/setup-mcp-integrations.sh stagehand
+bash .agents/scripts/setup-mcp-integrations.sh stagehand
 ```
 
 ### **Browser Automation Ecosystem**
@@ -354,10 +354,10 @@ Stagehand complements existing browser automation tools:
 
 ```bash
 # Run quality checks on Stagehand scripts
-bash .agent/scripts/linters-local.sh ~/.aidevops/stagehand/
+bash .agents/scripts/linters-local.sh ~/.aidevops/stagehand/
 
 # Lint JavaScript/TypeScript files
-bash .agent/scripts/linter-manager.sh install javascript
+bash .agents/scripts/linter-manager.sh install javascript
 ```
 
 ## 🎯 **Use Cases**
@@ -417,17 +417,17 @@ bash .agent/scripts/linter-manager.sh install javascript
 
 ```bash
 # Installation and setup
-bash .agent/scripts/stagehand-helper.sh install      # Install Stagehand
-bash .agent/scripts/stagehand-helper.sh setup        # Complete setup
-bash .agent/scripts/stagehand-helper.sh status       # Check installation
+bash .agents/scripts/stagehand-helper.sh install      # Install Stagehand
+bash .agents/scripts/stagehand-helper.sh setup        # Complete setup
+bash .agents/scripts/stagehand-helper.sh status       # Check installation
 
 # Development and testing
-bash .agent/scripts/stagehand-helper.sh create-example  # Create example script
-bash .agent/scripts/stagehand-helper.sh run-example     # Run basic example
-bash .agent/scripts/stagehand-helper.sh logs            # View logs
+bash .agents/scripts/stagehand-helper.sh create-example  # Create example script
+bash .agents/scripts/stagehand-helper.sh run-example     # Run basic example
+bash .agents/scripts/stagehand-helper.sh logs            # View logs
 
 # Maintenance
-bash .agent/scripts/stagehand-helper.sh clean        # Clean cache and logs
+bash .agents/scripts/stagehand-helper.sh clean        # Clean cache and logs
 ```
 
 ## 📖 **Resources**
@@ -442,7 +442,7 @@ bash .agent/scripts/stagehand-helper.sh clean        # Clean cache and logs
 
 - **Browser Automation**: docs/BROWSER-AUTOMATION.md
 - **MCP Integrations**: docs/MCP-INTEGRATIONS.md
-- **Quality Standards**: .agent/tools/code-review/code-standards.md
+- **Quality Standards**: .agents/tools/code-review/code-standards.md
 
 ### **Community & Support**
 
@@ -455,5 +455,5 @@ bash .agent/scripts/stagehand-helper.sh clean        # Clean cache and logs
 **🎉 Ready to revolutionize your browser automation with AI? Get started with Stagehand today!**
 
 ```bash
-bash .agent/scripts/stagehand-helper.sh setup
+bash .agents/scripts/stagehand-helper.sh setup
 ```
diff --git a/.agent/tools/browser/stealth-patches.md b/.agents/tools/browser/stealth-patches.md
similarity index 100%
rename from .agent/tools/browser/stealth-patches.md
rename to .agents/tools/browser/stealth-patches.md
diff --git a/.agent/tools/browser/sweet-cookie.md b/.agents/tools/browser/sweet-cookie.md
similarity index 100%
rename from .agent/tools/browser/sweet-cookie.md
rename to .agents/tools/browser/sweet-cookie.md
diff --git a/.agent/tools/browser/watercrawl.md b/.agents/tools/browser/watercrawl.md
similarity index 91%
rename from .agent/tools/browser/watercrawl.md
rename to .agents/tools/browser/watercrawl.md
index 4fb1d6f75..470a8c98b 100644
--- a/.agent/tools/browser/watercrawl.md
+++ b/.agents/tools/browser/watercrawl.md
@@ -20,8 +20,8 @@ tools:
 
 - **Purpose**: Transform web content into LLM-ready structured data
 - **Type**: Open-source, self-hosted first (Docker/Coolify), cloud API fallback
-- **Self-Hosted**: `bash .agent/scripts/watercrawl-helper.sh docker-setup`
-- **Cloud API**: `bash .agent/scripts/watercrawl-helper.sh api-url https://app.watercrawl.dev`
+- **Self-Hosted**: `bash .agents/scripts/watercrawl-helper.sh docker-setup`
+- **Cloud API**: `bash .agents/scripts/watercrawl-helper.sh api-url https://app.watercrawl.dev`
 
 **Self-Hosted Commands**: `docker-setup|docker-start|docker-stop|docker-logs|docker-admin|coolify-deploy`
 **API Commands**: `setup|status|api-key|api-url|scrape|crawl|search|sitemap|help`
@@ -90,20 +90,20 @@ WaterCrawl is a modern web crawling framework that transforms web content into s
 
 ```bash
 # Clone and configure WaterCrawl
-bash .agent/scripts/watercrawl-helper.sh docker-setup
+bash .agents/scripts/watercrawl-helper.sh docker-setup
 
 # Start services
-bash .agent/scripts/watercrawl-helper.sh docker-start
+bash .agents/scripts/watercrawl-helper.sh docker-start
 
 # Create admin user
-bash .agent/scripts/watercrawl-helper.sh docker-admin
+bash .agents/scripts/watercrawl-helper.sh docker-admin
 
 # Access dashboard at http://localhost
 # Get API key from dashboard, then:
-bash .agent/scripts/watercrawl-helper.sh api-key YOUR_API_KEY
+bash .agents/scripts/watercrawl-helper.sh api-key YOUR_API_KEY
 
 # Test crawling
-bash .agent/scripts/watercrawl-helper.sh scrape https://example.com
+bash .agents/scripts/watercrawl-helper.sh scrape https://example.com
 ```
 
 ### Coolify Deployment
@@ -111,7 +111,7 @@ bash .agent/scripts/watercrawl-helper.sh scrape https://example.com
 For VPS deployment via Coolify (self-hosted PaaS):
 
 ```bash
-bash .agent/scripts/watercrawl-helper.sh coolify-deploy
+bash .agents/scripts/watercrawl-helper.sh coolify-deploy
 ```
 
 This shows instructions for deploying WaterCrawl as a Docker Compose application in Coolify.
@@ -122,32 +122,32 @@ If you prefer the managed cloud service:
 
 ```bash
 # Install SDK
-bash .agent/scripts/watercrawl-helper.sh setup
+bash .agents/scripts/watercrawl-helper.sh setup
 
 # Point to cloud API
-bash .agent/scripts/watercrawl-helper.sh api-url https://app.watercrawl.dev
+bash .agents/scripts/watercrawl-helper.sh api-url https://app.watercrawl.dev
 
 # Configure API key (get from https://app.watercrawl.dev)
-bash .agent/scripts/watercrawl-helper.sh api-key YOUR_API_KEY
+bash .agents/scripts/watercrawl-helper.sh api-key YOUR_API_KEY
 
 # Check status
-bash .agent/scripts/watercrawl-helper.sh status
+bash .agents/scripts/watercrawl-helper.sh status
 ```
 
 ### Basic Usage
 
 ```bash
 # Scrape a single URL
-bash .agent/scripts/watercrawl-helper.sh scrape https://example.com
+bash .agents/scripts/watercrawl-helper.sh scrape https://example.com
 
 # Crawl a website (depth 3, max 100 pages)
-bash .agent/scripts/watercrawl-helper.sh crawl https://docs.example.com 3 100 output.json
+bash .agents/scripts/watercrawl-helper.sh crawl https://docs.example.com 3 100 output.json
 
 # Search the web
-bash .agent/scripts/watercrawl-helper.sh search "AI web crawling" 10 results.json
+bash .agents/scripts/watercrawl-helper.sh search "AI web crawling" 10 results.json
 
 # Generate sitemap
-bash .agent/scripts/watercrawl-helper.sh sitemap https://example.com sitemap.json
+bash .agents/scripts/watercrawl-helper.sh sitemap https://example.com sitemap.json
 ```
 
 ## Node.js SDK Usage
@@ -446,10 +446,10 @@ pip install watercrawl-openai
 
 ```bash
 # Check if key is configured
-bash .agent/scripts/watercrawl-helper.sh status
+bash .agents/scripts/watercrawl-helper.sh status
 
 # Reconfigure key
-bash .agent/scripts/watercrawl-helper.sh api-key YOUR_NEW_KEY
+bash .agents/scripts/watercrawl-helper.sh api-key YOUR_NEW_KEY
 ```
 
 ### Rate Limiting
diff --git a/.agent/tools/build-agent/add-skill.md b/.agents/tools/build-agent/add-skill.md
similarity index 97%
rename from .agent/tools/build-agent/add-skill.md
rename to .agents/tools/build-agent/add-skill.md
index d1e650a77..ee1deca32 100644
--- a/.agent/tools/build-agent/add-skill.md
+++ b/.agents/tools/build-agent/add-skill.md
@@ -32,7 +32,7 @@ External Skill (GitHub or ClawdHub)
     ├── GitHub: git clone --depth 1
     └── ClawdHub: Playwright browser extraction (SPA)
         ↓
-    Check Conflicts with .agent/
+    Check Conflicts with .agents/
         ↓
     Present Merge Options (if conflicts)
         ↓
@@ -130,7 +130,7 @@ Overwrite existing with imported. Best when:
 - You want upstream as source of truth
 
 **Strategy:**
-1. Backup existing to `.agent/.backup/`
+1. Backup existing to `.agents/.backup/`
 2. Replace with imported content
 3. Note replacement in skill-sources.json
 
@@ -183,7 +183,7 @@ Default: `tools/{skill-name}/`
       "name": "cloudflare",
       "upstream_url": "https://github.com/dmmulroy/cloudflare-skill",
       "upstream_commit": "abc123def456...",
-      "local_path": ".agent/services/hosting/cloudflare.md",
+      "local_path": ".agents/services/hosting/cloudflare.md",
       "format_detected": "skill-md",
       "imported_at": "2026-01-21T00:00:00Z",
       "last_checked": "2026-01-21T00:00:00Z",
@@ -291,8 +291,8 @@ apt install jq   # Ubuntu/Debian
 ### Conflicts not detected
 
 The helper checks for:
-- Exact path match (`.agent/path/skill.md`)
-- Directory match (`.agent/path/skill/`)
+- Exact path match (`.agents/path/skill.md`)
+- Directory match (`.agents/path/skill/`)
 
 It does NOT check for semantic duplicates. Use `/add-skill list` to review.
 
diff --git a/.agent/tools/build-agent/agent-review.md b/.agents/tools/build-agent/agent-review.md
similarity index 95%
rename from .agent/tools/build-agent/agent-review.md
rename to .agents/tools/build-agent/agent-review.md
index 6fb7a5d3f..9105329ac 100644
--- a/.agent/tools/build-agent/agent-review.md
+++ b/.agents/tools/build-agent/agent-review.md
@@ -111,10 +111,10 @@ For each agent file under review:
 
 ```bash
 # Search for similar instructions across all agents
-rg "pattern" .agent/
+rg "pattern" .agents/
 
 # Check specific files that might overlap
-diff .agent/file1.md .agent/file2.md
+diff .agents/file1.md .agents/file2.md
 ```text
 
 - Same concept should have single authoritative source
@@ -147,13 +147,13 @@ When proposing changes:
 ```markdown
 ## Agent Improvement Proposal
 
-**File**: `.agent/[path]/[file].md`
+**File**: `.agents/[path]/[file].md`
 **Issue**: [Brief description]
 **Evidence**: [Specific failure, contradiction, or user feedback]
 
 **Related Files** (checked for duplicates):
-- `.agent/[other-file].md` - [relationship]
-- `.agent/[another-file].md` - [relationship]
+- `.agents/[other-file].md` - [relationship]
+- `.agents/[another-file].md` - [relationship]
 
 **Proposed Change**:
 [Specific before/after or description]
@@ -209,7 +209,7 @@ fi
 
 ## After
 
-See error handling pattern at `.agent/scripts/hostinger-helper.sh:145`
+See error handling pattern at `.agents/scripts/hostinger-helper.sh:145`
 
 ```text
 
@@ -229,7 +229,7 @@ Improvements to aidevops agents benefit all users:
 
 1. Create improvement proposal
 2. Make changes in `~/Git/aidevops/`
-3. Run quality check: `.agent/scripts/linters-local.sh`
+3. Run quality check: `.agents/scripts/linters-local.sh`
 4. Commit with descriptive message
 5. Create PR to upstream
 
diff --git a/.agent/tools/build-agent/agent-testing.md b/.agents/tools/build-agent/agent-testing.md
similarity index 100%
rename from .agent/tools/build-agent/agent-testing.md
rename to .agents/tools/build-agent/agent-testing.md
diff --git a/.agent/tools/build-agent/build-agent.md b/.agents/tools/build-agent/build-agent.md
similarity index 97%
rename from .agent/tools/build-agent/build-agent.md
rename to .agents/tools/build-agent/build-agent.md
index 0fd7ccc55..fdb143bf7 100644
--- a/.agent/tools/build-agent/build-agent.md
+++ b/.agents/tools/build-agent/build-agent.md
@@ -83,7 +83,7 @@ Main agents are for high-level project orchestration:
 - **Scope**: Broad domain (wordpress, seo, content, aidevops)
 - **Role**: Coordinates subagents, makes strategic decisions
 - **Context**: Needs awareness of multiple related concerns
-- **Location**: Root of `.agent/` folder
+- **Location**: Root of `.agents/` folder
 - **Examples**: `seo.md`, `aidevops.md`, `build-plus.md`
 
 **Main agent characteristics:**
@@ -268,16 +268,16 @@ This repository has two agent directories with different purposes:
 
 | Directory | Purpose | Used By |
 |-----------|---------|---------|
-| `.agent/` | Source of truth with full documentation | Deployed to `~/.aidevops/agents/` by `setup.sh` |
+| `.agents/` | Source of truth with full documentation | Deployed to `~/.aidevops/agents/` by `setup.sh` |
 | `.opencode/agent/` | Generated stubs for OpenCode | OpenCode CLI (reads these directly) |
 
 **How it works:**
-1. `.agent/` contains the authoritative agent files with rich documentation
-2. `setup.sh` deploys `.agent/` to `~/.aidevops/agents/`
+1. `.agents/` contains the authoritative agent files with rich documentation
+2. `setup.sh` deploys `.agents/` to `~/.aidevops/agents/`
 3. `generate-opencode-agents.sh` creates minimal stubs in `~/.config/opencode/agent/` that reference the deployed files
 4. OpenCode reads the stubs, which point to the full agent content
 
-**Frontmatter in `.agent/` files** serves as:
+**Frontmatter in `.agents/` files** serves as:
 - Documentation of intended permissions
 - Reference for non-OpenCode AI assistants (Claude, Cursor, etc.)
 - Template for what the generated stubs should enable
@@ -355,10 +355,10 @@ Line numbers drift as code changes. Use search patterns instead:
 
 ```markdown
 # Bad (will drift)
-See error handling at `.agent/scripts/hostinger-helper.sh:145`
+See error handling at `.agents/scripts/hostinger-helper.sh:145`
 
 # Good (stable)
-Search for `handle_api_error` in `.agent/scripts/hostinger-helper.sh`
+Search for `handle_api_error` in `.agents/scripts/hostinger-helper.sh`
 
 # Better (with fallback)
 Search for `handle_api_error` in hostinger-helper.sh.
@@ -486,7 +486,7 @@ Before adding content to any agent file:
    - Remove redundant or obvious instructions
 
 6. **Does this duplicate other agents?**
-   - Search: `rg "pattern" .agent/` before adding
+   - Search: `rg "pattern" .agents/` before adding
    - Check for conflicting guidance across files
    - Single source of truth for each concept
 
@@ -556,7 +556,7 @@ Read subagents only when task requires them.
 3. **Command syntax reference** - The example IS the documentation
 
    ```bash
-   .agent/scripts/[service]-helper.sh [command] [account] [target]
+   .agents/scripts/[service]-helper.sh [command] [account] [target]
    ```
 
 **Avoid code examples when:**
@@ -640,7 +640,7 @@ When code examples are used during a task:
 
    ```bash
    # Search for similar instructions
-   rg "pattern" .agent/
+   rg "pattern" .agents/
    
    # Check files that might have parallel instructions
    # Note potential conflicts if change is made
@@ -655,7 +655,7 @@ When code examples are used during a task:
 
    ```text
    > Agent Feedback: While [task], I noticed [issue] in 
-   > `.agent/[file].md`. Related instructions also exist in 
+   > `.agents/[file].md`. Related instructions also exist in 
    > `[other-files]`. Suggested improvement: [change]. 
    > Should I update these after completing your request?
    ```
@@ -750,7 +750,7 @@ See "Subagent YAML Frontmatter" section for full permission options.
 ### Folder Organization
 
 ```text
-.agent/
+.agents/
 ├── AGENTS.md                 # Entry point (ALLCAPS - special root file)
 ├── {domain}.md               # Main agents at root (lowercase)
 ├── {domain}/                 # Subagents for that domain
@@ -802,7 +802,7 @@ See "Subagent YAML Frontmatter" section for full permission options.
 - Location (root vs folder) already distinguishes main from subagents
 - ALLCAPS causes cross-platform issues (Linux is case-sensitive)
 - Matches common framework conventions (OpenCode, Cursor, Continue)
-- `ls .agent/*.md` instantly shows all main agents
+- `ls .agents/*.md` instantly shows all main agents
 
 **Why main agents stay at root (not inside folders)?**
 
@@ -825,7 +825,7 @@ Main agents provide overview and point to subagents for details (progressive dis
 
 ### Deployment Sync
 
-Agent changes in `.agent/` require `setup.sh` to deploy to `~/.aidevops/agents/`:
+Agent changes in `.agents/` require `setup.sh` to deploy to `~/.aidevops/agents/`:
 
 ```bash
 cd ~/Git/aidevops && ./setup.sh
diff --git a/.agent/tools/build-mcp/aidevops-plugin.md b/.agents/tools/build-mcp/aidevops-plugin.md
similarity index 100%
rename from .agent/tools/build-mcp/aidevops-plugin.md
rename to .agents/tools/build-mcp/aidevops-plugin.md
diff --git a/.agent/tools/build-mcp/api-wrapper.md b/.agents/tools/build-mcp/api-wrapper.md
similarity index 100%
rename from .agent/tools/build-mcp/api-wrapper.md
rename to .agents/tools/build-mcp/api-wrapper.md
diff --git a/.agent/tools/build-mcp/build-mcp.md b/.agents/tools/build-mcp/build-mcp.md
similarity index 100%
rename from .agent/tools/build-mcp/build-mcp.md
rename to .agents/tools/build-mcp/build-mcp.md
diff --git a/.agent/tools/build-mcp/deployment.md b/.agents/tools/build-mcp/deployment.md
similarity index 100%
rename from .agent/tools/build-mcp/deployment.md
rename to .agents/tools/build-mcp/deployment.md
diff --git a/.agent/tools/build-mcp/server-patterns.md b/.agents/tools/build-mcp/server-patterns.md
similarity index 100%
rename from .agent/tools/build-mcp/server-patterns.md
rename to .agents/tools/build-mcp/server-patterns.md
diff --git a/.agent/tools/build-mcp/transports.md b/.agents/tools/build-mcp/transports.md
similarity index 100%
rename from .agent/tools/build-mcp/transports.md
rename to .agents/tools/build-mcp/transports.md
diff --git a/.agent/tools/code-review/auditing.md b/.agents/tools/code-review/auditing.md
similarity index 83%
rename from .agent/tools/code-review/auditing.md
rename to .agents/tools/code-review/auditing.md
index 154ea5176..154c7bedd 100644
--- a/.agent/tools/code-review/auditing.md
+++ b/.agents/tools/code-review/auditing.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- **Helper**: `.agent/scripts/code-audit-helper.sh`
+- **Helper**: `.agents/scripts/code-audit-helper.sh`
 - **Services**: CodeRabbit (AI reviews), CodeFactor (quality), Codacy (enterprise), SonarCloud (security)
 - **Config**: `configs/code-audit-config.json`
 - **Commands**: `services` | `audit [repo]` | `report [repo] [file]` | `start-mcp [service] [port]`
@@ -106,36 +106,36 @@ cp configs/code-audit-config.json.txt configs/code-audit-config.json
 
 ```bash
 # List all configured services
-./.agent/scripts/code-audit-helper.sh services
+./.agents/scripts/code-audit-helper.sh services
 
 # Run comprehensive audit across all services
-./.agent/scripts/code-audit-helper.sh audit my-repository
+./.agents/scripts/code-audit-helper.sh audit my-repository
 
 # Generate detailed audit report
-./.agent/scripts/code-audit-helper.sh report my-repository audit-report.json
+./.agents/scripts/code-audit-helper.sh report my-repository audit-report.json
 ```
 
 ### **CodeRabbit Operations:**
 
 ```bash
 # List CodeRabbit repositories
-./.agent/scripts/code-audit-helper.sh coderabbit-repos personal
+./.agents/scripts/code-audit-helper.sh coderabbit-repos personal
 
 # Get analysis for repository
-./.agent/scripts/code-audit-helper.sh coderabbit-analysis personal repo-id
+./.agents/scripts/code-audit-helper.sh coderabbit-analysis personal repo-id
 
 # Start CodeRabbit MCP server
-./.agent/scripts/code-audit-helper.sh start-mcp coderabbit 3003
+./.agents/scripts/code-audit-helper.sh start-mcp coderabbit 3003
 ```
 
 ### **CodeFactor Operations:**
 
 ```bash
 # List CodeFactor repositories
-./.agent/scripts/code-audit-helper.sh codefactor-repos personal
+./.agents/scripts/code-audit-helper.sh codefactor-repos personal
 
 # Get issues for repository
-./.agent/scripts/code-audit-helper.sh codefactor-issues personal my-repo
+./.agents/scripts/code-audit-helper.sh codefactor-issues personal my-repo
 
 # Check repository grade
 curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/my-repo
@@ -145,26 +145,26 @@ curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/m
 
 ```bash
 # List Codacy repositories
-./.agent/scripts/code-audit-helper.sh codacy-repos organization
+./.agents/scripts/code-audit-helper.sh codacy-repos organization
 
 # Get quality overview
-./.agent/scripts/code-audit-helper.sh codacy-quality organization my-repo
+./.agents/scripts/code-audit-helper.sh codacy-quality organization my-repo
 
 # Start Codacy MCP server
-./.agent/scripts/code-audit-helper.sh start-mcp codacy 3004
+./.agents/scripts/code-audit-helper.sh start-mcp codacy 3004
 ```
 
 ### **SonarCloud Operations:**
 
 ```bash
 # List SonarCloud projects
-./.agent/scripts/code-audit-helper.sh sonarcloud-projects personal
+./.agents/scripts/code-audit-helper.sh sonarcloud-projects personal
 
 # Get project measures
-./.agent/scripts/code-audit-helper.sh sonarcloud-measures personal project-key
+./.agents/scripts/code-audit-helper.sh sonarcloud-measures personal project-key
 
 # Start SonarCloud MCP server
-./.agent/scripts/code-audit-helper.sh start-mcp sonarcloud 3005
+./.agents/scripts/code-audit-helper.sh start-mcp sonarcloud 3005
 ```
 
 ## Security Best Practices
@@ -181,14 +181,14 @@ curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/m
 
 ```bash
 # Regular security audits
-./.agent/scripts/code-audit-helper.sh audit my-repository
+./.agents/scripts/code-audit-helper.sh audit my-repository
 
 # Monitor for security vulnerabilities
 # Check SonarCloud security hotspots
-./.agent/scripts/code-audit-helper.sh sonarcloud-measures personal project-key
+./.agents/scripts/code-audit-helper.sh sonarcloud-measures personal project-key
 
 # Review Codacy security issues
-./.agent/scripts/code-audit-helper.sh codacy-quality organization my-repo
+./.agents/scripts/code-audit-helper.sh codacy-quality organization my-repo
 ```
 
 ## Quality Gates & Metrics
@@ -229,7 +229,7 @@ curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/m
 
 ```bash
 # Start CodeRabbit MCP server
-./.agent/scripts/code-audit-helper.sh start-mcp coderabbit 3003
+./.agents/scripts/code-audit-helper.sh start-mcp coderabbit 3003
 
 # Configure in AI assistant
 {
@@ -250,7 +250,7 @@ curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/m
 # https://github.com/codacy/codacy-mcp-server
 
 # Start server
-./.agent/scripts/code-audit-helper.sh start-mcp codacy 3004
+./.agents/scripts/code-audit-helper.sh start-mcp codacy 3004
 ```
 
 #### **SonarCloud MCP:**
@@ -260,7 +260,7 @@ curl -H "X-CF-TOKEN: $API_TOKEN" https://www.codefactor.io/api/v1/repositories/m
 # https://github.com/SonarSource/sonarqube-mcp-server
 
 # Start server
-./.agent/scripts/code-audit-helper.sh start-mcp sonarcloud 3005
+./.agents/scripts/code-audit-helper.sh start-mcp sonarcloud 3005
 ```
 
 ### **AI Assistant Capabilities:**
@@ -289,8 +289,8 @@ jobs:
       - uses: actions/checkout@v3
       - name: Run Code Audit
         run: |
-          ./.agent/scripts/code-audit-helper.sh audit ${{ github.repository }}
-          ./.agent/scripts/code-audit-helper.sh report ${{ github.repository }} audit-report.json
+          ./.agents/scripts/code-audit-helper.sh audit ${{ github.repository }}
+          ./.agents/scripts/code-audit-helper.sh report ${{ github.repository }} audit-report.json
       - name: Upload Report
         uses: actions/upload-artifact@v3
         with:
@@ -307,8 +307,8 @@ REPO_NAME="$1"
 REPORT_FILE="audit-report-$(date +%Y%m%d-%H%M%S).json"
 
 # Run comprehensive audit
-./.agent/scripts/code-audit-helper.sh audit "$REPO_NAME"
-./.agent/scripts/code-audit-helper.sh report "$REPO_NAME" "$REPORT_FILE"
+./.agents/scripts/code-audit-helper.sh audit "$REPO_NAME"
+./.agents/scripts/code-audit-helper.sh report "$REPO_NAME" "$REPORT_FILE"
 
 # Check quality gates
 COVERAGE=$(jq -r '.coverage' "$REPORT_FILE")
diff --git a/.agent/tools/code-review/automation.md b/.agents/tools/code-review/automation.md
similarity index 82%
rename from .agent/tools/code-review/automation.md
rename to .agents/tools/code-review/automation.md
index c1e6bc3f3..04e4d6ec2 100644
--- a/.agent/tools/code-review/automation.md
+++ b/.agents/tools/code-review/automation.md
@@ -18,15 +18,15 @@ tools:
 
 ## Quick Reference
 
-- Master script: `bash .agent/scripts/linters-local.sh` (multi-platform validation)
-- Fix script: `bash .agent/scripts/quality-fix.sh [file|dir]`
+- Master script: `bash .agents/scripts/linters-local.sh` (multi-platform validation)
+- Fix script: `bash .agents/scripts/quality-fix.sh [file|dir]`
 - SonarCloud rules: S7679 (positional params), S1481 (unused vars), S1192 (strings), S7682 (returns)
 - Specialized fixes:
   - `fix-content-type.sh` - Content-Type header constants
   - `fix-auth-headers.sh` - Authorization header patterns
   - `fix-error-messages.sh` - Error message consolidation
   - `markdown-formatter.sh` - Markdown linting/formatting
-- CLI manager: `bash .agent/scripts/quality-cli-manager.sh install|analyze|status all`
+- CLI manager: `bash .agents/scripts/quality-cli-manager.sh install|analyze|status all`
 - Platform CLIs: CodeRabbit, Codacy, SonarScanner
 - Achievement: 349 -> 42 issues (88% reduction), A-grade platforms
 <!-- AI-CONTEXT-END -->
@@ -45,7 +45,7 @@ This guide provides detailed documentation of our quality automation tools and t
 #### linters-local.sh - Master Quality Validator
 
 **Purpose**: Comprehensive multi-platform quality validation
-**Usage**: `bash .agent/scripts/linters-local.sh`
+**Usage**: `bash .agents/scripts/linters-local.sh`
 
 **Checks Performed**:
 
@@ -60,7 +60,7 @@ This guide provides detailed documentation of our quality automation tools and t
 #### quality-fix.sh - Universal Issue Resolution
 
 **Purpose**: Automated fixing of common quality issues
-**Usage**: `bash .agent/scripts/quality-fix.sh [file|directory]`
+**Usage**: `bash .agents/scripts/quality-fix.sh [file|directory]`
 
 **Fixes Applied**:
 
@@ -113,13 +113,13 @@ This guide provides detailed documentation of our quality automation tools and t
 
 ```bash
 # Install all quality CLIs
-bash .agent/scripts/quality-cli-manager.sh install all
+bash .agents/scripts/quality-cli-manager.sh install all
 
 # Run comprehensive analysis
-bash .agent/scripts/quality-cli-manager.sh analyze all
+bash .agents/scripts/quality-cli-manager.sh analyze all
 
 # Check status of all platforms
-bash .agent/scripts/quality-cli-manager.sh status all
+bash .agents/scripts/quality-cli-manager.sh status all
 ```
 
 #### Individual Platform CLIs
@@ -127,21 +127,21 @@ bash .agent/scripts/quality-cli-manager.sh status all
 **CodeRabbit CLI**: AI-powered code review
 
 ```bash
-bash .agent/scripts/coderabbit-cli.sh review
-bash .agent/scripts/coderabbit-cli.sh analyze .agent/scripts/
+bash .agents/scripts/coderabbit-cli.sh review
+bash .agents/scripts/coderabbit-cli.sh analyze .agents/scripts/
 ```
 
 **Codacy CLI v2**: Comprehensive static analysis
 
 ```bash
-bash .agent/scripts/codacy-cli.sh analyze
-bash .agent/scripts/codacy-cli.sh upload results.sarif
+bash .agents/scripts/codacy-cli.sh analyze
+bash .agents/scripts/codacy-cli.sh upload results.sarif
 ```
 
 **SonarScanner CLI**: SonarCloud integration
 
 ```bash
-bash .agent/scripts/sonarscanner-cli.sh analyze
+bash .agents/scripts/sonarscanner-cli.sh analyze
 ```
 
 ### Automation Workflows
@@ -153,16 +153,16 @@ bash .agent/scripts/sonarscanner-cli.sh analyze
 # Run before every commit
 
 # 1. Comprehensive quality check
-bash .agent/scripts/linters-local.sh
+bash .agents/scripts/linters-local.sh
 
 # 2. Fix common issues
-bash .agent/scripts/quality-fix.sh .
+bash .agents/scripts/quality-fix.sh .
 
 # 3. Format markdown
-bash .agent/scripts/markdown-formatter.sh .
+bash .agents/scripts/markdown-formatter.sh .
 
 # 4. Verify improvements
-bash .agent/scripts/linters-local.sh
+bash .agents/scripts/linters-local.sh
 ```
 
 #### Continuous Quality Monitoring
@@ -172,10 +172,10 @@ bash .agent/scripts/linters-local.sh
 # Daily quality monitoring
 
 # 1. Multi-platform analysis
-bash .agent/scripts/quality-cli-manager.sh analyze all
+bash .agents/scripts/quality-cli-manager.sh analyze all
 
 # 2. Generate quality report
-bash .agent/scripts/linters-local.sh > quality-report.txt
+bash .agents/scripts/linters-local.sh > quality-report.txt
 
 # 3. Track progress
 echo "$(date): $(grep 'SonarCloud:' quality-report.txt)" >> quality-history.log
diff --git a/.agent/tools/code-review/best-practices.md b/.agents/tools/code-review/best-practices.md
similarity index 95%
rename from .agent/tools/code-review/best-practices.md
rename to .agents/tools/code-review/best-practices.md
index c1b57767e..10ca1a6b9 100644
--- a/.agent/tools/code-review/best-practices.md
+++ b/.agents/tools/code-review/best-practices.md
@@ -81,7 +81,7 @@ printf 'Price: %s50/month\n' '$'  # Not: echo "Price: $50/month"
 
 #### Pre-Development Checklist
 
-1. **Run quality check**: `bash .agent/scripts/linters-local.sh`
+1. **Run quality check**: `bash .agents/scripts/linters-local.sh`
 2. **Check current issues**: Note SonarCloud/Codacy/CodeFactor status
 3. **Plan improvements**: How will changes enhance quality?
 4. **Test functionality**: Ensure no feature loss
@@ -163,14 +163,14 @@ fi
 
 ```bash
 # CodeRabbit analysis
-bash .agent/scripts/coderabbit-cli.sh review
+bash .agents/scripts/coderabbit-cli.sh review
 
 # Comprehensive analysis
-bash .agent/scripts/quality-cli-manager.sh analyze all
+bash .agents/scripts/quality-cli-manager.sh analyze all
 
 # Individual platform analysis
-bash .agent/scripts/codacy-cli.sh analyze
-bash .agent/scripts/sonarscanner-cli.sh analyze
+bash .agents/scripts/codacy-cli.sh analyze
+bash .agents/scripts/sonarscanner-cli.sh analyze
 ```
 
 ### Success Metrics
diff --git a/.agent/tools/code-review/codacy.md b/.agents/tools/code-review/codacy.md
similarity index 87%
rename from .agent/tools/code-review/codacy.md
rename to .agents/tools/code-review/codacy.md
index d653c0f4b..0221e7de4 100644
--- a/.agent/tools/code-review/codacy.md
+++ b/.agents/tools/code-review/codacy.md
@@ -18,8 +18,8 @@ tools:
 
 ## Quick Reference
 
-- Auto-fix command: `bash .agent/scripts/codacy-cli.sh analyze --fix`
-- Via manager: `bash .agent/scripts/quality-cli-manager.sh analyze codacy-fix`
+- Auto-fix command: `bash .agents/scripts/codacy-cli.sh analyze --fix`
+- Via manager: `bash .agents/scripts/quality-cli-manager.sh analyze codacy-fix`
 - Fix types: Code style, best practices, security, performance, maintainability
 - Safety: Non-breaking, reversible, conservative (skips ambiguous)
 - Metrics: 70-90% time savings, 99%+ accuracy, 60-80% violation coverage
@@ -57,32 +57,32 @@ Codacy CLI v2 provides automated fix capabilities that mirror the "Fix Issues" f
 
 ```bash
 # Basic auto-fix analysis
-bash .agent/scripts/codacy-cli.sh analyze --fix
+bash .agents/scripts/codacy-cli.sh analyze --fix
 
 # Auto-fix with specific tool
-bash .agent/scripts/codacy-cli.sh analyze eslint --fix
+bash .agents/scripts/codacy-cli.sh analyze eslint --fix
 
 # Check what would be fixed (dry-run equivalent)
-bash .agent/scripts/codacy-cli.sh analyze
+bash .agents/scripts/codacy-cli.sh analyze
 ```
 
 #### **Method 2: Quality CLI Manager**
 
 ```bash
 # Auto-fix via unified manager
-bash .agent/scripts/quality-cli-manager.sh analyze codacy-fix
+bash .agents/scripts/quality-cli-manager.sh analyze codacy-fix
 
 # Status check before auto-fix
-bash .agent/scripts/quality-cli-manager.sh status codacy
+bash .agents/scripts/quality-cli-manager.sh status codacy
 ```
 
 #### **Method 3: Integration with Quality Workflow**
 
 ```bash
 # Pre-commit auto-fix workflow
-bash .agent/scripts/linters-local.sh
-bash .agent/scripts/codacy-cli.sh analyze --fix
-bash .agent/scripts/linters-local.sh  # Verify improvements
+bash .agents/scripts/linters-local.sh
+bash .agents/scripts/codacy-cli.sh analyze --fix
+bash .agents/scripts/linters-local.sh  # Verify improvements
 ```
 
 ### **📊 EXPECTED RESULTS**
@@ -118,7 +118,7 @@ bash .agent/scripts/linters-local.sh  # Verify improvements
 # GitHub Actions example
 - name: Auto-fix code quality issues
   run: |
-    bash .agent/scripts/codacy-cli.sh analyze --fix
+    bash .agents/scripts/codacy-cli.sh analyze --fix
     git add .
     git diff --staged --quiet || git commit -m "🔧 AUTO-FIX: Applied Codacy automated fixes"
 ```
diff --git a/.agent/tools/code-review/code-simplifier.md b/.agents/tools/code-review/code-simplifier.md
similarity index 100%
rename from .agent/tools/code-review/code-simplifier.md
rename to .agents/tools/code-review/code-simplifier.md
diff --git a/.agent/tools/code-review/code-standards.md b/.agents/tools/code-review/code-standards.md
similarity index 94%
rename from .agent/tools/code-review/code-standards.md
rename to .agents/tools/code-review/code-standards.md
index 7f40c8eee..454398158 100644
--- a/.agent/tools/code-review/code-standards.md
+++ b/.agents/tools/code-review/code-standards.md
@@ -39,8 +39,8 @@ tools:
 ~/.aidevops/agents/scripts/linters-local.sh
 
 # Check specific rules
-grep -L "return [01]" .agent/scripts/*.sh  # S7682
-grep -n '\$[1-9]' .agent/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'  # S7679
+grep -L "return [01]" .agents/scripts/*.sh  # S7682
+grep -n '\$[1-9]' .agents/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'  # S7679
 ```
 
 **Workflow Position**: Reference during development, validated by `/linters-local`
@@ -80,7 +80,7 @@ function_name() {
 **Validation**:
 
 ```bash
-grep -L "return [01]" .agent/scripts/*.sh
+grep -L "return [01]" .agents/scripts/*.sh
 ```
 
 ### S7679 - Positional Parameters
@@ -115,7 +115,7 @@ main() {
 **Validation**:
 
 ```bash
-grep -n '\$[1-9]' .agent/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'
+grep -n '\$[1-9]' .agents/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'
 ```
 
 ### S1192 - String Literals
@@ -140,7 +140,7 @@ print_error "Account name is required"  # Causes S1192 violation
 **Validation**:
 
 ```bash
-for file in .agent/scripts/*.sh; do
+for file in .agents/scripts/*.sh; do
     echo "=== $file ==="
     grep -o '"[^"]*"' "$file" | sort | uniq -c | sort -nr | head -5
 done
@@ -173,7 +173,7 @@ All shell scripts must pass ShellCheck with zero violations.
 
 ```bash
 # Validate all scripts
-find .agent/scripts/ -name "*.sh" -exec shellcheck {} \;
+find .agents/scripts/ -name "*.sh" -exec shellcheck {} \;
 
 # Validate single script
 shellcheck script.sh
@@ -362,13 +362,13 @@ Before committing, verify:
 ~/.aidevops/agents/scripts/linters-local.sh
 
 # 2. Check return statements
-grep -L "return [01]" .agent/scripts/*.sh
+grep -L "return [01]" .agents/scripts/*.sh
 
 # 3. Check positional parameters
-grep -n '\$[1-9]' .agent/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'
+grep -n '\$[1-9]' .agents/scripts/*.sh | grep -v 'local.*=.*\$[1-9]'
 
 # 4. Run ShellCheck
-find .agent/scripts/ -name "*.sh" -exec shellcheck {} \;
+find .agents/scripts/ -name "*.sh" -exec shellcheck {} \;
 
 # 5. Check for secrets
 ~/.aidevops/agents/scripts/secretlint-helper.sh scan
diff --git a/.agent/tools/code-review/coderabbit.md b/.agents/tools/code-review/coderabbit.md
similarity index 100%
rename from .agent/tools/code-review/coderabbit.md
rename to .agents/tools/code-review/coderabbit.md
diff --git a/.agent/tools/code-review/management.md b/.agents/tools/code-review/management.md
similarity index 100%
rename from .agent/tools/code-review/management.md
rename to .agents/tools/code-review/management.md
diff --git a/.agent/tools/code-review/qlty.md b/.agents/tools/code-review/qlty.md
similarity index 82%
rename from .agent/tools/code-review/qlty.md
rename to .agents/tools/code-review/qlty.md
index 5a36c0ae1..67d8aac3b 100644
--- a/.agent/tools/code-review/qlty.md
+++ b/.agents/tools/code-review/qlty.md
@@ -23,9 +23,9 @@ tools:
   - Account API Key (`qltp_...`) - PREFERRED, account-wide access
   - Coverage Token (`qltcw_...`) - Organization-specific fallback
   - Workspace ID (UUID) - Context identifier
-- Store credentials: `bash .agent/scripts/setup-local-api-keys.sh set qlty-account-api-key KEY`
+- Store credentials: `bash .agents/scripts/setup-local-api-keys.sh set qlty-account-api-key KEY`
 - Organization-specific: `set qlty-ORGNAME TOKEN`, `set qlty-ORGNAME-workspace-id UUID`
-- Commands: `bash .agent/scripts/qlty-cli.sh install|init|check|fmt --all|smells --all [ORG]`
+- Commands: `bash .agents/scripts/qlty-cli.sh install|init|check|fmt --all|smells --all [ORG]`
 - Current config: Account API key active, marcusquinn org fully configured
 - Storage: `~/.config/aidevops/api-keys` (600 permissions)
 - Path: Ensure `~/.qlty/bin` in PATH
@@ -103,39 +103,39 @@ The CLI automatically selects the best available credential:
 
 ```bash
 # PREFERRED: Store Account API Key (account-wide access)
-bash .agent/scripts/setup-local-api-keys.sh set qlty-account-api-key YOUR_ACCOUNT_API_KEY
+bash .agents/scripts/setup-local-api-keys.sh set qlty-account-api-key YOUR_ACCOUNT_API_KEY
 
 # ALTERNATIVE: Store Coverage Token (organization-specific)
-bash .agent/scripts/setup-local-api-keys.sh set qlty-ORGNAME YOUR_COVERAGE_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set qlty-ORGNAME YOUR_COVERAGE_TOKEN
 
 # OPTIONAL: Store Workspace ID (context for operations)
-bash .agent/scripts/setup-local-api-keys.sh set qlty-ORGNAME-workspace-id YOUR_WORKSPACE_ID
+bash .agents/scripts/setup-local-api-keys.sh set qlty-ORGNAME-workspace-id YOUR_WORKSPACE_ID
 ```
 
 ### 2. Verify Configuration
 
 ```bash
 # List all configured services
-bash .agent/scripts/setup-local-api-keys.sh list
+bash .agents/scripts/setup-local-api-keys.sh list
 
 # Check Qlty CLI help (shows configured organizations)
-bash .agent/scripts/qlty-cli.sh help
+bash .agents/scripts/qlty-cli.sh help
 ```
 
 ### 3. Test Functionality
 
 ```bash
 # Install Qlty CLI
-bash .agent/scripts/qlty-cli.sh install
+bash .agents/scripts/qlty-cli.sh install
 
 # Initialize repository
-bash .agent/scripts/qlty-cli.sh init
+bash .agents/scripts/qlty-cli.sh init
 
 # Test with default organization
-bash .agent/scripts/qlty-cli.sh check 5
+bash .agents/scripts/qlty-cli.sh check 5
 
 # Test with specific organization
-bash .agent/scripts/qlty-cli.sh check 5 ORGNAME
+bash .agents/scripts/qlty-cli.sh check 5 ORGNAME
 ```
 
 ## Usage Examples
@@ -144,26 +144,26 @@ bash .agent/scripts/qlty-cli.sh check 5 ORGNAME
 
 ```bash
 # Code quality check
-bash .agent/scripts/qlty-cli.sh check
+bash .agents/scripts/qlty-cli.sh check
 
 # Auto-format all files
-bash .agent/scripts/qlty-cli.sh fmt --all
+bash .agents/scripts/qlty-cli.sh fmt --all
 
 # Detect code smells
-bash .agent/scripts/qlty-cli.sh smells --all
+bash .agents/scripts/qlty-cli.sh smells --all
 ```
 
 ### Specific Organization
 
 ```bash
 # Code quality check for 'mycompany' organization
-bash .agent/scripts/qlty-cli.sh check 10 mycompany
+bash .agents/scripts/qlty-cli.sh check 10 mycompany
 
 # Auto-format for 'clientorg' organization
-bash .agent/scripts/qlty-cli.sh fmt --all clientorg
+bash .agents/scripts/qlty-cli.sh fmt --all clientorg
 
 # Code smells for 'teamproject' organization
-bash .agent/scripts/qlty-cli.sh smells --all teamproject
+bash .agents/scripts/qlty-cli.sh smells --all teamproject
 ```
 
 ## Multi-Organization Management
@@ -211,10 +211,10 @@ bash .agent/scripts/qlty-cli.sh smells --all teamproject
 
 ```bash
 # Check stored configurations
-bash .agent/scripts/setup-local-api-keys.sh list
+bash .agents/scripts/setup-local-api-keys.sh list
 
 # Test token loading
-bash .agent/scripts/qlty-cli.sh check 1 ORGNAME
+bash .agents/scripts/qlty-cli.sh check 1 ORGNAME
 
 # Verify CLI installation
 qlty --version
@@ -228,10 +228,10 @@ Qlty CLI integrates with the unified Quality CLI Manager:
 
 ```bash
 # Install all quality tools including Qlty
-bash .agent/scripts/quality-cli-manager.sh install all
+bash .agents/scripts/quality-cli-manager.sh install all
 
 # Run Qlty analysis through manager
-bash .agent/scripts/quality-cli-manager.sh analyze qlty
+bash .agents/scripts/quality-cli-manager.sh analyze qlty
 ```
 
 ### GitHub Actions
diff --git a/.agent/tools/code-review/secretlint.md b/.agents/tools/code-review/secretlint.md
similarity index 86%
rename from .agent/tools/code-review/secretlint.md
rename to .agents/tools/code-review/secretlint.md
index cc47b004f..c3fdc8552 100644
--- a/.agent/tools/code-review/secretlint.md
+++ b/.agents/tools/code-review/secretlint.md
@@ -49,38 +49,38 @@ Secretlint is a pluggable linting tool designed to prevent committing credential
 
 ```bash
 # Option 1: Local installation (recommended for projects)
-./.agent/scripts/secretlint-helper.sh install
+./.agents/scripts/secretlint-helper.sh install
 
 # Option 2: Quick scan without installation
-./.agent/scripts/secretlint-helper.sh quick
+./.agents/scripts/secretlint-helper.sh quick
 
 # Option 3: Docker (no Node.js required)
-./.agent/scripts/secretlint-helper.sh docker
+./.agents/scripts/secretlint-helper.sh docker
 
 # Option 4: Global installation
-./.agent/scripts/secretlint-helper.sh install global
+./.agents/scripts/secretlint-helper.sh install global
 ```
 
 ### Basic Usage
 
 ```bash
 # Check installation status
-./.agent/scripts/secretlint-helper.sh status
+./.agents/scripts/secretlint-helper.sh status
 
 # Initialize configuration
-./.agent/scripts/secretlint-helper.sh init
+./.agents/scripts/secretlint-helper.sh init
 
 # Scan all files
-./.agent/scripts/secretlint-helper.sh scan
+./.agents/scripts/secretlint-helper.sh scan
 
 # Scan specific directory
-./.agent/scripts/secretlint-helper.sh scan "src/**/*"
+./.agents/scripts/secretlint-helper.sh scan "src/**/*"
 
 # Quick scan (no installation needed)
-./.agent/scripts/secretlint-helper.sh quick
+./.agents/scripts/secretlint-helper.sh quick
 
 # Scan via Docker
-./.agent/scripts/secretlint-helper.sh docker
+./.agents/scripts/secretlint-helper.sh docker
 ```
 
 ## Detected Secret Types
@@ -240,7 +240,7 @@ secretlint "**/*"
 ```bash
 secretlint "**/*" --format json
 # or
-./.agent/scripts/secretlint-helper.sh scan . json
+./.agents/scripts/secretlint-helper.sh scan . json
 ```
 
 ### SARIF (for CI/CD)
@@ -252,7 +252,7 @@ npm install @secretlint/secretlint-formatter-sarif --save-dev
 # Generate SARIF
 secretlint "**/*" --format @secretlint/secretlint-formatter-sarif > results.sarif
 # or
-./.agent/scripts/secretlint-helper.sh sarif
+./.agents/scripts/secretlint-helper.sh sarif
 ```
 
 ### Mask Result (fix secrets)
@@ -261,7 +261,7 @@ secretlint "**/*" --format @secretlint/secretlint-formatter-sarif > results.sari
 # Mask secrets in a file and overwrite
 secretlint .zsh_history --format=mask-result --output=.zsh_history
 # or
-./.agent/scripts/secretlint-helper.sh mask .env.example
+./.agents/scripts/secretlint-helper.sh mask .env.example
 ```
 
 ## Pre-commit Integration
@@ -270,14 +270,14 @@ secretlint .zsh_history --format=mask-result --output=.zsh_history
 
 ```bash
 # Setup via helper
-./.agent/scripts/secretlint-helper.sh hook
+./.agents/scripts/secretlint-helper.sh hook
 ```
 
 ### Option 2: Husky + lint-staged (Node.js projects)
 
 ```bash
 # Setup via helper
-./.agent/scripts/secretlint-helper.sh husky
+./.agents/scripts/secretlint-helper.sh husky
 ```
 
 Or manually:
@@ -473,28 +473,28 @@ The Docker image includes:
 
 ```bash
 # Installation
-./.agent/scripts/secretlint-helper.sh install         # Local install
-./.agent/scripts/secretlint-helper.sh install global  # Global install
-./.agent/scripts/secretlint-helper.sh install-rules all  # Additional rules
+./.agents/scripts/secretlint-helper.sh install         # Local install
+./.agents/scripts/secretlint-helper.sh install global  # Global install
+./.agents/scripts/secretlint-helper.sh install-rules all  # Additional rules
 
 # Configuration
-./.agent/scripts/secretlint-helper.sh init            # Initialize config
-./.agent/scripts/secretlint-helper.sh status          # Check status
+./.agents/scripts/secretlint-helper.sh init            # Initialize config
+./.agents/scripts/secretlint-helper.sh status          # Check status
 
 # Scanning
-./.agent/scripts/secretlint-helper.sh scan            # Scan all files
-./.agent/scripts/secretlint-helper.sh scan "src/**/*" # Scan specific
-./.agent/scripts/secretlint-helper.sh quick           # Quick scan (npx)
-./.agent/scripts/secretlint-helper.sh docker          # Docker scan
+./.agents/scripts/secretlint-helper.sh scan            # Scan all files
+./.agents/scripts/secretlint-helper.sh scan "src/**/*" # Scan specific
+./.agents/scripts/secretlint-helper.sh quick           # Quick scan (npx)
+./.agents/scripts/secretlint-helper.sh docker          # Docker scan
 
 # Output
-./.agent/scripts/secretlint-helper.sh scan . json     # JSON output
-./.agent/scripts/secretlint-helper.sh sarif           # SARIF output
-./.agent/scripts/secretlint-helper.sh mask file.txt   # Mask secrets
+./.agents/scripts/secretlint-helper.sh scan . json     # JSON output
+./.agents/scripts/secretlint-helper.sh sarif           # SARIF output
+./.agents/scripts/secretlint-helper.sh mask file.txt   # Mask secrets
 
 # Hooks
-./.agent/scripts/secretlint-helper.sh hook            # Git hook
-./.agent/scripts/secretlint-helper.sh husky           # Husky setup
+./.agents/scripts/secretlint-helper.sh hook            # Git hook
+./.agents/scripts/secretlint-helper.sh husky           # Husky setup
 ```
 
 ### Quality Pipeline Integration
@@ -503,10 +503,10 @@ Secretlint integrates with the framework's quality pipeline:
 
 ```bash
 # Run as part of quality checks
-./.agent/scripts/linters-local.sh  # Includes secretlint
+./.agents/scripts/linters-local.sh  # Includes secretlint
 
 # Pre-commit validation
-./.agent/scripts/pre-commit-hook.sh  # Includes secretlint
+./.agents/scripts/pre-commit-hook.sh  # Includes secretlint
 ```
 
 ## Troubleshooting
@@ -525,13 +525,13 @@ npm install --save-dev secretlint @secretlint/secretlint-rule-preset-recommend
 npm install -g secretlint @secretlint/secretlint-rule-preset-recommend
 
 # Verify installation
-./.agent/scripts/secretlint-helper.sh status
+./.agents/scripts/secretlint-helper.sh status
 ```
 
 **"No configuration file found"**
 
 ```bash
-./.agent/scripts/secretlint-helper.sh init
+./.agents/scripts/secretlint-helper.sh init
 ```
 
 **"secretlint command not found"**
@@ -549,15 +549,15 @@ Exit code 2 indicates a configuration or installation error (not secrets found).
 
 ```bash
 # Diagnose the issue
-./.agent/scripts/secretlint-helper.sh status
+./.agents/scripts/secretlint-helper.sh status
 
 # Common fixes:
 # 1. Missing rules - reinstall
-./.agent/scripts/secretlint-helper.sh install
+./.agents/scripts/secretlint-helper.sh install
 
 # 2. Invalid config - reinitialize
 rm .secretlintrc.json
-./.agent/scripts/secretlint-helper.sh init
+./.agents/scripts/secretlint-helper.sh init
 ```
 
 **Performance issues with large repos**
diff --git a/.agent/tools/code-review/security-analysis.md b/.agents/tools/code-review/security-analysis.md
similarity index 86%
rename from .agent/tools/code-review/security-analysis.md
rename to .agents/tools/code-review/security-analysis.md
index 193ec33e7..6691101f1 100644
--- a/.agent/tools/code-review/security-analysis.md
+++ b/.agents/tools/code-review/security-analysis.md
@@ -21,7 +21,7 @@ mcp:
 
 ## Quick Reference
 
-- **Helper**: `.agent/scripts/security-helper.sh`
+- **Helper**: `.agents/scripts/security-helper.sh`
 - **Commands**: `analyze [scope]` | `scan-deps` | `history [commits]` | `ferret` | `report`
 - **Scopes**: `diff` (default), `staged`, `branch`, `full`
 - **Output**: `.security-analysis/` directory with reports
@@ -63,25 +63,25 @@ This tool provides comprehensive security scanning capabilities:
 
 ```bash
 # Check installation status
-./.agent/scripts/security-helper.sh status
+./.agents/scripts/security-helper.sh status
 
 # Analyze current changes (git diff)
-./.agent/scripts/security-helper.sh analyze
+./.agents/scripts/security-helper.sh analyze
 
 # Analyze full codebase
-./.agent/scripts/security-helper.sh analyze full
+./.agents/scripts/security-helper.sh analyze full
 
 # Scan git history (last 50 commits)
-./.agent/scripts/security-helper.sh history 50
+./.agents/scripts/security-helper.sh history 50
 
 # Scan dependencies for vulnerabilities
-./.agent/scripts/security-helper.sh scan-deps
+./.agents/scripts/security-helper.sh scan-deps
 
 # Generate comprehensive report
-./.agent/scripts/security-helper.sh report
+./.agents/scripts/security-helper.sh report
 
 # Scan AI CLI configurations (Ferret)
-./.agent/scripts/security-helper.sh ferret
+./.agents/scripts/security-helper.sh ferret
 ```
 
 ## Scan Modes
@@ -91,9 +91,9 @@ This tool provides comprehensive security scanning capabilities:
 Analyzes uncommitted changes using `git diff --merge-base origin/HEAD`:
 
 ```bash
-./.agent/scripts/security-helper.sh analyze
+./.agents/scripts/security-helper.sh analyze
 # or explicitly
-./.agent/scripts/security-helper.sh analyze diff
+./.agents/scripts/security-helper.sh analyze diff
 ```
 
 ### Staged Changes
@@ -101,7 +101,7 @@ Analyzes uncommitted changes using `git diff --merge-base origin/HEAD`:
 Analyzes only staged changes:
 
 ```bash
-./.agent/scripts/security-helper.sh analyze staged
+./.agents/scripts/security-helper.sh analyze staged
 ```
 
 ### Branch Analysis
@@ -109,7 +109,7 @@ Analyzes only staged changes:
 Analyzes all changes on the current branch compared to main:
 
 ```bash
-./.agent/scripts/security-helper.sh analyze branch
+./.agents/scripts/security-helper.sh analyze branch
 ```
 
 ### Full Codebase Scan
@@ -117,17 +117,17 @@ Analyzes all changes on the current branch compared to main:
 Scans the entire codebase for vulnerabilities:
 
 ```bash
-./.agent/scripts/security-helper.sh analyze full
+./.agents/scripts/security-helper.sh analyze full
 ```
 
 **Note**: Full scans can be time-consuming for large codebases. Consider using file filters:
 
 ```bash
 # Scan only specific directories
-./.agent/scripts/security-helper.sh analyze full --include="src/**/*.ts,lib/**/*.js"
+./.agents/scripts/security-helper.sh analyze full --include="src/**/*.ts,lib/**/*.js"
 
 # Exclude test files
-./.agent/scripts/security-helper.sh analyze full --exclude="**/*.test.ts,**/*.spec.js"
+./.agents/scripts/security-helper.sh analyze full --exclude="**/*.test.ts,**/*.spec.js"
 ```
 
 ### Git History Scan
@@ -136,16 +136,16 @@ Scans historical commits for vulnerabilities that may have been introduced:
 
 ```bash
 # Scan last 50 commits
-./.agent/scripts/security-helper.sh history 50
+./.agents/scripts/security-helper.sh history 50
 
 # Scan specific commit range
-./.agent/scripts/security-helper.sh history abc123..def456
+./.agents/scripts/security-helper.sh history abc123..def456
 
 # Scan commits since a date
-./.agent/scripts/security-helper.sh history --since="2024-01-01"
+./.agents/scripts/security-helper.sh history --since="2024-01-01"
 
 # Scan commits by author
-./.agent/scripts/security-helper.sh history --author="developer@example.com"
+./.agents/scripts/security-helper.sh history --author="developer@example.com"
 ```
 
 ## Vulnerability Detection
@@ -194,7 +194,7 @@ Ferret is a specialized security scanner for AI assistant configurations (Claude
 
 **Install**: `npm install -g ferret-scan` or use `npx ferret-scan`
 
-**Usage**: `./.agent/scripts/security-helper.sh ferret` or `ferret scan .`
+**Usage**: `./.agents/scripts/security-helper.sh ferret` or `ferret scan .`
 
 **Full documentation**: [github.com/fubak/ferret-scan](https://github.com/fubak/ferret-scan)
 
@@ -254,13 +254,13 @@ Uses OSV-Scanner to identify vulnerable dependencies:
 
 ```bash
 # Scan current project
-./.agent/scripts/security-helper.sh scan-deps
+./.agents/scripts/security-helper.sh scan-deps
 
 # Scan with recursive lockfile detection
-./.agent/scripts/security-helper.sh scan-deps --recursive
+./.agents/scripts/security-helper.sh scan-deps --recursive
 
 # Output as JSON
-./.agent/scripts/security-helper.sh scan-deps --format=json
+./.agents/scripts/security-helper.sh scan-deps --format=json
 ```
 
 ### Supported Package Managers
@@ -326,7 +326,7 @@ const result = await db.query(query, [req.params.id]);
 For CI/CD integration, generate SARIF format:
 
 ```bash
-./.agent/scripts/security-helper.sh report --format=sarif
+./.agents/scripts/security-helper.sh report --format=sarif
 ```
 
 ## CI/CD Integration
@@ -347,8 +347,8 @@ jobs:
 
       - name: Run Security Analysis
         run: |
-          ./.agent/scripts/security-helper.sh analyze branch
-          ./.agent/scripts/security-helper.sh scan-deps
+          ./.agents/scripts/security-helper.sh analyze branch
+          ./.agents/scripts/security-helper.sh scan-deps
 
       - name: Upload SARIF
         uses: github/codeql-action/upload-sarif@v3
@@ -370,7 +370,7 @@ jobs:
 # .git/hooks/pre-commit
 
 # Run security analysis on staged changes
-./.agent/scripts/security-helper.sh analyze staged --severity-threshold=high
+./.agents/scripts/security-helper.sh analyze staged --severity-threshold=high
 
 if [ $? -ne 0 ]; then
     echo "Security issues found. Please fix before committing."
@@ -512,7 +512,7 @@ For large codebases, consider scanning specific directories:
 
 ```bash
 # Scan only source files (exclude tests, node_modules, etc.)
-cd src && ./.agent/scripts/security-helper.sh analyze full
+cd src && ./.agents/scripts/security-helper.sh analyze full
 ```
 
 **"Too many false positives"**
@@ -534,10 +534,10 @@ Security analysis integrates with the framework's quality pipeline:
 
 ```bash
 # Run as part of preflight checks
-./.agent/scripts/linters-local.sh  # Includes security-helper.sh
+./.agents/scripts/linters-local.sh  # Includes security-helper.sh
 
 # Full quality check
-./.agent/scripts/quality-check.sh  # Includes security analysis
+./.agents/scripts/quality-check.sh  # Includes security analysis
 ```
 
 ### CLI Usage
@@ -545,12 +545,12 @@ Security analysis integrates with the framework's quality pipeline:
 Run the helper script directly:
 
 ```bash
-./.agent/scripts/security-helper.sh analyze        # Default analysis (diff)
-./.agent/scripts/security-helper.sh analyze full   # Full codebase scan
-./.agent/scripts/security-helper.sh history 50     # Scan last 50 commits
-./.agent/scripts/security-helper.sh scan-deps      # Dependency scan
-./.agent/scripts/security-helper.sh ferret         # AI CLI config scan
-./.agent/scripts/security-helper.sh report         # Generate report
+./.agents/scripts/security-helper.sh analyze        # Default analysis (diff)
+./.agents/scripts/security-helper.sh analyze full   # Full codebase scan
+./.agents/scripts/security-helper.sh history 50     # Scan last 50 commits
+./.agents/scripts/security-helper.sh scan-deps      # Dependency scan
+./.agents/scripts/security-helper.sh ferret         # AI CLI config scan
+./.agents/scripts/security-helper.sh report         # Generate report
 ```
 
 ## Resources
diff --git a/.agent/tools/code-review/setup.md b/.agents/tools/code-review/setup.md
similarity index 100%
rename from .agent/tools/code-review/setup.md
rename to .agents/tools/code-review/setup.md
diff --git a/.agent/tools/code-review/snyk.md b/.agents/tools/code-review/snyk.md
similarity index 91%
rename from .agent/tools/code-review/snyk.md
rename to .agents/tools/code-review/snyk.md
index 9ba889d37..e8cdf6df8 100644
--- a/.agent/tools/code-review/snyk.md
+++ b/.agents/tools/code-review/snyk.md
@@ -48,7 +48,7 @@ Snyk provides four core security scanning capabilities:
 
 ```bash
 # Install via the helper script
-./.agent/scripts/snyk-helper.sh install
+./.agents/scripts/snyk-helper.sh install
 
 # Or install manually:
 # macOS (Homebrew)
@@ -66,7 +66,7 @@ chmod +x /usr/local/bin/snyk
 
 ```bash
 # Interactive OAuth authentication (recommended for local use)
-./.agent/scripts/snyk-helper.sh auth
+./.agents/scripts/snyk-helper.sh auth
 
 # Or set environment variable (recommended for CI/CD)
 export SNYK_TOKEN="your-api-token"
@@ -89,48 +89,48 @@ cp configs/snyk-config.json.txt configs/snyk-config.json
 
 ```bash
 # Check status and authentication
-./.agent/scripts/snyk-helper.sh status
+./.agents/scripts/snyk-helper.sh status
 
 # Scan current directory for dependency vulnerabilities
-./.agent/scripts/snyk-helper.sh test
+./.agents/scripts/snyk-helper.sh test
 
 # Scan source code for security issues
-./.agent/scripts/snyk-helper.sh code
+./.agents/scripts/snyk-helper.sh code
 
 # Scan a container image
-./.agent/scripts/snyk-helper.sh container nginx:latest
+./.agents/scripts/snyk-helper.sh container nginx:latest
 
 # Scan Infrastructure as Code files
-./.agent/scripts/snyk-helper.sh iac ./terraform/
+./.agents/scripts/snyk-helper.sh iac ./terraform/
 
 # Run all security scans
-./.agent/scripts/snyk-helper.sh full
+./.agents/scripts/snyk-helper.sh full
 ```
 
 ### Advanced Scanning
 
 ```bash
 # Scan with specific organization
-./.agent/scripts/snyk-helper.sh test . my-org
+./.agents/scripts/snyk-helper.sh test . my-org
 
 # Scan with JSON output for CI/CD
-./.agent/scripts/snyk-helper.sh test . "" "--json"
+./.agents/scripts/snyk-helper.sh test . "" "--json"
 
 # Scan with severity threshold
-./.agent/scripts/snyk-helper.sh test . "" "--severity-threshold=critical"
+./.agents/scripts/snyk-helper.sh test . "" "--severity-threshold=critical"
 
 # Scan all projects in a monorepo
-./.agent/scripts/snyk-helper.sh test . "" "--all-projects"
+./.agents/scripts/snyk-helper.sh test . "" "--all-projects"
 
 # Scan container with Dockerfile context
-./.agent/scripts/snyk-helper.sh container my-image:tag "" "--file=Dockerfile"
+./.agents/scripts/snyk-helper.sh container my-image:tag "" "--file=Dockerfile"
 ```
 
 ### Continuous Monitoring
 
 ```bash
 # Create project snapshot for monitoring
-./.agent/scripts/snyk-helper.sh monitor . my-org my-project-name
+./.agents/scripts/snyk-helper.sh monitor . my-org my-project-name
 
 # Monitor container image
 snyk container monitor nginx:latest --org=my-org
@@ -142,10 +142,10 @@ snyk container monitor nginx:latest --org=my-org
 
 ```bash
 # Generate CycloneDX SBOM (default)
-./.agent/scripts/snyk-helper.sh sbom . cyclonedx1.4+json sbom.json
+./.agents/scripts/snyk-helper.sh sbom . cyclonedx1.4+json sbom.json
 
 # Generate SPDX SBOM
-./.agent/scripts/snyk-helper.sh sbom . spdx2.3+json sbom-spdx.json
+./.agents/scripts/snyk-helper.sh sbom . spdx2.3+json sbom-spdx.json
 ```
 
 ## CI/CD Integration
@@ -264,7 +264,7 @@ Add to your MCP configuration file:
 snyk mcp
 
 # Or via helper script
-./.agent/scripts/snyk-helper.sh mcp
+./.agents/scripts/snyk-helper.sh mcp
 ```
 
 ## Severity Levels
@@ -546,16 +546,16 @@ The Snyk integration provides:
 
 ```bash
 # Status check
-./.agent/scripts/snyk-helper.sh status
+./.agents/scripts/snyk-helper.sh status
 
 # Full security scan
-./.agent/scripts/snyk-helper.sh full
+./.agents/scripts/snyk-helper.sh full
 
 # List configured organizations
-./.agent/scripts/snyk-helper.sh accounts
+./.agents/scripts/snyk-helper.sh accounts
 
 # Start MCP server
-./.agent/scripts/snyk-helper.sh mcp
+./.agents/scripts/snyk-helper.sh mcp
 ```
 
 ---
diff --git a/.agent/tools/code-review/tools.md b/.agents/tools/code-review/tools.md
similarity index 95%
rename from .agent/tools/code-review/tools.md
rename to .agents/tools/code-review/tools.md
index bd1c2a287..c2c396100 100644
--- a/.agent/tools/code-review/tools.md
+++ b/.agents/tools/code-review/tools.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- Linter manager: `bash .agent/scripts/linter-manager.sh detect|install-detected|install-all|install [lang]`
+- Linter manager: `bash .agents/scripts/linter-manager.sh detect|install-detected|install-all|install [lang]`
 - Languages: Python (pycodestyle, Pylint, Bandit, Ruff), JS/TS (Oxlint, ESLint), CSS (Stylelint), Shell (ShellCheck), Docker (Hadolint), YAML (Yamllint)
 - Platforms comparison:
   - CodeRabbit: AI code review, no auto-fix
@@ -68,16 +68,16 @@ CodeFactor uses a comprehensive collection of open-source analysis tools. Our fr
 
 ```bash
 # Detect languages in current project
-bash .agent/scripts/linter-manager.sh detect
+bash .agents/scripts/linter-manager.sh detect
 
 # Install linters for detected languages
-bash .agent/scripts/linter-manager.sh install-detected
+bash .agents/scripts/linter-manager.sh install-detected
 
 # Install all supported linters
-bash .agent/scripts/linter-manager.sh install-all
+bash .agents/scripts/linter-manager.sh install-all
 
 # Install linters for specific language
-bash .agent/scripts/linter-manager.sh install python
+bash .agents/scripts/linter-manager.sh install python
 ```
 
 ### Quality Analysis Platforms
diff --git a/.agent/tools/content/summarize.md b/.agents/tools/content/summarize.md
similarity index 100%
rename from .agent/tools/content/summarize.md
rename to .agents/tools/content/summarize.md
diff --git a/.agent/tools/context/augment-context-engine.md b/.agents/tools/context/augment-context-engine.md
similarity index 100%
rename from .agent/tools/context/augment-context-engine.md
rename to .agents/tools/context/augment-context-engine.md
diff --git a/.agent/tools/context/context-builder-agent.md b/.agents/tools/context/context-builder-agent.md
similarity index 100%
rename from .agent/tools/context/context-builder-agent.md
rename to .agents/tools/context/context-builder-agent.md
diff --git a/.agent/tools/context/context-builder.md b/.agents/tools/context/context-builder.md
similarity index 98%
rename from .agent/tools/context/context-builder.md
rename to .agents/tools/context/context-builder.md
index 242028850..3ba4f6e6a 100644
--- a/.agent/tools/context/context-builder.md
+++ b/.agents/tools/context/context-builder.md
@@ -138,10 +138,10 @@ The helper script is included in the aidevops framework:
 
 ```bash
 # Already available at
-~/Git/aidevops/.agent/scripts/context-builder-helper.sh
+~/Git/aidevops/.agents/scripts/context-builder-helper.sh
 
 # Or add to PATH
-alias context-builder='~/Git/aidevops/.agent/scripts/context-builder-helper.sh'
+alias context-builder='~/Git/aidevops/.agents/scripts/context-builder-helper.sh'
 ```text
 
 ### Dependencies
diff --git a/.agent/tools/context/context-guardrails.md b/.agents/tools/context/context-guardrails.md
similarity index 100%
rename from .agent/tools/context/context-guardrails.md
rename to .agents/tools/context/context-guardrails.md
diff --git a/.agent/tools/context/context7.md b/.agents/tools/context/context7.md
similarity index 100%
rename from .agent/tools/context/context7.md
rename to .agents/tools/context/context7.md
diff --git a/.agent/tools/context/dspy.md b/.agents/tools/context/dspy.md
similarity index 96%
rename from .agent/tools/context/dspy.md
rename to .agents/tools/context/dspy.md
index 498edec06..91ca2bc96 100644
--- a/.agent/tools/context/dspy.md
+++ b/.agents/tools/context/dspy.md
@@ -20,7 +20,7 @@ tools:
 
 - DSPy: Framework for algorithmically optimizing LLM prompts and weights
 - Requires: Python 3.8+, OpenAI/Anthropic API key
-- Helper: `./.agent/scripts/dspy-helper.sh install|test|init [project]`
+- Helper: `./.agents/scripts/dspy-helper.sh install|test|init [project]`
 - Config: `configs/dspy-config.json` (copy from .txt template)
 - Projects: `data/dspy/[project-name]/`
 - Virtual env: `python-env/dspy-env/`
@@ -45,10 +45,10 @@ DSPy (Declarative Self-improving Python) is a framework for algorithmically opti
 
 ```bash
 # Install DSPy dependencies
-./.agent/scripts/dspy-helper.sh install
+./.agents/scripts/dspy-helper.sh install
 
 # Test installation
-./.agent/scripts/dspy-helper.sh test
+./.agents/scripts/dspy-helper.sh test
 ```
 
 ### **Configuration**
@@ -83,7 +83,7 @@ DSPy (Declarative Self-improving Python) is a framework for algorithmically opti
 
 ```text
 aidevops/
-├── .agent/scripts/dspy-helper.sh          # DSPy management script
+├── .agents/scripts/dspy-helper.sh          # DSPy management script
 ├── configs/dspy-config.json          # DSPy configuration
 ├── python-env/dspy-env/              # Python virtual environment
 ├── data/dspy/                        # DSPy projects and datasets
@@ -97,7 +97,7 @@ aidevops/
 
 ```bash
 # Create a new DSPy project
-./.agent/scripts/dspy-helper.sh init my-chatbot
+./.agents/scripts/dspy-helper.sh init my-chatbot
 
 # Navigate to project directory
 cd data/dspy/my-chatbot
diff --git a/.agent/tools/context/dspyground.md b/.agents/tools/context/dspyground.md
similarity index 96%
rename from .agent/tools/context/dspyground.md
rename to .agents/tools/context/dspyground.md
index cdf8f57ef..e29da8bbf 100644
--- a/.agent/tools/context/dspyground.md
+++ b/.agents/tools/context/dspyground.md
@@ -20,7 +20,7 @@ tools:
 
 - DSPyGround: Visual prompt optimization playground with GEPA optimizer
 - Requires: Node.js 18+, AI Gateway API key
-- Helper: `./.agent/scripts/dspyground-helper.sh install|init|dev [project]`
+- Helper: `./.agents/scripts/dspyground-helper.sh install|init|dev [project]`
 - Config: `configs/dspyground-config.json`, project: `dspyground.config.ts`
 - Projects: `data/dspyground/[project-name]/`
 - Web UI: `http://localhost:3000` (run with `dspyground dev`)
@@ -49,7 +49,7 @@ DSPyGround is a visual prompt optimization playground powered by the GEPA (Genet
 
 ```bash
 # Install DSPyGround globally
-./.agent/scripts/dspyground-helper.sh install
+./.agents/scripts/dspyground-helper.sh install
 
 # Verify installation
 dspyground --version
@@ -74,7 +74,7 @@ dspyground --version
 
 ```text
 aidevops/
-├── .agent/scripts/dspyground-helper.sh    # DSPyGround management script
+├── .agents/scripts/dspyground-helper.sh    # DSPyGround management script
 ├── configs/dspyground-config.json    # DSPyGround configuration
 ├── data/dspyground/                  # DSPyGround projects
 │   └── my-agent/
@@ -90,7 +90,7 @@ aidevops/
 
 ```bash
 # Create a new DSPyGround project
-./.agent/scripts/dspyground-helper.sh init my-agent
+./.agents/scripts/dspyground-helper.sh init my-agent
 
 # Navigate to project directory
 cd data/dspyground/my-agent
@@ -100,7 +100,7 @@ cd data/dspyground/my-agent
 
 ```bash
 # Start the development server
-./.agent/scripts/dspyground-helper.sh dev my-agent
+./.agents/scripts/dspyground-helper.sh dev my-agent
 
 # Or from project directory
 dspyground dev
diff --git a/.agent/tools/context/github-search.md b/.agents/tools/context/github-search.md
similarity index 100%
rename from .agent/tools/context/github-search.md
rename to .agents/tools/context/github-search.md
diff --git a/.agent/tools/context/llm-tldr.md b/.agents/tools/context/llm-tldr.md
similarity index 100%
rename from .agent/tools/context/llm-tldr.md
rename to .agents/tools/context/llm-tldr.md
diff --git a/.agent/tools/context/mcp-discovery.md b/.agents/tools/context/mcp-discovery.md
similarity index 100%
rename from .agent/tools/context/mcp-discovery.md
rename to .agents/tools/context/mcp-discovery.md
diff --git a/.agent/tools/context/model-routing.md b/.agents/tools/context/model-routing.md
similarity index 100%
rename from .agent/tools/context/model-routing.md
rename to .agents/tools/context/model-routing.md
diff --git a/.agent/tools/context/osgrep.md b/.agents/tools/context/osgrep.md
similarity index 100%
rename from .agent/tools/context/osgrep.md
rename to .agents/tools/context/osgrep.md
diff --git a/.agent/tools/context/prompt-optimization.md b/.agents/tools/context/prompt-optimization.md
similarity index 100%
rename from .agent/tools/context/prompt-optimization.md
rename to .agents/tools/context/prompt-optimization.md
diff --git a/.agent/tools/context/toon.md b/.agents/tools/context/toon.md
similarity index 81%
rename from .agent/tools/context/toon.md
rename to .agents/tools/context/toon.md
index 4fda25cea..cae2cd136 100644
--- a/.agent/tools/context/toon.md
+++ b/.agents/tools/context/toon.md
@@ -51,23 +51,23 @@ TOON CLI is automatically available through npx (no installation required):
 npx @toon-format/cli --help
 
 # Or use the AI DevOps helper
-./.agent/scripts/toon-helper.sh info
+./.agents/scripts/toon-helper.sh info
 ```
 
 ### **Basic Usage**
 
 ```bash
 # Convert JSON to TOON
-./.agent/scripts/toon-helper.sh encode data.json output.toon
+./.agents/scripts/toon-helper.sh encode data.json output.toon
 
 # Convert TOON back to JSON
-./.agent/scripts/toon-helper.sh decode output.toon restored.json
+./.agents/scripts/toon-helper.sh decode output.toon restored.json
 
 # Show token efficiency comparison
-./.agent/scripts/toon-helper.sh compare large-dataset.json
+./.agents/scripts/toon-helper.sh compare large-dataset.json
 
 # Validate TOON format
-./.agent/scripts/toon-helper.sh validate data.toon
+./.agents/scripts/toon-helper.sh validate data.toon
 ```
 
 ## 📊 **Format Examples**
@@ -135,34 +135,34 @@ project:
 
 ```bash
 # Basic conversion
-./.agent/scripts/toon-helper.sh encode input.json output.toon
+./.agents/scripts/toon-helper.sh encode input.json output.toon
 
 # With tab delimiter (often more efficient)
-./.agent/scripts/toon-helper.sh encode input.json output.toon '\t' true
+./.agents/scripts/toon-helper.sh encode input.json output.toon '\t' true
 
 # Decode with lenient validation
-./.agent/scripts/toon-helper.sh decode input.toon output.json false
+./.agents/scripts/toon-helper.sh decode input.toon output.json false
 ```
 
 ### **Batch Processing**
 
 ```bash
 # Convert directory of JSON files to TOON
-./.agent/scripts/toon-helper.sh batch ./json-files ./toon-files json-to-toon
+./.agents/scripts/toon-helper.sh batch ./json-files ./toon-files json-to-toon
 
 # Convert directory of TOON files to JSON
-./.agent/scripts/toon-helper.sh batch ./toon-files ./json-files toon-to-json '\t'
+./.agents/scripts/toon-helper.sh batch ./toon-files ./json-files toon-to-json '\t'
 ```
 
 ### **Stream Processing**
 
 ```bash
 # Convert from stdin
-cat data.json | ./.agent/scripts/toon-helper.sh stdin-encode
-echo '{"name": "test"}' | ./.agent/scripts/toon-helper.sh stdin-encode '\t' true
+cat data.json | ./.agents/scripts/toon-helper.sh stdin-encode
+echo '{"name": "test"}' | ./.agents/scripts/toon-helper.sh stdin-encode '\t' true
 
 # Decode from stdin
-cat data.toon | ./.agent/scripts/toon-helper.sh stdin-decode
+cat data.toon | ./.agents/scripts/toon-helper.sh stdin-decode
 ```
 
 ## 🎯 **AI DevOps Use Cases**
@@ -173,7 +173,7 @@ Perfect for server configurations, deployment settings, and infrastructure data:
 
 ```bash
 # Convert server inventory to TOON for AI analysis
-./.agent/scripts/toon-helper.sh encode servers.json servers.toon '\t' true
+./.agents/scripts/toon-helper.sh encode servers.json servers.toon '\t' true
 ```
 
 ### **2. API Response Formatting**
@@ -182,7 +182,7 @@ Reduce token costs when sending API responses to LLMs:
 
 ```bash
 # Convert API responses for efficient LLM processing
-curl -s "https://api.example.com/data" | ./.agent/scripts/toon-helper.sh stdin-encode
+curl -s "https://api.example.com/data" | ./.agents/scripts/toon-helper.sh stdin-encode
 ```
 
 ### **3. Database Exports**
@@ -191,7 +191,7 @@ Efficient format for database query results:
 
 ```bash
 # Export database results in TOON format
-mysql -e "SELECT * FROM users" --json | ./.agent/scripts/toon-helper.sh stdin-encode '\t'
+mysql -e "SELECT * FROM users" --json | ./.agents/scripts/toon-helper.sh stdin-encode '\t'
 ```
 
 ### **4. Log Analysis**
@@ -200,7 +200,7 @@ Structure log data for AI analysis:
 
 ```bash
 # Convert structured logs to TOON
-./.agent/scripts/toon-helper.sh batch ./logs/json ./logs/toon json-to-toon
+./.agents/scripts/toon-helper.sh batch ./logs/json ./logs/toon json-to-toon
 ```
 
 ## 📈 **Token Efficiency**
@@ -260,13 +260,13 @@ Task: Return only users with role "user" as TOON.
 
 ```bash
 # Validate TOON format
-./.agent/scripts/toon-helper.sh validate data.toon
+./.agents/scripts/toon-helper.sh validate data.toon
 
 # Compare efficiency
-./.agent/scripts/toon-helper.sh compare large-dataset.json
+./.agents/scripts/toon-helper.sh compare large-dataset.json
 
 # Show format information
-./.agent/scripts/toon-helper.sh info
+./.agents/scripts/toon-helper.sh info
 ```
 
 ## 📚 **Resources**
diff --git a/.agent/tools/conversion/mineru.md b/.agents/tools/conversion/mineru.md
similarity index 100%
rename from .agent/tools/conversion/mineru.md
rename to .agents/tools/conversion/mineru.md
diff --git a/.agent/tools/conversion/pandoc.md b/.agents/tools/conversion/pandoc.md
similarity index 85%
rename from .agent/tools/conversion/pandoc.md
rename to .agents/tools/conversion/pandoc.md
index cc2037c2b..705769a39 100644
--- a/.agent/tools/conversion/pandoc.md
+++ b/.agents/tools/conversion/pandoc.md
@@ -20,7 +20,7 @@ tools:
 
 - **Purpose**: Convert documents to markdown for AI processing
 - **Install**: `brew install pandoc poppler` (macOS) or `apt install pandoc poppler-utils`
-- **Helper**: `.agent/scripts/pandoc-helper.sh`
+- **Helper**: `.agents/scripts/pandoc-helper.sh`
 - **Commands**: `convert [file]` | `batch [dir] [output] [pattern]` | `formats` | `detect [file]`
 - **Supported**: DOCX, PDF, HTML, EPUB, ODT, RTF, LaTeX, JSON, CSV, RST, Org-mode
 - **Output**: Markdown with ATX headers, no line wrapping, preserved structure
@@ -68,26 +68,26 @@ pdftotext -v  # For PDF support
 
 ```bash
 # Convert Word document to markdown
-bash .agent/scripts/pandoc-helper.sh convert document.docx
+bash .agents/scripts/pandoc-helper.sh convert document.docx
 
 # Convert PDF with custom output name
-bash .agent/scripts/pandoc-helper.sh convert report.pdf analysis.md
+bash .agents/scripts/pandoc-helper.sh convert report.pdf analysis.md
 
 # Convert with specific format and options
-bash .agent/scripts/pandoc-helper.sh convert file.html output.md html "--extract-media=./images"
+bash .agents/scripts/pandoc-helper.sh convert file.html output.md html "--extract-media=./images"
 ```
 
 ### **Batch Conversion**
 
 ```bash
 # Convert all Word documents in a directory
-bash .agent/scripts/pandoc-helper.sh batch ./documents ./markdown "*.docx"
+bash .agents/scripts/pandoc-helper.sh batch ./documents ./markdown "*.docx"
 
 # Convert all supported formats
-bash .agent/scripts/pandoc-helper.sh batch ./input ./output "*"
+bash .agents/scripts/pandoc-helper.sh batch ./input ./output "*"
 
 # Convert with specific pattern
-bash .agent/scripts/pandoc-helper.sh batch ./reports ./markdown "*.{pdf,docx,html}"
+bash .agents/scripts/pandoc-helper.sh batch ./reports ./markdown "*.{pdf,docx,html}"
 ```
 
 ## Supported Formats
@@ -132,26 +132,26 @@ bash .agent/scripts/pandoc-helper.sh batch ./reports ./markdown "*.{pdf,docx,htm
 
 ```bash
 # Automatically detect file format
-bash .agent/scripts/pandoc-helper.sh detect unknown_file.ext
+bash .agents/scripts/pandoc-helper.sh detect unknown_file.ext
 
 # Show all supported formats
-bash .agent/scripts/pandoc-helper.sh formats
+bash .agents/scripts/pandoc-helper.sh formats
 ```
 
 ### **Custom Conversion Options**
 
 ```bash
 # Extract images and media
-bash .agent/scripts/pandoc-helper.sh convert document.docx output.md docx "--extract-media=./media"
+bash .agents/scripts/pandoc-helper.sh convert document.docx output.md docx "--extract-media=./media"
 
 # Include table of contents
-bash .agent/scripts/pandoc-helper.sh convert document.html output.md html "--toc"
+bash .agents/scripts/pandoc-helper.sh convert document.html output.md html "--toc"
 
 # Create standalone document
-bash .agent/scripts/pandoc-helper.sh convert document.rst output.md rst "--standalone"
+bash .agents/scripts/pandoc-helper.sh convert document.rst output.md rst "--standalone"
 
 # Set custom metadata
-bash .agent/scripts/pandoc-helper.sh convert document.tex output.md latex "--metadata title='My Document'"
+bash .agents/scripts/pandoc-helper.sh convert document.tex output.md latex "--metadata title='My Document'"
 ```
 
 ## AI Assistant Integration
@@ -169,7 +169,7 @@ bash .agent/scripts/pandoc-helper.sh convert document.tex output.md latex "--met
 
 ```bash
 # 1. Convert documents for analysis
-bash .agent/scripts/pandoc-helper.sh batch ./project-docs ./markdown "*.{docx,pdf,html}"
+bash .agents/scripts/pandoc-helper.sh batch ./project-docs ./markdown "*.{docx,pdf,html}"
 
 # 2. Process converted files with AI
 # AI can now easily read and analyze all documents
@@ -275,7 +275,7 @@ pandoc --verbose input.pdf -o output.md
 
 ```bash
 # Convert project documentation
-bash .agent/scripts/pandoc-helper.sh batch ./docs ./ai-ready "*.{docx,pdf}"
+bash .agents/scripts/pandoc-helper.sh batch ./docs ./ai-ready "*.{docx,pdf}"
 
 # Now AI can process all documentation:
 # "Analyze all the converted documentation and create a project summary"
@@ -287,7 +287,7 @@ bash .agent/scripts/pandoc-helper.sh batch ./docs ./ai-ready "*.{docx,pdf}"
 
 ```bash
 # Convert and commit to Git
-bash .agent/scripts/pandoc-helper.sh batch ./documents ./markdown
+bash .agents/scripts/pandoc-helper.sh batch ./documents ./markdown
 git add markdown/
 git commit -m "📄 Add converted documentation for AI processing"
 ```
diff --git a/.agent/tools/credentials/api-key-management.md b/.agents/tools/credentials/api-key-management.md
similarity index 91%
rename from .agent/tools/credentials/api-key-management.md
rename to .agents/tools/credentials/api-key-management.md
index bbe1a3879..8727f8a0e 100644
--- a/.agent/tools/credentials/api-key-management.md
+++ b/.agents/tools/credentials/api-key-management.md
@@ -21,7 +21,7 @@ tools:
 - **Primary Method**: Environment variables (`export CODACY_API_TOKEN="..."`)
 - **Local Storage**: `configs/*-config.json` (gitignored), `~/.config/coderabbit/api_key`
 - **CI/CD**: GitHub Secrets (`SONAR_TOKEN`, `CODACY_API_TOKEN`, `GITHUB_TOKEN`)
-- **Helper Script**: `.agent/scripts/setup-local-api-keys.sh` (set, load, list)
+- **Helper Script**: `.agents/scripts/setup-local-api-keys.sh` (set, load, list)
 - **Token Sources**: Codacy (app.codacy.com/account/api-tokens), SonarCloud (sonarcloud.io/account/security)
 - **Security**: 600 permissions, never commit, regular rotation (90 days)
 - **If Compromised**: Revoke immediately → Generate new → Update local + GitHub secrets → Verify
@@ -95,14 +95,14 @@ GITHUB_TOKEN                         # Automatic (provided by GitHub)
 
 ```bash
 # Use secure local storage (RECOMMENDED)
-bash .agent/scripts/setup-local-api-keys.sh set codacy YOUR_CODACY_API_TOKEN
-bash .agent/scripts/setup-local-api-keys.sh set sonar YOUR_SONAR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set codacy YOUR_CODACY_API_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set sonar YOUR_SONAR_TOKEN
 
 # Load all API keys into environment when needed
-bash .agent/scripts/setup-local-api-keys.sh load
+bash .agents/scripts/setup-local-api-keys.sh load
 
 # List configured services
-bash .agent/scripts/setup-local-api-keys.sh list
+bash .agents/scripts/setup-local-api-keys.sh list
 ```
 
 ### **4. Test Configuration**
@@ -110,7 +110,7 @@ bash .agent/scripts/setup-local-api-keys.sh list
 ```bash
 # Test Codacy CLI
 cd git/aidevops
-bash .agent/scripts/codacy-cli.sh analyze
+bash .agents/scripts/codacy-cli.sh analyze
 
 # Test environment variables
 echo "Codacy token: ${CODACY_API_TOKEN:0:10}..."
diff --git a/.agent/tools/credentials/api-key-setup.md b/.agents/tools/credentials/api-key-setup.md
similarity index 82%
rename from .agent/tools/credentials/api-key-setup.md
rename to .agents/tools/credentials/api-key-setup.md
index d0cc7c6b8..688972363 100644
--- a/.agent/tools/credentials/api-key-setup.md
+++ b/.agents/tools/credentials/api-key-setup.md
@@ -20,7 +20,7 @@ tools:
 
 - **Secrets Location**: `~/.config/aidevops/mcp-env.sh` (600 permissions)
 - **Working Dirs**: `~/.aidevops/` (agno, stagehand, reports)
-- **Setup**: `bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh setup`
+- **Setup**: `bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh setup`
 
 **Commands**:
 - `set <service-name> <VALUE>` - Store API key (converts to UPPER_CASE export)
@@ -53,7 +53,7 @@ This file is automatically sourced by your shell (zsh and bash) on startup.
 ### 1. Initialize Secure Storage
 
 ```bash
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh setup
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh setup
 ```
 
 This will:
@@ -68,10 +68,10 @@ This will:
 
 ```bash
 # Service name format (converted to UPPER_CASE)
-bash .agent/scripts/setup-local-api-keys.sh set vercel-token YOUR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set vercel-token YOUR_TOKEN
 # Result: export VERCEL_TOKEN="YOUR_TOKEN"
 
-bash .agent/scripts/setup-local-api-keys.sh set sonar YOUR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set sonar YOUR_TOKEN
 # Result: export SONAR="YOUR_TOKEN"
 ```
 
@@ -86,13 +86,13 @@ export VERCEL_TOKEN="abc123"
 Use the `add` command to parse and store it:
 
 ```bash
-bash .agent/scripts/setup-local-api-keys.sh add 'export VERCEL_TOKEN="abc123"'
+bash .agents/scripts/setup-local-api-keys.sh add 'export VERCEL_TOKEN="abc123"'
 ```
 
 #### Method C: Direct env var name
 
 ```bash
-bash .agent/scripts/setup-local-api-keys.sh set SUPABASE_KEY abc123
+bash .agents/scripts/setup-local-api-keys.sh set SUPABASE_KEY abc123
 # Result: export SUPABASE_KEY="abc123"
 ```
 
@@ -100,29 +100,29 @@ bash .agent/scripts/setup-local-api-keys.sh set SUPABASE_KEY abc123
 
 ```bash
 # Codacy - https://app.codacy.com/account/api-tokens
-bash .agent/scripts/setup-local-api-keys.sh set codacy-project-token YOUR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set codacy-project-token YOUR_TOKEN
 
 # SonarCloud - https://sonarcloud.io/account/security
-bash .agent/scripts/setup-local-api-keys.sh set sonar-token YOUR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set sonar-token YOUR_TOKEN
 
 # CodeRabbit - https://app.coderabbit.ai/settings
-bash .agent/scripts/setup-local-api-keys.sh set coderabbit-api-key YOUR_KEY
+bash .agents/scripts/setup-local-api-keys.sh set coderabbit-api-key YOUR_KEY
 
 # Hetzner Cloud - https://console.hetzner.cloud/projects/*/security/tokens
-bash .agent/scripts/setup-local-api-keys.sh set hcloud-token-projectname YOUR_TOKEN
+bash .agents/scripts/setup-local-api-keys.sh set hcloud-token-projectname YOUR_TOKEN
 
 # OpenAI - https://platform.openai.com/api-keys
-bash .agent/scripts/setup-local-api-keys.sh set openai-api-key YOUR_KEY
+bash .agents/scripts/setup-local-api-keys.sh set openai-api-key YOUR_KEY
 ```
 
 ### 4. Verify Storage
 
 ```bash
 # List configured services (keys are not shown)
-bash .agent/scripts/setup-local-api-keys.sh list
+bash .agents/scripts/setup-local-api-keys.sh list
 
 # Get a specific key
-bash .agent/scripts/setup-local-api-keys.sh get sonar-token
+bash .agents/scripts/setup-local-api-keys.sh get sonar-token
 
 # View the file directly (redacted)
 cat ~/.config/aidevops/mcp-env.sh | sed 's/=.*/=<REDACTED>/'
@@ -190,13 +190,13 @@ chmod 600 ~/.config/aidevops/mcp-env.sh
 
 ```bash
 # Check if stored
-bash .agent/scripts/setup-local-api-keys.sh get service-name
+bash .agents/scripts/setup-local-api-keys.sh get service-name
 
 # Check environment
 echo $SERVICE_NAME
 
 # Re-add if missing
-bash .agent/scripts/setup-local-api-keys.sh set service-name YOUR_KEY
+bash .agents/scripts/setup-local-api-keys.sh set service-name YOUR_KEY
 ```
 
 ### Changes Not Taking Effect
@@ -212,7 +212,7 @@ source ~/.zshrc  # or ~/.bashrc
 
 ```bash
 # Re-run setup to add sourcing to shell configs
-bash .agent/scripts/setup-local-api-keys.sh setup
+bash .agents/scripts/setup-local-api-keys.sh setup
 ```
 
 ## Multi-Tenant Support
diff --git a/.agent/tools/credentials/environment-variables.md b/.agents/tools/credentials/environment-variables.md
similarity index 95%
rename from .agent/tools/credentials/environment-variables.md
rename to .agents/tools/credentials/environment-variables.md
index c2167cae4..ddd6c4fcb 100644
--- a/.agent/tools/credentials/environment-variables.md
+++ b/.agents/tools/credentials/environment-variables.md
@@ -22,7 +22,7 @@ tools:
 - **OpenAI**: `OPENAI_API_KEY` (sk-...), `OPENAI_BASE_URL`
 - **Anthropic**: `ANTHROPIC_API_KEY`, `ANTHROPIC_BASE_URL`
 - **Others**: `AI_GATEWAY_API_KEY`, `GOOGLE_API_KEY`, `AZURE_OPENAI_API_KEY`
-- **DSPy test**: `./.agent/scripts/dspy-helper.sh test`
+- **DSPy test**: `./.agents/scripts/dspy-helper.sh test`
 - **Check keys**: `env | grep -E "(OPENAI|ANTHROPIC|CLAUDE)_API_KEY"`
 - **Test OpenAI**: `curl -H "Authorization: Bearer $OPENAI_API_KEY" https://api.openai.com/v1/models | head -20`
 - **Benefits**: Secure (no keys in files), convenient (works immediately), flexible (override per-project)
@@ -133,16 +133,16 @@ Since your `OPENAI_API_KEY` is already set, you can immediately:
 
 ```bash
 # Test DSPy
-./.agent/scripts/dspy-helper.sh test
+./.agents/scripts/dspy-helper.sh test
 
 # Create and run DSPy project
-./.agent/scripts/dspy-helper.sh init my-bot
+./.agents/scripts/dspy-helper.sh init my-bot
 cd data/dspy/my-bot
 source ../../../python-env/dspy-env/bin/activate
 python3 main.py
 
 # Create DSPyGround project
-./.agent/scripts/dspyground-helper.sh init my-agent
+./.agents/scripts/dspyground-helper.sh init my-agent
 cd data/dspyground/my-agent
 # Add AI_GATEWAY_API_KEY to .env if using AI Gateway
 # Otherwise, your OPENAI_API_KEY works directly
diff --git a/.agent/tools/credentials/list-keys.md b/.agents/tools/credentials/list-keys.md
similarity index 100%
rename from .agent/tools/credentials/list-keys.md
rename to .agents/tools/credentials/list-keys.md
diff --git a/.agent/tools/credentials/multi-tenant.md b/.agents/tools/credentials/multi-tenant.md
similarity index 99%
rename from .agent/tools/credentials/multi-tenant.md
rename to .agents/tools/credentials/multi-tenant.md
index a27e839e4..e28f2ee91 100644
--- a/.agent/tools/credentials/multi-tenant.md
+++ b/.agents/tools/credentials/multi-tenant.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- **Script**: `.agent/scripts/credential-helper.sh`
+- **Script**: `.agents/scripts/credential-helper.sh`
 - **Storage**: `~/.config/aidevops/tenants/{tenant}/mcp-env.sh`
 - **Active tenant**: `~/.config/aidevops/active-tenant`
 - **Project override**: `.aidevops-tenant` (gitignored)
diff --git a/.agent/tools/credentials/vaultwarden.md b/.agents/tools/credentials/vaultwarden.md
similarity index 87%
rename from .agent/tools/credentials/vaultwarden.md
rename to .agents/tools/credentials/vaultwarden.md
index 3ac4d3e78..75feb82e8 100644
--- a/.agent/tools/credentials/vaultwarden.md
+++ b/.agents/tools/credentials/vaultwarden.md
@@ -200,80 +200,80 @@ bw --version
 
 ```bash
 # List all Vaultwarden instances
-./.agent/scripts/vaultwarden-helper.sh instances
+./.agents/scripts/vaultwarden-helper.sh instances
 
 # Get vault status
-./.agent/scripts/vaultwarden-helper.sh status production
+./.agents/scripts/vaultwarden-helper.sh status production
 
 # Login to vault
-./.agent/scripts/vaultwarden-helper.sh login production user@example.com
+./.agents/scripts/vaultwarden-helper.sh login production user@example.com
 
 # Unlock vault (after login)
-./.agent/scripts/vaultwarden-helper.sh unlock
+./.agents/scripts/vaultwarden-helper.sh unlock
 ```
 
 ### **Vault Management:**
 
 ```bash
 # List all vault items
-./.agent/scripts/vaultwarden-helper.sh list production
+./.agents/scripts/vaultwarden-helper.sh list production
 
 # Search vault items
-./.agent/scripts/vaultwarden-helper.sh search production "github"
+./.agents/scripts/vaultwarden-helper.sh search production "github"
 
 # Get specific item
-./.agent/scripts/vaultwarden-helper.sh get production item-uuid
+./.agents/scripts/vaultwarden-helper.sh get production item-uuid
 
 # Get password for item
-./.agent/scripts/vaultwarden-helper.sh get-password production "GitHub Account"
+./.agents/scripts/vaultwarden-helper.sh get-password production "GitHub Account"
 
 # Get username for item
-./.agent/scripts/vaultwarden-helper.sh get-username production "GitHub Account"
+./.agents/scripts/vaultwarden-helper.sh get-username production "GitHub Account"
 ```
 
 ### **Item Management:**
 
 ```bash
 # Create new vault item
-./.agent/scripts/vaultwarden-helper.sh create production "New Service" username password123 https://service.com
+./.agents/scripts/vaultwarden-helper.sh create production "New Service" username password123 https://service.com
 
 # Update vault item
-./.agent/scripts/vaultwarden-helper.sh update production item-uuid password newpassword123
+./.agents/scripts/vaultwarden-helper.sh update production item-uuid password newpassword123
 
 # Delete vault item
-./.agent/scripts/vaultwarden-helper.sh delete production item-uuid
+./.agents/scripts/vaultwarden-helper.sh delete production item-uuid
 
 # Generate secure password
-./.agent/scripts/vaultwarden-helper.sh generate 20 true
+./.agents/scripts/vaultwarden-helper.sh generate 20 true
 ```
 
 ### **Organization Management:**
 
 ```bash
 # List organization vault items
-./.agent/scripts/vaultwarden-helper.sh org-list production org-uuid
+./.agents/scripts/vaultwarden-helper.sh org-list production org-uuid
 
 # Sync vault with server
-./.agent/scripts/vaultwarden-helper.sh sync production
+./.agents/scripts/vaultwarden-helper.sh sync production
 
 # Export vault (encrypted)
-./.agent/scripts/vaultwarden-helper.sh export production json vault-backup.json
+./.agents/scripts/vaultwarden-helper.sh export production json vault-backup.json
 ```
 
 ### **Security & Auditing:**
 
 ```bash
 # Audit vault security
-./.agent/scripts/vaultwarden-helper.sh audit production
+./.agents/scripts/vaultwarden-helper.sh audit production
 
 # Lock vault
-./.agent/scripts/vaultwarden-helper.sh lock
+./.agents/scripts/vaultwarden-helper.sh lock
 
 # Start MCP server for AI access
-./.agent/scripts/vaultwarden-helper.sh start-mcp production 3002
+./.agents/scripts/vaultwarden-helper.sh start-mcp production 3002
 
 # Test MCP connection
-./.agent/scripts/vaultwarden-helper.sh test-mcp 3002
+./.agents/scripts/vaultwarden-helper.sh test-mcp 3002
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -297,7 +297,7 @@ unset BW_SESSION
 bw lock
 
 # Regular security audits
-./.agent/scripts/vaultwarden-helper.sh audit production
+./.agents/scripts/vaultwarden-helper.sh audit production
 ```
 
 ### **Organizational Security:**
@@ -359,10 +359,10 @@ bw login user@example.com
 
 ```bash
 # Start Bitwarden MCP server
-./.agent/scripts/vaultwarden-helper.sh start-mcp production 3002
+./.agents/scripts/vaultwarden-helper.sh start-mcp production 3002
 
 # Test MCP server
-./.agent/scripts/vaultwarden-helper.sh test-mcp 3002
+./.agents/scripts/vaultwarden-helper.sh test-mcp 3002
 
 # Configure in AI assistant
 # Add to MCP servers configuration:
@@ -393,7 +393,7 @@ The MCP server enables AI assistants to:
 
 ```bash
 # Export encrypted vault
-./.agent/scripts/vaultwarden-helper.sh export production json vault-backup-$(date +%Y%m%d).json
+./.agents/scripts/vaultwarden-helper.sh export production json vault-backup-$(date +%Y%m%d).json
 
 # Secure backup file
 chmod 600 vault-backup-*.json
@@ -411,7 +411,7 @@ BACKUP_DIR="/secure/backups/vaultwarden"
 DATE=$(date +%Y%m%d-%H%M%S)
 
 # Create backup
-./.agent/scripts/vaultwarden-helper.sh export $INSTANCE json "$BACKUP_DIR/vault-$DATE.json"
+./.agents/scripts/vaultwarden-helper.sh export $INSTANCE json "$BACKUP_DIR/vault-$DATE.json"
 
 # Encrypt backup
 gpg --cipher-algo AES256 --compress-algo 1 --s2k-mode 3 \
diff --git a/.agent/tools/data-extraction/outscraper.md b/.agents/tools/data-extraction/outscraper.md
similarity index 100%
rename from .agent/tools/data-extraction/outscraper.md
rename to .agents/tools/data-extraction/outscraper.md
diff --git a/.agent/tools/deployment/cloudron-app-packaging.md b/.agents/tools/deployment/cloudron-app-packaging.md
similarity index 99%
rename from .agent/tools/deployment/cloudron-app-packaging.md
rename to .agents/tools/deployment/cloudron-app-packaging.md
index d9d27aa22..a8636ffdb 100644
--- a/.agent/tools/deployment/cloudron-app-packaging.md
+++ b/.agents/tools/deployment/cloudron-app-packaging.md
@@ -740,7 +740,7 @@ cloudron init
 
 # Structure
 # ~/Git/cloudron-myapp/
-#   .agent/                    # aidevops config
+#   .agents/                    # aidevops config
 #   CloudronManifest.json      # Cloudron manifest
 #   Dockerfile                 # Build instructions
 #   start.sh                   # Entry point
@@ -754,7 +754,7 @@ cloudron init
 .cloudron/
 
 # aidevops
-.agent/loop-state/
+.agents/loop-state/
 *.local.md
 
 # Build artifacts
diff --git a/.agent/tools/deployment/cloudron-git-reference.md b/.agents/tools/deployment/cloudron-git-reference.md
similarity index 100%
rename from .agent/tools/deployment/cloudron-git-reference.md
rename to .agents/tools/deployment/cloudron-git-reference.md
diff --git a/.agent/tools/deployment/coolify-cli.md b/.agents/tools/deployment/coolify-cli.md
similarity index 77%
rename from .agent/tools/deployment/coolify-cli.md
rename to .agents/tools/deployment/coolify-cli.md
index 1c81a3cff..8e831d69e 100644
--- a/.agent/tools/deployment/coolify-cli.md
+++ b/.agents/tools/deployment/coolify-cli.md
@@ -21,17 +21,17 @@ tools:
 - **Purpose**: Self-hosted PaaS for Docker deployment
 - **Install**: `curl -fsSL https://raw.githubusercontent.com/coollabsio/coolify-cli/main/scripts/install.sh | bash`
 - **Config**: `configs/coolify-cli-config.json`
-- **Script**: `.agent/scripts/coolify-cli-helper.sh`
+- **Script**: `.agents/scripts/coolify-cli-helper.sh`
 - **Local Dev First**: Works without Coolify setup
 
 **Commands**: `add-context|list-contexts|list-apps|deploy|get-app|list-servers|add-server|list-databases|create-db|dev|build`
 
-**Usage**: `./.agent/scripts/coolify-cli-helper.sh [command] [context] [args]`
+**Usage**: `./.agents/scripts/coolify-cli-helper.sh [command] [context] [args]`
 
 **Databases**: PostgreSQL, MySQL, MongoDB, Redis, ClickHouse, KeyDB
 **Frameworks**: Node.js, PHP, Python, Docker, static sites
 
-**Local Dev** (no Coolify): `./.agent/scripts/coolify-cli-helper.sh dev local ./app 3000`
+**Local Dev** (no Coolify): `./.agents/scripts/coolify-cli-helper.sh dev local ./app 3000`
 <!-- AI-CONTEXT-END -->
 
 Comprehensive self-hosted deployment and management using the Coolify CLI through the AI DevOps Framework.
@@ -91,13 +91,13 @@ nano configs/coolify-cli-config.json
 
 ```bash
 # Add production context
-./.agent/scripts/coolify-cli-helper.sh add-context production https://coolify.example.com your-api-token true
+./.agents/scripts/coolify-cli-helper.sh add-context production https://coolify.example.com your-api-token true
 
 # Add staging context
-./.agent/scripts/coolify-cli-helper.sh add-context staging https://staging.coolify.example.com staging-token
+./.agents/scripts/coolify-cli-helper.sh add-context staging https://staging.coolify.example.com staging-token
 
 # List contexts
-./.agent/scripts/coolify-cli-helper.sh list-contexts
+./.agents/scripts/coolify-cli-helper.sh list-contexts
 ```
 
 ## Usage Examples
@@ -106,10 +106,10 @@ nano configs/coolify-cli-config.json
 
 ```bash
 # Start development server (works immediately)
-./.agent/scripts/coolify-cli-helper.sh dev local ./my-app 3000
+./.agents/scripts/coolify-cli-helper.sh dev local ./my-app 3000
 
 # Build project locally
-./.agent/scripts/coolify-cli-helper.sh build local ./my-app
+./.agents/scripts/coolify-cli-helper.sh build local ./my-app
 
 # Works with any project type:
 # - Node.js projects with package.json
@@ -122,26 +122,26 @@ nano configs/coolify-cli-config.json
 
 ```bash
 # List applications
-./.agent/scripts/coolify-cli-helper.sh list-apps production
+./.agents/scripts/coolify-cli-helper.sh list-apps production
 
 # Deploy application by name
-./.agent/scripts/coolify-cli-helper.sh deploy production my-app
+./.agents/scripts/coolify-cli-helper.sh deploy production my-app
 
 # Force deploy
-./.agent/scripts/coolify-cli-helper.sh deploy production my-app true
+./.agents/scripts/coolify-cli-helper.sh deploy production my-app true
 
 # Get application details
-./.agent/scripts/coolify-cli-helper.sh get-app production app-uuid-here
+./.agents/scripts/coolify-cli-helper.sh get-app production app-uuid-here
 ```
 
 ### Server Management
 
 ```bash
 # List servers
-./.agent/scripts/coolify-cli-helper.sh list-servers production
+./.agents/scripts/coolify-cli-helper.sh list-servers production
 
 # Add new server
-./.agent/scripts/coolify-cli-helper.sh add-server production myserver 192.168.1.100 key-uuid 22 root true
+./.agents/scripts/coolify-cli-helper.sh add-server production myserver 192.168.1.100 key-uuid 22 root true
 
 # Parameters: context name ip key-uuid port user validate
 ```
@@ -150,10 +150,10 @@ nano configs/coolify-cli-config.json
 
 ```bash
 # List databases
-./.agent/scripts/coolify-cli-helper.sh list-databases production
+./.agents/scripts/coolify-cli-helper.sh list-databases production
 
 # Create PostgreSQL database
-./.agent/scripts/coolify-cli-helper.sh create-db production postgresql server-uuid project-uuid main mydb true
+./.agents/scripts/coolify-cli-helper.sh create-db production postgresql server-uuid project-uuid main mydb true
 
 # Parameters: context type server-uuid project-uuid environment name instant-deploy
 ```
@@ -208,10 +208,10 @@ Full Docker integration:
 
 ```bash
 # Docker Compose projects
-./.agent/scripts/coolify-cli-helper.sh dev local ./docker-app 3000
+./.agents/scripts/coolify-cli-helper.sh dev local ./docker-app 3000
 
 # Dockerfile projects
-./.agent/scripts/coolify-cli-helper.sh build local ./docker-app
+./.agents/scripts/coolify-cli-helper.sh build local ./docker-app
 ```
 
 ## Integration with CI/CD
@@ -231,7 +231,7 @@ jobs:
       - uses: actions/checkout@v4
       - name: Deploy to Coolify
         run: |
-          ./.agent/scripts/coolify-cli-helper.sh deploy production my-app true
+          ./.agents/scripts/coolify-cli-helper.sh deploy production my-app true
         env:
           COOLIFY_TOKEN: ${{ secrets.COOLIFY_TOKEN }}
 ```
@@ -240,13 +240,13 @@ jobs:
 
 ```bash
 # Development
-./.agent/scripts/coolify-cli-helper.sh dev local ./app 3000
+./.agents/scripts/coolify-cli-helper.sh dev local ./app 3000
 
 # Staging deployment
-./.agent/scripts/coolify-cli-helper.sh deploy staging my-app
+./.agents/scripts/coolify-cli-helper.sh deploy staging my-app
 
 # Production deployment
-./.agent/scripts/coolify-cli-helper.sh deploy production my-app
+./.agents/scripts/coolify-cli-helper.sh deploy production my-app
 ```
 
 ## Database Management
@@ -264,9 +264,9 @@ jobs:
 
 ```bash
 # Create databases
-./.agent/scripts/coolify-cli-helper.sh create-db production postgresql server-uuid project-uuid main postgres-db true
-./.agent/scripts/coolify-cli-helper.sh create-db production redis server-uuid project-uuid main redis-cache true
-./.agent/scripts/coolify-cli-helper.sh create-db production mongodb server-uuid project-uuid main mongo-db true
+./.agents/scripts/coolify-cli-helper.sh create-db production postgresql server-uuid project-uuid main postgres-db true
+./.agents/scripts/coolify-cli-helper.sh create-db production redis server-uuid project-uuid main redis-cache true
+./.agents/scripts/coolify-cli-helper.sh create-db production mongodb server-uuid project-uuid main mongo-db true
 ```
 
 ## Security Best Practices
@@ -303,8 +303,8 @@ jobs:
 2. **Context Issues**
 
    ```bash
-   ./.agent/scripts/coolify-cli-helper.sh list-contexts
-   ./.agent/scripts/coolify-cli-helper.sh add-context production https://coolify.example.com token
+   ./.agents/scripts/coolify-cli-helper.sh list-contexts
+   ./.agents/scripts/coolify-cli-helper.sh add-context production https://coolify.example.com token
    ```
 
 3. **Local Development Issues**
@@ -324,7 +324,7 @@ Enable verbose logging:
 ```bash
 # Set debug environment variable
 export DEBUG=1
-./.agent/scripts/coolify-cli-helper.sh deploy production my-app
+./.agents/scripts/coolify-cli-helper.sh deploy production my-app
 ```
 
 ## Framework Support
diff --git a/.agent/tools/deployment/coolify-setup.md b/.agents/tools/deployment/coolify-setup.md
similarity index 89%
rename from .agent/tools/deployment/coolify-setup.md
rename to .agents/tools/deployment/coolify-setup.md
index a8b0593a5..3119c9a59 100644
--- a/.agent/tools/deployment/coolify-setup.md
+++ b/.agents/tools/deployment/coolify-setup.md
@@ -22,7 +22,7 @@ tools:
 - **Install**: `curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash`
 - **Requirements**: 2GB+ RAM, Ubuntu 20.04+/Debian 11+, ports 22/80/443/8000
 - **Dashboard**: `https://your-server-ip:8000`
-- **Helper**: `.agent/scripts/coolify-helper.sh`
+- **Helper**: `.agents/scripts/coolify-helper.sh`
 - **Commands**: `list` | `connect [server]` | `open [server]` | `status [server]` | `apps [server]` | `exec [server] [cmd]`
 - **Config**: `configs/coolify-config.json`
 - **Features**: Git deployments, databases (PostgreSQL/MySQL/MongoDB/Redis), SSL automation, Docker containers
@@ -193,34 +193,34 @@ cp configs/coolify-config.json.txt configs/coolify-config.json
 
 ```bash
 # List Coolify servers
-./.agent/scripts/coolify-helper.sh list
+./.agents/scripts/coolify-helper.sh list
 
 # Connect to server via SSH
-./.agent/scripts/coolify-helper.sh connect coolify-main
+./.agents/scripts/coolify-helper.sh connect coolify-main
 
 # Open Coolify web interface
-./.agent/scripts/coolify-helper.sh open coolify-main
+./.agents/scripts/coolify-helper.sh open coolify-main
 
 # Check server status
-./.agent/scripts/coolify-helper.sh status coolify-main
+./.agents/scripts/coolify-helper.sh status coolify-main
 ```
 
 ### **Application Management:**
 
 ```bash
 # List applications on server
-./.agent/scripts/coolify-helper.sh apps main_server
+./.agents/scripts/coolify-helper.sh apps main_server
 
 # Execute commands on server
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker ps'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'df -h'
 ```
 
 ### **SSH Configuration:**
 
 ```bash
 # Generate SSH configs for easy access
-./.agent/scripts/coolify-helper.sh generate-ssh-configs
+./.agents/scripts/coolify-helper.sh generate-ssh-configs
 
 # Then you can simply use:
 ssh coolify-main
@@ -257,29 +257,29 @@ ssh coolify-main
 
 ```bash
 # Check Coolify service status
-./.agent/scripts/coolify-helper.sh exec coolify-main 'systemctl status coolify'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'systemctl status coolify'
 
 # Check Docker containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker ps'
 
 # Check disk space
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'df -h'
 
 # Check memory usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'free -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'free -h'
 ```
 
 ### **Log Management:**
 
 ```bash
 # View Coolify logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
 
 # View application logs (in Coolify dashboard)
 # Go to Application → Logs tab
 
 # System logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'journalctl -u coolify -f'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'journalctl -u coolify -f'
 ```
 
 ### **Backup Strategy:**
diff --git a/.agent/tools/deployment/coolify.md b/.agents/tools/deployment/coolify.md
similarity index 75%
rename from .agent/tools/deployment/coolify.md
rename to .agents/tools/deployment/coolify.md
index 72891f9f8..c73e5b883 100644
--- a/.agent/tools/deployment/coolify.md
+++ b/.agents/tools/deployment/coolify.md
@@ -107,37 +107,37 @@ curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
 
 ```bash
 # List Coolify servers
-./.agent/scripts/coolify-helper.sh list
+./.agents/scripts/coolify-helper.sh list
 
 # Connect to server
-./.agent/scripts/coolify-helper.sh connect coolify-main
+./.agents/scripts/coolify-helper.sh connect coolify-main
 
 # Open Coolify web interface
-./.agent/scripts/coolify-helper.sh open coolify-main
+./.agents/scripts/coolify-helper.sh open coolify-main
 
 # Check server status
-./.agent/scripts/coolify-helper.sh status coolify-main
+./.agents/scripts/coolify-helper.sh status coolify-main
 ```
 
 ### **Application Management:**
 
 ```bash
 # List applications
-./.agent/scripts/coolify-helper.sh apps main_server
+./.agents/scripts/coolify-helper.sh apps main_server
 
 # Execute commands on server
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker ps'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'df -h'
 
 # Check Docker containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs container-name'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs container-name'
 ```
 
 ### **SSH Configuration:**
 
 ```bash
 # Generate SSH configs
-./.agent/scripts/coolify-helper.sh generate-ssh-configs
+./.agents/scripts/coolify-helper.sh generate-ssh-configs
 
 # Then use simplified SSH
 ssh coolify-main
@@ -149,11 +149,11 @@ ssh coolify-main
 
 ```bash
 # Configure firewall
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 22/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 80/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 443/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 8000/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw enable'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'ufw allow 22/tcp'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'ufw allow 80/tcp'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'ufw allow 443/tcp'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'ufw allow 8000/tcp'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'ufw enable'
 ```
 
 ### **SSH Key Management:**
@@ -179,13 +179,13 @@ ssh coolify-main
 ```bash
 # Check build logs in Coolify dashboard
 # Verify build commands and dependencies
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs build-container'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs build-container'
 
 # Check disk space
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'df -h'
 
 # Check memory usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'free -h'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'free -h'
 ```
 
 #### **SSL Certificate Issues:**
@@ -195,23 +195,23 @@ ssh coolify-main
 nslookup yourdomain.com
 
 # Check Let's Encrypt logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
 
 # Manual certificate renewal
-./.agent/scripts/coolify-helper.sh exec coolify-main 'certbot renew'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'certbot renew'
 ```
 
 #### **Application Not Accessible:**
 
 ```bash
 # Check application status
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker ps'
 
 # Check application logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs app-container'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs app-container'
 
 # Verify port configuration
-./.agent/scripts/coolify-helper.sh exec coolify-main 'netstat -tlnp'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'netstat -tlnp'
 ```
 
 ## 📊 **Performance Optimization**
@@ -220,11 +220,11 @@ nslookup yourdomain.com
 
 ```bash
 # Monitor resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'htop'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'iostat -x 1'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'htop'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'iostat -x 1'
 
 # Docker resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker stats'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker stats'
 ```
 
 ### **Application Performance:**
@@ -238,10 +238,10 @@ nslookup yourdomain.com
 
 ```bash
 # Monitor database performance
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_stat_activity'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_stat_activity'
 
 # Database backups
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_dump dbname > backup.sql'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_dump dbname > backup.sql'
 ```
 
 ## 🔄 **Backup & Disaster Recovery**
@@ -268,29 +268,29 @@ nslookup yourdomain.com
 
 ```bash
 # List containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps -a'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker ps -a'
 
 # Container logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs -f container-name'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker logs -f container-name'
 
 # Execute in container
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec -it container-name bash'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker exec -it container-name bash'
 
 # Container resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker stats container-name'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker stats container-name'
 ```
 
 ### **Image Management:**
 
 ```bash
 # List images
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker images'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker images'
 
 # Clean up unused images
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker image prune -a'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker image prune -a'
 
 # Clean up unused volumes
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker volume prune'
+./.agents/scripts/coolify-helper.sh exec coolify-main 'docker volume prune'
 ```
 
 ## 📚 **Best Practices**
diff --git a/.agent/tools/deployment/vercel.md b/.agents/tools/deployment/vercel.md
similarity index 80%
rename from .agent/tools/deployment/vercel.md
rename to .agents/tools/deployment/vercel.md
index 7525c3ee6..499dc560a 100644
--- a/.agent/tools/deployment/vercel.md
+++ b/.agents/tools/deployment/vercel.md
@@ -21,17 +21,17 @@ tools:
 - **CLI**: `vercel` (install: `npm i -g vercel`)
 - **Auth**: `vercel login` → `vercel whoami`
 - **Config**: `configs/vercel-cli-config.json`
-- **Script**: `.agent/scripts/vercel-cli-helper.sh`
+- **Script**: `.agents/scripts/vercel-cli-helper.sh`
 - **Local Dev First**: Works without auth for immediate development
 
 **Commands**: `list-projects|deploy|get-project|list-deployments|list-env|add-env|remove-env|list-domains|add-domain|list-accounts|whoami|dev|build`
 
-**Usage**: `./.agent/scripts/vercel-cli-helper.sh [command] [account] [args]`
+**Usage**: `./.agents/scripts/vercel-cli-helper.sh [command] [account] [args]`
 
 **Environments**: development, preview, production
 **Frameworks**: Next.js, React, Vue, Nuxt, Svelte, Angular, static sites
 
-**Local Dev** (no auth): `./.agent/scripts/vercel-cli-helper.sh dev personal ./app 3000`
+**Local Dev** (no auth): `./.agents/scripts/vercel-cli-helper.sh dev personal ./app 3000`
 <!-- AI-CONTEXT-END -->
 
 Comprehensive Vercel deployment and project management using the Vercel CLI through the AI DevOps Framework.
@@ -133,52 +133,52 @@ nano configs/vercel-cli-config.json
 
 ```bash
 # List all projects
-./.agent/scripts/vercel-cli-helper.sh list-projects personal
+./.agents/scripts/vercel-cli-helper.sh list-projects personal
 
 # Deploy to preview environment
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./my-app preview
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./my-app preview
 
 # Deploy to production
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./my-app production
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./my-app production
 
 # Get project information
-./.agent/scripts/vercel-cli-helper.sh get-project personal my-app
+./.agents/scripts/vercel-cli-helper.sh get-project personal my-app
 
 # List recent deployments
-./.agent/scripts/vercel-cli-helper.sh list-deployments personal my-app 10
+./.agents/scripts/vercel-cli-helper.sh list-deployments personal my-app 10
 ```
 
 ### Environment Variables
 
 ```bash
 # List environment variables
-./.agent/scripts/vercel-cli-helper.sh list-env personal my-app development
+./.agents/scripts/vercel-cli-helper.sh list-env personal my-app development
 
 # Add environment variable
-./.agent/scripts/vercel-cli-helper.sh add-env personal my-app API_KEY "secret-value" production
+./.agents/scripts/vercel-cli-helper.sh add-env personal my-app API_KEY "secret-value" production
 
 # Remove environment variable
-./.agent/scripts/vercel-cli-helper.sh remove-env personal my-app OLD_VAR production
+./.agents/scripts/vercel-cli-helper.sh remove-env personal my-app OLD_VAR production
 ```
 
 ### Domain Management
 
 ```bash
 # List domains
-./.agent/scripts/vercel-cli-helper.sh list-domains personal
+./.agents/scripts/vercel-cli-helper.sh list-domains personal
 
 # Add domain to project
-./.agent/scripts/vercel-cli-helper.sh add-domain personal my-app example.com
+./.agents/scripts/vercel-cli-helper.sh add-domain personal my-app example.com
 ```
 
 ### Account Management
 
 ```bash
 # List configured accounts
-./.agent/scripts/vercel-cli-helper.sh list-accounts
+./.agents/scripts/vercel-cli-helper.sh list-accounts
 
 # Show current Vercel user
-./.agent/scripts/vercel-cli-helper.sh whoami
+./.agents/scripts/vercel-cli-helper.sh whoami
 ```
 
 ## Advanced Features
@@ -222,10 +222,10 @@ Perfect for immediate development without any setup:
 
 ```bash
 # Start development server (works immediately)
-./.agent/scripts/vercel-cli-helper.sh dev personal ./my-app 3000
+./.agents/scripts/vercel-cli-helper.sh dev personal ./my-app 3000
 
 # Build project locally
-./.agent/scripts/vercel-cli-helper.sh build personal ./my-app
+./.agents/scripts/vercel-cli-helper.sh build personal ./my-app
 
 # Works with any project type:
 # - Node.js projects with package.json
@@ -240,12 +240,12 @@ Support for development, preview, and production environments:
 
 ```bash
 # Local development (no auth required)
-./.agent/scripts/vercel-cli-helper.sh dev personal ./app 3000
+./.agents/scripts/vercel-cli-helper.sh dev personal ./app 3000
 
 # Deploy to specific environments (requires auth)
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app development
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app preview
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app production
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app development
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app preview
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app production
 ```
 
 ## Integration with CI/CD
@@ -265,7 +265,7 @@ jobs:
       - uses: actions/checkout@v4
       - name: Deploy to Vercel
         run: |
-          ./.agent/scripts/vercel-cli-helper.sh deploy production ./ production
+          ./.agents/scripts/vercel-cli-helper.sh deploy production ./ production
         env:
           VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
 ```
@@ -274,10 +274,10 @@ jobs:
 
 ```bash
 # Preview deployments for feature branches
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app preview
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app preview
 
 # Production deployments for main branch
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app production
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app production
 ```
 
 ## Security Best Practices
@@ -330,7 +330,7 @@ Enable verbose logging:
 ```bash
 # Set debug environment variable
 export DEBUG=1
-./.agent/scripts/vercel-cli-helper.sh deploy personal ./app
+./.agents/scripts/vercel-cli-helper.sh deploy personal ./app
 ```
 
 ## Framework Support
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill.md b/.agents/tools/diagrams/mermaid-diagrams-skill.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/ADVANCED.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/ADVANCED.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/ADVANCED.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/ADVANCED.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/ARCHITECTURE.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/ARCHITECTURE.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/ARCHITECTURE.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/ARCHITECTURE.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/CHEATSHEET.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/CHEATSHEET.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/CHEATSHEET.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/CHEATSHEET.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/CLASS-ER.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/CLASS-ER.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/CLASS-ER.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/CLASS-ER.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/DATA-CHARTS.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/DATA-CHARTS.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/DATA-CHARTS.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/DATA-CHARTS.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/FLOWCHARTS.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/FLOWCHARTS.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/FLOWCHARTS.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/FLOWCHARTS.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/SEQUENCE.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/SEQUENCE.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/SEQUENCE.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/SEQUENCE.md
diff --git a/.agent/tools/diagrams/mermaid-diagrams-skill/references/STATE-JOURNEY.md b/.agents/tools/diagrams/mermaid-diagrams-skill/references/STATE-JOURNEY.md
similarity index 100%
rename from .agent/tools/diagrams/mermaid-diagrams-skill/references/STATE-JOURNEY.md
rename to .agents/tools/diagrams/mermaid-diagrams-skill/references/STATE-JOURNEY.md
diff --git a/.agent/tools/git.md b/.agents/tools/git.md
similarity index 100%
rename from .agent/tools/git.md
rename to .agents/tools/git.md
diff --git a/.agent/tools/git/authentication.md b/.agents/tools/git/authentication.md
similarity index 100%
rename from .agent/tools/git/authentication.md
rename to .agents/tools/git/authentication.md
diff --git a/.agent/tools/git/gitea-cli.md b/.agents/tools/git/gitea-cli.md
similarity index 99%
rename from .agent/tools/git/gitea-cli.md
rename to .agents/tools/git/gitea-cli.md
index 624f7989b..cfff0d268 100644
--- a/.agent/tools/git/gitea-cli.md
+++ b/.agents/tools/git/gitea-cli.md
@@ -22,7 +22,7 @@ tools:
 - **Install**: `brew install tea` (macOS) | `go install code.gitea.io/tea/cmd/tea@latest`
 - **Auth**: `tea login add --name <name> --url <url> --token <token>`
 - **Config**: `configs/gitea-cli-config.json`
-- **Script**: `.agent/scripts/gitea-cli-helper.sh`
+- **Script**: `.agents/scripts/gitea-cli-helper.sh`
 - **Requires**: `jq` for JSON parsing
 
 **Commands**: `list-repos|create-repo|delete-repo|list-issues|create-issue|close-issue|list-prs|create-pr|merge-pr|list-branches|create-branch`
diff --git a/.agent/tools/git/github-actions.md b/.agents/tools/git/github-actions.md
similarity index 100%
rename from .agent/tools/git/github-actions.md
rename to .agents/tools/git/github-actions.md
diff --git a/.agent/tools/git/github-cli.md b/.agents/tools/git/github-cli.md
similarity index 100%
rename from .agent/tools/git/github-cli.md
rename to .agents/tools/git/github-cli.md
diff --git a/.agent/tools/git/gitlab-cli.md b/.agents/tools/git/gitlab-cli.md
similarity index 98%
rename from .agent/tools/git/gitlab-cli.md
rename to .agents/tools/git/gitlab-cli.md
index ed5edaffb..9b9e4b5a0 100644
--- a/.agent/tools/git/gitlab-cli.md
+++ b/.agents/tools/git/gitlab-cli.md
@@ -22,7 +22,7 @@ tools:
 - **Install**: `brew install glab` (macOS) | `apt install glab` (Ubuntu)
 - **Auth**: `glab auth login` (GitLab.com) | `glab auth login --hostname gitlab.company.com` (self-hosted)
 - **Config**: `configs/gitlab-cli-config.json`
-- **Script**: `.agent/scripts/gitlab-cli-helper.sh`
+- **Script**: `.agents/scripts/gitlab-cli-helper.sh`
 - **Requires**: `jq` for JSON parsing
 
 **Commands**: `list-projects|create-project|delete-project|list-issues|create-issue|close-issue|list-mrs|create-mr|merge-mr|list-branches|create-branch`
diff --git a/.agent/tools/git/opencode-github-security.md b/.agents/tools/git/opencode-github-security.md
similarity index 100%
rename from .agent/tools/git/opencode-github-security.md
rename to .agents/tools/git/opencode-github-security.md
diff --git a/.agent/tools/git/opencode-github.md b/.agents/tools/git/opencode-github.md
similarity index 100%
rename from .agent/tools/git/opencode-github.md
rename to .agents/tools/git/opencode-github.md
diff --git a/.agent/tools/git/opencode-gitlab.md b/.agents/tools/git/opencode-gitlab.md
similarity index 100%
rename from .agent/tools/git/opencode-gitlab.md
rename to .agents/tools/git/opencode-gitlab.md
diff --git a/.agent/tools/git/security.md b/.agents/tools/git/security.md
similarity index 97%
rename from .agent/tools/git/security.md
rename to .agents/tools/git/security.md
index 55b1a1772..ae420b882 100644
--- a/.agent/tools/git/security.md
+++ b/.agents/tools/git/security.md
@@ -132,7 +132,7 @@ fi
 
 ### Tools
 
-- **secretlint**: `.agent/scripts/secretlint-helper.sh`
+- **secretlint**: `.agents/scripts/secretlint-helper.sh`
 - **git-secrets**: AWS secret detection
 - **trufflehog**: Historical secret scanning
 
@@ -140,7 +140,7 @@ fi
 
 ```bash
 # Scan for secrets
-./.agent/scripts/secretlint-helper.sh scan
+./.agents/scripts/secretlint-helper.sh scan
 
 # Scan git history
 trufflehog git file://. --only-verified
diff --git a/.agent/tools/git/worktrunk.md b/.agents/tools/git/worktrunk.md
similarity index 100%
rename from .agent/tools/git/worktrunk.md
rename to .agents/tools/git/worktrunk.md
diff --git a/.agent/tools/mobile/minisim.md b/.agents/tools/mobile/minisim.md
similarity index 100%
rename from .agent/tools/mobile/minisim.md
rename to .agents/tools/mobile/minisim.md
diff --git a/.agent/tools/monorepo/turborepo.md b/.agents/tools/monorepo/turborepo.md
similarity index 100%
rename from .agent/tools/monorepo/turborepo.md
rename to .agents/tools/monorepo/turborepo.md
diff --git a/.agent/tools/ocr/glm-ocr.md b/.agents/tools/ocr/glm-ocr.md
similarity index 100%
rename from .agent/tools/ocr/glm-ocr.md
rename to .agents/tools/ocr/glm-ocr.md
diff --git a/.agent/tools/opencode/oh-my-opencode.md b/.agents/tools/opencode/oh-my-opencode.md
similarity index 100%
rename from .agent/tools/opencode/oh-my-opencode.md
rename to .agents/tools/opencode/oh-my-opencode.md
diff --git a/.agent/tools/opencode/opencode-anthropic-auth.md b/.agents/tools/opencode/opencode-anthropic-auth.md
similarity index 100%
rename from .agent/tools/opencode/opencode-anthropic-auth.md
rename to .agents/tools/opencode/opencode-anthropic-auth.md
diff --git a/.agent/tools/opencode/opencode.md b/.agents/tools/opencode/opencode.md
similarity index 99%
rename from .agent/tools/opencode/opencode.md
rename to .agents/tools/opencode/opencode.md
index 71a2058f4..c07ed0b1c 100644
--- a/.agent/tools/opencode/opencode.md
+++ b/.agents/tools/opencode/opencode.md
@@ -36,10 +36,10 @@ tools:
 
 ```bash
 # Install agents
-.agent/scripts/generate-opencode-agents.sh
+.agents/scripts/generate-opencode-agents.sh
 
 # Check status
-.agent/scripts/generate-opencode-agents.sh
+.agents/scripts/generate-opencode-agents.sh
 
 # Authenticate (OAuth plugins)
 opencode auth login
@@ -119,7 +119,7 @@ opencode auth login
 ```bash
 # Run the setup script
 cd ~/Git/aidevops
-.agent/scripts/generate-opencode-agents.sh
+.agents/scripts/generate-opencode-agents.sh
 ```text
 
 This creates:
@@ -497,7 +497,7 @@ This pattern:
 |------|---------|-------|
 | `~/.aidevops/agents/` | Deployed aidevops agents | Created by setup.sh |
 | `~/.config/aidevops/mcp-env.sh` | API credentials | 600 permissions |
-| `~/Git/aidevops/.agent/` | Source agents | Development repo |
+| `~/Git/aidevops/.agents/` | Source agents | Development repo |
 | `~/Git/aidevops/setup.sh` | Deployment script | Copies to ~/.aidevops/ |
 
 **Troubleshooting Path Issues:**
diff --git a/.agent/tools/pdf/libpdf.md b/.agents/tools/pdf/libpdf.md
similarity index 100%
rename from .agent/tools/pdf/libpdf.md
rename to .agents/tools/pdf/libpdf.md
diff --git a/.agent/tools/pdf/overview.md b/.agents/tools/pdf/overview.md
similarity index 100%
rename from .agent/tools/pdf/overview.md
rename to .agents/tools/pdf/overview.md
diff --git a/.agent/tools/performance/performance.md b/.agents/tools/performance/performance.md
similarity index 100%
rename from .agent/tools/performance/performance.md
rename to .agents/tools/performance/performance.md
diff --git a/.agent/tools/performance/webpagetest.md b/.agents/tools/performance/webpagetest.md
similarity index 100%
rename from .agent/tools/performance/webpagetest.md
rename to .agents/tools/performance/webpagetest.md
diff --git a/.agent/tools/productivity/caldav-calendar-skill.md b/.agents/tools/productivity/caldav-calendar-skill.md
similarity index 100%
rename from .agent/tools/productivity/caldav-calendar-skill.md
rename to .agents/tools/productivity/caldav-calendar-skill.md
diff --git a/.agent/tools/programming/modern-javascript-skill.md b/.agents/tools/programming/modern-javascript-skill.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill.md
rename to .agents/tools/programming/modern-javascript-skill.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/CHEATSHEET.md b/.agents/tools/programming/modern-javascript-skill/references/CHEATSHEET.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/CHEATSHEET.md
rename to .agents/tools/programming/modern-javascript-skill/references/CHEATSHEET.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/COMPOSITION.md b/.agents/tools/programming/modern-javascript-skill/references/COMPOSITION.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/COMPOSITION.md
rename to .agents/tools/programming/modern-javascript-skill/references/COMPOSITION.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/CONCURRENCY.md b/.agents/tools/programming/modern-javascript-skill/references/CONCURRENCY.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/CONCURRENCY.md
rename to .agents/tools/programming/modern-javascript-skill/references/CONCURRENCY.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/ES2016-ES2017.md b/.agents/tools/programming/modern-javascript-skill/references/ES2016-ES2017.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/ES2016-ES2017.md
rename to .agents/tools/programming/modern-javascript-skill/references/ES2016-ES2017.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/ES2018-ES2019.md b/.agents/tools/programming/modern-javascript-skill/references/ES2018-ES2019.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/ES2018-ES2019.md
rename to .agents/tools/programming/modern-javascript-skill/references/ES2018-ES2019.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/ES2022-ES2023.md b/.agents/tools/programming/modern-javascript-skill/references/ES2022-ES2023.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/ES2022-ES2023.md
rename to .agents/tools/programming/modern-javascript-skill/references/ES2022-ES2023.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/ES2024.md b/.agents/tools/programming/modern-javascript-skill/references/ES2024.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/ES2024.md
rename to .agents/tools/programming/modern-javascript-skill/references/ES2024.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/ES2025.md b/.agents/tools/programming/modern-javascript-skill/references/ES2025.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/ES2025.md
rename to .agents/tools/programming/modern-javascript-skill/references/ES2025.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/IMMUTABILITY.md b/.agents/tools/programming/modern-javascript-skill/references/IMMUTABILITY.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/IMMUTABILITY.md
rename to .agents/tools/programming/modern-javascript-skill/references/IMMUTABILITY.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/PROMISES.md b/.agents/tools/programming/modern-javascript-skill/references/PROMISES.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/PROMISES.md
rename to .agents/tools/programming/modern-javascript-skill/references/PROMISES.md
diff --git a/.agent/tools/programming/modern-javascript-skill/references/UPCOMING.md b/.agents/tools/programming/modern-javascript-skill/references/UPCOMING.md
similarity index 100%
rename from .agent/tools/programming/modern-javascript-skill/references/UPCOMING.md
rename to .agents/tools/programming/modern-javascript-skill/references/UPCOMING.md
diff --git a/.agent/tools/security/privacy-filter.md b/.agents/tools/security/privacy-filter.md
similarity index 100%
rename from .agent/tools/security/privacy-filter.md
rename to .agents/tools/security/privacy-filter.md
diff --git a/.agent/tools/social-media/bird.md b/.agents/tools/social-media/bird.md
similarity index 100%
rename from .agent/tools/social-media/bird.md
rename to .agents/tools/social-media/bird.md
diff --git a/.agent/tools/task-management/beads.md b/.agents/tools/task-management/beads.md
similarity index 100%
rename from .agent/tools/task-management/beads.md
rename to .agents/tools/task-management/beads.md
diff --git a/.agent/tools/terminal/terminal-title.md b/.agents/tools/terminal/terminal-title.md
similarity index 100%
rename from .agent/tools/terminal/terminal-title.md
rename to .agents/tools/terminal/terminal-title.md
diff --git a/.agent/tools/ui/frontend-debugging.md b/.agents/tools/ui/frontend-debugging.md
similarity index 100%
rename from .agent/tools/ui/frontend-debugging.md
rename to .agents/tools/ui/frontend-debugging.md
diff --git a/.agent/tools/ui/i18next.md b/.agents/tools/ui/i18next.md
similarity index 100%
rename from .agent/tools/ui/i18next.md
rename to .agents/tools/ui/i18next.md
diff --git a/.agent/tools/ui/nextjs-layouts.md b/.agents/tools/ui/nextjs-layouts.md
similarity index 100%
rename from .agent/tools/ui/nextjs-layouts.md
rename to .agents/tools/ui/nextjs-layouts.md
diff --git a/.agent/tools/ui/react-context.md b/.agents/tools/ui/react-context.md
similarity index 100%
rename from .agent/tools/ui/react-context.md
rename to .agents/tools/ui/react-context.md
diff --git a/.agent/tools/ui/shadcn.md b/.agents/tools/ui/shadcn.md
similarity index 100%
rename from .agent/tools/ui/shadcn.md
rename to .agents/tools/ui/shadcn.md
diff --git a/.agent/tools/ui/tailwind-css.md b/.agents/tools/ui/tailwind-css.md
similarity index 100%
rename from .agent/tools/ui/tailwind-css.md
rename to .agents/tools/ui/tailwind-css.md
diff --git a/.agent/tools/ui/ui-skills.md b/.agents/tools/ui/ui-skills.md
similarity index 100%
rename from .agent/tools/ui/ui-skills.md
rename to .agents/tools/ui/ui-skills.md
diff --git a/.agent/tools/video/heygen-skill.md b/.agents/tools/video/heygen-skill.md
similarity index 100%
rename from .agent/tools/video/heygen-skill.md
rename to .agents/tools/video/heygen-skill.md
diff --git a/.agent/tools/video/heygen-skill/rules/assets.md b/.agents/tools/video/heygen-skill/rules/assets.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/assets.md
rename to .agents/tools/video/heygen-skill/rules/assets.md
diff --git a/.agent/tools/video/heygen-skill/rules/authentication.md b/.agents/tools/video/heygen-skill/rules/authentication.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/authentication.md
rename to .agents/tools/video/heygen-skill/rules/authentication.md
diff --git a/.agent/tools/video/heygen-skill/rules/avatars.md b/.agents/tools/video/heygen-skill/rules/avatars.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/avatars.md
rename to .agents/tools/video/heygen-skill/rules/avatars.md
diff --git a/.agent/tools/video/heygen-skill/rules/backgrounds.md b/.agents/tools/video/heygen-skill/rules/backgrounds.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/backgrounds.md
rename to .agents/tools/video/heygen-skill/rules/backgrounds.md
diff --git a/.agent/tools/video/heygen-skill/rules/captions.md b/.agents/tools/video/heygen-skill/rules/captions.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/captions.md
rename to .agents/tools/video/heygen-skill/rules/captions.md
diff --git a/.agent/tools/video/heygen-skill/rules/dimensions.md b/.agents/tools/video/heygen-skill/rules/dimensions.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/dimensions.md
rename to .agents/tools/video/heygen-skill/rules/dimensions.md
diff --git a/.agent/tools/video/heygen-skill/rules/photo-avatars.md b/.agents/tools/video/heygen-skill/rules/photo-avatars.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/photo-avatars.md
rename to .agents/tools/video/heygen-skill/rules/photo-avatars.md
diff --git a/.agent/tools/video/heygen-skill/rules/quota.md b/.agents/tools/video/heygen-skill/rules/quota.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/quota.md
rename to .agents/tools/video/heygen-skill/rules/quota.md
diff --git a/.agent/tools/video/heygen-skill/rules/remotion-integration.md b/.agents/tools/video/heygen-skill/rules/remotion-integration.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/remotion-integration.md
rename to .agents/tools/video/heygen-skill/rules/remotion-integration.md
diff --git a/.agent/tools/video/heygen-skill/rules/scripts.md b/.agents/tools/video/heygen-skill/rules/scripts.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/scripts.md
rename to .agents/tools/video/heygen-skill/rules/scripts.md
diff --git a/.agent/tools/video/heygen-skill/rules/streaming-avatars.md b/.agents/tools/video/heygen-skill/rules/streaming-avatars.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/streaming-avatars.md
rename to .agents/tools/video/heygen-skill/rules/streaming-avatars.md
diff --git a/.agent/tools/video/heygen-skill/rules/templates.md b/.agents/tools/video/heygen-skill/rules/templates.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/templates.md
rename to .agents/tools/video/heygen-skill/rules/templates.md
diff --git a/.agent/tools/video/heygen-skill/rules/text-overlays.md b/.agents/tools/video/heygen-skill/rules/text-overlays.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/text-overlays.md
rename to .agents/tools/video/heygen-skill/rules/text-overlays.md
diff --git a/.agent/tools/video/heygen-skill/rules/video-agent.md b/.agents/tools/video/heygen-skill/rules/video-agent.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/video-agent.md
rename to .agents/tools/video/heygen-skill/rules/video-agent.md
diff --git a/.agent/tools/video/heygen-skill/rules/video-generation.md b/.agents/tools/video/heygen-skill/rules/video-generation.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/video-generation.md
rename to .agents/tools/video/heygen-skill/rules/video-generation.md
diff --git a/.agent/tools/video/heygen-skill/rules/video-status.md b/.agents/tools/video/heygen-skill/rules/video-status.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/video-status.md
rename to .agents/tools/video/heygen-skill/rules/video-status.md
diff --git a/.agent/tools/video/heygen-skill/rules/video-translation.md b/.agents/tools/video/heygen-skill/rules/video-translation.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/video-translation.md
rename to .agents/tools/video/heygen-skill/rules/video-translation.md
diff --git a/.agent/tools/video/heygen-skill/rules/voices.md b/.agents/tools/video/heygen-skill/rules/voices.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/voices.md
rename to .agents/tools/video/heygen-skill/rules/voices.md
diff --git a/.agent/tools/video/heygen-skill/rules/webhooks.md b/.agents/tools/video/heygen-skill/rules/webhooks.md
similarity index 100%
rename from .agent/tools/video/heygen-skill/rules/webhooks.md
rename to .agents/tools/video/heygen-skill/rules/webhooks.md
diff --git a/.agent/tools/video/higgsfield.md b/.agents/tools/video/higgsfield.md
similarity index 100%
rename from .agent/tools/video/higgsfield.md
rename to .agents/tools/video/higgsfield.md
diff --git a/.agent/tools/video/remotion.md b/.agents/tools/video/remotion.md
similarity index 100%
rename from .agent/tools/video/remotion.md
rename to .agents/tools/video/remotion.md
diff --git a/.agent/tools/video/remotion/3d.md b/.agents/tools/video/remotion/3d.md
similarity index 100%
rename from .agent/tools/video/remotion/3d.md
rename to .agents/tools/video/remotion/3d.md
diff --git a/.agent/tools/video/remotion/animations.md b/.agents/tools/video/remotion/animations.md
similarity index 100%
rename from .agent/tools/video/remotion/animations.md
rename to .agents/tools/video/remotion/animations.md
diff --git a/.agent/tools/video/remotion/assets.md b/.agents/tools/video/remotion/assets.md
similarity index 100%
rename from .agent/tools/video/remotion/assets.md
rename to .agents/tools/video/remotion/assets.md
diff --git a/.agent/tools/video/remotion/assets/charts-bar-chart.tsx b/.agents/tools/video/remotion/assets/charts-bar-chart.tsx
similarity index 100%
rename from .agent/tools/video/remotion/assets/charts-bar-chart.tsx
rename to .agents/tools/video/remotion/assets/charts-bar-chart.tsx
diff --git a/.agent/tools/video/remotion/assets/text-animations-typewriter.tsx b/.agents/tools/video/remotion/assets/text-animations-typewriter.tsx
similarity index 100%
rename from .agent/tools/video/remotion/assets/text-animations-typewriter.tsx
rename to .agents/tools/video/remotion/assets/text-animations-typewriter.tsx
diff --git a/.agent/tools/video/remotion/assets/text-animations-word-highlight.tsx b/.agents/tools/video/remotion/assets/text-animations-word-highlight.tsx
similarity index 100%
rename from .agent/tools/video/remotion/assets/text-animations-word-highlight.tsx
rename to .agents/tools/video/remotion/assets/text-animations-word-highlight.tsx
diff --git a/.agent/tools/video/remotion/audio.md b/.agents/tools/video/remotion/audio.md
similarity index 100%
rename from .agent/tools/video/remotion/audio.md
rename to .agents/tools/video/remotion/audio.md
diff --git a/.agent/tools/video/remotion/calculate-metadata.md b/.agents/tools/video/remotion/calculate-metadata.md
similarity index 100%
rename from .agent/tools/video/remotion/calculate-metadata.md
rename to .agents/tools/video/remotion/calculate-metadata.md
diff --git a/.agent/tools/video/remotion/can-decode.md b/.agents/tools/video/remotion/can-decode.md
similarity index 100%
rename from .agent/tools/video/remotion/can-decode.md
rename to .agents/tools/video/remotion/can-decode.md
diff --git a/.agent/tools/video/remotion/charts.md b/.agents/tools/video/remotion/charts.md
similarity index 100%
rename from .agent/tools/video/remotion/charts.md
rename to .agents/tools/video/remotion/charts.md
diff --git a/.agent/tools/video/remotion/compositions.md b/.agents/tools/video/remotion/compositions.md
similarity index 100%
rename from .agent/tools/video/remotion/compositions.md
rename to .agents/tools/video/remotion/compositions.md
diff --git a/.agent/tools/video/remotion/display-captions.md b/.agents/tools/video/remotion/display-captions.md
similarity index 100%
rename from .agent/tools/video/remotion/display-captions.md
rename to .agents/tools/video/remotion/display-captions.md
diff --git a/.agent/tools/video/remotion/extract-frames.md b/.agents/tools/video/remotion/extract-frames.md
similarity index 100%
rename from .agent/tools/video/remotion/extract-frames.md
rename to .agents/tools/video/remotion/extract-frames.md
diff --git a/.agent/tools/video/remotion/fonts.md b/.agents/tools/video/remotion/fonts.md
similarity index 100%
rename from .agent/tools/video/remotion/fonts.md
rename to .agents/tools/video/remotion/fonts.md
diff --git a/.agent/tools/video/remotion/get-audio-duration.md b/.agents/tools/video/remotion/get-audio-duration.md
similarity index 100%
rename from .agent/tools/video/remotion/get-audio-duration.md
rename to .agents/tools/video/remotion/get-audio-duration.md
diff --git a/.agent/tools/video/remotion/get-video-dimensions.md b/.agents/tools/video/remotion/get-video-dimensions.md
similarity index 100%
rename from .agent/tools/video/remotion/get-video-dimensions.md
rename to .agents/tools/video/remotion/get-video-dimensions.md
diff --git a/.agent/tools/video/remotion/get-video-duration.md b/.agents/tools/video/remotion/get-video-duration.md
similarity index 100%
rename from .agent/tools/video/remotion/get-video-duration.md
rename to .agents/tools/video/remotion/get-video-duration.md
diff --git a/.agent/tools/video/remotion/gifs.md b/.agents/tools/video/remotion/gifs.md
similarity index 100%
rename from .agent/tools/video/remotion/gifs.md
rename to .agents/tools/video/remotion/gifs.md
diff --git a/.agent/tools/video/remotion/images.md b/.agents/tools/video/remotion/images.md
similarity index 100%
rename from .agent/tools/video/remotion/images.md
rename to .agents/tools/video/remotion/images.md
diff --git a/.agent/tools/video/remotion/import-srt-captions.md b/.agents/tools/video/remotion/import-srt-captions.md
similarity index 100%
rename from .agent/tools/video/remotion/import-srt-captions.md
rename to .agents/tools/video/remotion/import-srt-captions.md
diff --git a/.agent/tools/video/remotion/lottie.md b/.agents/tools/video/remotion/lottie.md
similarity index 100%
rename from .agent/tools/video/remotion/lottie.md
rename to .agents/tools/video/remotion/lottie.md
diff --git a/.agent/tools/video/remotion/measuring-dom-nodes.md b/.agents/tools/video/remotion/measuring-dom-nodes.md
similarity index 100%
rename from .agent/tools/video/remotion/measuring-dom-nodes.md
rename to .agents/tools/video/remotion/measuring-dom-nodes.md
diff --git a/.agent/tools/video/remotion/measuring-text.md b/.agents/tools/video/remotion/measuring-text.md
similarity index 100%
rename from .agent/tools/video/remotion/measuring-text.md
rename to .agents/tools/video/remotion/measuring-text.md
diff --git a/.agent/tools/video/remotion/sequencing.md b/.agents/tools/video/remotion/sequencing.md
similarity index 100%
rename from .agent/tools/video/remotion/sequencing.md
rename to .agents/tools/video/remotion/sequencing.md
diff --git a/.agent/tools/video/remotion/tailwind.md b/.agents/tools/video/remotion/tailwind.md
similarity index 100%
rename from .agent/tools/video/remotion/tailwind.md
rename to .agents/tools/video/remotion/tailwind.md
diff --git a/.agent/tools/video/remotion/text-animations.md b/.agents/tools/video/remotion/text-animations.md
similarity index 100%
rename from .agent/tools/video/remotion/text-animations.md
rename to .agents/tools/video/remotion/text-animations.md
diff --git a/.agent/tools/video/remotion/timing.md b/.agents/tools/video/remotion/timing.md
similarity index 100%
rename from .agent/tools/video/remotion/timing.md
rename to .agents/tools/video/remotion/timing.md
diff --git a/.agent/tools/video/remotion/transcribe-captions.md b/.agents/tools/video/remotion/transcribe-captions.md
similarity index 100%
rename from .agent/tools/video/remotion/transcribe-captions.md
rename to .agents/tools/video/remotion/transcribe-captions.md
diff --git a/.agent/tools/video/remotion/transitions.md b/.agents/tools/video/remotion/transitions.md
similarity index 100%
rename from .agent/tools/video/remotion/transitions.md
rename to .agents/tools/video/remotion/transitions.md
diff --git a/.agent/tools/video/remotion/trimming.md b/.agents/tools/video/remotion/trimming.md
similarity index 100%
rename from .agent/tools/video/remotion/trimming.md
rename to .agents/tools/video/remotion/trimming.md
diff --git a/.agent/tools/video/remotion/videos.md b/.agents/tools/video/remotion/videos.md
similarity index 100%
rename from .agent/tools/video/remotion/videos.md
rename to .agents/tools/video/remotion/videos.md
diff --git a/.agent/tools/video/video-prompt-design.md b/.agents/tools/video/video-prompt-design.md
similarity index 100%
rename from .agent/tools/video/video-prompt-design.md
rename to .agents/tools/video/video-prompt-design.md
diff --git a/.agent/tools/video/yt-dlp.md b/.agents/tools/video/yt-dlp.md
similarity index 100%
rename from .agent/tools/video/yt-dlp.md
rename to .agents/tools/video/yt-dlp.md
diff --git a/.agent/tools/wordpress.md b/.agents/tools/wordpress.md
similarity index 96%
rename from .agent/tools/wordpress.md
rename to .agents/tools/wordpress.md
index 5e0d35436..4680c51cd 100644
--- a/.agent/tools/wordpress.md
+++ b/.agents/tools/wordpress.md
@@ -31,10 +31,10 @@ mode: subagent
 
 ```bash
 # LocalWP sites
-.agent/scripts/wordpress-mcp-helper.sh list-sites
+.agents/scripts/wordpress-mcp-helper.sh list-sites
 
 # MainWP operations
-.agent/scripts/mainwp-helper.sh [command] [site]
+.agents/scripts/mainwp-helper.sh [command] [site]
 ```
 
 <!-- AI-CONTEXT-END -->
diff --git a/.agent/tools/wordpress/localwp.md b/.agents/tools/wordpress/localwp.md
similarity index 96%
rename from .agent/tools/wordpress/localwp.md
rename to .agents/tools/wordpress/localwp.md
index a55f7fb94..70c5f039d 100644
--- a/.agent/tools/wordpress/localwp.md
+++ b/.agents/tools/wordpress/localwp.md
@@ -17,7 +17,7 @@ tools:
 
 - **Purpose**: AI read-only access to Local by Flywheel WordPress databases
 - **Install**: `npm install -g @verygoodplugins/mcp-local-wp`
-- **Start**: `./.agent/scripts/localhost-helper.sh start-mcp`
+- **Start**: `./.agents/scripts/localhost-helper.sh start-mcp`
 - **Port**: 8085 (default)
 
 **MCP Tools**:
@@ -122,13 +122,13 @@ mcp-local-wp --help
 
 ```bash
 # Start LocalWP MCP server
-./.agent/scripts/localhost-helper.sh start-mcp
+./.agents/scripts/localhost-helper.sh start-mcp
 
 # Stop LocalWP MCP server
-./.agent/scripts/localhost-helper.sh stop-mcp
+./.agents/scripts/localhost-helper.sh stop-mcp
 
 # Check LocalWP sites
-./.agent/scripts/localhost-helper.sh list-localwp
+./.agents/scripts/localhost-helper.sh list-localwp
 ```
 
 ## Available Tools
@@ -279,7 +279,7 @@ The MCP server automatically detects your active Local by Flywheel MySQL instanc
 
 ```bash
 # Enable debug logging
-DEBUG=mcp-local-wp ./.agent/scripts/localhost-helper.sh start-mcp
+DEBUG=mcp-local-wp ./.agents/scripts/localhost-helper.sh start-mcp
 ```
 
 ## Benefits for AI Development
diff --git a/.agent/tools/wordpress/mainwp.md b/.agents/tools/wordpress/mainwp.md
similarity index 74%
rename from .agent/tools/wordpress/mainwp.md
rename to .agents/tools/wordpress/mainwp.md
index 327571db6..2e1c33f15 100644
--- a/.agent/tools/wordpress/mainwp.md
+++ b/.agents/tools/wordpress/mainwp.md
@@ -100,81 +100,81 @@ cp configs/mainwp-config.json.txt configs/mainwp-config.json
 
 ```bash
 # List all MainWP instances
-./.agent/scripts/mainwp-helper.sh instances
+./.agents/scripts/mainwp-helper.sh instances
 
 # List all managed sites
-./.agent/scripts/mainwp-helper.sh sites production
+./.agents/scripts/mainwp-helper.sh sites production
 
 # Get site details
-./.agent/scripts/mainwp-helper.sh site-details production 123
+./.agents/scripts/mainwp-helper.sh site-details production 123
 
 # Monitor all sites
-./.agent/scripts/mainwp-helper.sh monitor production
+./.agents/scripts/mainwp-helper.sh monitor production
 ```
 
 ### **WordPress Management:**
 
 ```bash
 # Update WordPress core for a site
-./.agent/scripts/mainwp-helper.sh update-core production 123
+./.agents/scripts/mainwp-helper.sh update-core production 123
 
 # Update all plugins for a site
-./.agent/scripts/mainwp-helper.sh update-plugins production 123
+./.agents/scripts/mainwp-helper.sh update-plugins production 123
 
 # Update specific plugin
-./.agent/scripts/mainwp-helper.sh update-plugin production 123 akismet
+./.agents/scripts/mainwp-helper.sh update-plugin production 123 akismet
 
 # List site plugins
-./.agent/scripts/mainwp-helper.sh plugins production 123
+./.agents/scripts/mainwp-helper.sh plugins production 123
 
 # List site themes
-./.agent/scripts/mainwp-helper.sh themes production 123
+./.agents/scripts/mainwp-helper.sh themes production 123
 ```
 
 ### **Backup Management:**
 
 ```bash
 # Create full backup
-./.agent/scripts/mainwp-helper.sh backup production 123 full
+./.agents/scripts/mainwp-helper.sh backup production 123 full
 
 # Create database backup
-./.agent/scripts/mainwp-helper.sh backup production 123 db
+./.agents/scripts/mainwp-helper.sh backup production 123 db
 
 # Create files backup
-./.agent/scripts/mainwp-helper.sh backup production 123 files
+./.agents/scripts/mainwp-helper.sh backup production 123 files
 
 # List all backups
-./.agent/scripts/mainwp-helper.sh backups production 123
+./.agents/scripts/mainwp-helper.sh backups production 123
 ```
 
 ### **Security Management:**
 
 ```bash
 # Run security scan
-./.agent/scripts/mainwp-helper.sh security-scan production 123
+./.agents/scripts/mainwp-helper.sh security-scan production 123
 
 # Get security scan results
-./.agent/scripts/mainwp-helper.sh security-results production 123
+./.agents/scripts/mainwp-helper.sh security-results production 123
 
 # Comprehensive security audit
-./.agent/scripts/mainwp-helper.sh audit-security production 123
+./.agents/scripts/mainwp-helper.sh audit-security production 123
 
 # Get uptime status
-./.agent/scripts/mainwp-helper.sh uptime production 123
+./.agents/scripts/mainwp-helper.sh uptime production 123
 ```
 
 ### **Bulk Operations:**
 
 ```bash
 # Bulk WordPress core updates
-./.agent/scripts/mainwp-helper.sh bulk-update-wp production 123 124 125
+./.agents/scripts/mainwp-helper.sh bulk-update-wp production 123 124 125
 
 # Bulk plugin updates
-./.agent/scripts/mainwp-helper.sh bulk-update-plugins production 123 124 125
+./.agents/scripts/mainwp-helper.sh bulk-update-plugins production 123 124 125
 
 # Sync multiple sites
 for site_id in 123 124 125; do
-    ./.agent/scripts/mainwp-helper.sh sync production $site_id
+    ./.agents/scripts/mainwp-helper.sh sync production $site_id
 done
 ```
 
@@ -182,13 +182,13 @@ done
 
 ```bash
 # Get site status
-./.agent/scripts/mainwp-helper.sh site-status production 123
+./.agents/scripts/mainwp-helper.sh site-status production 123
 
 # Sync site data
-./.agent/scripts/mainwp-helper.sh sync production 123
+./.agents/scripts/mainwp-helper.sh sync production 123
 
 # Monitor all sites overview
-./.agent/scripts/mainwp-helper.sh monitor production
+./.agents/scripts/mainwp-helper.sh monitor production
 ```
 
 ## 🛡️ **Security Best Practices**
@@ -205,13 +205,13 @@ done
 
 ```bash
 # Regular security audits
-./.agent/scripts/mainwp-helper.sh audit-security production 123
+./.agents/scripts/mainwp-helper.sh audit-security production 123
 
 # Monitor security scan results
-./.agent/scripts/mainwp-helper.sh security-results production 123
+./.agents/scripts/mainwp-helper.sh security-results production 123
 
 # Check uptime and availability
-./.agent/scripts/mainwp-helper.sh uptime production 123
+./.agents/scripts/mainwp-helper.sh uptime production 123
 ```
 
 ### **WordPress Security:**
@@ -230,7 +230,7 @@ done
 
 ```bash
 # Verify API credentials
-./.agent/scripts/mainwp-helper.sh instances
+./.agents/scripts/mainwp-helper.sh instances
 
 # Check MainWP instance accessibility
 curl -I https://mainwp.yourdomain.com/wp-json/mainwp/v1/
@@ -243,10 +243,10 @@ openssl s_client -connect mainwp.yourdomain.com:443
 
 ```bash
 # Force site sync
-./.agent/scripts/mainwp-helper.sh sync production 123
+./.agents/scripts/mainwp-helper.sh sync production 123
 
 # Check site status
-./.agent/scripts/mainwp-helper.sh site-status production 123
+./.agents/scripts/mainwp-helper.sh site-status production 123
 
 # Verify child plugin is active on target site
 ```
@@ -255,10 +255,10 @@ openssl s_client -connect mainwp.yourdomain.com:443
 
 ```bash
 # Check site details for error messages
-./.agent/scripts/mainwp-helper.sh site-details production 123
+./.agents/scripts/mainwp-helper.sh site-details production 123
 
 # Verify site accessibility
-./.agent/scripts/mainwp-helper.sh uptime production 123
+./.agents/scripts/mainwp-helper.sh uptime production 123
 
 # Check for maintenance mode or plugin conflicts
 ```
@@ -269,14 +269,14 @@ openssl s_client -connect mainwp.yourdomain.com:443
 
 ```bash
 # Daily monitoring routine
-./.agent/scripts/mainwp-helper.sh monitor production
+./.agents/scripts/mainwp-helper.sh monitor production
 
 # Check for sites needing updates
-./.agent/scripts/mainwp-helper.sh monitor production | grep "updates available"
+./.agents/scripts/mainwp-helper.sh monitor production | grep "updates available"
 
 # Security status overview
-for site_id in $(./.agent/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
-    ./.agent/scripts/mainwp-helper.sh security-results production $site_id
+for site_id in $(./.agents/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    ./.agents/scripts/mainwp-helper.sh security-results production $site_id
 done
 ```
 
@@ -289,17 +289,17 @@ INSTANCE="production"
 
 # Get sites needing attention
 echo "=== SITES NEEDING UPDATES ==="
-./.agent/scripts/mainwp-helper.sh monitor $INSTANCE
+./.agents/scripts/mainwp-helper.sh monitor $INSTANCE
 
 echo "=== BACKUP STATUS ==="
-for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+for site_id in $(./.agents/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
     echo "Site $site_id backups:"
-    ./.agent/scripts/mainwp-helper.sh backups $INSTANCE $site_id | tail -5
+    ./.agents/scripts/mainwp-helper.sh backups $INSTANCE $site_id | tail -5
 done
 
 echo "=== SECURITY ALERTS ==="
-for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
-    security_results=$(./.agent/scripts/mainwp-helper.sh security-results $INSTANCE $site_id)
+for site_id in $(./.agents/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    security_results=$(./.agents/scripts/mainwp-helper.sh security-results $INSTANCE $site_id)
     if echo "$security_results" | grep -q "warning\|error\|critical"; then
         echo "Site $site_id has security issues:"
         echo "$security_results"
@@ -324,9 +324,9 @@ done
 #!/bin/bash
 INSTANCE="production"
 
-for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+for site_id in $(./.agents/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
     echo "Creating backup for site $site_id"
-    ./.agent/scripts/mainwp-helper.sh backup $INSTANCE $site_id full
+    ./.agents/scripts/mainwp-helper.sh backup $INSTANCE $site_id full
     sleep 30  # Rate limiting
 done
 ```
@@ -335,9 +335,9 @@ done
 
 ```bash
 # Verify recent backups
-for site_id in $(./.agent/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
+for site_id in $(./.agents/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
     echo "Backup status for site $site_id:"
-    ./.agent/scripts/mainwp-helper.sh backups production $site_id | head -3
+    ./.agents/scripts/mainwp-helper.sh backups production $site_id | head -3
 done
 ```
 
diff --git a/.agent/tools/wordpress/scf.md b/.agents/tools/wordpress/scf.md
similarity index 100%
rename from .agent/tools/wordpress/scf.md
rename to .agents/tools/wordpress/scf.md
diff --git a/.agent/tools/wordpress/wp-admin.md b/.agents/tools/wordpress/wp-admin.md
similarity index 98%
rename from .agent/tools/wordpress/wp-admin.md
rename to .agents/tools/wordpress/wp-admin.md
index 09ad547c8..78d5745fe 100644
--- a/.agent/tools/wordpress/wp-admin.md
+++ b/.agents/tools/wordpress/wp-admin.md
@@ -577,13 +577,13 @@ For sites with MainWP Child connected, use `@mainwp` subagent for fleet operatio
 
 ```bash
 # List all sites
-./.agent/scripts/mainwp-helper.sh sites production
+./.agents/scripts/mainwp-helper.sh sites production
 
 # Bulk update plugins
-./.agent/scripts/mainwp-helper.sh bulk-update-plugins production 123 124 125
+./.agents/scripts/mainwp-helper.sh bulk-update-plugins production 123 124 125
 
 # Security scan
-./.agent/scripts/mainwp-helper.sh security-scan production 123
+./.agents/scripts/mainwp-helper.sh security-scan production 123
 ```
 
 ## SEO Tasks
diff --git a/.agent/tools/wordpress/wp-dev.md b/.agents/tools/wordpress/wp-dev.md
similarity index 99%
rename from .agent/tools/wordpress/wp-dev.md
rename to .agents/tools/wordpress/wp-dev.md
index 72f2ccf5c..55df92e16 100644
--- a/.agent/tools/wordpress/wp-dev.md
+++ b/.agents/tools/wordpress/wp-dev.md
@@ -60,7 +60,7 @@ node -v         # >= 18 (for HTTP transport, wp-env, Playground)
 - `@browser-automation` - E2E testing with Playwright
 - `@code-standards` - PHP/JS code quality checks
 
-**Related Workflows** (in .agent/workflows/):
+**Related Workflows** (in .agents/workflows/):
 - `bug-fixing.md` - Systematic debugging approach
 - `code-review.md` - Code review checklist
 - `git-workflow.md` - Branching for features/fixes
@@ -862,7 +862,7 @@ Before committing WordPress code:
 
 ```bash
 # Scan for secrets
-./.agent/scripts/secretlint-helper.sh scan
+./.agents/scripts/secretlint-helper.sh scan
 
 # Check for hardcoded credentials
 grep -r "password\|api_key\|secret" --include="*.php" .
diff --git a/.agent/tools/wordpress/wp-preferred.md b/.agents/tools/wordpress/wp-preferred.md
similarity index 100%
rename from .agent/tools/wordpress/wp-preferred.md
rename to .agents/tools/wordpress/wp-preferred.md
diff --git a/.agent/video.md b/.agents/video.md
similarity index 100%
rename from .agent/video.md
rename to .agents/video.md
diff --git a/.agent/workflows/branch.md b/.agents/workflows/branch.md
similarity index 98%
rename from .agent/workflows/branch.md
rename to .agents/workflows/branch.md
index 5c426c6a2..2aa6d3c2d 100644
--- a/.agent/workflows/branch.md
+++ b/.agents/workflows/branch.md
@@ -171,7 +171,7 @@ Regular commits following conventional format (`feat:`, `fix:`, `refactor:`, etc
 Run quality checks before pushing. Catches issues early.
 
 ```bash
-.agent/scripts/linters-local.sh --fast
+.agents/scripts/linters-local.sh --fast
 ```text
 
 **Agents**: `workflows/preflight.md`
@@ -181,7 +181,7 @@ Run quality checks before pushing. Catches issues early.
 Bump version for releases. Skip for WIP or intermediate commits.
 
 ```bash
-.agent/scripts/version-manager.sh bump [major|minor|patch]
+.agents/scripts/version-manager.sh bump [major|minor|patch]
 ```text
 
 **Agents**: `workflows/version-bump.md`, `workflows/changelog.md`
@@ -229,7 +229,7 @@ gh pr merge --squash --delete-branch
 Tag and publish for version releases.
 
 ```bash
-.agent/scripts/version-manager.sh release [major|minor|patch]
+.agents/scripts/version-manager.sh release [major|minor|patch]
 ```text
 
 **Agents**: `workflows/release.md`
diff --git a/.agent/workflows/branch/bugfix.md b/.agents/workflows/branch/bugfix.md
similarity index 100%
rename from .agent/workflows/branch/bugfix.md
rename to .agents/workflows/branch/bugfix.md
diff --git a/.agent/workflows/branch/chore.md b/.agents/workflows/branch/chore.md
similarity index 100%
rename from .agent/workflows/branch/chore.md
rename to .agents/workflows/branch/chore.md
diff --git a/.agent/workflows/branch/experiment.md b/.agents/workflows/branch/experiment.md
similarity index 100%
rename from .agent/workflows/branch/experiment.md
rename to .agents/workflows/branch/experiment.md
diff --git a/.agent/workflows/branch/feature.md b/.agents/workflows/branch/feature.md
similarity index 100%
rename from .agent/workflows/branch/feature.md
rename to .agents/workflows/branch/feature.md
diff --git a/.agent/workflows/branch/hotfix.md b/.agents/workflows/branch/hotfix.md
similarity index 100%
rename from .agent/workflows/branch/hotfix.md
rename to .agents/workflows/branch/hotfix.md
diff --git a/.agent/workflows/branch/refactor.md b/.agents/workflows/branch/refactor.md
similarity index 100%
rename from .agent/workflows/branch/refactor.md
rename to .agents/workflows/branch/refactor.md
diff --git a/.agent/workflows/branch/release.md b/.agents/workflows/branch/release.md
similarity index 94%
rename from .agent/workflows/branch/release.md
rename to .agents/workflows/branch/release.md
index f6871b6e3..0268903ee 100644
--- a/.agent/workflows/branch/release.md
+++ b/.agents/workflows/branch/release.md
@@ -51,9 +51,9 @@ git checkout -b release/1.2.0
 ### Release Lifecycle
 
 1. **Create release branch**
-2. **Update version files**: `.agent/scripts/version-manager.sh bump {type}`
+2. **Update version files**: `.agents/scripts/version-manager.sh bump {type}`
 3. **Update CHANGELOG.md**
-4. **Final testing**: `.agent/scripts/linters-local.sh`
+4. **Final testing**: `.agents/scripts/linters-local.sh`
 5. **Create PR to main**
 6. **Merge and tag**
 7. **Create GitHub release**
diff --git a/.agent/workflows/bug-fixing.md b/.agents/workflows/bug-fixing.md
similarity index 99%
rename from .agent/workflows/bug-fixing.md
rename to .agents/workflows/bug-fixing.md
index e0983913a..62a793e79 100644
--- a/.agent/workflows/bug-fixing.md
+++ b/.agents/workflows/bug-fixing.md
@@ -88,7 +88,7 @@ npm test
 composer test
 
 # Run quality checks
-bash ~/Git/aidevops/.agent/scripts/linters-local.sh
+bash ~/Git/aidevops/.agents/scripts/linters-local.sh
 ```
 
 #### Frontend Bug Verification (CRITICAL)
diff --git a/.agent/workflows/changelog.md b/.agents/workflows/changelog.md
similarity index 93%
rename from .agent/workflows/changelog.md
rename to .agents/workflows/changelog.md
index 8ffdcc7ce..77124f4ca 100644
--- a/.agent/workflows/changelog.md
+++ b/.agents/workflows/changelog.md
@@ -29,13 +29,13 @@ tools:
 
 ```bash
 # Preview changelog entry from commits
-.agent/scripts/version-manager.sh changelog-preview
+.agents/scripts/version-manager.sh changelog-preview
 
 # Validate changelog matches version
-.agent/scripts/version-manager.sh changelog-check
+.agents/scripts/version-manager.sh changelog-check
 
 # Full release (includes changelog validation)
-.agent/scripts/version-manager.sh release [major|minor|patch]
+.agents/scripts/version-manager.sh release [major|minor|patch]
 ```
 
 <!-- AI-CONTEXT-END -->
@@ -95,7 +95,7 @@ Before releasing, verify:
 To preview a changelog entry from recent commits:
 
 ```bash
-.agent/scripts/version-manager.sh changelog-preview
+.agents/scripts/version-manager.sh changelog-preview
 ```
 
 ## Before Releasing
diff --git a/.agent/workflows/code-audit-remote.md b/.agents/workflows/code-audit-remote.md
similarity index 97%
rename from .agent/workflows/code-audit-remote.md
rename to .agents/workflows/code-audit-remote.md
index f560a1619..58b0fd2ed 100644
--- a/.agent/workflows/code-audit-remote.md
+++ b/.agents/workflows/code-audit-remote.md
@@ -63,7 +63,7 @@ This complements `/linters-local` which runs fast, offline checks.
 bash ~/.aidevops/agents/scripts/coderabbit-cli.sh review
 
 # Analyze specific directory
-bash ~/.aidevops/agents/scripts/coderabbit-cli.sh analyze .agent/scripts/
+bash ~/.aidevops/agents/scripts/coderabbit-cli.sh analyze .agents/scripts/
 ```
 
 ### Codacy
@@ -218,8 +218,8 @@ jobs:
       - uses: actions/checkout@v4
       - name: Run Code Audit
         run: |
-          bash .agent/scripts/code-audit-helper.sh audit ${{ github.repository }}
-          bash .agent/scripts/code-audit-helper.sh report ${{ github.repository }} audit-report.json
+          bash .agents/scripts/code-audit-helper.sh audit ${{ github.repository }}
+          bash .agents/scripts/code-audit-helper.sh report ${{ github.repository }} audit-report.json
       - name: Upload Report
         uses: actions/upload-artifact@v4
         with:
diff --git a/.agent/workflows/conversation-starter.md b/.agents/workflows/conversation-starter.md
similarity index 100%
rename from .agent/workflows/conversation-starter.md
rename to .agents/workflows/conversation-starter.md
diff --git a/.agent/workflows/error-feedback.md b/.agents/workflows/error-feedback.md
similarity index 97%
rename from .agent/workflows/error-feedback.md
rename to .agents/workflows/error-feedback.md
index ff6da95cf..e75d3aae3 100644
--- a/.agent/workflows/error-feedback.md
+++ b/.agents/workflows/error-feedback.md
@@ -145,7 +145,7 @@ cat test-results.json | jq '.failures'
 
 ```bash
 # Universal quality check (aidevops)
-bash ~/Git/aidevops/.agent/scripts/linters-local.sh
+bash ~/Git/aidevops/.agents/scripts/linters-local.sh
 
 # ShellCheck (bash scripts)
 shellcheck script.sh
@@ -164,10 +164,10 @@ composer phpcs
 
 ```bash
 # Codacy auto-fix
-bash ~/Git/aidevops/.agent/scripts/codacy-cli.sh analyze --fix
+bash ~/Git/aidevops/.agents/scripts/codacy-cli.sh analyze --fix
 
 # Qlty auto-format
-bash ~/Git/aidevops/.agent/scripts/qlty-cli.sh fmt --all
+bash ~/Git/aidevops/.agents/scripts/qlty-cli.sh fmt --all
 
 # ESLint auto-fix
 npx eslint . --fix
@@ -557,7 +557,7 @@ gh run view {id} --log-failed
 gh pr checks
 
 # Run local quality check
-bash ~/Git/aidevops/.agent/scripts/linters-local.sh
+bash ~/Git/aidevops/.agents/scripts/linters-local.sh
 ```
 
 ### Common Fix Commands
@@ -573,6 +573,6 @@ npm run lint:fix
 npm run typecheck
 
 # Quality issues
-bash ~/Git/aidevops/.agent/scripts/codacy-cli.sh analyze --fix
-bash ~/Git/aidevops/.agent/scripts/qlty-cli.sh fmt --all
+bash ~/Git/aidevops/.agents/scripts/codacy-cli.sh analyze --fix
+bash ~/Git/aidevops/.agents/scripts/qlty-cli.sh fmt --all
 ```
diff --git a/.agent/workflows/feature-development.md b/.agents/workflows/feature-development.md
similarity index 99%
rename from .agent/workflows/feature-development.md
rename to .agents/workflows/feature-development.md
index d149f813c..76daf34a4 100644
--- a/.agent/workflows/feature-development.md
+++ b/.agents/workflows/feature-development.md
@@ -160,7 +160,7 @@ npm test
 composer test
 
 # Run quality checks
-bash ~/Git/aidevops/.agent/scripts/linters-local.sh
+bash ~/Git/aidevops/.agents/scripts/linters-local.sh
 
 # Run specific tests
 npm run test:feature
diff --git a/.agent/workflows/git-workflow.md b/.agents/workflows/git-workflow.md
similarity index 99%
rename from .agent/workflows/git-workflow.md
rename to .agents/workflows/git-workflow.md
index 5b6d9d5a8..80f3c9390 100644
--- a/.agent/workflows/git-workflow.md
+++ b/.agents/workflows/git-workflow.md
@@ -541,7 +541,7 @@ After completing file changes, run preflight automatically:
 > 2. Continue working
 > 3. Done for now
 
-**If changes include `.agent/` files** (in aidevops repo or repos with local agents):
+**If changes include `.agents/` files** (in aidevops repo or repos with local agents):
 
 > Agent files modified. Run `./setup.sh` to deploy to `~/.aidevops/agents/`?
 >
diff --git a/.agent/workflows/multi-repo-workspace.md b/.agents/workflows/multi-repo-workspace.md
similarity index 100%
rename from .agent/workflows/multi-repo-workspace.md
rename to .agents/workflows/multi-repo-workspace.md
diff --git a/.agent/workflows/plans.md b/.agents/workflows/plans.md
similarity index 99%
rename from .agent/workflows/plans.md
rename to .agents/workflows/plans.md
index 96d4e0372..fe7f76cb7 100644
--- a/.agent/workflows/plans.md
+++ b/.agents/workflows/plans.md
@@ -128,7 +128,7 @@ When tagging a task as `#ralph`, ensure it includes:
 ```markdown
 - [ ] t042 Fix all ShellCheck violations #ralph ~2h
   ralph-promise: "SHELLCHECK_CLEAN"
-  ralph-verify: "shellcheck .agent/scripts/*.sh"
+  ralph-verify: "shellcheck .agents/scripts/*.sh"
   ralph-max: 10
 ```
 
@@ -708,7 +708,7 @@ No branch, no PR — commit and push directly to main. These are low-risk planni
 
 ### Mixed changes (planning + non-exception files)
 
-If the change also touches non-exception files (e.g., `.agent/workflows/plans.md`):
+If the change also touches non-exception files (e.g., `.agents/workflows/plans.md`):
 
 1. **Create a worktree**: `wt switch -c chore/todo-{slug}` (creates `~/Git/{repo}-chore-todo-{slug}/`)
 2. **Make changes in the worktree directory**
diff --git a/.agent/workflows/postflight.md b/.agents/workflows/postflight.md
similarity index 98%
rename from .agent/workflows/postflight.md
rename to .agents/workflows/postflight.md
index 861b66688..adbfa194e 100644
--- a/.agent/workflows/postflight.md
+++ b/.agents/workflows/postflight.md
@@ -25,7 +25,7 @@ tools:
 - **Commands**:
   - `gh run list --workflow=code-quality.yml --limit=5`
   - `gh api repos/{owner}/{repo}/commits/{sha}/check-runs`
-  - `.agent/scripts/linters-local.sh`
+  - `.agents/scripts/linters-local.sh`
 - **Rollback**: See [Rollback Procedures](#rollback-procedures)
 
 <!-- AI-CONTEXT-END -->
@@ -154,7 +154,7 @@ curl -s "https://sonarcloud.io/api/measures/search_history?component=marcusquinn
 
 ```bash
 # Using Codacy CLI (if configured)
-./.agent/scripts/codacy-cli.sh status
+./.agents/scripts/codacy-cli.sh status
 
 # Check via API (requires CODACY_API_TOKEN)
 curl -s -H "api-token: $CODACY_API_TOKEN" \
@@ -165,7 +165,7 @@ curl -s -H "api-token: $CODACY_API_TOKEN" \
 
 ```bash
 # Run Snyk security scan
-./.agent/scripts/snyk-helper.sh test
+./.agents/scripts/snyk-helper.sh test
 
 # Check for secrets
 secretlint "**/*" --format compact
@@ -174,7 +174,7 @@ secretlint "**/*" --format compact
 npm audit --audit-level=high
 
 # Full security scan
-./.agent/scripts/snyk-helper.sh full
+./.agents/scripts/snyk-helper.sh full
 ```
 
 ### Comprehensive Postflight Script
@@ -410,11 +410,11 @@ Run postflight checks manually after release:
 
 ```bash
 # After release.md completes
-./.agent/scripts/postflight-check.sh
+./.agents/scripts/postflight-check.sh
 
 # Or individual checks
 gh run list --limit=5
-./.agent/scripts/linters-local.sh
+./.agents/scripts/linters-local.sh
 ```
 
 **When to use manual mode:**
@@ -462,7 +462,7 @@ git push origin --delete v{VERSION}
 git checkout -b hotfix/v{VERSION}.1
 # Fix the issue
 git commit -m "fix: resolve critical issue from v{VERSION}"
-./.agent/scripts/version-manager.sh release patch
+./.agents/scripts/version-manager.sh release patch
 ```
 
 ### 3. Rollback Checklist
@@ -480,7 +480,7 @@ git commit -m "fix: resolve critical issue from v{VERSION}"
 ```bash
 # Verify the rollback
 gh run list --limit=5  # Check CI/CD passes
-./.agent/scripts/linters-local.sh  # Verify quality restored
+./.agents/scripts/linters-local.sh  # Verify quality restored
 
 # Check SonarCloud
 curl -s "https://sonarcloud.io/api/qualitygates/project_status?projectKey=marcusquinn_aidevops" | jq '.projectStatus.status'
@@ -517,7 +517,7 @@ After release publication, run postflight checks:
 gh run watch $(gh run list --limit=1 --json databaseId -q '.[0].databaseId') --exit-status
 
 # Or run full postflight
-./.agent/scripts/postflight-check.sh
+./.agents/scripts/postflight-check.sh
 \`\`\`
 
 See `workflows/postflight.md` for detailed verification procedures and rollback guidance.
diff --git a/.agent/workflows/pr.md b/.agents/workflows/pr.md
similarity index 100%
rename from .agent/workflows/pr.md
rename to .agents/workflows/pr.md
diff --git a/.agent/workflows/pre-edit.md b/.agents/workflows/pre-edit.md
similarity index 97%
rename from .agent/workflows/pre-edit.md
rename to .agents/workflows/pre-edit.md
index eb6c83c5d..92a31bd48 100644
--- a/.agent/workflows/pre-edit.md
+++ b/.agents/workflows/pre-edit.md
@@ -96,7 +96,7 @@ Option 2 (continue on current branch) is acceptable IF:
 ## Working in aidevops Framework
 
 When modifying aidevops agents, you work in TWO locations:
-- **Source**: `~/Git/aidevops/.agent/` - THIS is the git repo, check branch HERE
+- **Source**: `~/Git/aidevops/.agents/` - THIS is the git repo, check branch HERE
 - **Deployed**: `~/.aidevops/agents/` - copy of source, not a git repo
 
 Run pre-edit-check.sh in `~/Git/aidevops/` BEFORE any changes to either location.
diff --git a/.agent/workflows/preflight.md b/.agents/workflows/preflight.md
similarity index 91%
rename from .agent/workflows/preflight.md
rename to .agents/workflows/preflight.md
index 6175d8b0d..e8bc2b7ac 100644
--- a/.agent/workflows/preflight.md
+++ b/.agents/workflows/preflight.md
@@ -19,9 +19,9 @@ tools:
 ## Quick Reference
 
 - **Auto-run**: Called by `version-manager.sh release` before version bump
-- **Manual**: `.agent/scripts/linters-local.sh`
+- **Manual**: `.agents/scripts/linters-local.sh`
 - **Skip**: `version-manager.sh release [type] --force --skip-preflight`
-- **Fast mode**: `.agent/scripts/linters-local.sh --fast`
+- **Fast mode**: `.agents/scripts/linters-local.sh --fast`
 
 **Check Phases** (fast → slow):
 1. Version consistency (~1s, blocking)
@@ -75,7 +75,7 @@ Preflight runs automatically during release:
 
 ```bash
 # Preflight runs before version bump
-.agent/scripts/version-manager.sh release minor
+.agents/scripts/version-manager.sh release minor
 ```text
 
 ### Manual
@@ -84,13 +84,13 @@ Run quality checks independently:
 
 ```bash
 # Full quality check
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 
 # Fast checks only (ShellCheck, secrets, returns)
-.agent/scripts/linters-local.sh --fast
+.agents/scripts/linters-local.sh --fast
 
 # Specific checks
-shellcheck .agent/scripts/*.sh
+shellcheck .agents/scripts/*.sh
 npx secretlint "**/*"
 ```text
 
@@ -124,10 +124,10 @@ For emergency hotfixes only:
 
 ```bash
 # Skip preflight (use with caution)
-.agent/scripts/version-manager.sh release patch --skip-preflight
+.agents/scripts/version-manager.sh release patch --skip-preflight
 
 # Skip both preflight and changelog
-.agent/scripts/version-manager.sh release patch --skip-preflight --force
+.agents/scripts/version-manager.sh release patch --skip-preflight --force
 ```text
 
 **When to skip:**
@@ -148,10 +148,10 @@ Lints all shell scripts for common issues:
 
 ```bash
 # Run manually
-shellcheck .agent/scripts/*.sh
+shellcheck .agents/scripts/*.sh
 
 # Check specific file
-shellcheck .agent/scripts/version-manager.sh
+shellcheck .agents/scripts/version-manager.sh
 ```text
 
 **Must pass**: Zero violations (errors are blocking)
@@ -165,7 +165,7 @@ Detects accidentally committed secrets:
 npx secretlint "**/*"
 
 # With helper
-.agent/scripts/secretlint-helper.sh scan
+.agents/scripts/secretlint-helper.sh scan
 ```text
 
 **Detects**: AWS keys, GitHub tokens, OpenAI keys, private keys, database URLs
@@ -175,7 +175,7 @@ npx secretlint "**/*"
 Ensures VERSION file matches all references:
 
 ```bash
-.agent/scripts/version-manager.sh validate
+.agents/scripts/version-manager.sh validate
 ```text
 
 **Checks**: VERSION, README badge, sonar-project.properties, setup.sh
@@ -186,7 +186,7 @@ Checks current quality gate status:
 
 ```bash
 # Via linters-local.sh
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 
 # Direct API (requires SONAR_TOKEN)
 curl -s "https://sonarcloud.io/api/qualitygates/project_status?projectKey=marcusquinn_aidevops"
@@ -239,7 +239,7 @@ curl -s "https://sonarcloud.io/api/hotspots/search?projectKey=marcusquinn_aidevo
 
 ```bash
 # See specific issues
-shellcheck -f gcc .agent/scripts/problem-script.sh
+shellcheck -f gcc .agents/scripts/problem-script.sh
 
 # Auto-fix some issues (with shellcheck-fix if available)
 # Or manually fix based on SC codes
@@ -261,10 +261,10 @@ path/to/false-positive.txt
 
 ```bash
 # Check current state
-.agent/scripts/version-manager.sh validate
+.agents/scripts/version-manager.sh validate
 
 # Fix by re-running bump
-.agent/scripts/version-manager.sh bump patch
+.agents/scripts/version-manager.sh bump patch
 ```text
 
 ## Worktree Awareness
diff --git a/.agent/workflows/ralph-loop.md b/.agents/workflows/ralph-loop.md
similarity index 97%
rename from .agent/workflows/ralph-loop.md
rename to .agents/workflows/ralph-loop.md
index 128e548d3..06cc07d8c 100644
--- a/.agent/workflows/ralph-loop.md
+++ b/.agents/workflows/ralph-loop.md
@@ -159,7 +159,7 @@ Cancel the active Ralph loop.
 
 ## State File
 
-Ralph stores its state in `.agent/loop-state/ralph-loop.local.md` (gitignored):
+Ralph stores its state in `.agents/loop-state/ralph-loop.local.md` (gitignored):
 
 ```yaml
 ---
@@ -408,13 +408,13 @@ If your AI CLI doesn't support stop hooks, use the external loop:
 
 ```bash
 # View current iteration
-grep '^iteration:' .agent/loop-state/ralph-loop.local.md
+grep '^iteration:' .agents/loop-state/ralph-loop.local.md
 
 # View full state
-head -10 .agent/loop-state/ralph-loop.local.md
+head -10 .agents/loop-state/ralph-loop.local.md
 
 # Check if loop is active
-test -f .agent/loop-state/ralph-loop.local.md && echo "Active" || echo "Not active"
+test -f .agents/loop-state/ralph-loop.local.md && echo "Active" || echo "Not active"
 ```
 
 ## Multi-Worktree Awareness
@@ -479,7 +479,7 @@ The `quality-loop-helper.sh` uses three strategies:
 
 ### Customizing Timing
 
-Edit `.agent/scripts/shared-constants.sh` to adjust timing constants:
+Edit `.agents/scripts/shared-constants.sh` to adjust timing constants:
 
 ```bash
 # Fast checks
@@ -702,7 +702,7 @@ full-loop-helper.sh start "Add new helper script" --no-auto-deploy
 
 ### State Management
 
-The full loop maintains state in `.agent/loop-state/full-loop.local.md` (gitignored), allowing:
+The full loop maintains state in `.agents/loop-state/full-loop.local.md` (gitignored), allowing:
 
 - Resume after interruption
 - Track current phase
@@ -710,7 +710,7 @@ The full loop maintains state in `.agent/loop-state/full-loop.local.md` (gitigno
 
 ```bash
 # Check current state
-cat .agent/loop-state/full-loop.local.md
+cat .agents/loop-state/full-loop.local.md
 
 # Resume from where you left off
 full-loop-helper.sh resume
diff --git a/.agent/workflows/readme-create-update.md b/.agents/workflows/readme-create-update.md
similarity index 100%
rename from .agent/workflows/readme-create-update.md
rename to .agents/workflows/readme-create-update.md
diff --git a/.agent/workflows/release.md b/.agents/workflows/release.md
similarity index 92%
rename from .agent/workflows/release.md
rename to .agents/workflows/release.md
index e0d5a04bf..761232c73 100644
--- a/.agent/workflows/release.md
+++ b/.agents/workflows/release.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- **Full release**: `.agent/scripts/version-manager.sh release [major|minor|patch] --skip-preflight`
+- **Full release**: `.agents/scripts/version-manager.sh release [major|minor|patch] --skip-preflight`
 - **CRITICAL**: Always use the script above - it updates all 6 version files atomically
 - **NEVER** manually edit VERSION, bump versions yourself, or use separate commands
 
@@ -30,11 +30,11 @@ git add -A && git commit -m "feat: description of changes"  # Commit if needed
 ```
 
 - **Auto-changelog**: Release script auto-generates CHANGELOG.md from conventional commits
-- **Create tag**: `.agent/scripts/version-manager.sh tag`
-- **GitHub release**: `.agent/scripts/version-manager.sh github-release`
-- **Postflight**: `.agent/scripts/postflight-check.sh` (verify after release)
+- **Create tag**: `.agents/scripts/version-manager.sh tag`
+- **GitHub release**: `.agents/scripts/version-manager.sh github-release`
+- **Postflight**: `.agents/scripts/postflight-check.sh` (verify after release)
 - **Deploy locally**: `./setup.sh` (aidevops repo only - deploys to ~/.aidevops/agents/)
-- **Validator**: `.agent/scripts/validate-version-consistency.sh`
+- **Validator**: `.agents/scripts/validate-version-consistency.sh`
 - **GitHub Actions**: `.github/workflows/version-validation.yml`
 - **Version bump only**: See `workflows/version-bump.md`
 - **Changelog format**: See `workflows/changelog.md`
@@ -126,7 +126,7 @@ The release script handles everything automatically:
 **MANDATORY**: Use this single command for ALL releases:
 
 ```bash
-./.agent/scripts/version-manager.sh release [major|minor|patch] --skip-preflight
+./.agents/scripts/version-manager.sh release [major|minor|patch] --skip-preflight
 ```
 
 **Flags**:
@@ -187,7 +187,7 @@ git checkout -b release/v{MAJOR}.{MINOR}.{PATCH}
 
 ```bash
 # For this framework
-./.agent/scripts/linters-local.sh
+./.agents/scripts/linters-local.sh
 
 # Generic checks
 npm run lint && npm test
@@ -201,10 +201,10 @@ The release script **automatically generates** CHANGELOG.md entries from convent
 
 ```bash
 # Preview what will be generated (optional)
-./.agent/scripts/version-manager.sh changelog-preview
+./.agents/scripts/version-manager.sh changelog-preview
 
 # Validate existing changelog (optional)
-./.agent/scripts/version-manager.sh changelog-check
+./.agents/scripts/version-manager.sh changelog-check
 ```
 
 The auto-generated changelog follows [Keep a Changelog](https://keepachangelog.com/) format:
@@ -235,7 +235,7 @@ git commit -m "chore(release): prepare v{MAJOR}.{MINOR}.{PATCH}"
 
 ```bash
 # Using version-manager (preferred)
-./.agent/scripts/version-manager.sh tag
+./.agents/scripts/version-manager.sh tag
 
 # Or manually
 git tag -a v{VERSION} -m "Release v{VERSION}"
@@ -257,7 +257,7 @@ git push gitlab main --tags
 **Using version-manager (preferred):**
 
 ```bash
-./.agent/scripts/version-manager.sh github-release
+./.agents/scripts/version-manager.sh github-release
 ```
 
 **Using GitHub CLI:**
@@ -349,10 +349,10 @@ The release script **automatically marks tasks complete** based on commit messag
 
 ```bash
 # Preview which tasks would be marked complete
-.agent/scripts/version-manager.sh list-task-ids
+.agents/scripts/version-manager.sh list-task-ids
 
 # Manually run auto-mark (without release)
-.agent/scripts/version-manager.sh auto-mark-tasks
+.agents/scripts/version-manager.sh auto-mark-tasks
 ```
 
 **Manual completion** (if needed):
@@ -402,10 +402,10 @@ After release publication, run postflight checks to verify release health:
 
 ```bash
 # Run full postflight verification
-./.agent/scripts/postflight-check.sh
+./.agents/scripts/postflight-check.sh
 
 # Quick check (CI/CD + SonarCloud only)
-./.agent/scripts/postflight-check.sh --quick
+./.agents/scripts/postflight-check.sh --quick
 
 # Or check CI/CD manually
 gh run watch $(gh run list --limit=1 --json databaseId -q '.[0].databaseId') --exit-status
@@ -480,7 +480,7 @@ curl -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user
 
 ```bash
 # Validate consistency
-./.agent/scripts/version-manager.sh validate
+./.agents/scripts/version-manager.sh validate
 
 # See version-bump.md for fixing
 ```
diff --git a/.agent/workflows/review-issue-pr.md b/.agents/workflows/review-issue-pr.md
similarity index 100%
rename from .agent/workflows/review-issue-pr.md
rename to .agents/workflows/review-issue-pr.md
diff --git a/.agent/workflows/session-manager.md b/.agents/workflows/session-manager.md
similarity index 100%
rename from .agent/workflows/session-manager.md
rename to .agents/workflows/session-manager.md
diff --git a/.agent/workflows/session-review.md b/.agents/workflows/session-review.md
similarity index 98%
rename from .agent/workflows/session-review.md
rename to .agents/workflows/session-review.md
index 823b80073..61853565c 100644
--- a/.agent/workflows/session-review.md
+++ b/.agents/workflows/session-review.md
@@ -71,7 +71,7 @@ grep -A 20 "## In Progress" TODO.md 2>/dev/null || echo "No TODO.md"
 git status --short
 
 # Check for active Ralph loop (new location, then legacy)
-test -f .agent/loop-state/ralph-loop.local.md && cat .agent/loop-state/ralph-loop.local.md | head -10 || \
+test -f .agents/loop-state/ralph-loop.local.md && cat .agents/loop-state/ralph-loop.local.md | head -10 || \
 test -f .claude/ralph-loop.local.md && cat .claude/ralph-loop.local.md | head -10
 
 # Check recent PR activity
diff --git a/.agent/workflows/sql-migrations.md b/.agents/workflows/sql-migrations.md
similarity index 100%
rename from .agent/workflows/sql-migrations.md
rename to .agents/workflows/sql-migrations.md
diff --git a/.agent/workflows/version-bump.md b/.agents/workflows/version-bump.md
similarity index 85%
rename from .agent/workflows/version-bump.md
rename to .agents/workflows/version-bump.md
index b787b1d5b..8c7883ca5 100644
--- a/.agent/workflows/version-bump.md
+++ b/.agents/workflows/version-bump.md
@@ -18,7 +18,7 @@ tools:
 
 ## Quick Reference
 
-- **Full release**: `.agent/scripts/version-manager.sh release [major|minor|patch] --skip-preflight`
+- **Full release**: `.agents/scripts/version-manager.sh release [major|minor|patch] --skip-preflight`
 - **CRITICAL**: This single command does everything - bump, commit, tag, push, GitHub release
 - **NEVER** run separate commands, manually edit VERSION, or bump versions yourself
 - **Files updated atomically**: VERSION, package.json, README.md badge, setup.sh, sonar-project.properties, .claude-plugin/marketplace.json
@@ -46,14 +46,14 @@ If you edit VERSION directly, the other 5 files become stale.
 **Always use**:
 
 ```bash
-.agent/scripts/version-manager.sh bump [major|minor|patch]
+.agents/scripts/version-manager.sh bump [major|minor|patch]
 # or for full release:
-.agent/scripts/version-manager.sh release [major|minor|patch]
+.agents/scripts/version-manager.sh release [major|minor|patch]
 ```
 
 ## The Primary Tool: version-manager.sh
 
-**Location**: `.agent/scripts/version-manager.sh`
+**Location**: `.agents/scripts/version-manager.sh`
 
 This script handles all version management tasks:
 
@@ -81,16 +81,16 @@ This script handles all version management tasks:
 
 ```bash
 # Standard release (runs preflight checks, requires changelog)
-.agent/scripts/version-manager.sh release patch
+.agents/scripts/version-manager.sh release patch
 
 # Bypass changelog check
-.agent/scripts/version-manager.sh release minor --force
+.agents/scripts/version-manager.sh release minor --force
 
 # Bypass preflight quality checks
-.agent/scripts/version-manager.sh release patch --skip-preflight
+.agents/scripts/version-manager.sh release patch --skip-preflight
 
 # Bypass both
-.agent/scripts/version-manager.sh release patch --force --skip-preflight
+.agents/scripts/version-manager.sh release patch --force --skip-preflight
 ```
 
 ## Files Updated Automatically
@@ -145,7 +145,7 @@ After (for version 1.6.0):
 
 ```bash
 # Preview suggested changelog entries from commits
-.agent/scripts/version-manager.sh changelog-preview
+.agents/scripts/version-manager.sh changelog-preview
 ```
 
 ## Recommended Workflow
@@ -153,7 +153,7 @@ After (for version 1.6.0):
 ### Step 1: Validate Current State
 
 ```bash
-.agent/scripts/version-manager.sh validate
+.agents/scripts/version-manager.sh validate
 ```
 
 This catches stale versions before you start. Fix any inconsistencies first.
@@ -166,13 +166,13 @@ Manually update the changelog (see gap section above).
 
 ```bash
 # For bug fixes
-.agent/scripts/version-manager.sh release patch
+.agents/scripts/version-manager.sh release patch
 
 # For new features
-.agent/scripts/version-manager.sh release minor
+.agents/scripts/version-manager.sh release minor
 
 # For breaking changes
-.agent/scripts/version-manager.sh release major
+.agents/scripts/version-manager.sh release major
 ```
 
 ### Step 4: Push Changes
@@ -212,12 +212,12 @@ The `validate` command checks:
 
 ## Preflight Quality Checks
 
-The `release` command automatically runs `.agent/scripts/linters-local.sh` before proceeding.
+The `release` command automatically runs `.agents/scripts/linters-local.sh` before proceeding.
 
 To bypass (not recommended):
 
 ```bash
-.agent/scripts/version-manager.sh release patch --skip-preflight
+.agents/scripts/version-manager.sh release patch --skip-preflight
 ```
 
 ## Troubleshooting
@@ -226,10 +226,10 @@ To bypass (not recommended):
 
 ```bash
 # See which files are out of sync
-.agent/scripts/version-manager.sh validate
+.agents/scripts/version-manager.sh validate
 
 # Sync all files to current VERSION
-.agent/scripts/version-manager.sh bump patch  # or use sync if available
+.agents/scripts/version-manager.sh bump patch  # or use sync if available
 ```
 
 ### GitHub Release Failed
@@ -246,7 +246,7 @@ gh auth login  # if needed
 Either update CHANGELOG.md or bypass:
 
 ```bash
-.agent/scripts/version-manager.sh release patch --force
+.agents/scripts/version-manager.sh release patch --force
 ```
 
 ## Related Workflows
diff --git a/.agent/workflows/wiki-update.md b/.agents/workflows/wiki-update.md
similarity index 89%
rename from .agent/workflows/wiki-update.md
rename to .agents/workflows/wiki-update.md
index 0e5508e6c..952a0de7e 100644
--- a/.agent/workflows/wiki-update.md
+++ b/.agents/workflows/wiki-update.md
@@ -76,7 +76,7 @@ Key queries for wiki updates:
 "List all service integrations and their purposes"
 
 # Workflow guides
-"What workflows are available in .agent/workflows/?"
+"What workflows are available in .agents/workflows/?"
 ```
 
 ### Using Repomix
@@ -85,7 +85,7 @@ Generate structured codebase context:
 
 ```bash
 # Compress mode for token-efficient overview
-.agent/scripts/context-builder-helper.sh compress .
+.agents/scripts/context-builder-helper.sh compress .
 
 # Or use Repomix MCP directly
 # pack_codebase with compress=true for ~80% token reduction
@@ -114,7 +114,7 @@ Reference `repomix-instruction.md` for codebase understanding guidelines.
 
 - [ ] Version number matches `VERSION` file
 - [ ] Service count matches actual integrations
-- [ ] Script count matches `.agent/scripts/` contents
+- [ ] Script count matches `.agents/scripts/` contents
 - [ ] MCP integrations list is current
 - [ ] Workflow guides reflect actual workflows
 - [ ] Code examples are accurate and working
@@ -126,11 +126,11 @@ Reference `repomix-instruction.md` for codebase understanding guidelines.
 | Wiki Section | Source of Truth |
 |--------------|-----------------|
 | Version | `VERSION` file |
-| Service count | `.agent/services/` + service `.md` files |
-| Script count | `ls .agent/scripts/*.sh \| wc -l` |
+| Service count | `.agents/services/` + service `.md` files |
+| Script count | `ls .agents/scripts/*.sh \| wc -l` |
 | MCP integrations | `configs/` directory |
-| Workflows | `.agent/workflows/` directory |
-| Agent structure | `.agent/AGENTS.md` |
+| Workflows | `.agents/workflows/` directory |
+| Agent structure | `.agents/AGENTS.md` |
 
 ### Common Update Triggers
 
@@ -174,7 +174,7 @@ Reference `repomix-instruction.md` for codebase understanding guidelines.
 
 #### Workflows-Guide.md
 
-- List all workflows from `.agent/workflows/`
+- List all workflows from `.agents/workflows/`
 - Brief description of each
 - Link to detailed workflow files
 
@@ -192,13 +192,13 @@ Reference `repomix-instruction.md` for codebase understanding guidelines.
 
 ```bash
 # Validate markdown formatting
-.agent/scripts/markdown-formatter.sh lint .wiki/
+.agents/scripts/markdown-formatter.sh lint .wiki/
 
 # Check for broken internal links
 # (wiki links use format: [Text](Page-Name))
 
 # Verify version consistency
-.agent/scripts/version-manager.sh validate
+.agents/scripts/version-manager.sh validate
 ```
 
 ### Content Validation
@@ -240,9 +240,9 @@ cat VERSION
 # Output: 2.0.0
 
 # 2. Count current resources
-echo "Scripts: $(ls .agent/scripts/*.sh 2>/dev/null | wc -l)"
-echo "Services: $(ls .agent/services/**/*.md 2>/dev/null | wc -l)"
-echo "Workflows: $(ls .agent/workflows/*.md 2>/dev/null | wc -l)"
+echo "Scripts: $(ls .agents/scripts/*.sh 2>/dev/null | wc -l)"
+echo "Services: $(ls .agents/services/**/*.md 2>/dev/null | wc -l)"
+echo "Workflows: $(ls .agents/workflows/*.md 2>/dev/null | wc -l)"
 
 # 3. Build context (using Augment Context Engine)
 # "Summarize all changes since the last wiki update"
@@ -250,7 +250,7 @@ echo "Workflows: $(ls .agent/workflows/*.md 2>/dev/null | wc -l)"
 # 4. Update wiki pages as needed
 
 # 5. Validate
-.agent/scripts/markdown-formatter.sh lint .wiki/
+.agents/scripts/markdown-formatter.sh lint .wiki/
 
 # 6. Commit
 git add .wiki/
@@ -328,6 +328,6 @@ VERSION=$(cat VERSION)
 ## Related Documentation
 
 - `repomix-instruction.md` - Codebase context instructions
-- `.agent/tools/context/augment-context-engine.md` - Augment setup
-- `.agent/tools/context/context-builder.md` - Repomix wrapper
+- `.agents/tools/context/augment-context-engine.md` - Augment setup
+- `.agents/tools/context/context-builder.md` - Repomix wrapper
 - `.github/workflows/sync-wiki.yml` - Auto-sync workflow
diff --git a/.agent/workflows/worktree.md b/.agents/workflows/worktree.md
similarity index 100%
rename from .agent/workflows/worktree.md
rename to .agents/workflows/worktree.md
diff --git a/.coderabbit.yaml b/.coderabbit.yaml
index c8ddad937..4b977fb4c 100644
--- a/.coderabbit.yaml
+++ b/.coderabbit.yaml
@@ -28,8 +28,8 @@ reviews:
   
   # Exclude certain files from review
   path_filters:
-    - "!.agent/tmp/*"
-    - "!.agent/memory/*"
+    - "!.agents/tmp/*"
+    - "!.agents/memory/*"
     - "!*.log"
     - "!*.tmp"
   
@@ -43,7 +43,7 @@ reviews:
         - Security of credential handling
         - Input validation
         
-    - path: ".agent/scripts/*.sh"
+    - path: ".agents/scripts/*.sh"
       instructions: |
         Automation scripts - focus on:
         - Reliability and robustness
diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml
index 2f495f1d3..11ab70c51 100644
--- a/.github/workflows/code-quality.yml
+++ b/.github/workflows/code-quality.yml
@@ -28,32 +28,32 @@ jobs:
         echo "✅ AGENTS.md: $(test -f AGENTS.md && echo 'Present' || echo 'Missing')"
         echo "✅ README.md: $(test -f README.md && echo 'Present' || echo 'Missing')"
         echo "✅ LICENSE: $(test -f LICENSE && echo 'Present' || echo 'Missing')"
-        echo "✅ .agent/ directory: $(test -d .agent && echo 'Present' || echo 'Missing')"
+        echo "✅ .agents/ directory: $(test -d .agent && echo 'Present' || echo 'Missing')"
 
         echo ""
         echo "📊 Framework Statistics:"
         echo "📚 Documentation files: $(find . -name '*.md' | wc -l)"
-        echo "🔧 Agent scripts: $(find .agent/scripts -name '*.sh' 2>/dev/null | wc -l || echo '0')"
-        echo "⚙️  Quality specs: $(find .agent/spec -name '*.md' 2>/dev/null | wc -l || echo '0')"
+        echo "🔧 Agent scripts: $(find .agents/scripts -name '*.sh' 2>/dev/null | wc -l || echo '0')"
+        echo "⚙️  Quality specs: $(find .agents/spec -name '*.md' 2>/dev/null | wc -l || echo '0')"
         echo "📖 Service docs: $(find docs -name '*.md' 2>/dev/null | wc -l || echo '0')"
 
         echo ""
         echo "🔍 Quality Checks:"
 
         # Check agent scripts exist and are executable
-        if [ -d ".agent/scripts" ]; then
-          script_count=$(find .agent/scripts -name "*.sh" | wc -l)
+        if [ -d ".agents/scripts" ]; then
+          script_count=$(find .agents/scripts -name "*.sh" | wc -l)
           echo "✅ Agent scripts found: $script_count"
         else
-          echo "❌ .agent/scripts directory missing"
+          echo "❌ .agents/scripts directory missing"
         fi
 
         # Check quality specs exist
-        if [ -d ".agent/spec" ]; then
-          spec_count=$(find .agent/spec -name "*.md" | wc -l)
+        if [ -d ".agents/spec" ]; then
+          spec_count=$(find .agents/spec -name "*.md" | wc -l)
           echo "✅ Quality specs found: $spec_count"
         else
-          echo "❌ .agent/spec directory missing"
+          echo "❌ .agents/spec directory missing"
         fi
 
         # Check documentation exists
@@ -73,7 +73,7 @@ jobs:
         echo "🔐 Security Validation:"
         echo "✅ API keys stored securely in local storage (~/.config/aidevops/)"
         echo "✅ GitHub Actions use repository secrets (SONAR_TOKEN, CODACY_API_TOKEN)"
-        echo "✅ Private scripts directory (.agent/scripts-private/) gitignored"
+        echo "✅ Private scripts directory (.agents/scripts-private/) gitignored"
         echo "✅ Security documentation and best practices implemented"
 
   sonarcloud:
diff --git a/.github/workflows/code-review-monitoring.yml b/.github/workflows/code-review-monitoring.yml
index e0ec0f880..5f66103ec 100644
--- a/.github/workflows/code-review-monitoring.yml
+++ b/.github/workflows/code-review-monitoring.yml
@@ -73,10 +73,10 @@ jobs:
         CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }}
       run: |
         # Make scripts executable
-        chmod +x .agent/scripts/*.sh
+        chmod +x .agents/scripts/*.sh
         
         # Run monitoring with full analysis
-        ./.agent/scripts/monitor-code-review.sh monitor
+        ./.agents/scripts/monitor-code-review.sh monitor
     
     - name: 🔧 Apply Auto-Fixes
       run: |
@@ -85,12 +85,12 @@ jobs:
         # See: https://github.com/marcusquinn/aidevops/issues/333
         
         # Apply framework-specific fixes only
-        ./.agent/scripts/monitor-code-review.sh fix
+        ./.agents/scripts/monitor-code-review.sh fix
     
     - name: 📊 Generate Quality Report
       run: |
         # Generate comprehensive quality report
-        ./.agent/scripts/monitor-code-review.sh report > quality-report.md
+        ./.agents/scripts/monitor-code-review.sh report > quality-report.md
         
         # Add current metrics
         echo "## 📈 Current Quality Metrics" >> quality-report.md
diff --git a/.github/workflows/opencode-agent.yml b/.github/workflows/opencode-agent.yml
index 6f83b7768..f5f231a8f 100644
--- a/.github/workflows/opencode-agent.yml
+++ b/.github/workflows/opencode-agent.yml
@@ -1,7 +1,7 @@
 # OpenCode AI Agent - Maximum Security Configuration
 #
 # This workflow enables AI-powered issue resolution with strict security controls.
-# See: .agent/tools/git/opencode-github-security.md for full documentation
+# See: .agents/tools/git/opencode-github-security.md for full documentation
 #
 # Security features:
 # - Trusted users only (OWNER, MEMBER, COLLABORATOR)
@@ -277,7 +277,7 @@ jobs:
             - Create pull requests with clear descriptions
             - Add helpful comments explaining changes
             
-            Follow the project's coding standards in .agent/tools/code-review/code-standards.md
+            Follow the project's coding standards in .agents/tools/code-review/code-standards.md
       
       - name: Mark completion
         if: always()
diff --git a/.github/workflows/postflight.yml b/.github/workflows/postflight.yml
index 594187b6c..5804af148 100644
--- a/.github/workflows/postflight.yml
+++ b/.github/workflows/postflight.yml
@@ -218,4 +218,4 @@ jobs:
         echo "Recommended actions:"
         echo "1. Review the failed checks in the workflow summary"
         echo "2. If critical issues found, consider rollback"
-        echo "3. See: .agent/workflows/postflight.md#rollback-procedures"
+        echo "3. See: .agents/workflows/postflight.md#rollback-procedures"
diff --git a/.github/workflows/update-website-docs.yml b/.github/workflows/update-website-docs.yml
index 484c666b8..6aedc5fb7 100644
--- a/.github/workflows/update-website-docs.yml
+++ b/.github/workflows/update-website-docs.yml
@@ -45,7 +45,7 @@ jobs:
           let readme = fs.readFileSync('README.md', 'utf8');
           
           // Convert relative links to absolute GitHub URLs
-          // Matches markdown links like [text](.agent/file.md) or [text](LICENSE)
+          // Matches markdown links like [text](.agents/file.md) or [text](LICENSE)
           const repoBase = 'https://github.com/marcusquinn/aidevops/blob/main/';
           readme = readme.replace(/\]\((?!http|#|mailto:)([^)]+)\)/g, (match, path) => {
             return `](${repoBase}${path})`;
diff --git a/.github/workflows/version-validation.yml b/.github/workflows/version-validation.yml
index 9e0cef83c..860806094 100644
--- a/.github/workflows/version-validation.yml
+++ b/.github/workflows/version-validation.yml
@@ -28,10 +28,10 @@ jobs:
         echo ""
         
         # Make validation script executable
-        chmod +x .agent/scripts/validate-version-consistency.sh
+        chmod +x .agents/scripts/validate-version-consistency.sh
         
         # Run version validation
-        if ./.agent/scripts/validate-version-consistency.sh; then
+        if ./.agents/scripts/validate-version-consistency.sh; then
           echo ""
           echo "✅ Version Validation: PASSED"
           echo "All version references are consistent across the framework."
@@ -103,7 +103,7 @@ jobs:
         
         echo ""
         echo "💡 To create a release:"
-        echo "   ./.agent/scripts/version-manager.sh release [major|minor|patch]"
+        echo "   ./.agents/scripts/version-manager.sh release [major|minor|patch]"
         echo ""
         echo "✅ Framework is ready for release when version validation passes."
 
diff --git a/.gitignore b/.gitignore
index f96b78593..acd01b638 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,7 +8,7 @@ configs/*.json
 !configs/mcp-templates/
 
 # Allow agent directory to be committed
-!.agent/
+!.agents/
 
 # Password files and credentials
 *.password
@@ -36,11 +36,11 @@ authorized_keys
 # Exceptions for secretlint tool (security linter, not actual secrets)
 !.secretlintrc.json
 !.secretlintignore
-!.agent/scripts/secretlint-helper.sh
-!.agent/secretlint.md
+!.agents/scripts/secretlint-helper.sh
+!.agents/secretlint.md
 
 # Exception for credential management script (not actual credentials)
-!.agent/scripts/credential-helper.sh
+!.agents/scripts/credential-helper.sh
 
 # Environment files
 .env*
@@ -56,11 +56,11 @@ credentials/
 .credentials/
 
 # Exception: agent credential documentation (not actual credentials)
-!.agent/tools/credentials/
-!.agent/tools/credentials/**
+!.agents/tools/credentials/
+!.agents/tools/credentials/**
 
 # Private scripts (never commit)
-.agent/scripts-private/
+.agents/scripts-private/
 scripts-private/
 
 # Backup files
@@ -136,10 +136,10 @@ tmp.*.json
 
 # AI Assistant working directories
 # Ignore all files in tmp and memory directories except README.md
-.agent/tmp/*
-!.agent/tmp/README.md
-.agent/memory/*
-!.agent/memory/README.md
+.agents/tmp/*
+!.agents/tmp/README.md
+.agents/memory/*
+!.agents/memory/README.md
 
 # Analysis reports and results
 *.sarif
@@ -165,7 +165,7 @@ test-*.yaml
 #Ignore vscode AI rules
 .github/instructions/codacy.instructions.md
 
-# AI Tool Symlinks - Track these (they point to .agent and AGENTS.md)
+# AI Tool Symlinks - Track these (they point to .agents and AGENTS.md)
 # Rules files - only actual files tracked, not symlinks
 !CLAUDE.md
 !GEMINI.md
@@ -183,7 +183,7 @@ test-*.yaml
 
 # AI tool directories removed - cause duplicate @ refs in OpenCode
 # These tools should use ~/.aidevops/agents/ (deployed location)
-# See .agent/AGENTS.md "AI Tool Configuration" section
+# See .agents/AGENTS.md "AI Tool Configuration" section
 .ai
 .kiro
 .continue
@@ -196,7 +196,7 @@ test-*.yaml
 .aidevops-tenant
 
 # Loop state files (local to each worktree, not committed)
-.agent/loop-state/
+.agents/loop-state/
 
 # Superset local config
 .superset/
diff --git a/.opencode/MCP-TESTING-GUIDE.md b/.opencode/MCP-TESTING-GUIDE.md
index 877bf0e4c..33f4654ac 100644
--- a/.opencode/MCP-TESTING-GUIDE.md
+++ b/.opencode/MCP-TESTING-GUIDE.md
@@ -17,13 +17,13 @@ bun run dashboard
 ### 2. Run Health Check
 
 ```bash
-./.agent/scripts/mcp-inspector-helper.sh health
+./.agents/scripts/mcp-inspector-helper.sh health
 ```
 
 ### 3. Test API Gateway
 
 ```bash
-./.agent/scripts/mcp-inspector-helper.sh test-gateway
+./.agents/scripts/mcp-inspector-helper.sh test-gateway
 ```
 
 ## MCP Inspector Commands
@@ -34,38 +34,38 @@ The web UI provides interactive testing at `http://localhost:6274`:
 
 ```bash
 # Launch with all configured servers
-./.agent/scripts/mcp-inspector-helper.sh ui
+./.agents/scripts/mcp-inspector-helper.sh ui
 
 # Launch for specific server
-./.agent/scripts/mcp-inspector-helper.sh ui context7
+./.agents/scripts/mcp-inspector-helper.sh ui context7
 ```
 
 ### List Tools
 
 ```bash
 # List tools from all servers
-./.agent/scripts/mcp-inspector-helper.sh list-tools
+./.agents/scripts/mcp-inspector-helper.sh list-tools
 
 # List tools from specific server
-./.agent/scripts/mcp-inspector-helper.sh list-tools context7
-./.agent/scripts/mcp-inspector-helper.sh list-tools repomix
+./.agents/scripts/mcp-inspector-helper.sh list-tools context7
+./.agents/scripts/mcp-inspector-helper.sh list-tools repomix
 ```
 
 ### Call Tools
 
 ```bash
 # Call Context7 resolve-library-id
-./.agent/scripts/mcp-inspector-helper.sh call-tool context7 resolve-library-id libraryName=bun
+./.agents/scripts/mcp-inspector-helper.sh call-tool context7 resolve-library-id libraryName=bun
 
 # Call Repomix pack_codebase
-./.agent/scripts/mcp-inspector-helper.sh call-tool repomix pack_codebase directory=/path/to/repo
+./.agents/scripts/mcp-inspector-helper.sh call-tool repomix pack_codebase directory=/path/to/repo
 ```
 
 ### List Resources
 
 ```bash
-./.agent/scripts/mcp-inspector-helper.sh list-resources
-./.agent/scripts/mcp-inspector-helper.sh list-resources filesystem
+./.agents/scripts/mcp-inspector-helper.sh list-resources
+./.agents/scripts/mcp-inspector-helper.sh list-resources filesystem
 ```
 
 ## Direct npx Commands
@@ -210,7 +210,7 @@ ws.onmessage = (e) => console.log(JSON.parse(e.data))
 1. Check if server is running:
 
    ```bash
-   ./.agent/scripts/mcp-inspector-helper.sh health
+   ./.agents/scripts/mcp-inspector-helper.sh health
    ```
 
 2. Check server logs:
@@ -301,6 +301,6 @@ const data = await response.json()
     ├── parallel-quality.ts     # Parallel quality checks
     └── toon.ts                 # TOON OpenCode tool
 
-.agent/scripts/
+.agents/scripts/
 └── mcp-inspector-helper.sh     # Inspector helper script
 ```
diff --git a/.opencode/tool/api-keys.ts b/.opencode/tool/api-keys.ts
index 903af3d78..465c8a331 100644
--- a/.opencode/tool/api-keys.ts
+++ b/.opencode/tool/api-keys.ts
@@ -12,11 +12,11 @@ export default tool({
     // Route tenant actions to credential-helper.sh
     if (args.action.startsWith("tenant-")) {
       const subcommand = args.action.replace("tenant-", "")
-      const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/credential-helper.sh ${subcommand} ${service}`.text()
+      const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/credential-helper.sh ${subcommand} ${service}`.text()
       return result.trim()
     }
 
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/setup-local-api-keys.sh ${args.action} ${service}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/setup-local-api-keys.sh ${args.action} ${service}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/linter-manager.ts b/.opencode/tool/linter-manager.ts
index c6af45743..389685c26 100644
--- a/.opencode/tool/linter-manager.ts
+++ b/.opencode/tool/linter-manager.ts
@@ -8,7 +8,7 @@ export default tool({
   },
   async execute(args) {
     const linter = args.linter || ""
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/linter-manager.sh ${args.action} ${linter}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/linter-manager.sh ${args.action} ${linter}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/markdown-formatter.ts b/.opencode/tool/markdown-formatter.ts
index 021826312..69a738aaa 100644
--- a/.opencode/tool/markdown-formatter.ts
+++ b/.opencode/tool/markdown-formatter.ts
@@ -8,7 +8,7 @@ export default tool({
   },
   async execute(args) {
     const target = args.target || "."
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/markdown-formatter.sh ${args.action} ${target}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/markdown-formatter.sh ${args.action} ${target}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/mcp-integrations.ts b/.opencode/tool/mcp-integrations.ts
index c367f811c..fd79cf69d 100644
--- a/.opencode/tool/mcp-integrations.ts
+++ b/.opencode/tool/mcp-integrations.ts
@@ -7,7 +7,7 @@ export const setup = tool({
   },
   async execute(args) {
     const server = args.server || "all"
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/setup-mcp-integrations.sh setup ${server}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/setup-mcp-integrations.sh setup ${server}`.text()
     return result.trim()
   },
 })
@@ -19,7 +19,7 @@ export const validate = tool({
   },
   async execute(args) {
     const server = args.server || "all"
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/validate-mcp-integrations.sh ${server}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/validate-mcp-integrations.sh ${server}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/parallel-quality.ts b/.opencode/tool/parallel-quality.ts
index f8f6c6e09..eb598d906 100644
--- a/.opencode/tool/parallel-quality.ts
+++ b/.opencode/tool/parallel-quality.ts
@@ -158,7 +158,7 @@ export default tool({
 
     // Use resolved paths - no user input in paths
     const rootDir = new URL('../..', import.meta.url).pathname
-    const scriptDir = new URL('../../.agent/scripts', import.meta.url).pathname
+    const scriptDir = new URL('../../.agents/scripts', import.meta.url).pathname
 
     // Get predefined safe commands
     const allChecks = getSafeCommands(scriptDir, rootDir)
diff --git a/.opencode/tool/quality-check.ts b/.opencode/tool/quality-check.ts
index f0f062edb..814c16c27 100644
--- a/.opencode/tool/quality-check.ts
+++ b/.opencode/tool/quality-check.ts
@@ -9,7 +9,7 @@ export default tool({
   async execute(args) {
     const target = args.target || "."
     const fixFlag = args.fix ? "--fix" : ""
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/quality-check.sh ${target} ${fixFlag}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/quality-check.sh ${target} ${fixFlag}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/system-cleanup.ts b/.opencode/tool/system-cleanup.ts
index 4caf652e5..345548b80 100644
--- a/.opencode/tool/system-cleanup.ts
+++ b/.opencode/tool/system-cleanup.ts
@@ -6,7 +6,7 @@ export default tool({
     target: tool.schema.enum(["all", "cache", "logs", "temp", "node_modules", "dry-run"]).describe("What to clean up"),
   },
   async execute(args) {
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/system-cleanup.sh ${args.target}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/system-cleanup.sh ${args.target}`.text()
     return result.trim()
   },
 })
diff --git a/.opencode/tool/version-manager.ts b/.opencode/tool/version-manager.ts
index 4414883f3..24c2f3fc7 100644
--- a/.opencode/tool/version-manager.ts
+++ b/.opencode/tool/version-manager.ts
@@ -8,7 +8,7 @@ export default tool({
   },
   async execute(args) {
     const type = args.type || ""
-    const result = await Bun.$`bash ${import.meta.dir}/../../.agent/scripts/version-manager.sh ${args.action} ${type}`.text()
+    const result = await Bun.$`bash ${import.meta.dir}/../../.agents/scripts/version-manager.sh ${args.action} ${type}`.text()
     return result.trim()
   },
 })
diff --git a/.playwright-cli/.!78875!page-2026-01-25T03-31-43-006Z.png b/.playwright-cli/.!78875!page-2026-01-25T03-31-43-006Z.png
new file mode 100644
index 000000000..e69de29bb
diff --git a/AGENTS.md b/AGENTS.md
index 4ff94a986..7585cef75 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,7 +5,7 @@
 ## Quick Reference
 
 - **Purpose**: Contributing to aidevops framework development
-- **User Guide**: `.agent/AGENTS.md` (deployed to `~/.aidevops/agents/`)
+- **User Guide**: `.agents/AGENTS.md` (deployed to `~/.aidevops/agents/`)
 - **Repo**: `~/Git/aidevops/`
 
 **OpenCode Paths** (aidevops recommends OpenCode as primary tool):
@@ -24,10 +24,10 @@
 ./setup.sh
 
 # Quality check
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 
 # Release
-.agent/scripts/version-manager.sh release [major|minor|patch]
+.agents/scripts/version-manager.sh release [major|minor|patch]
 ```text
 
 **Quality Standards**: SonarCloud A-grade, ShellCheck zero violations,
@@ -43,7 +43,7 @@
 │   └── tasks/             # PRD and task files
 │       ├── prd-*.md       # Product requirement documents
 │       └── tasks-*.md     # Implementation task lists
-└── .agent/
+└── .agents/
     ├── AGENTS.md          # User guide (distributed)
     ├── {domain}.md        # Main agents (aidevops, wordpress, seo, etc.)
     ├── {domain}/          # Subagents for each domain
@@ -54,7 +54,7 @@
     └── scripts/           # Helper scripts
 ```
 
-**Before extending aidevops**: Read `.agent/aidevops/architecture.md` for:
+**Before extending aidevops**: Read `.agents/aidevops/architecture.md` for:
 - Agent design patterns (progressive disclosure, context offloading, Ralph loop)
 - Extension guide (adding services, tools, documentation standards)
 - Framework conventions (naming, code standards, security requirements)
@@ -68,13 +68,13 @@ This repository has two AGENTS.md files with different purposes:
 | File | Purpose | Audience |
 |------|---------|----------|
 | `~/Git/aidevops/AGENTS.md` | Development guide | Contributors |
-| `~/Git/aidevops/.agent/AGENTS.md` | User guide | Users of aidevops |
+| `~/Git/aidevops/.agents/AGENTS.md` | User guide | Users of aidevops |
 
-The `.agent/AGENTS.md` is copied to `~/.aidevops/agents/AGENTS.md` by `setup.sh`.
+The `.agents/AGENTS.md` is copied to `~/.aidevops/agents/AGENTS.md` by `setup.sh`.
 
 ## Contributing
 
-See `.agent/aidevops/` for framework development guidance:
+See `.agents/aidevops/` for framework development guidance:
 
 | File | Purpose |
 |------|---------|
@@ -105,13 +105,13 @@ From `tools/build-agent/build-agent.md`:
 
 ```bash
 # Before committing
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 
 # ShellCheck all scripts
-find .agent/scripts/ -name "*.sh" -exec shellcheck {} \;
+find .agents/scripts/ -name "*.sh" -exec shellcheck {} \;
 
 # Release new version
-.agent/scripts/version-manager.sh release [major|minor|patch]
+.agents/scripts/version-manager.sh release [major|minor|patch]
 ```text
 
 ## Self-Assessment Protocol
@@ -120,4 +120,4 @@ When developing agents, apply self-assessment from `tools/build-agent/build-agen
 
 - **Triggers**: Observable failure, user correction, contradiction, staleness
 - **Process**: Complete task, cite evidence, check duplicates, propose fix
-- **Duplicates**: Always `rg "pattern" .agent/` before adding instructions
+- **Duplicates**: Always `rg "pattern" .agents/` before adding instructions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b443aa454..aeff2f0cf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -979,14 +979,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Loop state migration in setup.sh from `.claude/` to `.agent/loop-state/` (#67)
+- Loop state migration in setup.sh from `.claude/` to `.agents/loop-state/` (#67)
 
 ## [2.51.0] - 2026-01-12
 
 ### Added
 
 - add FluentCRM MCP integration for sales and marketing (#64)
-- migrate loop state to .agent/loop-state and enhance re-anchor (#65)
+- migrate loop state to .agents/loop-state and enhance re-anchor (#65)
 
 ### Changed
 
@@ -1010,7 +1010,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- Loop state directory migrated from `.claude/` to `.agent/loop-state/` (backward compatible) (#65)
+- Loop state directory migrated from `.claude/` to `.agents/loop-state/` (backward compatible) (#65)
 - Ralph loop documentation updated with context pollution prevention philosophy (#65)
 - Chrome DevTools docs: add individual network request throttling (#66)
 - Linter thresholds improved and preflight issues fixed (#62)
@@ -1545,7 +1545,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- auto-discover primary agents from .agent/*.md files
+- auto-discover primary agents from .agents/*.md files
 - add comprehensive git workflow with branch safety and preflight checks
 
 ### Changed
@@ -1879,7 +1879,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **YAML Frontmatter with Tool Permissions** - Added to ~120 subagent files
   - Standardized tool permission declarations across all subagents
   - Enables OpenCode to enforce tool access controls per agent
-- **Agent Directory Architecture Documentation** - Documented `.agent/` vs `.opencode/agent/` structure
+- **Agent Directory Architecture Documentation** - Documented `.agents/` vs `.opencode/agent/` structure
   - Clarified deployment paths and directory purposes
 
 ### Changed
@@ -1904,7 +1904,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - **osgrep Local Semantic Search** - New tool integration for 100% private semantic code search
-  - Documentation in `.agent/tools/context/osgrep.md`
+  - Documentation in `.agents/tools/context/osgrep.md`
   - Config templates for osgrep MCP integration
   - Updated setup.sh and scripts for osgrep CLI support
   - GitHub issue comments submitted (#58, #26) for upstream bug tracking
@@ -2099,11 +2099,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Disabled `bash` tool to prevent shell command file writes
   - Disabled `task` tool to prevent spawning write-capable subagents (subagents don't inherit parent permissions)
   - Added explicit `write: deny` permission for defense in depth
-  - Updated `.agent/plan-plus.md` documentation to reflect strict read-only mode
+  - Updated `.agents/plan-plus.md` documentation to reflect strict read-only mode
 
 ### Added
 
-- **Permission Model Limitations Documentation** - New section in `.agent/tools/opencode/opencode.md`
+- **Permission Model Limitations Documentation** - New section in `.agents/tools/opencode/opencode.md`
   - Documents OpenCode permission inheritance behavior
   - Explains subagent permission isolation
   - Provides guidance for securing read-only agents
@@ -2115,7 +2115,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Secretlint Integration** - Secret detection tool to prevent committing credentials
   - New `secretlint-helper.sh` for installation, scanning, and pre-commit hook management
   - Configuration files `.secretlintrc.json` and `.secretlintignore` for project-specific setup
-  - Comprehensive documentation in `.agent/secretlint.md`
+  - Comprehensive documentation in `.agents/secretlint.md`
   - Multi-provider detection: AWS, GCP, GitHub, OpenAI, Anthropic, Slack, npm tokens
   - Private key detection: RSA, DSA, EC, OpenSSH keys
   - Database connection string scanning
@@ -2141,7 +2141,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **Comprehensive AI Workflow Documentation** - 9 new workflow guides in `.agent/workflows/`:
+- **Comprehensive AI Workflow Documentation** - 9 new workflow guides in `.agents/workflows/`:
   - `git-workflow.md` - Git practices and branch strategies
   - `bug-fixing.md` - Bug fix and hotfix workflows
   - `feature-development.md` - Feature development lifecycle
@@ -2156,8 +2156,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Grep by Vercel MCP server integration for GitHub code search
 - Cross-tool AI assistant symlinks (.cursorrules, .windsurfrules, CLAUDE.md, GEMINI.md)
 - OpenCode custom tool definitions in `.opencode/tool/`
-- Consolidated `.agent/` directory structure
-- Developer preferences guidance in `.agent/memory/README.md`
+- Consolidated `.agents/` directory structure
+- Developer preferences guidance in `.agents/memory/README.md`
 
 ### Changed
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6fc43f17a..dc619ad51 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -21,7 +21,7 @@ cd aidevops
 ./setup.sh
 
 # Run quality checks before committing
-.agent/scripts/linters-local.sh
+.agents/scripts/linters-local.sh
 ```
 
 ## Commit Messages
diff --git a/README.md b/README.md
index 0a013d265..fe315d6e2 100644
--- a/README.md
+++ b/README.md
@@ -93,7 +93,7 @@ The result: AI agents that work *with* your development process, not around it.
 
 - Primary agents (Build+, SEO, Marketing, etc.) with @plan-plus subagent for planning-only mode
 - 614+ subagent markdown files organized by domain
-- 167 helper scripts in `.agent/scripts/`
+- 167 helper scripts in `.agents/scripts/`
 - 28 slash commands for common workflows
 
 <!-- AI-CONTEXT-END -->
@@ -188,7 +188,7 @@ aidevops init planning,time-tracking  # Enable specific features
 
 This creates:
 - `.aidevops.json` - Configuration with enabled features
-- `.agent` symlink → `~/.aidevops/agents/`
+- `.agents` symlink → `~/.aidevops/agents/`
 - `TODO.md` - Quick task tracking with time estimates
 - `todo/PLANS.md` - Complex execution plans
 - `.beads/` - Task graph database (if beads enabled)
@@ -249,7 +249,7 @@ aidevops init beads              # Enable beads (includes planning)
 - `bdui` (React/Ink TUI) - Modern terminal UI
 - `perles` (Rust TUI) - BQL query language
 
-See `.agent/tools/task-management/beads.md` for complete documentation and installation commands.
+See `.agents/tools/task-management/beads.md` for complete documentation and installation commands.
 
 **Your AI assistant now has agentic access to 30+ service integrations.**
 
@@ -321,7 +321,7 @@ The setup offers to install [oh-my-opencode](https://github.com/code-yeongyu/oh-
 > @explore search for authentication handling
 ```
 
-See `.agent/tools/opencode/oh-my-opencode.md` for the full compatibility guide.
+See `.agents/tools/opencode/oh-my-opencode.md` for the full compatibility guide.
 
 ### GitHub AI Agent Integration
 
@@ -359,7 +359,7 @@ The secure workflow is included at `.github/workflows/opencode-agent.yml`.
 | PR | `/oc review this PR` | Code review feedback |
 | PR Files tab | `/oc add error handling here` | Line-specific fix |
 
-See `.agent/tools/git/opencode-github-security.md` for the full security documentation.
+See `.agents/tools/git/opencode-github-security.md` for the full security documentation.
 
 **Supported AI Assistants:** OpenCode is the recommended and primary-tested tool. All 18 assistants below have MCP configuration support, but only OpenCode receives continual testing and first-class integration. Other tools are supported as a courtesy for users evaluating aidevops capabilities.
 
@@ -379,7 +379,7 @@ Your terminal tab/window title automatically shows `repo/branch` context when wo
 
 **Example format:** `{repo}/{branch-type}/{description}`
 
-See `.agent/tools/terminal/terminal-title.md` for customization options.
+See `.agents/tools/terminal/terminal-title.md` for customization options.
 
 **Also Supported (community-tested):**
 
@@ -504,7 +504,7 @@ aidevops implements proven agent design patterns identified by [Lance Martin (La
 
 **Key insight**: Context is a finite resource with diminishing returns. aidevops treats every token as precious - loading only what's needed, when it's needed.
 
-See `.agent/aidevops/architecture.md` for detailed implementation notes and references.
+See `.agents/aidevops/architecture.md` for detailed implementation notes and references.
 
 ### Multi-Agent Orchestration
 
@@ -540,11 +540,11 @@ Coordinator (pulse loop)
 4. Agents send completion reports back via mailbox
 5. SQLite WAL mode + `busy_timeout` handles concurrent access (79x faster than previous file-based system)
 
-**Compaction plugin** (`.agent/plugins/opencode-aidevops/`): When OpenCode compacts context (at ~200K tokens), the plugin injects current session state - agent registry, pending mailbox messages, git context, and relevant memories - ensuring continuity across compaction boundaries.
+**Compaction plugin** (`.agents/plugins/opencode-aidevops/`): When OpenCode compacts context (at ~200K tokens), the plugin injects current session state - agent registry, pending mailbox messages, git context, and relevant memories - ensuring continuity across compaction boundaries.
 
-**Custom system prompt** (`.agent/prompts/build.txt`): Based on upstream OpenCode with aidevops-specific overrides for tool preferences, professional objectivity, and per-model reinforcements for weaker models.
+**Custom system prompt** (`.agents/prompts/build.txt`): Based on upstream OpenCode with aidevops-specific overrides for tool preferences, professional objectivity, and per-model reinforcements for weaker models.
 
-**Subagent index** (`.agent/subagent-index.toon`): Compressed TOON routing table listing all agents, subagents, workflows, and scripts with model tier assignments - enables fast agent discovery without loading full markdown files.
+**Subagent index** (`.agents/subagent-index.toon`): Compressed TOON routing table listing all agents, subagents, workflows, and scripts with model tier assignments - enables fast agent discovery without loading full markdown files.
 
 ## **Autonomous Orchestration & Parallel Agents**
 
@@ -599,7 +599,7 @@ OpenCode Server (opencode serve)
 └─────────────────┘
 ```
 
-**Example runner templates:** [code-reviewer](.agent/tools/ai-assistants/runners/code-reviewer.md), [seo-analyst](.agent/tools/ai-assistants/runners/seo-analyst.md) - copy and customize for your own runners.
+**Example runner templates:** [code-reviewer](.agents/tools/ai-assistants/runners/code-reviewer.md), [seo-analyst](.agents/tools/ai-assistants/runners/seo-analyst.md) - copy and customize for your own runners.
 
 **Matrix bot dispatch** (optional): Bridge Matrix chat rooms to runners for chat-triggered AI.
 
@@ -617,7 +617,7 @@ matrix-dispatch-helper.sh start --daemon
 # In Matrix room: "!ai Review src/auth.ts for security issues"
 ```
 
-**See:** [headless-dispatch.md](.agent/tools/ai-assistants/headless-dispatch.md) for full documentation including parallel vs sequential decision guide, SDK examples, CI/CD integration, and custom agent configuration. [matrix-bot.md](.agent/services/communications/matrix-bot.md) for Matrix bot setup including Cloudron Synapse guide.
+**See:** [headless-dispatch.md](.agents/tools/ai-assistants/headless-dispatch.md) for full documentation including parallel vs sequential decision guide, SDK examples, CI/CD integration, and custom agent configuration. [matrix-bot.md](.agents/services/communications/matrix-bot.md) for Matrix bot setup including Cloudron Synapse guide.
 
 ### Self-Improving Agent System
 
@@ -761,9 +761,9 @@ The setup script offers to install these tools automatically.
 
 **Git CLI Enhancement Features:**
 
-- **.agent/scripts/github-cli-helper.sh**: Advanced GitHub repository, issue, PR, and branch management
-- **.agent/scripts/gitlab-cli-helper.sh**: Complete GitLab project, issue, MR, and branch management
-- **.agent/scripts/gitea-cli-helper.sh**: Full Gitea repository, issue, PR, and branch management
+- **.agents/scripts/github-cli-helper.sh**: Advanced GitHub repository, issue, PR, and branch management
+- **.agents/scripts/gitlab-cli-helper.sh**: Complete GitLab project, issue, MR, and branch management
+- **.agents/scripts/gitea-cli-helper.sh**: Full Gitea repository, issue, PR, and branch management
 
 ### **Security & Code Quality**
 
@@ -786,7 +786,7 @@ The setup script offers to install these tools automatically.
 - **[Repomix](https://repomix.com/)**: Pack codebases into AI-friendly context (80% token reduction with compress mode)
 - **[DSPy](https://dspy.ai/)**: Framework for programming with language models
 - **[DSPyGround](https://dspyground.com/)**: Interactive playground for prompt optimization
-- **[TOON Format](https://github.com/marcusquinn/aidevops/blob/main/.agent/toon-format.md)**: Token-Oriented Object Notation - 20-60% token reduction for LLM prompts
+- **[TOON Format](https://github.com/marcusquinn/aidevops/blob/main/.agents/toon-format.md)**: Token-Oriented Object Notation - 20-60% token reduction for LLM prompts
 
 ### **Document Processing & OCR**
 
@@ -813,7 +813,7 @@ ollama pull glm-ocr
 ollama run glm-ocr "Extract all text" --images /path/to/document.png
 ```
 
-See `.agent/tools/ocr/glm-ocr.md` for batch processing, PDF workflows, and Peekaboo integration.
+See `.agents/tools/ocr/glm-ocr.md` for batch processing, PDF workflows, and Peekaboo integration.
 
 ### **Communications**
 
@@ -935,7 +935,7 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
 **Data Extraction:**
 
 - [Outscraper](https://outscraper.com/) - Google Maps, business data, reviews extraction
-- [curl-copy](.agent/tools/browser/curl-copy.md) - Authenticated scraping via DevTools "Copy as cURL" (no browser automation needed)
+- [curl-copy](.agents/tools/browser/curl-copy.md) - Authenticated scraping via DevTools "Copy as cURL" (no browser automation needed)
 
 **Performance & Security:**
 
@@ -967,13 +967,13 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
 
 ```bash
 # Install all MCP integrations
-bash .agent/scripts/setup-mcp-integrations.sh all
+bash .agents/scripts/setup-mcp-integrations.sh all
 
 # Install specific integration
-bash .agent/scripts/setup-mcp-integrations.sh stagehand          # JavaScript version
-bash .agent/scripts/setup-mcp-integrations.sh stagehand-python   # Python version
-bash .agent/scripts/setup-mcp-integrations.sh stagehand-both     # Both versions
-bash .agent/scripts/setup-mcp-integrations.sh chrome-devtools
+bash .agents/scripts/setup-mcp-integrations.sh stagehand          # JavaScript version
+bash .agents/scripts/setup-mcp-integrations.sh stagehand-python   # Python version
+bash .agents/scripts/setup-mcp-integrations.sh stagehand-both     # Both versions
+bash .agents/scripts/setup-mcp-integrations.sh chrome-devtools
 ```
 
 ### OpenCode LSP Configuration
@@ -1067,7 +1067,7 @@ Agents use lightweight methods instead of expensive vision API calls:
 | Element scan | ~0.002s | ~20/element | Form filling, clicking |
 | Screenshot | ~0.05s | ~1K tokens (vision) | Visual debugging only |
 
-See [`.agent/tools/browser/browser-automation.md`](.agent/tools/browser/browser-automation.md) for the full decision tree and [`browser-benchmark.md`](.agent/tools/browser/browser-benchmark.md) for reproducible benchmark scripts.
+See [`.agents/tools/browser/browser-automation.md`](.agents/tools/browser/browser-automation.md) for the full decision tree and [`browser-benchmark.md`](.agents/tools/browser/browser-benchmark.md) for reproducible benchmark scripts.
 
 ### Device Emulation
 
@@ -1098,7 +1098,7 @@ Test responsive layouts and mobile-specific behavior using Playwright's built-in
 
 **Recipes included:** Responsive breakpoint testing, multi-device parallel testing, touch gesture testing, geolocation-dependent features, dark mode visual regression, and network condition emulation.
 
-See [`.agent/tools/browser/playwright-emulation.md`](.agent/tools/browser/playwright-emulation.md) for complete documentation with code examples.
+See [`.agents/tools/browser/playwright-emulation.md`](.agents/tools/browser/playwright-emulation.md) for complete documentation with code examples.
 
 ### Anti-Detect Browser
 
@@ -1149,7 +1149,7 @@ anti-detect-helper.sh warmup "my-account" --duration 30m
 | **Camoufox** (Firefox) | High (C++ level) | Medium | Full anti-detect, fingerprint rotation |
 | **rebrowser-patches** (Chromium) | Medium (CDP patches) | Fast | Quick stealth on existing Playwright code |
 
-See [`.agent/tools/browser/anti-detect-browser.md`](.agent/tools/browser/anti-detect-browser.md) for the full decision tree and subagent index.
+See [`.agents/tools/browser/anti-detect-browser.md`](.agents/tools/browser/anti-detect-browser.md) for the full decision tree and subagent index.
 
 ## **Repomix - AI Context Generation**
 
@@ -1174,8 +1174,8 @@ npx repomix
 npx repomix --compress
 
 # Or use the helper script
-.agent/scripts/context-builder-helper.sh pack      # Full context
-.agent/scripts/context-builder-helper.sh compress  # Compressed
+.agents/scripts/context-builder-helper.sh pack      # Full context
+.agents/scripts/context-builder-helper.sh compress  # Compressed
 ```
 
 ### Configuration Files
@@ -1191,7 +1191,7 @@ npx repomix --compress
 - **No pre-generated files**: Outputs are generated on-demand to avoid staleness
 - **Inherits .gitignore**: Security patterns automatically respected
 - **Secretlint enabled**: Scans for exposed credentials before output
-- **Symlinks excluded**: Avoids duplicating `.agent/` content
+- **Symlinks excluded**: Avoids duplicating `.agents/` content
 
 ### MCP Integration
 
@@ -1209,7 +1209,7 @@ Repomix runs as an MCP server for direct AI assistant integration:
 
 > Install globally first: `bun install -g repomix` (done automatically by `setup.sh`)
 
-See `.agent/tools/context/context-builder.md` for complete documentation.
+See `.agents/tools/context/context-builder.md` for complete documentation.
 
 ## **Augment Context Engine - Semantic Codebase Search**
 
@@ -1300,7 +1300,7 @@ The AI should provide a semantic understanding of your project architecture.
 | **Architecture review** | Repomix (compress) | 80% token reduction, structure only |
 | **CI/CD integration** | Repomix GitHub Action | Automated context in releases |
 
-See `.agent/tools/context/augment-context-engine.md` for complete documentation including configurations for Zed, GitHub Copilot, Kilo Code, Kiro, AntiGravity, Gemini CLI, and Factory.AI Droid.
+See `.agents/tools/context/augment-context-engine.md` for complete documentation including configurations for Zed, GitHub Copilot, Kilo Code, Kiro, AntiGravity, Gemini CLI, and Factory.AI Droid.
 
 ### osgrep - Local Alternative (Experimental)
 
@@ -1317,7 +1317,7 @@ osgrep "where is authentication handled?"
 | Auth | None required | Account + login |
 | Node.js | 18+ | 22+ |
 
-See `.agent/tools/context/osgrep.md` for complete documentation and AI tool configurations.
+See `.agents/tools/context/osgrep.md` for complete documentation and AI tool configurations.
 
 ### llm-tldr - Semantic Code Analysis
 
@@ -1353,7 +1353,7 @@ tldr impact src/auth.py validate   # What would change affect?
 | Semantic search | N/A | Finding code by meaning |
 | Impact analysis | N/A | Change risk assessment |
 
-See `.agent/tools/context/llm-tldr.md` for complete documentation.
+See `.agents/tools/context/llm-tldr.md` for complete documentation.
 
 ## **Cross-Tool Compatibility**
 
@@ -1411,20 +1411,20 @@ aidevops skill add owner/repo --dry-run             # Preview without changes
 - Conflict detection with merge/replace/rename options
 - Upstream commit tracking for update detection (`aidevops skill check`)
 - Conversion to aidevops subagent format with YAML frontmatter
-- Registry stored in `.agent/configs/skill-sources.json`
+- Registry stored in `.agents/configs/skill-sources.json`
 - Telemetry disabled (no data sent to skills.sh or other services)
 
 **How it differs from `npx add-skill`:**
 
 | | `aidevops skill add` | `npx add-skill` |
 |---|---|---|
-| **Target** | Converts to aidevops format in `.agent/` | Copies SKILL.md to agent-specific dirs |
+| **Target** | Converts to aidevops format in `.agents/` | Copies SKILL.md to agent-specific dirs |
 | **Tracking** | Git commit-based upstream tracking | Lock file with content hashes |
 | **Telemetry** | Disabled | Sends anonymous install counts |
 | **Scope** | OpenCode-first | 22+ agents |
 | **Updates** | `aidevops skill check` (GitHub API) | `npx skills check` (Vercel API) |
 
-See `.agent/scripts/add-skill-helper.sh` for implementation details.
+See `.agents/scripts/add-skill-helper.sh` for implementation details.
 
 ## **AI Agents & Subagents**
 
@@ -1464,7 +1464,7 @@ Ordered as they appear in OpenCode Tab selector and other AI assistants (15 tota
 
 ### **Example Subagents with MCP Integration**
 
-These are examples of subagents that have supporting MCPs enabled. See `.agent/` for the full list of 614+ subagents organized by domain.
+These are examples of subagents that have supporting MCPs enabled. See `.agents/` for the full list of 614+ subagents organized by domain.
 
 | Agent | Purpose | MCPs Enabled |
 |-------|---------|--------------|
@@ -1492,10 +1492,10 @@ These are examples of subagents that have supporting MCPs enabled. See `.agent/`
 
 ```bash
 # Install aidevops agents for OpenCode
-.agent/scripts/generate-opencode-agents.sh
+.agents/scripts/generate-opencode-agents.sh
 
 # Check status
-.agent/scripts/generate-opencode-agents.sh  # Shows status after generation
+.agents/scripts/generate-opencode-agents.sh  # Shows status after generation
 ```
 
 ### **Setup for Other AI Assistants**
@@ -1516,7 +1516,7 @@ Add to your AI assistant's system prompt:
 ```text
 Before any DevOps operations, read ~/git/aidevops/AGENTS.md for authoritative guidance.
 
-When working with specific services, read the corresponding .agent/[service].md file
+When working with specific services, read the corresponding .agents/[service].md file
 for focused guidance. Available services: hostinger, hetzner, wordpress, seo,
 code-quality, browser-automation, git-platforms.
 ```
@@ -1710,7 +1710,7 @@ Task → Implement → Check → Fix Issues → Re-check → ... → Complete
 
 ```bash
 # Run quality checks iteratively until all pass
-.agent/scripts/quality-loop-helper.sh preflight --auto-fix --max-iterations <MAX_ITERATIONS>
+.agents/scripts/quality-loop-helper.sh preflight --auto-fix --max-iterations <MAX_ITERATIONS>
 
 # Or use the slash command
 /preflight-loop --auto-fix --max-iterations <MAX_ITERATIONS>
@@ -1724,7 +1724,7 @@ Task → Implement → Check → Fix Issues → Re-check → ... → Complete
 - Works with any quality check (linting, tests, builds)
 - Detailed logging of each iteration
 
-See `.agent/workflows/ralph-loop.md` for the full workflow guide.
+See `.agents/workflows/ralph-loop.md` for the full workflow guide.
 
 ### Full Loop - End-to-End Development Automation
 
@@ -1755,7 +1755,7 @@ Task Development → Preflight → PR Create → PR Review → Postflight → De
 
 The loop pauses for human input at merge approval, rollback decisions, and scope changes.
 
-See `.agent/scripts/commands/full-loop.md` for complete documentation.
+See `.agents/scripts/commands/full-loop.md` for complete documentation.
 
 ### Git Worktrees - Parallel Branch Development
 
@@ -1798,7 +1798,7 @@ wt merge
 
 **Worktree-first workflow:** The pre-edit check now **enforces** worktrees as the default when creating branches, keeping your main directory on `main`. This prevents uncommitted changes from blocking branch switches and ensures parallel sessions don't inherit wrong branch state.
 
-See `.agent/workflows/worktree.md` for the complete guide and `.agent/tools/git/worktrunk.md` for Worktrunk documentation.
+See `.agents/workflows/worktree.md` for the complete guide and `.agents/tools/git/worktrunk.md` for Worktrunk documentation.
 
 ### Session Management - Parallel AI Sessions
 
@@ -1838,7 +1838,7 @@ When ending a session, the AI provides a continuation prompt for the next sessio
 [Copy this to start a new session with full context]
 ```
 
-See `.agent/workflows/session-manager.md` for the complete guide.
+See `.agents/workflows/session-manager.md` for the complete guide.
 
 ### Cross-Session Memory System
 
@@ -1927,7 +1927,7 @@ pattern-tracker-helper.sh suggest "refactor the auth middleware"
 
 **Storage:** `~/.aidevops/.agent-workspace/memory/memory.db` (+ optional `embeddings.db` for semantic search, `namespaces/` for per-runner isolation)
 
-See `.agent/memory/README.md` for complete documentation.
+See `.agents/memory/README.md` for complete documentation.
 
 ### **Installation**
 
@@ -1938,7 +1938,7 @@ Slash commands are automatically installed by `setup.sh`:
 ~/.config/opencode/commands/
 
 # Regenerate commands manually:
-.agent/scripts/generate-opencode-commands.sh
+.agents/scripts/generate-opencode-commands.sh
 ```
 
 ### **Usage**
@@ -1974,7 +1974,7 @@ tools:
 Detailed instructions for the agent...
 ```
 
-See `.agent/opencode-integration.md` for complete documentation.
+See `.agents/opencode-integration.md` for complete documentation.
 
 ---
 
@@ -1984,57 +1984,57 @@ See `.agent/opencode-integration.md` for complete documentation.
 
 ```bash
 # List all servers across providers
-./.agent/scripts/servers-helper.sh list
+./.agents/scripts/servers-helper.sh list
 
 # Connect to specific servers
-./.agent/scripts/hostinger-helper.sh connect example.com
-./.agent/scripts/hetzner-helper.sh connect main web-server
+./.agents/scripts/hostinger-helper.sh connect example.com
+./.agents/scripts/hetzner-helper.sh connect main web-server
 
 # Execute commands remotely
-./.agent/scripts/hostinger-helper.sh exec example.com "uptime"
+./.agents/scripts/hostinger-helper.sh exec example.com "uptime"
 ```
 
 ### **Monitoring & Uptime (Updown.io)**
 
 ```bash
 # List all monitors
-./.agent/scripts/updown-helper.sh list
+./.agents/scripts/updown-helper.sh list
 
 # Add a new website check
-./.agent/scripts/updown-helper.sh add https://example.com "My Website"
+./.agents/scripts/updown-helper.sh add https://example.com "My Website"
 ```
 
 ### **Domain & DNS Management**
 
 ```bash
 # Purchase and configure domain
-./.agent/scripts/spaceship-helper.sh purchase example.com
-./.agent/scripts/dns-helper.sh cloudflare add-record example.com A 192.168.1.1
+./.agents/scripts/spaceship-helper.sh purchase example.com
+./.agents/scripts/dns-helper.sh cloudflare add-record example.com A 192.168.1.1
 
 # Check domain availability
-./.agent/scripts/101domains-helper.sh check-availability example.com
+./.agents/scripts/101domains-helper.sh check-availability example.com
 ```
 
 ### **Strategic Keyword Research**
 
 ```bash
 # Basic keyword research with volume, CPC, difficulty
-./.agent/scripts/keyword-research-helper.sh research "seo tools" --limit 20
+./.agents/scripts/keyword-research-helper.sh research "seo tools" --limit 20
 
 # Google autocomplete long-tail discovery
-./.agent/scripts/keyword-research-helper.sh autocomplete "how to" --provider both
+./.agents/scripts/keyword-research-helper.sh autocomplete "how to" --provider both
 
 # Extended research with SERP weakness detection
-./.agent/scripts/keyword-research-helper.sh extended "keywords" --quick
+./.agents/scripts/keyword-research-helper.sh extended "keywords" --quick
 
 # Competitor keyword research
-./.agent/scripts/keyword-research-helper.sh extended --competitor ahrefs.com --limit 50
+./.agents/scripts/keyword-research-helper.sh extended --competitor ahrefs.com --limit 50
 
 # Keyword gap analysis (find keywords competitor ranks for but you don't)
-./.agent/scripts/keyword-research-helper.sh extended --gap semrush.com,ahrefs.com
+./.agents/scripts/keyword-research-helper.sh extended --gap semrush.com,ahrefs.com
 
 # Domain research (all keywords a domain ranks for)
-./.agent/scripts/keyword-research-helper.sh extended --domain example.com --limit 100
+./.agents/scripts/keyword-research-helper.sh extended --domain example.com --limit 100
 ```
 
 **Features:**
@@ -2050,19 +2050,19 @@ See `.agent/opencode-integration.md` for complete documentation.
 
 ```bash
 # Run quality analysis with auto-fixes
-bash .agent/scripts/qlty-cli.sh check 10
-bash .agent/scripts/qlty-cli.sh fix
+bash .agents/scripts/qlty-cli.sh check 10
+bash .agents/scripts/qlty-cli.sh fix
 
 # Run chunked Codacy analysis for large repositories
-bash .agent/scripts/codacy-cli-chunked.sh quick    # Fast analysis
-bash .agent/scripts/codacy-cli-chunked.sh chunked # Full analysis
+bash .agents/scripts/codacy-cli-chunked.sh quick    # Fast analysis
+bash .agents/scripts/codacy-cli-chunked.sh chunked # Full analysis
 
 # AI coding assistance
-bash .agent/scripts/ampcode-cli.sh scan ./src
-bash .agent/scripts/continue-cli.sh review
+bash .agents/scripts/ampcode-cli.sh scan ./src
+bash .agents/scripts/continue-cli.sh review
 
 # Audit website performance
-./.agent/scripts/pagespeed-helper.sh wordpress https://example.com
+./.agents/scripts/pagespeed-helper.sh wordpress https://example.com
 ```
 
 ## **Documentation & Resources**
@@ -2077,18 +2077,18 @@ bash .agent/scripts/continue-cli.sh review
 - **[The Agent Directory](.wiki/The-Agent-Directory.md)** - Agent file structure
 - **[Understanding AGENTS.md](.wiki/Understanding-AGENTS-md.md)** - How agents work
 
-**Agent Guides** (in `.agent/`):
+**Agent Guides** (in `.agents/`):
 
-- **[API Integrations](.agent/aidevops/api-integrations.md)** - Service APIs
-- **[Browser Automation](.agent/tools/browser/browser-automation.md)** - 8 tools + anti-detect stack: decision tree, parallel, extensions, fingerprinting
-- **[Device Emulation](.agent/tools/browser/playwright-emulation.md)** - Mobile/tablet testing: 100+ device presets, viewport, geolocation, locale, dark mode
-- **[Anti-Detect Browser](.agent/tools/browser/anti-detect-browser.md)** - Multi-profile management, fingerprint rotation, proxy integration
-- **[Web Performance](.agent/tools/performance/performance.md)** - Core Web Vitals, network dependencies, accessibility (Chrome DevTools MCP)
-- **[PageSpeed](.agent/tools/browser/pagespeed.md)** - Lighthouse CLI and PageSpeed Insights API
-- **[Pandoc](.agent/tools/conversion/pandoc.md)** - Document format conversion
-- **[Security](.agent/aidevops/security.md)** - Enterprise security standards
+- **[API Integrations](.agents/aidevops/api-integrations.md)** - Service APIs
+- **[Browser Automation](.agents/tools/browser/browser-automation.md)** - 8 tools + anti-detect stack: decision tree, parallel, extensions, fingerprinting
+- **[Device Emulation](.agents/tools/browser/playwright-emulation.md)** - Mobile/tablet testing: 100+ device presets, viewport, geolocation, locale, dark mode
+- **[Anti-Detect Browser](.agents/tools/browser/anti-detect-browser.md)** - Multi-profile management, fingerprint rotation, proxy integration
+- **[Web Performance](.agents/tools/performance/performance.md)** - Core Web Vitals, network dependencies, accessibility (Chrome DevTools MCP)
+- **[PageSpeed](.agents/tools/browser/pagespeed.md)** - Lighthouse CLI and PageSpeed Insights API
+- **[Pandoc](.agents/tools/conversion/pandoc.md)** - Document format conversion
+- **[Security](.agents/aidevops/security.md)** - Enterprise security standards
 
-**Provider-Specific Guides:** Hostinger, Hetzner, Cloudflare, WordPress, Git platforms, Vercel CLI, Coolify CLI, and more in `.agent/`
+**Provider-Specific Guides:** Hostinger, Hetzner, Cloudflare, WordPress, Git platforms, Vercel CLI, Coolify CLI, and more in `.agents/`
 
 ## **Architecture**
 
@@ -2096,7 +2096,7 @@ bash .agent/scripts/continue-cli.sh review
 aidevops/
 ├── setup.sh                       # Main setup script
 ├── AGENTS.md                      # AI agent guidance (dev)
-├── .agent/                        # Agents and documentation
+├── .agents/                        # Agents and documentation
 │   ├── AGENTS.md                  # User guide (deployed to ~/.aidevops/agents/)
 │   ├── *.md                       # 15 primary agents
 │   ├── scripts/                   # 146 helper scripts
@@ -2117,10 +2117,10 @@ cp configs/hetzner-config.json.txt configs/hetzner-config.json
 # Edit with your actual credentials
 
 # 2. Test connections
-./.agent/scripts/servers-helper.sh list
+./.agents/scripts/servers-helper.sh list
 
 # 3. Install MCP integrations (optional)
-bash .agent/scripts/setup-mcp-integrations.sh all
+bash .agents/scripts/setup-mcp-integrations.sh all
 ```
 
 ## **Security & Best Practices**
@@ -2155,7 +2155,7 @@ source <(credential-helper.sh export)
 
 **Resolution priority:** Project `.aidevops-tenant` → Global active tenant → Default
 
-See `.agent/tools/credentials/multi-tenant.md` for complete documentation.
+See `.agents/tools/credentials/multi-tenant.md` for complete documentation.
 
 **Quality Assurance:**
 
diff --git a/TODO.md b/TODO.md
index bc991f733..30885c84f 100644
--- a/TODO.md
+++ b/TODO.md
@@ -135,7 +135,7 @@ Tasks with no open blockers - ready to work on. Use `/ready` to refresh this lis
 - [ ] t026 Create subscription audit /command and @subagent for accounts agent #accounts #subscriptions #automation ~30m (ai:20m test:5m read:5m) logged:2025-01-03 ref:https://x.com/frankdegods/status/2007199488776253597
 - [ ] t027 Add hyprwhspr speech-to-text support (Arch/Omarchy Linux only) #tools #accessibility #linux ~10m (ai:8m read:2m) logged:2025-01-03
 - [x] t028 Setup sisyphus-dev-ai style GitHub collaborator for autonomous issue resolution #git #automation #agents ~1d (ai:4h test:4h read:2h) logged:2025-01-03 completed:2025-01-09 ref:https://github.com/code-yeongyu/oh-my-opencode/issues/425
-  - Notes: Implemented secure OpenCode GitHub integration with max security approach. Created `.github/workflows/opencode-agent.yml` with trusted-user-only access, ai-approved label requirement, prompt injection detection, audit logging, and 15-min timeout. Documentation in `.agent/tools/git/opencode-github-security.md`. Helper script updated with `create-secure` and `create-labels` commands.
+  - Notes: Implemented secure OpenCode GitHub integration with max security approach. Created `.github/workflows/opencode-agent.yml` with trusted-user-only access, ai-approved label requirement, prompt injection detection, audit logging, and 15-min timeout. Documentation in `.agents/tools/git/opencode-github-security.md`. Helper script updated with `create-secure` and `create-labels` commands.
 - [x] t051 Loop System v2 - Fresh sessions per iteration #workflow #automation ~4h (ai:2h test:1h read:1h) logged:2025-01-11 started:2025-01-11T00:00Z completed:2025-01-11 ref:https://github.com/gmickel/gmickel-claude-marketplace/tree/main/plugins/flow-next
   - Notes: Implemented flow-next inspired architecture for ralph-loop and full-loop. Created loop-common.sh (~700 lines) with JSON state management, re-anchor prompt generator (reads TODO.md, git state, memories), receipt verification, memory integration hooks, and task blocking after N failures. PR #38 merged. Prevents context drift by spawning fresh AI sessions per iteration.
 - [ ] t029 Research Penberg's Weave project (deterministic execution for AI agents) #research #tools #agents ~10m (ai:8m read:2m) logged:2025-01-03 ref:https://x.com/penberg/status/2007533204622770214,https://github.com/penberg/weave
@@ -171,7 +171,7 @@ Tasks with no open blockers - ready to work on. Use `/ready` to refresh this lis
 - [ ] t045 Create Enpass agent using enpass-cli #tools #credentials #security ~15m (ai:10m test:3m read:2m) logged:2025-01-08
   - Notes: Use https://github.com/hazcod/enpass-cli (156 stars, Go). BLOCKER: Issue #151 - SQLCipher v4 incompatibility with Enpass v6.8+. May need to fork and PR fix for SQLCipher v4 support. Install: `brew install enpass-cli` or `go install github.com/hazcod/enpass-cli@latest`. Commands: list, show, copy, pass. Add to tools/credentials/enpass.md.
 - [x] t046 Review OpenClaw (formerly Moltbot, Clawdbot) for inspiration and incorporation into aidevops #research #agents #messaging ~4h (ai:2h test:1h read:1h) logged:2025-01-09 started:2026-01-18T10:00Z completed:2026-01-18 actual:2h ref:https://github.com/openclaw/openclaw
-  - Notes: Added OpenClaw integration to aidevops. Created .agent/tools/ai-assistants/openclaw.md subagent with full documentation. Updated overview.md and onboarding.md with OpenClaw recommendations. OpenClaw provides mobile AI access via WhatsApp/Telegram/Slack/Discord/Signal/iMessage/Teams with local gateway, voice wake, and skills system compatible with aidevops agents.
+  - Notes: Added OpenClaw integration to aidevops. Created .agents/tools/ai-assistants/openclaw.md subagent with full documentation. Updated overview.md and onboarding.md with OpenClaw recommendations. OpenClaw provides mobile AI access via WhatsApp/Telegram/Slack/Discord/Signal/iMessage/Teams with local gateway, voice wake, and skills system compatible with aidevops agents.
 - [ ] t047 TODO/PLANS sync with GitHub/GitLab/Gitea issues + cross-platform tools research #git #sync #planning ~45m (ai:25m test:10m read:10m) logged:2025-01-09
   - Notes: Evaluate bi-directional sync between TODO.md/PLANS.md and git platform issues. Research tools for syncing issues/PRs across multiple git platforms (GitHub, GitLab, Gitea). Related to t020 (Git Issues Bi-directional Sync). Consider: gitea-github-migrator, gitlab-github-sync, issue-sync tools, Allspice Hub, Linear/Jira integrations. Key questions: 1) Should tasks auto-create issues? 2) Should issue updates sync back to TODO.md? 3) How to handle cross-platform mirroring for multi-platform projects?
 - [x] t048 Add worktree cleanup reminder to postflight workflow #workflow #git ~10m actual:0m (ai:8m test:2m) logged:2025-01-10 completed:2026-01-25
@@ -185,7 +185,7 @@ Tasks with no open blockers - ready to work on. Use `/ready` to refresh this lis
 - [x] t052 Agent Design Pattern Improvements #plan → [todo/PLANS.md#agent-design-pattern-improvements] ~1d actual:1h45m (ai:6h test:4h read:2h) logged:2025-01-11 started:2026-01-21T05:04Z completed:2026-01-21
   - Notes: All 5 phases complete. YAML frontmatter already on all 195 subagents. Created session-distill-helper.sh, documented cache-aware prompts in build-agent.md, created mcp-index-helper.sh + mcp-discovery.md, added memory consolidate command.
 - [x] t053 Add YAML frontmatter to source subagents #architecture #agents ~2h (ai:1.5h test:30m) logged:2025-01-11 blocked-by:t052 completed:2026-01-21 actual:0m
-  - Notes: ALREADY COMPLETE - All 195 subagents already have YAML frontmatter with tools: section. Verified via `find .agent -mindepth 2 -name "*.md" | while read f; do head -1 "$f" | grep -q "^---$" || echo "$f"; done` (no output = all have frontmatter).
+  - Notes: ALREADY COMPLETE - All 195 subagents already have YAML frontmatter with tools: section. Verified via `find .agents -mindepth 2 -name "*.md" | while read f; do head -1 "$f" | grep -q "^---$" || echo "$f"; done` (no output = all have frontmatter).
 - [x] t054 Automatic session reflection to memory #workflow #memory ~4h (ai:2.5h test:1h read:30m) logged:2025-01-11 blocked-by:t052 started:2026-01-21T05:30Z completed:2026-01-21 actual:30m
   - Notes: Created session-distill-helper.sh with analyze/extract/store/auto/prompt commands. Extracts learnings from git history (ERROR_FIX, WORKING_SOLUTION, CODEBASE_PATTERN, CONTEXT). Integrates with memory-helper.sh for storage.
 - [x] t055 Document cache-aware prompt patterns #docs #optimization ~1h (ai:30m test:15m read:15m) logged:2025-01-11 blocked-by:t052 started:2026-01-21T05:45Z completed:2026-01-21 actual:15m
@@ -204,7 +204,7 @@ Tasks with no open blockers - ready to work on. Use `/ready` to refresh this lis
   - Notes: Vercel's Agent Skills collection (332 stars, MIT). Currently includes vercel-deploy skill for instant deployment without auth. Auto-detects 40+ frameworks, returns preview URL + claim URL. Follows agentskills.io format (SKILL.md structure). Evaluate: 1) Add vercel-deploy as aidevops skill 2) Adopt Agent Skills format for aidevops skills 3) Contribute aidevops skills back to ecosystem.
 - [ ] t064 Add seo-regex subagent with Search Console regex workflow #seo #tools ~5m (ai:4m read:1m) logged:2026-01-15
 - [x] t083 Create Bing Webmaster Tools subagent #seo #tools ~15m actual:10m (ai:10m test:3m read:2m) logged:2026-01-29 completed:2026-02-06 related:seo-audit-skill
-  - Notes: Created .agent/seo/bing-webmaster-tools.md with curl-based API integration. Added to subagent-index.toon.
+  - Notes: Created .agents/seo/bing-webmaster-tools.md with curl-based API integration. Added to subagent-index.toon.
   - Notes: API integration for Bing Webmaster Tools. Features: submit URLs, check indexation status, view search analytics, manage sitemaps. Ref: https://www.bing.com/webmasters/help/webmaster-api-5f3c5e1e
 - [x] t084 Create Rich Results Test subagent #seo #tools #schema ~10m (ai:8m test:1m read:1m) logged:2026-01-29 related:seo-audit-skill completed:2026-02-06
   - Notes: Created seo/rich-results.md. Google deprecated the standalone API, so the subagent documents manual testing and provides a Playwright script for browser automation. Also references Schema.org Validator as an alternative.
diff --git a/aidevops.sh b/aidevops.sh
index 99acb14c5..e06da8f1c 100755
--- a/aidevops.sh
+++ b/aidevops.sh
@@ -915,13 +915,18 @@ cmd_init() {
 EOF
     print_success "Created .aidevops.json"
     
-    # Create .agent symlink
-    if [[ ! -e "$project_root/.agent" ]]; then
-        print_info "Creating .agent symlink..."
-        ln -s "$AGENTS_DIR" "$project_root/.agent"
-        print_success "Created .agent -> $AGENTS_DIR"
+    # Create .agents symlink (or migrate from legacy .agent)
+    if [[ -L "$project_root/.agent" || -d "$project_root/.agent" ]]; then
+        # Migrate legacy .agent symlink to .agents
+        rm -f "$project_root/.agent"
+        ln -s "$AGENTS_DIR" "$project_root/.agents"
+        print_success "Migrated .agent -> .agents symlink"
+    elif [[ ! -e "$project_root/.agents" ]]; then
+        print_info "Creating .agents symlink..."
+        ln -s "$AGENTS_DIR" "$project_root/.agents"
+        print_success "Created .agents -> $AGENTS_DIR"
     else
-        print_warning ".agent already exists, skipping symlink"
+        print_warning ".agents already exists, skipping symlink"
     fi
     
     # Create planning files if enabled
@@ -981,7 +986,7 @@ Complex, multi-session work that requires detailed planning.
 
 ---
 
-*See `.agent/workflows/plans.md` for planning workflow*
+*See `.agents/workflows/plans.md` for planning workflow*
 EOF
                 print_success "Created todo/PLANS.md (minimal template)"
             fi
@@ -1005,7 +1010,7 @@ EOF
 
 Declarative schema files - source of truth for database structure.
 
-See: `@sql-migrations` or `.agent/workflows/sql-migrations.md`
+See: `@sql-migrations` or `.agents/workflows/sql-migrations.md`
 EOF
             print_success "Created schemas/ directory"
         else
@@ -1020,7 +1025,7 @@ EOF
 
 Auto-generated versioned migration files. Do not edit manually.
 
-See: `@sql-migrations` or `.agent/workflows/sql-migrations.md`
+See: `@sql-migrations` or `.agents/workflows/sql-migrations.md`
 EOF
             print_success "Created migrations/ directory"
         else
@@ -1035,7 +1040,7 @@ EOF
 
 Initial and reference data (roles, statuses, test accounts).
 
-See: `@sql-migrations` or `.agent/workflows/sql-migrations.md`
+See: `@sql-migrations` or `.agents/workflows/sql-migrations.md`
 EOF
             print_success "Created seeds/ directory"
         else
@@ -1080,13 +1085,17 @@ EOF
     # Add to .gitignore if needed
     local gitignore="$project_root/.gitignore"
     if [[ -f "$gitignore" ]]; then
-        if ! grep -q "^\.agent$" "$gitignore" 2>/dev/null; then
+        if ! grep -q "^\.agents$" "$gitignore" 2>/dev/null; then
             {
                 echo ""
                 echo "# aidevops"
-                echo ".agent"
+                echo ".agents"
             } >> "$gitignore"
-            print_success "Added .agent to .gitignore"
+            print_success "Added .agents to .gitignore"
+            # Also add legacy .agent for backward compatibility
+            if ! grep -q "^\.agent$" "$gitignore" 2>/dev/null; then
+                echo ".agent" >> "$gitignore"
+            fi
         fi
         # Add .beads if beads is enabled
         if [[ "$enable_beads" == "true" ]]; then
@@ -1130,7 +1139,7 @@ EOF
     elif [[ "$enable_database" == "true" ]]; then
         echo "  1. Add schema files to schemas/"
         echo "  2. Run diff to generate migrations"
-        echo "  3. See .agent/workflows/sql-migrations.md"
+        echo "  3. See .agents/workflows/sql-migrations.md"
     else
         echo "  1. Add tasks to TODO.md"
         echo "  2. Use /create-prd for complex features"
diff --git a/configs/agno-config.json.txt b/configs/agno-config.json.txt
index f780db529..4aed410a2 100644
--- a/configs/agno-config.json.txt
+++ b/configs/agno-config.json.txt
@@ -167,7 +167,7 @@
     }
   },
   "usage_examples": {
-    "setup": "bash .agent/scripts/agno-setup.sh setup",
+    "setup": "bash .agents/scripts/agno-setup.sh setup",
     "start_services": "~/.aidevops/scripts/start-agno-stack.sh",
     "check_status": "~/.aidevops/scripts/agno-status.sh",
     "stop_services": "~/.aidevops/scripts/stop-agno-stack.sh",
diff --git a/configs/autogen-config.json.txt b/configs/autogen-config.json.txt
index 41459a031..26a37519c 100644
--- a/configs/autogen-config.json.txt
+++ b/configs/autogen-config.json.txt
@@ -72,7 +72,7 @@
       },
       "aidevops_workflows": {
         "enabled": true,
-        "helper_script": ".agent/scripts/autogen-helper.sh"
+        "helper_script": ".agents/scripts/autogen-helper.sh"
       },
       "dotnet_support": {
         "enabled": false,
@@ -100,7 +100,7 @@
     }
   },
   "usage_examples": {
-    "setup": "bash .agent/scripts/autogen-helper.sh setup",
+    "setup": "bash .agents/scripts/autogen-helper.sh setup",
     "start_studio": "~/.aidevops/scripts/start-autogen-studio.sh",
     "stop_studio": "~/.aidevops/scripts/stop-autogen-studio.sh",
     "status": "~/.aidevops/scripts/autogen-status.sh",
diff --git a/configs/capsolver-config.json.txt b/configs/capsolver-config.json.txt
index 2801de59a..2e0c77198 100644
--- a/configs/capsolver-config.json.txt
+++ b/configs/capsolver-config.json.txt
@@ -21,7 +21,7 @@
       "description": "reCAPTCHA v2 checkbox solving",
       "response_field": "gRecaptchaResponse",
       "injection_target": "g-recaptcha-response",
-      "pricing": "./.agent/scripts/crawl4ai-helper.sh.5/1000 requests",
+      "pricing": "./.agents/scripts/crawl4ai-helper.sh.5/1000 requests",
       "avg_solve_time": "< 9 seconds"
     },
     "recaptcha_v3": {
@@ -29,7 +29,7 @@
       "description": "reCAPTCHA v3 invisible solving with score ≥0.7",
       "response_field": "gRecaptchaResponse",
       "injection_method": "fetch_hook",
-      "pricing": "./.agent/scripts/crawl4ai-helper.sh.5/1000 requests",
+      "pricing": "./.agents/scripts/crawl4ai-helper.sh.5/1000 requests",
       "avg_solve_time": "< 3 seconds"
     },
     "recaptcha_v2_enterprise": {
@@ -74,21 +74,21 @@
       "type": "GeeTestTaskProxyLess",
       "description": "GeeTest v3 CAPTCHA solving",
       "response_field": "challenge",
-      "pricing": "./.agent/scripts/crawl4ai-helper.sh.5/1000 requests",
+      "pricing": "./.agents/scripts/crawl4ai-helper.sh.5/1000 requests",
       "avg_solve_time": "< 5 seconds"
     },
     "geetest_v4": {
       "type": "GeeTestV4TaskProxyLess",
       "description": "GeeTest v4 CAPTCHA solving",
       "response_field": "captcha_output",
-      "pricing": "./.agent/scripts/crawl4ai-helper.sh.5/1000 requests",
+      "pricing": "./.agents/scripts/crawl4ai-helper.sh.5/1000 requests",
       "avg_solve_time": "< 5 seconds"
     },
     "image_to_text": {
       "type": "ImageToTextTask",
       "description": "OCR image CAPTCHA solving",
       "response_field": "text",
-      "pricing": "./.agent/scripts/crawl4ai-helper.sh.4/1000 requests",
+      "pricing": "./.agents/scripts/crawl4ai-helper.sh.4/1000 requests",
       "avg_solve_time": "< 1 second"
     }
   },
diff --git a/configs/context-builder-config.json.txt b/configs/context-builder-config.json.txt
index 8fe3bd925..2f1424e2c 100644
--- a/configs/context-builder-config.json.txt
+++ b/configs/context-builder-config.json.txt
@@ -3,7 +3,7 @@
   "_instructions": "Copy to context-builder-config.json and customize",
   
   "defaults": {
-    "output_directory": "~/.agent/work/context",
+    "output_directory": "~/.agents/work/context",
     "default_style": "xml",
     "default_mode": "compress",
     "auto_clipboard": true
diff --git a/configs/crewai-config.json.txt b/configs/crewai-config.json.txt
index 4437c5dca..f74bad6bd 100644
--- a/configs/crewai-config.json.txt
+++ b/configs/crewai-config.json.txt
@@ -74,7 +74,7 @@
       },
       "aidevops_workflows": {
         "enabled": true,
-        "helper_script": ".agent/scripts/crewai-helper.sh"
+        "helper_script": ".agents/scripts/crewai-helper.sh"
       }
     }
   },
@@ -91,7 +91,7 @@
     }
   },
   "usage_examples": {
-    "setup": "bash .agent/scripts/crewai-helper.sh setup",
+    "setup": "bash .agents/scripts/crewai-helper.sh setup",
     "start_studio": "~/.aidevops/scripts/start-crewai-studio.sh",
     "stop_studio": "~/.aidevops/scripts/stop-crewai-studio.sh",
     "status": "~/.aidevops/scripts/crewai-status.sh",
diff --git a/configs/langflow-config.json.txt b/configs/langflow-config.json.txt
index 3e9ff0304..81420c8a5 100644
--- a/configs/langflow-config.json.txt
+++ b/configs/langflow-config.json.txt
@@ -66,7 +66,7 @@
       },
       "aidevops_workflows": {
         "enabled": true,
-        "helper_script": ".agent/scripts/langflow-helper.sh"
+        "helper_script": ".agents/scripts/langflow-helper.sh"
       }
     },
     "deployment": {
@@ -95,12 +95,12 @@
     }
   },
   "usage_examples": {
-    "setup": "bash .agent/scripts/langflow-helper.sh setup",
+    "setup": "bash .agents/scripts/langflow-helper.sh setup",
     "start": "~/.aidevops/scripts/start-langflow.sh",
     "stop": "~/.aidevops/scripts/stop-langflow.sh",
     "status": "~/.aidevops/scripts/langflow-status.sh",
-    "export_flows": "bash .agent/scripts/langflow-helper.sh export ./flows",
-    "import_flows": "bash .agent/scripts/langflow-helper.sh import ./flows",
+    "export_flows": "bash .agents/scripts/langflow-helper.sh export ./flows",
+    "import_flows": "bash .agents/scripts/langflow-helper.sh import ./flows",
     "access_ui": "http://localhost:7860",
     "access_api": "http://localhost:7860/docs"
   },
diff --git a/configs/mcp-templates/fluentcrm.json b/configs/mcp-templates/fluentcrm.json
index 868ec2a1c..8f0d25a72 100644
--- a/configs/mcp-templates/fluentcrm.json
+++ b/configs/mcp-templates/fluentcrm.json
@@ -7,6 +7,6 @@
       "source ~/.config/aidevops/mcp-env.sh && node ~/.local/share/mcp-servers/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"
     ],
     "enabled": false,
-    "_comment": "Disabled globally. Enabled via fluentcrm_*: true in services/crm/fluentcrm.md subagent. Requires local build - see .agent/services/crm/fluentcrm.md for setup."
+    "_comment": "Disabled globally. Enabled via fluentcrm_*: true in services/crm/fluentcrm.md subagent. Requires local build - see .agents/services/crm/fluentcrm.md for setup."
   }
 }
diff --git a/homebrew/aidevops.rb b/homebrew/aidevops.rb
index c20fcbc13..532ee918e 100644
--- a/homebrew/aidevops.rb
+++ b/homebrew/aidevops.rb
@@ -22,7 +22,7 @@ def install
     libexec.install "setup.sh"
     
     # Install agent files
-    (share/"aidevops").install ".agent"
+    (share/"aidevops").install ".agents"
     (share/"aidevops").install "VERSION"
     
     # Create wrapper in bin that calls the libexec script
diff --git a/repomix-instruction.md b/repomix-instruction.md
index a9b27635c..23215bce2 100644
--- a/repomix-instruction.md
+++ b/repomix-instruction.md
@@ -7,18 +7,18 @@ and helper scripts for DevOps automation across 30+ services.
 
 ### Directory Structure
 
-- **`.agent/`** - Canonical source for all agent definitions (other dirs are symlinks)
-- **`.agent/scripts/`** - Helper shell scripts for service automation
+- **`.agents/`** - Canonical source for all agent definitions (other dirs are symlinks)
+- **`.agents/scripts/`** - Helper shell scripts for service automation
 - **`configs/`** - MCP configuration templates (`.json.txt` files are safe to read)
 - **`AGENTS.md`** - Developer guide for contributing
-- **`.agent/AGENTS.md`** - User guide distributed to `~/.aidevops/agents/`
+- **`.agents/AGENTS.md`** - User guide distributed to `~/.aidevops/agents/`
 
 ### Symlink Architecture
 
-These directories are **symlinks to `.agent/`** - don't analyze them separately:
+These directories are **symlinks to `.agents/`** - don't analyze them separately:
 - `.ai/`, `.continue/`, `.cursor/`, `.claude/`, `.factory/`, `.codex/`, `.kiro/`, `.opencode/`
 
-Focus on `.agent/` for the authoritative content.
+Focus on `.agents/` for the authoritative content.
 
 ### Code Quality Standards
 
@@ -36,16 +36,16 @@ Focus on `.agent/` for the authoritative content.
 
 ## When Analyzing This Codebase
 
-- **For architecture understanding**: Focus on `.agent/AGENTS.md` and `.agent/aidevops/architecture.md`
-- **For script patterns**: Reference `.agent/scripts/` - all follow consistent conventions
-- **For service integrations**: Check `.agent/services/` and `configs/`
-- **For workflows**: See `.agent/workflows/` for release, versioning, bug-fixing guides
+- **For architecture understanding**: Focus on `.agents/AGENTS.md` and `.agents/aidevops/architecture.md`
+- **For script patterns**: Reference `.agents/scripts/` - all follow consistent conventions
+- **For service integrations**: Check `.agents/services/` and `configs/`
+- **For workflows**: See `.agents/workflows/` for release, versioning, bug-fixing guides
 
 ## Common Tasks
 
 | Task | Key Files |
 |------|-----------|
-| Add new service | `.agent/aidevops/add-new-mcp-to-aidevops.md` |
-| Create agent | `.agent/build-agent.md` |
-| Review agents | `.agent/build-agent/agent-review.md` |
-| Release version | `.agent/workflows/release-process.md` |
+| Add new service | `.agents/aidevops/add-new-mcp-to-aidevops.md` |
+| Create agent | `.agents/build-agent.md` |
+| Review agents | `.agents/build-agent/agent-review.md` |
+| Release version | `.agents/workflows/release-process.md` |
diff --git a/setup.sh b/setup.sh
index a0a2891b4..0f1c93fe9 100755
--- a/setup.sh
+++ b/setup.sh
@@ -223,6 +223,123 @@ cleanup_deprecated_paths() {
     return 0
 }
 
+# Migrate .agent -> .agents in user projects and local config
+# v2.104.0: Industry converging on .agents/ folder convention (aligning with AGENTS.md)
+# This migrates:
+# 1. .agent symlinks in user projects -> .agents
+# 2. .agent/loop-state/ -> .agents/loop-state/ in user projects
+# 3. .gitignore entries in user projects
+# 4. References in user's AI assistant configs
+# 5. References in ~/.aidevops/ config files
+migrate_agent_to_agents_folder() {
+    print_info "Checking for .agent -> .agents migration..."
+    
+    local migrated=0
+    
+    # 1. Migrate .agent symlinks in registered repos
+    local repos_file="$HOME/.config/aidevops/repos.json"
+    if [[ -f "$repos_file" ]] && command -v jq &>/dev/null; then
+        while IFS= read -r repo_path; do
+            [[ -z "$repo_path" ]] && continue
+            [[ ! -d "$repo_path" ]] && continue
+            
+            # Migrate .agent symlink to .agents
+            if [[ -L "$repo_path/.agent" ]]; then
+                local target
+                target=$(readlink "$repo_path/.agent")
+                rm -f "$repo_path/.agent"
+                ln -s "$target" "$repo_path/.agents" 2>/dev/null || true
+                print_info "  Migrated symlink: $repo_path/.agent -> .agents"
+                ((migrated++))
+            elif [[ -d "$repo_path/.agent" && ! -L "$repo_path/.agent" ]]; then
+                # Real directory (not symlink) - rename it
+                if [[ ! -e "$repo_path/.agents" ]]; then
+                    mv "$repo_path/.agent" "$repo_path/.agents"
+                    print_info "  Renamed directory: $repo_path/.agent -> .agents"
+                    ((migrated++))
+                fi
+            fi
+            
+            # Update .gitignore: add .agents, keep .agent for backward compat
+            local gitignore="$repo_path/.gitignore"
+            if [[ -f "$gitignore" ]]; then
+                # Add .agents entry if not present
+                if ! grep -q "^\.agents$" "$gitignore" 2>/dev/null; then
+                    # Replace .agent with .agents if it exists
+                    if grep -q "^\.agent$" "$gitignore" 2>/dev/null; then
+                        sed -i '' 's/^\.agent$/.agents/' "$gitignore" 2>/dev/null || \
+                        sed -i 's/^\.agent$/.agents/' "$gitignore" 2>/dev/null || true
+                    else
+                        echo ".agents" >> "$gitignore"
+                    fi
+                    print_info "  Updated .gitignore in $(basename "$repo_path")"
+                fi
+                
+                # Update .agent/loop-state/ -> .agents/loop-state/
+                if grep -q "^\.agent/loop-state/" "$gitignore" 2>/dev/null; then
+                    sed -i '' 's|^\.agent/loop-state/|.agents/loop-state/|' "$gitignore" 2>/dev/null || \
+                    sed -i 's|^\.agent/loop-state/|.agents/loop-state/|' "$gitignore" 2>/dev/null || true
+                fi
+            fi
+        done < <(jq -r '.initialized_repos[].path' "$repos_file" 2>/dev/null)
+    fi
+    
+    # 2. Also scan ~/Git/ for any .agent symlinks not in repos.json
+    if [[ -d "$HOME/Git" ]]; then
+        while IFS= read -r -d '' agent_link; do
+            local repo_dir
+            repo_dir=$(dirname "$agent_link")
+            if [[ -L "$agent_link" ]] && [[ ! -e "$repo_dir/.agents" ]]; then
+                local target
+                target=$(readlink "$agent_link")
+                rm -f "$agent_link"
+                ln -s "$target" "$repo_dir/.agents" 2>/dev/null || true
+                print_info "  Migrated symlink: $agent_link -> .agents"
+                ((migrated++))
+            fi
+        done < <(find "$HOME/Git" -maxdepth 3 -name ".agent" -type l -print0 2>/dev/null)
+    fi
+    
+    # 3. Update AI assistant config files that reference .agent/
+    local ai_config_files=(
+        "$HOME/.config/opencode/agent/AGENTS.md"
+        "$HOME/.config/Claude/AGENTS.md"
+        "$HOME/.cursor/rules/AGENTS.md"
+        "$HOME/.claude/commands/AGENTS.md"
+        "$HOME/.continue/AGENTS.md"
+        "$HOME/.cody/AGENTS.md"
+        "$HOME/.opencode/AGENTS.md"
+    )
+    
+    for config_file in "${ai_config_files[@]}"; do
+        if [[ -f "$config_file" ]]; then
+            if grep -q '\.agent/' "$config_file" 2>/dev/null; then
+                sed -i '' 's|\.agent/|.agents/|g' "$config_file" 2>/dev/null || \
+                sed -i 's|\.agent/|.agents/|g' "$config_file" 2>/dev/null || true
+                print_info "  Updated references in $config_file"
+                ((migrated++))
+            fi
+        fi
+    done
+    
+    # 4. Update session greeting cache if it references .agent/
+    local greeting_cache="$HOME/.aidevops/cache/session-greeting.txt"
+    if [[ -f "$greeting_cache" ]]; then
+        if grep -q '\.agent/' "$greeting_cache" 2>/dev/null; then
+            sed -i '' 's|\.agent/|.agents/|g' "$greeting_cache" 2>/dev/null || \
+            sed -i 's|\.agent/|.agents/|g' "$greeting_cache" 2>/dev/null || true
+        fi
+    fi
+    
+    if [[ $migrated -gt 0 ]]; then
+        print_success "Migrated $migrated .agent -> .agents reference(s)"
+    else
+        print_info "No .agent -> .agents migration needed"
+    fi
+    
+    return 0
+}
+
 # Remove deprecated MCP entries from opencode.json
 # These MCPs have been replaced by curl-based subagents (zero context cost)
 cleanup_deprecated_mcps() {
@@ -598,8 +715,8 @@ migrate_old_backups() {
     return 0
 }
 
-# Migrate loop state from .claude/ to .agent/loop-state/ in user projects
-# This handles the breaking change from v2.51.0 where loop state directory moved
+# Migrate loop state from .claude/ to .agents/loop-state/ in user projects
+# Also migrates from legacy .agents/loop-state/ to .agents/loop-state/
 # The migration is non-destructive: moves files, doesn't delete originals until confirmed
 migrate_loop_state_directories() {
     print_info "Checking for legacy loop state directories..."
@@ -619,60 +736,69 @@ migrate_loop_state_directories() {
     
     for repo_dir in "${git_dirs[@]}"; do
         local old_state_dir="$repo_dir/.claude"
-        local new_state_dir="$repo_dir/.agent/loop-state"
-        
-        # Skip if no old state directory
-        [[ ! -d "$old_state_dir" ]] && continue
-        
-        # Check for loop state files in old location
-        local has_loop_state=false
-        if [[ -f "$old_state_dir/ralph-loop.local.state" ]] || \
-           [[ -f "$old_state_dir/loop-state.json" ]] || \
-           [[ -d "$old_state_dir/receipts" ]]; then
-            has_loop_state=true
-        fi
-        
-        [[ "$has_loop_state" != "true" ]] && continue
-        
-        print_info "Found legacy loop state in: $repo_dir/.claude/"
-        
-        # Create new directory
-        mkdir -p "$new_state_dir"
-        
-        # Move loop-related files
-        for file in ralph-loop.local.state loop-state.json re-anchor.md guardrails.md; do
-            if [[ -f "$old_state_dir/$file" ]]; then
-                mv "$old_state_dir/$file" "$new_state_dir/"
-                print_info "  Moved $file"
+        local legacy_state_dir="$repo_dir/.agent/loop-state"
+        local new_state_dir="$repo_dir/.agents/loop-state"
+        
+        # Migrate from .claude/ (oldest legacy path)
+        if [[ -d "$old_state_dir" ]]; then
+            local has_loop_state=false
+            if [[ -f "$old_state_dir/ralph-loop.local.state" ]] || \
+               [[ -f "$old_state_dir/loop-state.json" ]] || \
+               [[ -d "$old_state_dir/receipts" ]]; then
+                has_loop_state=true
+            fi
+            
+            if [[ "$has_loop_state" == "true" ]]; then
+                print_info "Found legacy loop state in: $repo_dir/.claude/"
+                mkdir -p "$new_state_dir"
+                
+                for file in ralph-loop.local.state loop-state.json re-anchor.md guardrails.md; do
+                    if [[ -f "$old_state_dir/$file" ]]; then
+                        mv "$old_state_dir/$file" "$new_state_dir/"
+                        print_info "  Moved $file"
+                    fi
+                done
+                
+                if [[ -d "$old_state_dir/receipts" ]]; then
+                    mv "$old_state_dir/receipts" "$new_state_dir/"
+                    print_info "  Moved receipts/"
+                fi
+                
+                local remaining
+                remaining=$(find "$old_state_dir" -mindepth 1 -maxdepth 1 2>/dev/null | wc -l | tr -d ' ')
+                
+                if [[ "$remaining" -eq 0 ]]; then
+                    rmdir "$old_state_dir" 2>/dev/null && print_info "  Removed empty .claude/"
+                else
+                    print_warning "  .claude/ has other files, not removing"
+                fi
+                
+                ((migrated++))
             fi
-        done
-        
-        # Move receipts directory
-        if [[ -d "$old_state_dir/receipts" ]]; then
-            mv "$old_state_dir/receipts" "$new_state_dir/"
-            print_info "  Moved receipts/"
         fi
         
-        # Check if .claude/ is now empty (only has hidden files or nothing)
-        local remaining
-        remaining=$(find "$old_state_dir" -mindepth 1 -maxdepth 1 2>/dev/null | wc -l | tr -d ' ')
-        
-        if [[ "$remaining" -eq 0 ]]; then
-            rmdir "$old_state_dir" 2>/dev/null && print_info "  Removed empty .claude/"
-        else
-            print_warning "  .claude/ has other files, not removing"
+        # Migrate from .agents/loop-state/ (v2.51.0-v2.103.0 path) to .agents/loop-state/
+        if [[ -d "$legacy_state_dir" ]] && [[ "$legacy_state_dir" != "$new_state_dir" ]]; then
+            print_info "Found legacy loop state in: $repo_dir/.agent/loop-state/"
+            mkdir -p "$new_state_dir"
+            
+            # Move all files from old to new
+            if [[ -n "$(ls -A "$legacy_state_dir" 2>/dev/null)" ]]; then
+                cp -R "$legacy_state_dir"/* "$new_state_dir/" 2>/dev/null || true
+                rm -rf "$legacy_state_dir"
+                print_info "  Migrated .agents/loop-state/ -> .agents/loop-state/"
+                ((migrated++))
+            fi
         fi
         
         # Update .gitignore if needed
         local gitignore="$repo_dir/.gitignore"
         if [[ -f "$gitignore" ]]; then
-            if ! grep -q "^\.agent/loop-state/" "$gitignore" 2>/dev/null; then
-                echo ".agent/loop-state/" >> "$gitignore"
-                print_info "  Added .agent/loop-state/ to .gitignore"
+            if ! grep -q "^\.agents/loop-state/" "$gitignore" 2>/dev/null; then
+                echo ".agents/loop-state/" >> "$gitignore"
+                print_info "  Added .agents/loop-state/ to .gitignore"
             fi
         fi
-        
-        ((migrated++))
     done
     
     if [[ $migrated -gt 0 ]]; then
@@ -1539,7 +1665,7 @@ set_permissions() {
     
     # Make scripts executable (suppress errors for missing paths)
     chmod +x ./*.sh 2>/dev/null || true
-    chmod +x .agent/scripts/*.sh 2>/dev/null || true
+    chmod +x .agents/scripts/*.sh 2>/dev/null || true
     chmod +x ssh/*.sh 2>/dev/null || true
     
     # Secure configuration files
@@ -1721,22 +1847,22 @@ setup_aliases() {
             cat >> "$shell_rc" << 'EOF'
 
 # AI Assistant Server Access Framework
-alias servers './.agent/scripts/servers-helper.sh'
-alias servers-list './.agent/scripts/servers-helper.sh list'
-alias hostinger './.agent/scripts/hostinger-helper.sh'
-alias hetzner './.agent/scripts/hetzner-helper.sh'
-alias aws-helper './.agent/scripts/aws-helper.sh'
+alias servers './.agents/scripts/servers-helper.sh'
+alias servers-list './.agents/scripts/servers-helper.sh list'
+alias hostinger './.agents/scripts/hostinger-helper.sh'
+alias hetzner './.agents/scripts/hetzner-helper.sh'
+alias aws-helper './.agents/scripts/aws-helper.sh'
 EOF
         else
             # Bash, zsh, ksh use same syntax
             cat >> "$shell_rc" << 'EOF'
 
 # AI Assistant Server Access Framework
-alias servers='./.agent/scripts/servers-helper.sh'
-alias servers-list='./.agent/scripts/servers-helper.sh list'
-alias hostinger='./.agent/scripts/hostinger-helper.sh'
-alias hetzner='./.agent/scripts/hetzner-helper.sh'
-alias aws-helper='./.agent/scripts/aws-helper.sh'
+alias servers='./.agents/scripts/servers-helper.sh'
+alias servers-list='./.agents/scripts/servers-helper.sh list'
+alias hostinger='./.agents/scripts/hostinger-helper.sh'
+alias hetzner='./.agents/scripts/hetzner-helper.sh'
+alias aws-helper='./.agents/scripts/aws-helper.sh'
 EOF
         fi
         print_success "Aliases added to $shell_rc"
@@ -1751,7 +1877,7 @@ EOF
 setup_terminal_title() {
     print_info "Setting up terminal title integration..."
     
-    local setup_script=".agent/scripts/terminal-title-setup.sh"
+    local setup_script=".agents/scripts/terminal-title-setup.sh"
     
     if [[ ! -f "$setup_script" ]]; then
         print_warning "Terminal title setup script not found - skipping"
@@ -1839,7 +1965,7 @@ deploy_ai_templates() {
 # Extract OpenCode prompts from binary (for Plan+ system-reminder)
 # Must run before deploy_aidevops_agents so the cache exists for injection
 extract_opencode_prompts() {
-    local extract_script=".agent/scripts/extract-opencode-prompts.sh"
+    local extract_script=".agents/scripts/extract-opencode-prompts.sh"
     if [[ -f "$extract_script" ]]; then
         if bash "$extract_script"; then
             print_success "OpenCode prompts extracted"
@@ -1852,7 +1978,7 @@ extract_opencode_prompts() {
 
 # Check if upstream OpenCode prompts have drifted from our synced version
 check_opencode_prompt_drift() {
-    local drift_script=".agent/scripts/opencode-prompt-drift-check.sh"
+    local drift_script=".agents/scripts/opencode-prompt-drift-check.sh"
     if [[ -f "$drift_script" ]]; then
         local output exit_code=0
         output=$(bash "$drift_script" --quiet 2>/dev/null) || exit_code=$?
@@ -1862,7 +1988,7 @@ check_opencode_prompt_drift() {
             upstream_hash=$(echo "$output" | cut -d'|' -f3)
             print_warning "OpenCode upstream prompt has changed (${local_hash} → ${upstream_hash})"
             print_info "  Review: https://github.com/anomalyco/opencode/compare/${local_hash}...${upstream_hash}"
-            print_info "  Update .agent/prompts/build.txt if needed"
+            print_info "  Update .agents/prompts/build.txt if needed"
         elif [[ "$exit_code" -eq 0 ]]; then
             print_success "OpenCode prompt in sync with upstream"
         else
@@ -1878,7 +2004,7 @@ deploy_aidevops_agents() {
     
     local script_dir
     script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    local source_dir="$script_dir/.agent"
+    local source_dir="$script_dir/.agents"
     local target_dir="$HOME/.aidevops/agents"
     
     # Validate source directory exists (catches curl install from wrong directory)
@@ -2057,7 +2183,7 @@ create_skill_symlinks() {
         local_path=$(echo "$skill_json" | jq -r '.local_path')
         
         # Skip if path doesn't exist
-        local full_path="$agents_dir/${local_path#.agent/}"
+        local full_path="$agents_dir/${local_path#.agents/}"
         if [[ ! -f "$full_path" ]]; then
             print_warning "Skill file not found: $full_path"
             continue
@@ -2263,7 +2389,7 @@ update_opencode_config() {
     # Generate OpenCode agent configuration
     # - Primary agents: Added to opencode.json (for Tab order & MCP control)
     # - Subagents: Generated as markdown in ~/.config/opencode/agent/
-    local generator_script=".agent/scripts/generate-opencode-agents.sh"
+    local generator_script=".agents/scripts/generate-opencode-agents.sh"
     if [[ -f "$generator_script" ]]; then
         print_info "Generating OpenCode agent configuration..."
         if bash "$generator_script"; then
@@ -2277,7 +2403,7 @@ update_opencode_config() {
     
     # Generate OpenCode commands
     # - Commands from workflows and agents -> /command-name
-    local commands_script=".agent/scripts/generate-opencode-commands.sh"
+    local commands_script=".agents/scripts/generate-opencode-commands.sh"
     if [[ -f "$commands_script" ]]; then
         print_info "Generating OpenCode commands..."
         if bash "$commands_script"; then
@@ -3074,11 +3200,11 @@ setup_ai_orchestration() {
     echo "  - AutoGen: Microsoft agentic AI (localhost:8081)"
     echo ""
     print_info "Setup individual frameworks with:"
-    echo "  bash .agent/scripts/langflow-helper.sh setup"
-    echo "  bash .agent/scripts/crewai-helper.sh setup"
-    echo "  bash .agent/scripts/autogen-helper.sh setup"
+    echo "  bash .agents/scripts/langflow-helper.sh setup"
+    echo "  bash .agents/scripts/crewai-helper.sh setup"
+    echo "  bash .agents/scripts/autogen-helper.sh setup"
     echo ""
-    print_info "See .agent/tools/ai-orchestration/overview.md for comparison"
+    print_info "See .agents/tools/ai-orchestration/overview.md for comparison"
     
     return 0
 }
@@ -3431,7 +3557,7 @@ setup_multi_tenant_credentials() {
     
     if [[ ! -f "$credential_helper" ]]; then
         # Try local script if deployed version not available yet
-        credential_helper=".agent/scripts/credential-helper.sh"
+        credential_helper=".agents/scripts/credential-helper.sh"
     fi
     
     if [[ ! -f "$credential_helper" ]]; then
@@ -3495,7 +3621,7 @@ check_tool_updates() {
     
     if [[ ! -f "$tool_check_script" ]]; then
         # Try local script if deployed version not available yet
-        tool_check_script=".agent/scripts/tool-version-check.sh"
+        tool_check_script=".agents/scripts/tool-version-check.sh"
     fi
     
     if [[ ! -f "$tool_check_script" ]]; then
@@ -3626,7 +3752,8 @@ main() {
     confirm_step "Setup terminal title integration" && setup_terminal_title
     confirm_step "Deploy AI templates to home directories" && deploy_ai_templates
     confirm_step "Migrate old backups to new structure" && migrate_old_backups
-    confirm_step "Migrate loop state from .claude/ to .agent/loop-state/" && migrate_loop_state_directories
+    confirm_step "Migrate loop state from .claude/.agent/ to .agents/loop-state/" && migrate_loop_state_directories
+    confirm_step "Migrate .agent -> .agents in user projects" && migrate_agent_to_agents_folder
     confirm_step "Cleanup deprecated agent paths" && cleanup_deprecated_paths
     confirm_step "Cleanup deprecated MCP entries (hetzner, serper, etc.)" && cleanup_deprecated_mcps
     confirm_step "Validate and repair OpenCode config schema" && validate_opencode_config
@@ -3673,8 +3800,8 @@ echo "  aidevops uninstall    - Remove aidevops"
     echo "Next steps:"
     echo "1. Edit configuration files in configs/ with your actual credentials"
     echo "2. Setup Git CLI tools and authentication (shown during setup)"
-    echo "3. Setup API keys: bash .agent/scripts/setup-local-api-keys.sh setup"
-    echo "4. Test access: ./.agent/scripts/servers-helper.sh list"
+    echo "3. Setup API keys: bash .agents/scripts/setup-local-api-keys.sh setup"
+    echo "4. Test access: ./.agents/scripts/servers-helper.sh list"
     echo "5. Read documentation: ~/.aidevops/agents/AGENTS.md"
     echo ""
     echo "For development on aidevops framework itself:"
@@ -3704,8 +3831,8 @@ echo "  aidevops uninstall    - Remove aidevops"
     echo "• Ahrefs                 - Backlink and keyword data"
     echo ""
     echo "DSPy & DSPyGround Integration:"
-    echo "• ./.agent/scripts/dspy-helper.sh        - DSPy prompt optimization toolkit"
-    echo "• ./.agent/scripts/dspyground-helper.sh  - DSPyGround playground interface"
+    echo "• ./.agents/scripts/dspy-helper.sh        - DSPy prompt optimization toolkit"
+    echo "• ./.agents/scripts/dspyground-helper.sh  - DSPyGround playground interface"
     echo "• python-env/dspy-env/              - Python virtual environment for DSPy"
     echo "• data/dspy/                        - DSPy projects and datasets"
     echo "• data/dspyground/                  - DSPyGround projects and configurations"
diff --git a/sonar-project.properties b/sonar-project.properties
index 7f16e707e..c89bd35d6 100644
--- a/sonar-project.properties
+++ b/sonar-project.properties
@@ -8,7 +8,7 @@ sonar.projectName=AI DevOps Framework
 sonar.projectVersion=2.103.0
 
 # Path is relative to the sonar-project.properties file
-sonar.sources=.agent,configs,templates
+sonar.sources=.agents,configs,templates
 
 # Encoding of the source code. Default is default system encoding
 sonar.sourceEncoding=UTF-8
@@ -20,7 +20,7 @@ sonar.exclusions=**/*.txt,**/tmp/**,**/logs/**,.git/**,**/*.json
 sonar.coverage.exclusions=**/*.sh,**/*.md,**/*.json,**/*.yml,**/*.yaml,configs/**/*.py,**/example*.py,**/*-example.py
 
 # Duplication exclusions for configuration templates and documentation
-sonar.cpd.exclusions=configs/**/*.txt,.agent/**/*.md,templates/**/*.md
+sonar.cpd.exclusions=configs/**/*.txt,.agents/**/*.md,templates/**/*.md
 
 # Security hotspot exclusions for DevOps framework patterns
 # These are intentional behaviors required for CLI tool installation and local development
diff --git a/templates/deploy-templates.sh b/templates/deploy-templates.sh
index baf449ee4..023ddf45f 100755
--- a/templates/deploy-templates.sh
+++ b/templates/deploy-templates.sh
@@ -27,7 +27,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(dirname "$SCRIPT_DIR")"
 
 # Validate we're in the correct repository
-if [[ ! -f "$REPO_ROOT/AGENTS.md" ]] || [[ ! -d "$REPO_ROOT/.agent" ]]; then
+if [[ ! -f "$REPO_ROOT/AGENTS.md" ]] || [[ ! -d "$REPO_ROOT/.agents" ]]; then
     print_error "This script must be run from within the aidevops repository"
     exit 1
 fi
@@ -168,7 +168,7 @@ deploy_agent_directory() {
     fi
     
     # Deploy template
-    cp "$SCRIPT_DIR/home/.agent/README.md" "$target_file"
+    cp "$SCRIPT_DIR/home/.agents/README.md" "$target_file"
     print_success "Deployed: $target_file"
     return 0
 }
diff --git a/templates/home/AGENTS.md b/templates/home/AGENTS.md
index 70c4e4495..0a584bfd4 100644
--- a/templates/home/AGENTS.md
+++ b/templates/home/AGENTS.md
@@ -53,13 +53,13 @@ AI assistants operating in this environment should:
 
 ```bash
 # Store API keys securely
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh set service-name YOUR_API_KEY
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh set service-name YOUR_API_KEY
 
 # Or paste export commands from services
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh add 'export TOKEN="xxx"'
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh add 'export TOKEN="xxx"'
 
 # List configured services (keys are never displayed)
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh list
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh list
 
 # Verify secure storage location
 ls -la ~/.config/aidevops/
diff --git a/templates/home/git/AGENTS.md b/templates/home/git/AGENTS.md
index 69c3b68b3..0fb77a985 100644
--- a/templates/home/git/AGENTS.md
+++ b/templates/home/git/AGENTS.md
@@ -23,7 +23,7 @@ For all infrastructure, hosting, and DevOps tasks:
 ```bash
 # Use the DevOps framework
 cd ~/Git/aidevops
-./.agent/scripts/servers-helper.sh help
+./.agents/scripts/servers-helper.sh help
 
 # View complete provider documentation
 ls ~/Git/aidevops/docs/
@@ -57,10 +57,10 @@ ls ~/Git/aidevops/docs/
 
 ```bash
 # Store API keys securely
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh set service-name YOUR_API_KEY
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh set service-name YOUR_API_KEY
 
 # List configured services (keys are never displayed)
-bash ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh list
+bash ~/Git/aidevops/.agents/scripts/setup-local-api-keys.sh list
 
 # Verify secure storage location
 ls -la ~/.config/aidevops/
@@ -81,7 +81,7 @@ ls -la ~/.config/aidevops/
 cd ~/Git/aidevops
 
 # View agent documentation
-ls ~/Git/aidevops/.agent/
+ls ~/Git/aidevops/.agents/
 
 # View setup documentation
 cat ~/Git/aidevops/README.md
diff --git a/templates/wordpress-performance-workflow.md b/templates/wordpress-performance-workflow.md
index e0f7e0a98..2c85afe5b 100644
--- a/templates/wordpress-performance-workflow.md
+++ b/templates/wordpress-performance-workflow.md
@@ -6,7 +6,7 @@ This template provides a comprehensive workflow for optimizing WordPress website
 
 ```bash
 # Comprehensive WordPress performance analysis
-./.agent/scripts/pagespeed-helper.sh wordpress https://your-wordpress-site.com
+./.agents/scripts/pagespeed-helper.sh wordpress https://your-wordpress-site.com
 
 # This will run:
 # 1. PageSpeed Insights (desktop & mobile)
@@ -20,7 +20,7 @@ This template provides a comprehensive workflow for optimizing WordPress website
 
 ```bash
 # Create baseline report
-./.agent/scripts/pagespeed-helper.sh audit https://your-site.com
+./.agents/scripts/pagespeed-helper.sh audit https://your-site.com
 ```text
 
 **Key Metrics to Track:**
@@ -97,7 +97,7 @@ SITE_URL="https://your-wordpress-site.com"
 DATE=$(date +"%Y-%m-%d")
 
 echo "Weekly Performance Check - $DATE"
-./.agent/scripts/pagespeed-helper.sh wordpress "$SITE_URL"
+./.agents/scripts/pagespeed-helper.sh wordpress "$SITE_URL"
 
 # Save results for comparison
 cp ~/.ai-devops/reports/pagespeed/lighthouse_*.json "weekly-reports/lighthouse-$DATE.json"
@@ -121,7 +121,7 @@ Add this to your AI assistant's system prompt:
 
 ```text
 For WordPress performance optimization, use the PageSpeed and Lighthouse tools in 
-~/git/aidevops/.agent/scripts/pagespeed-helper.sh. Focus on:
+~/git/aidevops/.agents/scripts/pagespeed-helper.sh. Focus on:
 
 1. Core Web Vitals improvement
 2. WordPress-specific optimizations (plugins, themes, caching)
@@ -137,14 +137,14 @@ Always provide specific, actionable recommendations with implementation steps.
 1. **"Audit my WordPress site performance"**
 
    ```bash
-   ./.agent/scripts/pagespeed-helper.sh wordpress https://your-site.com
+   ./.agents/scripts/pagespeed-helper.sh wordpress https://your-site.com
    ```
 
 2. **"Compare performance before and after optimization"**
 
    ```bash
-   ./.agent/scripts/pagespeed-helper.sh report before-optimization.json
-   ./.agent/scripts/pagespeed-helper.sh report after-optimization.json
+   ./.agents/scripts/pagespeed-helper.sh report before-optimization.json
+   ./.agents/scripts/pagespeed-helper.sh report after-optimization.json
    ```
 
 3. **"Monitor multiple WordPress sites"**
@@ -154,7 +154,7 @@ Always provide specific, actionable recommendations with implementation steps.
    echo "https://site1.com" > wordpress-sites.txt
    echo "https://site2.com" >> wordpress-sites.txt
    
-   ./.agent/scripts/pagespeed-helper.sh bulk wordpress-sites.txt
+   ./.agents/scripts/pagespeed-helper.sh bulk wordpress-sites.txt
    ```
 
 ## 📈 **Performance Targets**
@@ -201,8 +201,8 @@ Always provide specific, actionable recommendations with implementation steps.
 
 ```bash
 # Generate comprehensive report
-./.agent/scripts/pagespeed-helper.sh lighthouse https://your-site.com json
-./.agent/scripts/pagespeed-helper.sh report ~/.ai-devops/reports/pagespeed/lighthouse_*.json
+./.agents/scripts/pagespeed-helper.sh lighthouse https://your-site.com json
+./.agents/scripts/pagespeed-helper.sh report ~/.ai-devops/reports/pagespeed/lighthouse_*.json
 ```text
 
 ### **Track Improvements Over Time**
diff --git a/tests/docker/Dockerfile b/tests/docker/Dockerfile
index 0f5749a37..52fe030cd 100644
--- a/tests/docker/Dockerfile
+++ b/tests/docker/Dockerfile
@@ -7,7 +7,7 @@ RUN apk add --no-cache bash curl git jq sudo coreutils grep sed && \
 
 USER testuser
 WORKDIR /home/testuser
-RUN mkdir -p ~/git ~/.config/aidevops ~/.agent/{tmp,work,memory}
+RUN mkdir -p ~/git ~/.config/aidevops ~/.agents/{tmp,work,memory}
 
 ENV HOME=/home/testuser
 CMD ["/bin/bash"]
diff --git a/tests/docker/run-tests.sh b/tests/docker/run-tests.sh
index 4dff32f7f..fd602e135 100755
--- a/tests/docker/run-tests.sh
+++ b/tests/docker/run-tests.sh
@@ -2,7 +2,7 @@
 # Setup script test runner
 set -uo pipefail
 
-SCRIPTS_DIR="${HOME}/git/aidevops/.agent/scripts"
+SCRIPTS_DIR="${HOME}/git/aidevops/.agents/scripts"
 PASS=0
 FAIL=0
 SKIP=0
diff --git a/tests/toon-test-documents/sample.md b/tests/toon-test-documents/sample.md
index c861dc590..77c3cdc3c 100644
--- a/tests/toon-test-documents/sample.md
+++ b/tests/toon-test-documents/sample.md
@@ -24,7 +24,7 @@ This is a **test document** to demonstrate the Pandoc conversion capabilities of
 ### Code Example
 
 ```bash
-bash .agent/scripts/pandoc-helper.sh convert document.docx
+bash .agents/scripts/pandoc-helper.sh convert document.docx
 ```
 
 For more information, visit the [AI DevOps repository](https://github.com/marcusquinn/aidevops).
diff --git a/tests/toon-test-documents/toon-integration-test.sh b/tests/toon-test-documents/toon-integration-test.sh
index 8053cd0aa..9e22e4100 100755
--- a/tests/toon-test-documents/toon-integration-test.sh
+++ b/tests/toon-test-documents/toon-integration-test.sh
@@ -12,7 +12,7 @@ echo ""
 # Test 1: Basic conversion
 echo "📝 Test 1: Basic JSON to TOON conversion"
 echo '{"project": "AI DevOps", "version": "1.0", "active": true}' > test-basic.json
-./.agent/scripts/toon-helper.sh encode test-basic.json test-basic.toon
+./.agents/scripts/toon-helper.sh encode test-basic.json test-basic.toon
 echo "✅ Basic conversion completed"
 echo ""
 
@@ -27,19 +27,19 @@ cat > test-tabular.json << 'EOF'
   ]
 }
 EOF
-./.agent/scripts/toon-helper.sh encode test-tabular.json test-tabular.toon ',' true
+./.agents/scripts/toon-helper.sh encode test-tabular.json test-tabular.toon ',' true
 echo "✅ Tabular conversion with stats completed"
 echo ""
 
 # Test 3: Tab delimiter for better efficiency
 echo "🔤 Test 3: Tab delimiter conversion"
-./.agent/scripts/toon-helper.sh encode test-tabular.json test-tabular-tab.toon '\t' true
+./.agents/scripts/toon-helper.sh encode test-tabular.json test-tabular-tab.toon '\t' true
 echo "✅ Tab delimiter conversion completed"
 echo ""
 
 # Test 4: Round-trip validation
 echo "🔄 Test 4: Round-trip validation"
-./.agent/scripts/toon-helper.sh decode test-tabular.toon test-restored.json
+./.agents/scripts/toon-helper.sh decode test-tabular.toon test-restored.json
 # Use jq to normalize JSON for comparison (semantic comparison)
 if command -v jq &> /dev/null; then
     if jq -S . test-tabular.json > test-normalized.json && jq -S . test-restored.json > test-restored-normalized.json; then
@@ -59,17 +59,17 @@ echo ""
 
 # Test 5: TOON validation
 echo "✅ Test 5: TOON format validation"
-./.agent/scripts/toon-helper.sh validate test-tabular.toon
+./.agents/scripts/toon-helper.sh validate test-tabular.toon
 echo ""
 
 # Test 6: Stdin processing
 echo "📥 Test 6: Stdin processing"
-echo '{"name": "stdin-test", "items": ["a", "b", "c"]}' | ./.agent/scripts/toon-helper.sh stdin-encode ',' true
+echo '{"name": "stdin-test", "items": ["a", "b", "c"]}' | ./.agents/scripts/toon-helper.sh stdin-encode ',' true
 echo ""
 
 # Test 7: Comparison analysis
 echo "📈 Test 7: Token efficiency comparison"
-./.agent/scripts/toon-helper.sh compare test-tabular.json
+./.agents/scripts/toon-helper.sh compare test-tabular.json
 echo ""
 
 # Show generated files
diff --git a/todo/PLANS.md b/todo/PLANS.md
index 366070013..5aa38c8fd 100644
--- a/todo/PLANS.md
+++ b/todo/PLANS.md
@@ -38,9 +38,9 @@ Eliminate `curl | sh` installs by downloading scripts to disk, verifying integri
 
 Targets include:
 - `setup.sh` (multiple install blocks)
-- `.agent/scripts/qlty-cli.sh`
-- `.agent/scripts/coderabbit-cli.sh`
-- `.agent/scripts/dev-browser-helper.sh`
+- `.agents/scripts/qlty-cli.sh`
+- `.agents/scripts/coderabbit-cli.sh`
+- `.agents/scripts/dev-browser-helper.sh`
 
 #### Progress
 
@@ -185,7 +185,7 @@ m090,p017,Phase 3: Add reset/clear UI flow and verify behavior,45m,,2026-02-03T0
 
 **Status:** Planning
 **Estimate:** ~2d (ai:1d test:0.5d read:0.5d)
-**Architecture:** [.agent/build-mcp/aidevops-plugin.md](../.agent/build-mcp/aidevops-plugin.md)
+**Architecture:** [.agents/build-mcp/aidevops-plugin.md](../.agents/build-mcp/aidevops-plugin.md)
 
 <!--TOON:plan{id,title,status,phase,total_phases,owner,tags,est,est_ai,est_test,est_read,logged,started}:
 p001,aidevops-opencode Plugin,planning,0,4,,opencode|plugin,2d,1d,0.5d,0.5d,2025-12-21T01:50Z,
@@ -1086,7 +1086,7 @@ Implement remaining agent design pattern improvements identified from Lance Mart
 
 | Priority | Improvement | Estimate | Description |
 |----------|-------------|----------|-------------|
-| Medium | YAML frontmatter in source subagents | ~2h | Add frontmatter to all `.agent/**/*.md` for better progressive disclosure |
+| Medium | YAML frontmatter in source subagents | ~2h | Add frontmatter to all `.agents/**/*.md` for better progressive disclosure |
 | Medium | Automatic session reflection | ~4h | Auto-distill sessions to memory on completion |
 | Low | Cache-aware prompt structure | ~1h | Document stable-prefix patterns for better cache hits |
 | Low | Tool description indexing | ~3h | Cursor-style MCP description sync for on-demand retrieval |
@@ -1095,7 +1095,7 @@ Implement remaining agent design pattern improvements identified from Lance Mart
 #### Progress
 
 - [ ] (2025-01-11) Phase 1: Add YAML frontmatter to source subagents ~2h
-  - Add `description`, `triggers`, `tools` to all `.agent/**/*.md` files
+  - Add `description`, `triggers`, `tools` to all `.agents/**/*.md` files
   - Update `generate-opencode-agents.sh` to parse frontmatter
 - [ ] (2025-01-11) Phase 2: Automatic session reflection ~4h
   - Create `session-distill-helper.sh` to extract learnings
@@ -1156,7 +1156,7 @@ p012,/add-skill System for External Skill Import,planning,0,6,,skills|agents|imp
 
 Create a comprehensive skill import system that allows rapid adoption of external AI agent skills into aidevops, with upstream tracking for updates and multi-assistant compatibility.
 
-**Problem:** Many people are creating and sharing Claude Code skills, OpenCode skills, and other AI assistant configurations. aidevops has its own superior `.agent/` folder structure. We need to rapidly import external skills, convert to aidevops format, handle conflicts intelligently, and track upstream for updates.
+**Problem:** Many people are creating and sharing Claude Code skills, OpenCode skills, and other AI assistant configurations. aidevops has its own superior `.agents/` folder structure. We need to rapidly import external skills, convert to aidevops format, handle conflicts intelligently, and track upstream for updates.
 
 #### Research Completed (2026-01-21)
 
@@ -1190,7 +1190,7 @@ Create a comprehensive skill import system that allows rapid adoption of externa
 - `trailofbits/skills` - Security auditing
 
 **Architecture Decision:**
-- Source of truth: `.agent/` (aidevops format)
+- Source of truth: `.agents/` (aidevops format)
 - `setup.sh` generates symlinks to `~/.config/opencode/skills/`, `~/.codex/skills/`, `~/.claude/skills/`, `~/.config/amp/tools/`
 - Nesting: Simple skills → single .md file; Complex skills → folder with subagents
 - Tracking: `skill-sources.json` with upstream URL, version, last-checked
@@ -1200,12 +1200,12 @@ Create a comprehensive skill import system that allows rapid adoption of externa
 - [ ] (2026-01-21) Phase 1: Create skill-sources.json schema and registry ~2h
   - Define JSON schema for tracking upstream skills
   - Add existing humanise.md as first tracked skill
-  - Create `.agent/configs/skill-sources.json`
+  - Create `.agents/configs/skill-sources.json`
 - [ ] (2026-01-21) Phase 2: Create add-skill-helper.sh ~4h
   - Fetch via `npx skills add` or direct GitHub
   - Detect format (SKILL.md, AGENTS.md, .cursorrules, raw)
   - Extract metadata, instructions, resources
-  - Check for conflicts with existing .agent/ files
+  - Check for conflicts with existing .agents/ files
 - [ ] (2026-01-21) Phase 3: Create /add-skill command ~2h
   - Create `scripts/commands/add-skill.md`
   - Present merge options when conflicts detected
@@ -1236,7 +1236,7 @@ m063,p012,Phase 6: Update setup.sh for symlinks,3h,,2026-01-21T00:00Z,,pending
 #### Decision Log
 
 - **Decision:** Use symlinks by default, pointer fallback for Windows
-  **Rationale:** Single source of truth; updates to .agent/ automatically reflected
+  **Rationale:** Single source of truth; updates to .agents/ automatically reflected
   **Date:** 2026-01-21
 
 - **Decision:** Use `npx skills add` as fetch mechanism when available
@@ -1262,18 +1262,18 @@ d025,p012,Merge conflicts require human decision,Preserves existing knowledge,20
 
 | File | Purpose |
 |------|---------|
-| `.agent/configs/skill-sources.json` | Registry of imported skills with upstream tracking |
-| `.agent/scripts/add-skill-helper.sh` | Fetch, analyse, convert, merge skills |
-| `.agent/scripts/skill-update-helper.sh` | Check all tracked skills for updates |
-| `.agent/scripts/commands/add-skill.md` | `/add-skill` command definition |
-| `.agent/tools/build-agent/add-skill.md` | Subagent with conversion/merge logic |
+| `.agents/configs/skill-sources.json` | Registry of imported skills with upstream tracking |
+| `.agents/scripts/add-skill-helper.sh` | Fetch, analyse, convert, merge skills |
+| `.agents/scripts/skill-update-helper.sh` | Check all tracked skills for updates |
+| `.agents/scripts/commands/add-skill.md` | `/add-skill` command definition |
+| `.agents/tools/build-agent/add-skill.md` | Subagent with conversion/merge logic |
 
 #### Files to Update
 
 | File | Changes |
 |------|---------|
 | `setup.sh` | Generate symlinks to all AI assistant skill locations |
-| `generate-skills.sh` | Create SKILL.md stubs pointing to .agent/ source |
+| `generate-skills.sh` | Create SKILL.md stubs pointing to .agents/ source |
 | `AGENTS.md` | Document /add-skill command in quick reference |
 
 #### Surprises & Discoveries
diff --git a/todo/tasks/prd-document-extraction.md b/todo/tasks/prd-document-extraction.md
index 711090373..fe815c841 100644
--- a/todo/tasks/prd-document-extraction.md
+++ b/todo/tasks/prd-document-extraction.md
@@ -234,9 +234,9 @@ testing,,2h,2h
 
 ### Related Documents
 
-- [Unstract Subagent](../../.agent/services/document-processing/unstract.md)
+- [Unstract Subagent](../../.agents/services/document-processing/unstract.md)
 - [OCR Invoice/Receipt Extraction Pipeline](../PLANS.md#ocr-invoicereceipt-extraction-pipeline)
-- [Pandoc Conversion Tool](../../.agent/tools/conversion/pandoc.md)
+- [Pandoc Conversion Tool](../../.agents/tools/conversion/pandoc.md)
 
 ### External References
 
diff --git a/todo/tasks/prd-memory-auto-capture.md b/todo/tasks/prd-memory-auto-capture.md
index 206134dfc..014c92967 100644
--- a/todo/tasks/prd-memory-auto-capture.md
+++ b/todo/tasks/prd-memory-auto-capture.md
@@ -223,9 +223,9 @@ privacy,1h,1.5h,,2.5h
 
 ### Related Documents
 
-- [memory/README.md](../../.agent/memory/README.md) - Current memory system docs
+- [memory/README.md](../../.agents/memory/README.md) - Current memory system docs
 - [claude-mem](https://github.com/thedotmack/claude-mem) - Reference implementation
-- [scripts/commands/remember.md](../../.agent/scripts/commands/remember.md) - Manual memory command
+- [scripts/commands/remember.md](../../.agents/scripts/commands/remember.md) - Manual memory command
 
 ### Comparison with claude-mem