refactor: rename .agent/ to .agents/ for industry alignment

.agent/aidevops.md → .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

.agent/aidevops/add-new-mcp-to-aidevops.md → .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.

.agent/aidevops/api-integrations.md → .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,31 +48,31 @@ 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**
 
 - **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**
 
 - **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**
 
 - **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,39 +82,39 @@ 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**
 
 - **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**
 
 - **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**
 
 - **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**
 
 - **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,15 +124,15 @@ 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**
 
 - **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,15 +247,15 @@ 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
 
 ### **Agno AgentOS**
 
 - **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/)