ai-eng-system 0.0.6 → 0.0.8

package/README.md

@@ -12,14 +12,17 @@ Advanced development tools with context engineering, research orchestration, and
 
 ### OpenCode
 ```bash
-bun scripts/install.js  # Global install (default)
-# or
-bun scripts/install.js --local  # Local install
-```
+# Add to opencode.jsonc:
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-skills", "ai-eng-system"]
+}
 
+# Run OpenCode - plugin auto-installs commands, agents, and skills
+```
 ## 📋 What's Included
 
-### Commands (15 total)
+### Commands (16 total)
 - `/ai-eng/plan` - Create detailed implementation plans
 - `/ai-eng/review` - Multi-perspective code review (29 agents)
 - `/ai-eng/seo` - SEO audits with Core Web Vitals
@@ -35,6 +38,7 @@ bun scripts/install.js --local  # Local install
 - `/ai-eng/create-tool` - AI-assisted custom tool creation
 - `/ai-eng/research` - Multi-phase research orchestration
 - `/ai-eng/context` - Context management and retrieval
+- `/ai-eng/clean` - Remove build artifacts and generated files
 
 ### Agents (29 total)
 - **Architecture & Planning**: `architect-advisor`, `backend-architect`, `infrastructure-builder`
@@ -45,11 +49,12 @@ bun scripts/install.js --local  # Local install
 - **Content & SEO**: `seo-specialist`, `prompt-optimizer`
 - **Plugin Development**: `agent-creator`, `command-creator`, `skill-creator`, `tool-creator`, `plugin-validator`
 
-### Skills (4 packs)
+### Skills (13 files)
 - `devops` - Coolify deployment, Git worktree workflows
 - `prompting` - Research-backed incentive prompting techniques
 - `research` - Comprehensive multi-phase research orchestration
 - `plugin-dev` - Plugin development knowledge base and references
+- `text-cleanup` - Pattern-based text cleanup (slop, comments)
 
 ## 🏗️ Architecture
 
@@ -59,6 +64,8 @@ This repo follows Anthropic's official Claude Code marketplace pattern:
 - **Embedded plugin**: `plugins/ai-eng-system/` with standard plugin layout
 - **Build system**: Transforms canonical `content/` sources into platform-specific outputs
 - **OpenCode support**: Pre-built distributions in `dist/.opencode/`
+- **Auto-installation**: Plugin automatically installs files when loaded by OpenCode or via npm postinstall
+
 
 ## 🔧 Development
 
@@ -111,5 +118,49 @@ bun test             # Run test suite
 - [Research Guide](docs/research-command-guide.md) - Research orchestration usage
 
 ---
+## 💻 Usage Example
+
+### OpenCode Setup
+
+```bash
+# 1. Create opencode.jsonc in your project
+cat > opencode.jsonc << 'EOF'
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-skills", "ai-eng-system"]
+}
+EOF
+
+# 2. Install package (optional - auto-installs via plugin)
+npm install ai-eng-system
+
+# 3. Run OpenCode
+# Commands and agents are automatically available!
+```
+
+**When OpenCode loads the plugin**, it automatically:
+- ✅ Installs 16 commands to `.opencode/command/ai-eng/`
+- ✅ Installs 30 agents to `.opencode/agent/ai-eng/`
+- ✅ Installs 13 skill files to `.opencode/skills/`
+
+### Using Commands
+
+```bash
+/ai-eng/plan              # Create implementation plan
+/ai-eng/review             # Multi-agent code review
+/ai-eng/work               # Execute implementation plan
+/ai-eng/seo                # SEO audit
+/ai-eng/create-agent       # Generate new agent
+# ... and 11 more
+```
+
+### Using Agents
+
+Commands reference specialized agents automatically:
+```bash
+/ai-eng/review --agent=code-reviewer     # Quality-focused review
+/ai-eng/review --agent=frontend-reviewer # Frontend review
+/ai-eng/review --agent=backend-architect  # Architecture review
+```
 
 **Built with research-backed prompting techniques** (+45-115% quality improvement)

package/dist/.claude-plugin/agents/agent-creator.md

@@ -79,8 +79,6 @@ temperature: 0.3
 tools:
   read: true
   write: true
-permission:
-  bash: deny
 ---
 ```
 

package/dist/.claude-plugin/agents/ai_engineer.md

@@ -16,7 +16,6 @@ tools:
   list: true
   webfetch: true
 category: ai-innovation
-permission: {}
 ---
 
 **primary_objective**: Build production-ready LLM applications, advanced RAG systems, and intelligent agents.

package/dist/.claude-plugin/agents/api_builder_enhanced.md

@@ -12,7 +12,6 @@ mode: subagent
 temperature: 0.1
 tools: {}
 category: development
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/backend_architect.md

@@ -14,40 +14,6 @@ tools:
   glob: true
   list: true
 category: development
-permission:
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
-  edit:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/*.pem": deny
-    "**/*.crt": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-    "**/.env": deny
-    "**/.env.local": deny
-    "**/.env.production": deny
-  write:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/*.pem": deny
-    "**/*.crt": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-    "**/.env": deny
-    "**/.env.local": deny
-    "**/.env.production": deny
-  bash:
-    "*": allow
-    rm -rf /*: deny
-    rm -rf .*: deny
-    ":(){ :|:& };:": deny
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/code_reviewer.md

@@ -17,15 +17,6 @@ tools:
   write: false
   patch: false
 category: quality-testing
-permission:
-  bash: deny
-  edit: deny
-  write: deny
-  patch: deny
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/cost_optimizer.md

@@ -16,7 +16,6 @@ tools:
   bash: false
   webfetch: false
 category: operations
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/database_optimizer.md

@@ -18,7 +18,6 @@ tools:
   list: true
   webfetch: true
 category: development
-permission: {}
 ---
 
 **primary_objective**: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures.

package/dist/.claude-plugin/agents/deployment_engineer.md

@@ -16,7 +16,6 @@ tools:
   list: true
   webfetch: true
 category: operations
-permission: {}
 ---
 
 **primary_objective**: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation.

package/dist/.claude-plugin/agents/docs-writer.md

@@ -13,8 +13,6 @@ tools:
   glob: true
   list: true
 category: development
-permission:
-  bash: deny
 ---
 
 You are a senior technical documentation writer with 15+ years of experience, having led documentation teams at major tech companies like Google and Microsoft. You've authored comprehensive API documentation, developer guides, and user manuals that have been praised for their clarity, accuracy, and developer-friendly approach. Your expertise is highly sought after in the industry for creating documentation that developers actually want to read.

package/dist/.claude-plugin/agents/documentation_specialist.md

@@ -9,8 +9,6 @@ tools:
   read: true
   write: true
 category: development
-permission:
-  bash: deny
 ---
 
 You are a senior technical documentation specialist with 15+ years of experience leading documentation teams at major technology companies like Google, Microsoft, and Amazon. You've authored over 50 technical books, led the documentation efforts for enterprise-scale systems serving millions of users, and pioneered automated documentation generation techniques that reduced manual documentation time by 80%.

package/dist/.claude-plugin/agents/full_stack_developer.md

@@ -16,27 +16,6 @@ tools:
   glob: true
   list: true
 category: development
-permission:
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
-  edit:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-  write:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-  bash:
-    "*": allow
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/infrastructure_builder.md

@@ -15,7 +15,6 @@ tools:
   bash: true
   webfetch: false
 category: operations
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/ml_engineer.md

@@ -16,7 +16,6 @@ tools:
   list: true
   webfetch: true
 category: ai-innovation
-permission: {}
 ---
 
 **primary_objective**: Build production ML systems with PyTorch 2.x, TensorFlow, and modern ML frameworks.

package/dist/.claude-plugin/agents/monitoring_expert.md

@@ -17,7 +17,6 @@ tools:
   bash: true
   webfetch: false
 category: operations
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/performance_engineer.md

@@ -15,7 +15,6 @@ tools:
   list: true
   webfetch: true
 category: quality-testing
-permission: {}
 ---
 
 **primary_objective**: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance.

package/dist/.claude-plugin/agents/security_scanner.md

@@ -15,15 +15,6 @@ tools:
   write: false
   patch: false
 category: quality-testing
-permission:
-  bash: deny
-  edit: deny
-  write: deny
-  patch: deny
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/agents/test_generator.md

@@ -8,7 +8,6 @@ tools:
   write: true
   bash: true
 category: quality-testing
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.claude-plugin/hooks.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "notification",
-            "message": "🔧 Ferg Engineering System loaded. Commands: /ai-eng/plan, /ai-eng/review, /ai-eng/seo, /ai-eng/work, /ai-eng/compound, /ai-eng/deploy, /ai-eng/optimize, /ai-eng/recursive-init, /ai-eng/create-plugin, /ai-eng/create-agent, /ai-eng/create-command, /ai-eng/create-skill, /ai-eng/create-tool, /ai-eng/research, /ai-eng/context"
+            "message": "🔧 Ferg Engineering System loaded. Commands: /ai-eng/plan, /ai-eng/view, /ai-eng/seo, /ai-eng/work, /ai-eng/compound, /ai-eng/deploy, /ai-eng/optimize, /ai-eng/recursive-init, /ai-eng/create-plugin, /ai-eng/create-agent, /ai-eng/create-command, /ai-eng/create-skill, /ai-eng/create-tool, /ai-eng/research, /ai-eng/context"
           }
         ]
       }

package/dist/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-eng-system",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "AI Engineering System with context engineering and research orchestration for Claude Code",
   "author": "v1truv1us",
   "license": "MIT",

package/dist/.claude-plugin/skills/plugin-dev/references/agent-format.md

@@ -8,12 +8,12 @@ Agents are specialized AI assistants that provide focused expertise for specific
 
 | Aspect | Claude Code | OpenCode | Canonical (content/) |
 |---------|-------------|----------|------------------|
-| **Frontmatter** | YAML block | YAML table | YAML block |
+| **Frontmatter** | YAML block | YAML block | YAML block |
 | **File Extension** | `.md` | `.md` | `.md` |
 | **Mode Specification** | `mode: subagent` | `mode: subagent` | `mode: subagent` |
 | **Model Override** | `model: sonnet` | `model: sonnet` | `model: sonnet` |
-| **Tool Control** | `tools: [...]` | `tools: { read: true }` | `tools: { read: true } |
-| **Color Coding** | `color: cyan` | `color: cyan` | `color: cyan` |
+| **Tool Control** | `tools: [...]` | `tools: { read: true }` | `tools: { read: true }` |
+| **Color Coding** | Named colors OK | Hex format only (e.g., `#00FFFF`) | Named colors OK (auto-converted to hex) |
 | **Temperature** | `temperature: 0.3` | `temperature: 0.3` | `temperature: 0.3` |
 | **Permissions** | N/A | `permission: { bash: deny }` | `permission: { bash: deny }` |
 
@@ -75,6 +75,8 @@ Build.ts transforms canonical to OpenCode format (table frontmatter):
 Agent system prompt here...
 ```
 
+**Note on Color Format**: OpenCode requires hex color codes (e.g., `#00FFFF`) while Claude Code accepts named colors (e.g., `cyan`). The build.ts script automatically converts named colors to hex format during OpenCode build. Valid named colors that are automatically converted include: `cyan`, `blue`, `green`, `yellow`, `magenta`, `red`, `orange`, `purple`, `pink`, `lime`, `olive`, `maroon`, `navy`, `teal`, `aqua`, `silver`, `gray`, `black`, `white`. You can also use hex colors directly in the canonical format if you prefer.
+
 ## Agent Modes
 
 ### Primary Agents
@@ -245,4 +247,22 @@ You are a senior code reviewer with 10+ years of experience...
 - `ai-eng/skill-creator` - Skill development guidance
 - `ai-eng/plugin-validator` - Plugin structure validation
 
-All agents follow the same quality standards and use the build.ts transformation system.
+All agents follow the same quality standards and use the build.ts transformation system.
+
+## Build Transformations
+
+The `build.ts` script performs automatic transformations to ensure compatibility:
+
+### Color Format Conversion
+- **Canonical → Claude Code**: Preserves named colors (e.g., `color: cyan`)
+- **Canonical → OpenCode**: Converts named colors to hex format (e.g., `color: cyan` → `color: "#00FFFF"`)
+
+### Field Removal
+- **OpenCode only**: Removes `name` and `category` fields from frontmatter
+- **Permission cleaning**: Filters to valid OpenCode permission keys (edit, bash, webfetch, doom_loop, external_directory)
+
+### Validation
+The build script validates OpenCode output:
+- Checks for hex color format (`^#[0-9a-fA-F]{6}$`)
+- Ensures required fields are present (description, mode)
+- Validates nested directory structure (ai-eng/<category>/<agent>.md)

package/dist/.opencode/agent/ai-eng/ai-innovation/ai_engineer.md

@@ -14,8 +14,6 @@ tools:
   glob: true
   list: true
   webfetch: true
-category: ai-innovation
-permission: {}
 ---
 
 **primary_objective**: Build production-ready LLM applications, advanced RAG systems, and intelligent agents.

package/dist/.opencode/agent/ai-eng/ai-innovation/ml_engineer.md

@@ -14,8 +14,6 @@ tools:
   glob: true
   list: true
   webfetch: true
-category: ai-innovation
-permission: {}
 ---
 
 **primary_objective**: Build production ML systems with PyTorch 2.x, TensorFlow, and modern ML frameworks.

package/dist/.opencode/agent/ai-eng/ai-innovation/prompt-optimizer.md

@@ -1,7 +1,6 @@
 ---
 description: Optimizes prompts using research-backed incentive techniques
 mode: subagent
-category: ai-innovation
 ---
 
 You are an expert prompt engineer specializing in research-backed prompting optimization. Your role is to enhance prompts for maximum AI response quality using techniques from peer-reviewed research.

package/dist/.opencode/agent/ai-eng/business-analytics/seo-specialist.md

@@ -1,7 +1,6 @@
 ---
 description: SEO analysis and recommendations
 mode: subagent
-category: business-analytics
 ---
 
 You are a senior SEO engineer with 10+ years of experience, having led SEO strategy at high-traffic sites like HubSpot, Moz, and Ahrefs. You've recovered sites from Google penalties, achieved #1 rankings for competitive keywords, and your technical SEO audits are legendary in the industry.

package/dist/.opencode/agent/ai-eng/development/api_builder_enhanced.md

@@ -10,8 +10,6 @@ description: "Expert at building robust, scalable APIs with proper
 mode: subagent
 temperature: 0.1
 tools: {}
-category: development
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.opencode/agent/ai-eng/development/architect-advisor.md

@@ -1,7 +1,6 @@
 ---
 description: Architectural guidance and technical decisions
 mode: subagent
-category: development
 ---
 
 You are a principal software architect with 15+ years of experience, having designed systems at Netflix, Stripe, and AWS. You've scaled systems from startup to billions of requests, led major platform migrations, and your architectural decisions have stood the test of time. Your expertise spans distributed systems, domain-driven design, and cloud-native architectures.

package/dist/.opencode/agent/ai-eng/development/backend_architect.md

@@ -12,41 +12,6 @@ tools:
   grep: true
   glob: true
   list: true
-category: development
-permission:
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
-  edit:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/*.pem": deny
-    "**/*.crt": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-    "**/.env": deny
-    "**/.env.local": deny
-    "**/.env.production": deny
-  write:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/*.pem": deny
-    "**/*.crt": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-    "**/.env": deny
-    "**/.env.local": deny
-    "**/.env.production": deny
-  bash:
-    "*": allow
-    rm -rf /*: deny
-    rm -rf .*: deny
-    ":(){ :|:& };:": deny
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.opencode/agent/ai-eng/development/database_optimizer.md

@@ -16,8 +16,6 @@ tools:
   glob: true
   list: true
   webfetch: true
-category: development
-permission: {}
 ---
 
 **primary_objective**: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures.

package/dist/.opencode/agent/ai-eng/development/docs-writer.md

@@ -2,7 +2,7 @@
 description: Write concise documentation pages in required format.
 mode: primary
 model: sonnet
-color: cyan
+color: "#00FFFF"
 temperature: 0.3
 tools:
   read: true
@@ -11,9 +11,6 @@ tools:
   grep: true
   glob: true
   list: true
-category: development
-permission:
-  bash: deny
 ---
 
 You are a senior technical documentation writer with 15+ years of experience, having led documentation teams at major tech companies like Google and Microsoft. You've authored comprehensive API documentation, developer guides, and user manuals that have been praised for their clarity, accuracy, and developer-friendly approach. Your expertise is highly sought after in the industry for creating documentation that developers actually want to read.

package/dist/.opencode/agent/ai-eng/development/documentation_specialist.md

@@ -2,14 +2,11 @@
 description: Analyze codebases and generate comprehensive technical documentation.
 mode: subagent
 model: sonnet
-color: cyan
+color: "#00FFFF"
 temperature: 0.3
 tools:
   read: true
   write: true
-category: development
-permission:
-  bash: deny
 ---
 
 You are a senior technical documentation specialist with 15+ years of experience leading documentation teams at major technology companies like Google, Microsoft, and Amazon. You've authored over 50 technical books, led the documentation efforts for enterprise-scale systems serving millions of users, and pioneered automated documentation generation techniques that reduced manual documentation time by 80%.

package/dist/.opencode/agent/ai-eng/development/frontend-reviewer.md

@@ -1,7 +1,6 @@
 ---
 description: Reviews frontend code for best practices
 mode: subagent
-category: development
 ---
 
 You are a senior frontend architect with 12+ years of experience at companies like Vercel, Netlify, and Shopify. Your code reviews have prevented countless production bugs and your expertise in React, TypeScript, and modern web performance is highly sought after.

package/dist/.opencode/agent/ai-eng/development/full_stack_developer.md

@@ -14,28 +14,6 @@ tools:
   grep: true
   glob: true
   list: true
-category: development
-permission:
-  read: allow
-  grep: allow
-  glob: allow
-  list: allow
-  edit:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-  write:
-    "*": allow
-    "**/*.env*": deny
-    "**/*.secret": deny
-    "**/*.key": deny
-    "**/.git/**": deny
-    "**/node_modules/**": deny
-  bash:
-    "*": allow
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.opencode/agent/ai-eng/development/java-pro.md

@@ -1,7 +1,6 @@
 ---
 description: Expert Java development with modern Java 21+ features
 mode: subagent
-category: development
 ---
 
 You are a principal Java architect with 15+ years of experience, having built high-scale systems at Netflix, Amazon, and LinkedIn. You've led Java modernization efforts from Java 8 to 21+, implemented virtual threads in production handling millions of concurrent connections, and your Spring Boot architectures serve billions of requests daily. Your expertise spans the entire JVM ecosystem from GraalVM native compilation to reactive systems.

package/dist/.opencode/agent/ai-eng/meta/agent-creator.md

@@ -10,7 +10,6 @@ tools:
   write: true
   glob: true
   list: true
-category: meta
 ---
 
 You are an elite AI agent architect specializing in crafting high-performance agent configurations for both Claude Code and OpenCode platforms. Your expertise lies in translating user requirements into precisely-tuned agent specifications that maximize effectiveness and reliability.
@@ -81,8 +80,6 @@ temperature: 0.3
 tools:
   read: true
   write: true
-permission:
-  bash: deny
 ---
 ```
 

package/dist/.opencode/agent/ai-eng/meta/command-creator.md

@@ -10,7 +10,6 @@ tools:
   write: true
   glob: true
   list: true
-category: meta
 ---
 
 You are an expert command engineer specializing in crafting high-performance slash commands for both Claude Code and OpenCode platforms. Your expertise lies in translating user requirements into precisely-tuned command specifications that maximize effectiveness, reusability, and user experience.

package/dist/.opencode/agent/ai-eng/meta/skill-creator.md

@@ -10,7 +10,6 @@ tools:
   write: true
   glob: true
   list: true
-category: meta
 ---
 
 You are an expert knowledge architect specializing in crafting high-quality skills for both Claude Code and OpenCode platforms. Your expertise lies in designing effective learning systems with progressive disclosure, proper triggering, and comprehensive domain knowledge packaging.

package/dist/.opencode/agent/ai-eng/meta/tool-creator.md

@@ -10,7 +10,6 @@ tools:
   write: true
   glob: true
   list: true
-category: meta
 ---
 
 You are an expert TypeScript tool developer specializing in crafting high-performance custom tools for OpenCode. Your expertise lies in designing effective tool interfaces with proper validation, error handling, and integration patterns that maximize reliability and developer experience.

package/dist/.opencode/agent/ai-eng/operations/cost_optimizer.md

@@ -14,8 +14,6 @@ tools:
   patch: false
   bash: false
   webfetch: false
-category: operations
-permission: {}
 ---
 
 Take a deep breath and approach this task systematically.

package/dist/.opencode/agent/ai-eng/operations/deployment_engineer.md

@@ -14,8 +14,6 @@ tools:
   glob: true
   list: true
   webfetch: true
-category: operations
-permission: {}
 ---
 
 **primary_objective**: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation.