aw-ecc 1.4.21

package/.opencode/MIGRATION.md

@@ -0,0 +1,368 @@
+# Migration Guide: Claude Code to OpenCode
+
+This guide helps you migrate from Claude Code to OpenCode while using the Everything Claude Code (ECC) configuration.
+
+## Overview
+
+OpenCode is an alternative CLI for AI-assisted development that supports **all** the same features as Claude Code, with some differences in configuration format.
+
+## Key Differences
+
+| Feature | Claude Code | OpenCode | Notes |
+|---------|-------------|----------|-------|
+| Configuration | `CLAUDE.md`, `plugin.json` | `opencode.json` | Different file formats |
+| Agents | Markdown frontmatter | JSON object | Full parity |
+| Commands | `commands/*.md` | `command` object or `.md` files | Full parity |
+| Skills | `skills/*/SKILL.md` | `instructions` array | Loaded as context |
+| **Hooks** | `hooks.json` (3 phases) | **Plugin system (20+ events)** | **Full parity + more!** |
+| Rules | `rules/*.md` | `instructions` array | Consolidated or separate |
+| MCP | Full support | Full support | Full parity |
+
+## Hook Migration
+
+**OpenCode fully supports hooks** via its plugin system, which is actually MORE sophisticated than Claude Code with 20+ event types.
+
+### Hook Event Mapping
+
+| Claude Code Hook | OpenCode Plugin Event | Notes |
+|-----------------|----------------------|-------|
+| `PreToolUse` | `tool.execute.before` | Can modify tool input |
+| `PostToolUse` | `tool.execute.after` | Can modify tool output |
+| `Stop` | `session.idle` or `session.status` | Session lifecycle |
+| `SessionStart` | `session.created` | Session begins |
+| `SessionEnd` | `session.deleted` | Session ends |
+| N/A | `file.edited` | OpenCode-only: file changes |
+| N/A | `file.watcher.updated` | OpenCode-only: file system watch |
+| N/A | `message.updated` | OpenCode-only: message changes |
+| N/A | `lsp.client.diagnostics` | OpenCode-only: LSP integration |
+| N/A | `tui.toast.show` | OpenCode-only: notifications |
+
+### Converting Hooks to Plugins
+
+**Claude Code hook (hooks.json):**
+```json
+{
+  "PostToolUse": [{
+    "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+    "hooks": [{
+      "type": "command",
+      "command": "prettier --write \"$file_path\""
+    }]
+  }]
+}
+```
+
+**OpenCode plugin (.opencode/plugins/prettier-hook.ts):**
+```typescript
+export const PrettierPlugin = async ({ $ }) => {
+  return {
+    "file.edited": async (event) => {
+      if (event.path.match(/\.(ts|tsx|js|jsx)$/)) {
+        await $`prettier --write ${event.path}`
+      }
+    }
+  }
+}
+```
+
+### ECC Plugin Hooks Included
+
+The ECC OpenCode configuration includes translated hooks:
+
+| Hook | OpenCode Event | Purpose |
+|------|----------------|---------|
+| Prettier auto-format | `file.edited` | Format JS/TS files after edit |
+| TypeScript check | `tool.execute.after` | Run tsc after editing .ts files |
+| console.log warning | `file.edited` | Warn about console.log statements |
+| Session notification | `session.idle` | Notify when task completes |
+| Security check | `tool.execute.before` | Check for secrets before commit |
+
+## Migration Steps
+
+### 1. Install OpenCode
+
+```bash
+# Install OpenCode CLI
+npm install -g opencode
+# or
+curl -fsSL https://opencode.ai/install | bash
+```
+
+### 2. Use the ECC OpenCode Configuration
+
+The `.opencode/` directory in this repository contains the translated configuration:
+
+```
+.opencode/
+├── opencode.json              # Main configuration
+├── plugins/                   # Hook plugins (translated from hooks.json)
+│   ├── ecc-hooks.ts           # All ECC hooks as plugins
+│   └── index.ts               # Plugin exports
+├── tools/                     # Custom tools
+│   ├── run-tests.ts           # Run test suite
+│   ├── check-coverage.ts      # Check coverage
+│   └── security-audit.ts      # npm audit wrapper
+├── commands/                  # All 23 commands (markdown)
+│   ├── plan.md
+│   ├── tdd.md
+│   └── ... (21 more)
+├── prompts/
+│   └── agents/                # Agent prompt files (12)
+├── instructions/
+│   └── INSTRUCTIONS.md        # Consolidated rules
+├── package.json               # For npm distribution
+├── tsconfig.json              # TypeScript config
+└── MIGRATION.md               # This file
+```
+
+### 3. Run OpenCode
+
+```bash
+# In the repository root
+opencode
+
+# The configuration is automatically detected from .opencode/opencode.json
+```
+
+## Concept Mapping
+
+### Agents
+
+**Claude Code:**
+```markdown
+---
+name: planner
+description: Expert planning specialist...
+tools: ["Read", "Grep", "Glob"]
+model: opus
+---
+
+You are an expert planning specialist...
+```
+
+**OpenCode:**
+```json
+{
+  "agent": {
+    "planner": {
+      "description": "Expert planning specialist...",
+      "mode": "subagent",
+      "model": "anthropic/claude-opus-4-5",
+      "prompt": "{file:prompts/agents/planner.txt}",
+      "tools": { "read": true, "bash": true }
+    }
+  }
+}
+```
+
+### Commands
+
+**Claude Code:**
+```markdown
+---
+name: plan
+description: Create implementation plan
+---
+
+Create a detailed implementation plan for: {input}
+```
+
+**OpenCode (JSON):**
+```json
+{
+  "command": {
+    "plan": {
+      "description": "Create implementation plan",
+      "template": "Create a detailed implementation plan for: $ARGUMENTS",
+      "agent": "planner"
+    }
+  }
+}
+```
+
+**OpenCode (Markdown - .opencode/commands/plan.md):**
+```markdown
+---
+description: Create implementation plan
+agent: planner
+---
+
+Create a detailed implementation plan for: $ARGUMENTS
+```
+
+### Skills
+
+**Claude Code:** Skills are loaded from `skills/*/SKILL.md` files.
+
+**OpenCode:** Skills are added to the `instructions` array:
+```json
+{
+  "instructions": [
+    "skills/tdd-workflow/SKILL.md",
+    "skills/security-review/SKILL.md",
+    "skills/coding-standards/SKILL.md"
+  ]
+}
+```
+
+### Rules
+
+**Claude Code:** Rules are in separate `rules/*.md` files.
+
+**OpenCode:** Rules can be consolidated into `instructions` or kept separate:
+```json
+{
+  "instructions": [
+    "instructions/INSTRUCTIONS.md",
+    "rules/common/security.md",
+    "rules/common/coding-style.md"
+  ]
+}
+```
+
+## Model Mapping
+
+| Claude Code | OpenCode |
+|-------------|----------|
+| `opus` | `anthropic/claude-opus-4-5` |
+| `sonnet` | `anthropic/claude-sonnet-4-5` |
+| `haiku` | `anthropic/claude-haiku-4-5` |
+
+## Available Commands
+
+After migration, ALL 23 commands are available:
+
+| Command | Description |
+|---------|-------------|
+| `/plan` | Create implementation plan |
+| `/tdd` | Enforce TDD workflow |
+| `/code-review` | Review code changes |
+| `/security` | Run security review |
+| `/build-fix` | Fix build errors |
+| `/e2e` | Generate E2E tests |
+| `/refactor-clean` | Remove dead code |
+| `/orchestrate` | Multi-agent workflow |
+| `/learn` | Extract patterns mid-session |
+| `/checkpoint` | Save verification state |
+| `/verify` | Run verification loop |
+| `/eval` | Run evaluation |
+| `/update-docs` | Update documentation |
+| `/update-codemaps` | Update codemaps |
+| `/test-coverage` | Check test coverage |
+| `/setup-pm` | Configure package manager |
+| `/go-review` | Go code review |
+| `/go-test` | Go TDD workflow |
+| `/go-build` | Fix Go build errors |
+| `/skill-create` | Generate skills from git history |
+| `/instinct-status` | View learned instincts |
+| `/instinct-import` | Import instincts |
+| `/instinct-export` | Export instincts |
+| `/evolve` | Cluster instincts into skills |
+| `/promote` | Promote project instincts to global scope |
+| `/projects` | List known projects and instinct stats |
+
+## Available Agents
+
+| Agent | Description |
+|-------|-------------|
+| `planner` | Implementation planning |
+| `architect` | System design |
+| `code-reviewer` | Code review |
+| `security-reviewer` | Security analysis |
+| `tdd-guide` | Test-driven development |
+| `build-error-resolver` | Fix build errors |
+| `e2e-runner` | E2E testing |
+| `doc-updater` | Documentation |
+| `refactor-cleaner` | Dead code cleanup |
+| `go-reviewer` | Go code review |
+| `go-build-resolver` | Go build errors |
+| `database-reviewer` | Database optimization |
+
+## Plugin Installation
+
+### Option 1: Use ECC Configuration Directly
+
+The `.opencode/` directory contains everything pre-configured.
+
+### Option 2: Install as npm Package
+
+```bash
+npm install ecc-universal
+```
+
+Then in your `opencode.json`:
+```json
+{
+  "plugin": ["ecc-universal"]
+}
+```
+
+This only loads the published ECC OpenCode plugin module (hooks/events and exported plugin tools).
+It does **not** automatically inject ECC's full `agent`, `command`, or `instructions` config into your project.
+
+If you want the full ECC OpenCode workflow surface, use the repository's bundled `.opencode/opencode.json` as your base config or copy these pieces into your project:
+- `.opencode/commands/`
+- `.opencode/prompts/`
+- `.opencode/instructions/INSTRUCTIONS.md`
+- the `agent` and `command` sections from `.opencode/opencode.json`
+
+## Troubleshooting
+
+### Configuration Not Loading
+
+1. Verify `.opencode/opencode.json` exists in the repository root
+2. Check JSON syntax is valid: `cat .opencode/opencode.json | jq .`
+3. Ensure all referenced prompt files exist
+
+### Plugin Not Loading
+
+1. Verify plugin file exists in `.opencode/plugins/`
+2. Check TypeScript syntax is valid
+3. Ensure `plugin` array in `opencode.json` includes the path
+
+### Agent Not Found
+
+1. Check the agent is defined in `opencode.json` under the `agent` object
+2. Verify the prompt file path is correct
+3. Ensure the prompt file exists at the specified path
+
+### Command Not Working
+
+1. Verify the command is defined in `opencode.json` or as `.md` file in `.opencode/commands/`
+2. Check the referenced agent exists
+3. Ensure the template uses `$ARGUMENTS` for user input
+4. If you installed only `plugin: ["ecc-universal"]`, note that npm plugin install does not auto-add ECC commands or agents to your project config
+
+## Best Practices
+
+1. **Start Fresh**: Don't try to run both Claude Code and OpenCode simultaneously
+2. **Check Configuration**: Verify `opencode.json` loads without errors
+3. **Test Commands**: Run each command once to verify it works
+4. **Use Plugins**: Leverage the plugin hooks for automation
+5. **Use Agents**: Leverage the specialized agents for their intended purposes
+
+## Reverting to Claude Code
+
+If you need to switch back:
+
+1. Simply run `claude` instead of `opencode`
+2. Claude Code will use its own configuration (`CLAUDE.md`, `plugin.json`, etc.)
+3. The `.opencode/` directory won't interfere with Claude Code
+
+## Feature Parity Summary
+
+| Feature | Claude Code | OpenCode | Status |
+|---------|-------------|----------|--------|
+| Agents | ✅ 12 agents | ✅ 12 agents | **Full parity** |
+| Commands | ✅ 23 commands | ✅ 23 commands | **Full parity** |
+| Skills | ✅ 16 skills | ✅ 16 skills | **Full parity** |
+| Hooks | ✅ 3 phases | ✅ 20+ events | **OpenCode has MORE** |
+| Rules | ✅ 8 rules | ✅ 8 rules | **Full parity** |
+| MCP Servers | ✅ Full | ✅ Full | **Full parity** |
+| Custom Tools | ✅ Via hooks | ✅ Native support | **OpenCode is better** |
+
+## Feedback
+
+For issues specific to:
+- **OpenCode CLI**: Report to OpenCode's issue tracker
+- **ECC Configuration**: Report to [github.com/affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)

package/.opencode/README.md

@@ -0,0 +1,204 @@
+# OpenCode ECC Plugin
+
+> ⚠️ This README is specific to OpenCode usage.  
+> If you installed ECC via npm (e.g. `npm install opencode-ecc`), refer to the root README instead.
+
+Everything Claude Code (ECC) plugin for OpenCode - agents, commands, hooks, and skills.
+
+## Installation
+
+## Installation Overview
+
+There are two ways to use Everything Claude Code (ECC):
+
+1. **npm package (recommended for most users)**  
+   Install via npm/bun/yarn and use the `ecc-install` CLI to set up rules and agents.
+
+2. **Direct clone / plugin mode**  
+   Clone the repository and run OpenCode directly inside it.
+
+Choose the method that matches your workflow below.
+
+### Option 1: npm Package
+
+```bash
+npm install ecc-universal
+```
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["ecc-universal"]
+}
+```
+
+This loads the ECC OpenCode plugin module from npm:
+- hook/event integrations
+- bundled custom tools exported by the plugin
+
+It does **not** auto-register the full ECC command/agent/instruction catalog in your project config. For the full OpenCode setup, either:
+- run OpenCode inside this repository, or
+- copy the relevant `.opencode/commands/`, `.opencode/prompts/`, `.opencode/instructions/`, and the `instructions`, `agent`, and `command` config entries into your own project
+
+After installation, the `ecc-install` CLI is also available:
+
+```bash
+npx ecc-install typescript
+```
+
+### Option 2: Direct Use
+
+Clone and run OpenCode in the repository:
+
+```bash
+git clone https://github.com/affaan-m/everything-claude-code
+cd everything-claude-code
+opencode
+```
+
+## Features
+
+### Agents (12)
+
+| Agent | Description |
+|-------|-------------|
+| planner | Implementation planning |
+| architect | System design |
+| code-reviewer | Code review |
+| security-reviewer | Security analysis |
+| tdd-guide | Test-driven development |
+| build-error-resolver | Build error fixes |
+| e2e-runner | E2E testing |
+| doc-updater | Documentation |
+| refactor-cleaner | Dead code cleanup |
+| go-reviewer | Go code review |
+| go-build-resolver | Go build errors |
+| database-reviewer | Database optimization |
+
+### Commands (31)
+
+| Command | Description |
+|---------|-------------|
+| `/plan` | Create implementation plan |
+| `/tdd` | TDD workflow |
+| `/code-review` | Review code changes |
+| `/security` | Security review |
+| `/build-fix` | Fix build errors |
+| `/e2e` | E2E tests |
+| `/refactor-clean` | Remove dead code |
+| `/orchestrate` | Multi-agent workflow |
+| `/learn` | Extract patterns |
+| `/checkpoint` | Save progress |
+| `/verify` | Verification loop |
+| `/eval` | Evaluation |
+| `/update-docs` | Update docs |
+| `/update-codemaps` | Update codemaps |
+| `/test-coverage` | Coverage analysis |
+| `/setup-pm` | Package manager |
+| `/go-review` | Go code review |
+| `/go-test` | Go TDD |
+| `/go-build` | Go build fix |
+| `/skill-create` | Generate skills |
+| `/instinct-status` | View instincts |
+| `/instinct-import` | Import instincts |
+| `/instinct-export` | Export instincts |
+| `/evolve` | Cluster instincts |
+| `/promote` | Promote project instincts |
+| `/projects` | List known projects |
+| `/harness-audit` | Audit harness reliability and eval readiness |
+| `/loop-start` | Start controlled agentic loops |
+| `/loop-status` | Check loop state and checkpoints |
+| `/quality-gate` | Run quality gates on file/repo scope |
+| `/model-route` | Route tasks by model and budget |
+
+### Plugin Hooks
+
+| Hook | Event | Purpose |
+|------|-------|---------|
+| Prettier | `file.edited` | Auto-format JS/TS |
+| TypeScript | `tool.execute.after` | Check for type errors |
+| console.log | `file.edited` | Warn about debug statements |
+| Notification | `session.idle` | Desktop notification |
+| Security | `tool.execute.before` | Check for secrets |
+
+### Custom Tools
+
+| Tool | Description |
+|------|-------------|
+| run-tests | Run test suite with options |
+| check-coverage | Analyze test coverage |
+| security-audit | Security vulnerability scan |
+
+## Hook Event Mapping
+
+OpenCode's plugin system maps to Claude Code hooks:
+
+| Claude Code | OpenCode |
+|-------------|----------|
+| PreToolUse | `tool.execute.before` |
+| PostToolUse | `tool.execute.after` |
+| Stop | `session.idle` |
+| SessionStart | `session.created` |
+| SessionEnd | `session.deleted` |
+
+OpenCode has 20+ additional events not available in Claude Code.
+
+### Hook Runtime Controls
+
+OpenCode plugin hooks honor the same runtime controls used by Claude Code/Cursor:
+
+```bash
+export ECC_HOOK_PROFILE=standard
+export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
+```
+
+- `ECC_HOOK_PROFILE`: `minimal`, `standard` (default), `strict`
+- `ECC_DISABLED_HOOKS`: comma-separated hook IDs to disable
+
+## Skills
+
+The default OpenCode config loads 11 curated ECC skills via the `instructions` array:
+
+- coding-standards
+- backend-patterns
+- frontend-patterns
+- frontend-slides
+- security-review
+- tdd-workflow
+- strategic-compact
+- eval-harness
+- verification-loop
+- api-design
+- e2e-testing
+
+Additional specialized skills are shipped in `skills/` but not loaded by default to keep OpenCode sessions lean:
+
+- article-writing
+- content-engine
+- market-research
+- investor-materials
+- investor-outreach
+
+## Configuration
+
+Full configuration in `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "anthropic/claude-sonnet-4-5",
+  "small_model": "anthropic/claude-haiku-4-5",
+  "plugin": ["./plugins"],
+  "instructions": [
+    "skills/tdd-workflow/SKILL.md",
+    "skills/security-review/SKILL.md"
+  ],
+  "agent": { /* 12 agents */ },
+  "command": { /* 24 commands */ }
+}
+```
+
+## License
+
+MIT

package/.opencode/commands/build-fix.md

@@ -0,0 +1,56 @@
+---
+description: Fix build and TypeScript errors with minimal changes
+agent: build-error-resolver
+subtask: true
+---
+
+# Build Fix Command
+
+Fix build and TypeScript errors with minimal changes: $ARGUMENTS
+
+## Your Task
+
+1. **Run type check**: `npx tsc --noEmit`
+2. **Collect all errors**
+3. **Fix errors one by one** with minimal changes
+4. **Verify each fix** doesn't introduce new errors
+5. **Run final check** to confirm all errors resolved
+
+## Approach
+
+### DO:
+- ✅ Fix type errors with correct types
+- ✅ Add missing imports
+- ✅ Fix syntax errors
+- ✅ Make minimal changes
+- ✅ Preserve existing behavior
+- ✅ Run `tsc --noEmit` after each change
+
+### DON'T:
+- ❌ Refactor code
+- ❌ Add new features
+- ❌ Change architecture
+- ❌ Use `any` type (unless absolutely necessary)
+- ❌ Add `@ts-ignore` comments
+- ❌ Change business logic
+
+## Common Error Fixes
+
+| Error | Fix |
+|-------|-----|
+| Type 'X' is not assignable to type 'Y' | Add correct type annotation |
+| Property 'X' does not exist | Add property to interface or fix property name |
+| Cannot find module 'X' | Install package or fix import path |
+| Argument of type 'X' is not assignable | Cast or fix function signature |
+| Object is possibly 'undefined' | Add null check or optional chaining |
+
+## Verification Steps
+
+After fixes:
+1. `npx tsc --noEmit` - should show 0 errors
+2. `npm run build` - should succeed
+3. `npm test` - tests should still pass
+
+---
+
+**IMPORTANT**: Focus on fixing errors only. No refactoring, no improvements, no architectural changes. Get the build green with minimal diff.

package/.opencode/commands/checkpoint.md

@@ -0,0 +1,67 @@
+---
+description: Save verification state and progress checkpoint
+agent: build
+---
+
+# Checkpoint Command
+
+Save current verification state and create progress checkpoint: $ARGUMENTS
+
+## Your Task
+
+Create a snapshot of current progress including:
+
+1. **Tests status** - Which tests pass/fail
+2. **Coverage** - Current coverage metrics
+3. **Build status** - Build succeeds or errors
+4. **Code changes** - Summary of modifications
+5. **Next steps** - What remains to be done
+
+## Checkpoint Format
+
+### Checkpoint: [Timestamp]
+
+**Tests**
+- Total: X
+- Passing: Y
+- Failing: Z
+- Coverage: XX%
+
+**Build**
+- Status: ✅ Passing / ❌ Failing
+- Errors: [if any]
+
+**Changes Since Last Checkpoint**
+```
+git diff --stat [last-checkpoint-commit]
+```
+
+**Completed Tasks**
+- [x] Task 1
+- [x] Task 2
+- [ ] Task 3 (in progress)
+
+**Blocking Issues**
+- [Issue description]
+
+**Next Steps**
+1. Step 1
+2. Step 2
+
+## Usage with Verification Loop
+
+Checkpoints integrate with the verification loop:
+
+```
+/plan → implement → /checkpoint → /verify → /checkpoint → implement → ...
+```
+
+Use checkpoints to:
+- Save state before risky changes
+- Track progress through phases
+- Enable rollback if needed
+- Document verification points
+
+---
+
+**TIP**: Create checkpoints at natural breakpoints: after each phase, before major refactoring, after fixing critical bugs.