opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "autoupdate": true,
  "default_agent": "build",
  "instructions": [
    "instructions/subagent-routing.md",
    "instructions/serena.md",
    "skills/socratic-design/SKILL.md",
    "skills/security-review/SKILL.md",
    "skills/coding-standards/SKILL.md",
    "skills/git-workflow/SKILL.md",
  ],
  "agent": {
    "build": {
      "description": "Primary coding agent for development work",
      "mode": "primary",
      "model": "{env:OPENCODE_MODEL_PRIMARY}",
      "prompt": "{file:./prompts/agents/build.txt}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true,
        "read": true,
        "task": true,
      },
      "permission": {
        "read": "allow",
        "edit": "allow",
        "bash": "allow",
        // OpenCode task permissions are last-match-wins; direct Task smoke tests verify these allows override the wildcard deny.
        // Keep this allowlist in sync when adding or renaming subagents.
        "task": {
          "*": "deny",
          "planner": "allow",
          "architect": "allow",
          "code-reviewer": "allow",
          "security-reviewer": "allow",
          "tdd-guide": "allow",
          "build-error-resolver": "allow",
          "e2e-runner": "allow",
          "doc-updater": "allow",
          "refactor-cleaner": "allow",
          "database-reviewer": "allow",
          "git-specialist": "allow",
        },
      },
    },
    "planner": {
      "description": "MUST delegate for complex feature planning, implementation plans, large refactors, or unclear execution order. Produces plans only.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_PLANNER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_PRIMARY}",
      "prompt": "{file:./prompts/agents/planner.txt}",
      "tools": {
        "read": true,
        "bash": true,
        "write": false,
        "edit": false,
      },
    },
    "architect": {
      "description": "MUST delegate for architecture, system design, scalability, cross-module boundaries, or high-impact technical decisions.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/architect.txt}",
      "tools": {
        "read": true,
        "bash": true,
        "write": false,
        "edit": false,
      },
    },
    "code-reviewer": {
      "description": "MUST delegate immediately after meaningful code changes. Reviews diffs for bugs, regressions, quality, maintainability, and tests.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/code-reviewer.txt}",
      "tools": {
        "read": true,
        "bash": true,
        "grep": true,
        "write": false,
        "edit": false,
      },
    },
    "security-reviewer": {
      "description": "MUST delegate for auth, user input, API endpoints, secrets, payments, PII, or sensitive data. Finds and may patch security issues.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/security-reviewer.txt}",
      "tools": {
        "read": true,
        "bash": true,
        "write": true,
        "edit": true,
        "grep": true,
        "glob": true,
      },
    },
    "tdd-guide": {
      "description": "MUST delegate for new features, bug fixes, or refactors that need tests. Enforces RED-GREEN-REFACTOR and 80%+ coverage.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/tdd-guide.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
      },
    },
    "build-error-resolver": {
      "description": "MUST delegate when build, typecheck, lint, or TypeScript errors occur. Fixes only those errors with minimal diffs.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/build-error-resolver.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
      },
    },
    "e2e-runner": {
      "description": "MUST delegate for browser automation, Playwright work, and critical user-flow E2E tests. Generates, runs, and reports artifacts.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "prompt": "{file:./prompts/agents/e2e-runner.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
      },
    },
    "doc-updater": {
      "description": "MUST delegate for documentation, README updates, architecture notes, and codemaps. Keeps docs aligned with code changes.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/doc-updater.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
      },
    },
    "refactor-cleaner": {
      "description": "MUST delegate for dead code, unused exports, duplication, and consolidation cleanup. Preserves behavior and verifies safety.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "reasoningEffort": "{env:OPENCODE_REASONING_SECONDARY}",
      "prompt": "{file:./prompts/agents/refactor-cleaner.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
      },
    },
    "database-reviewer": {
      "description": "MUST delegate for PostgreSQL, SQL, Supabase, RLS, migrations, schema design, query performance, or DB security.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_WORKER}",
      "prompt": "{file:./prompts/agents/database-reviewer.txt}",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
      },
    },
    "git-specialist": {
      "description": "MUST delegate for branch names, commits, staging, pushes, pull requests, and git hygiene. Performs git-only work safely.",
      "mode": "subagent",
      "model": "{env:OPENCODE_MODEL_SUBAGENT_MINI}",
      "reasoningEffort": "{env:OPENCODE_REASONING_TERTIARY}",
      "prompt": "{file:./prompts/agents/git-specialist.txt}",
      "tools": {
        "bash": true,
        "read": false,
        "write": false,
        "edit": false,
        "grep": false,
        "glob": false,
      },
    },
  },
  "command": {
    "git": {
      "description": "Handle git operations with enforced branch and commit conventions",
      "template": "{file:commands/git.md}\n\n$ARGUMENTS",
      "agent": "git-specialist",
      "subtask": true,
    },
    "push-changes": {
      "description": "Commit relevant changes and push through the git workflow",
      "template": "{file:commands/git.md}\n\nExecute this git task:\nCommit the relevant changes with a compliant conventional commit message and push the current branch to its remote. Before pushing, inspect every local commit that would be published: compare against the tracked upstream when one exists, otherwise compare against the branch point from the repository default branch and stop if unrelated committed work would also be published. If no upstream exists and the published commit set is correct, push with upstream tracking. If there is nothing to commit, do not create an empty commit. If hooks fail or the push is ambiguous, stop and report the blocker.\n\nAdditional context: $ARGUMENTS",
      "agent": "git-specialist",
      "subtask": true,
    },
    "plan": {
      "description": "Create a detailed implementation plan for complex features",
      "template": "{file:commands/plan.md}\n\n$ARGUMENTS",
      "agent": "planner",
      "subtask": true,
    },
    "tdd": {
      "description": "Enforce TDD workflow with 80%+ test coverage",
      "template": "{file:commands/tdd.md}\n\n$ARGUMENTS",
      "agent": "tdd-guide",
      "subtask": true,
    },
    "code-review": {
      "description": "Review code for quality, security, and maintainability",
      "template": "{file:commands/code-review.md}\n\n$ARGUMENTS",
      "agent": "code-reviewer",
      "subtask": true,
    },
    "security": {
      "description": "Run comprehensive security review",
      "template": "{file:commands/security.md}\n\n$ARGUMENTS",
      "agent": "security-reviewer",
      "subtask": true,
    },
    "build-fix": {
      "description": "Fix build and TypeScript errors with minimal changes",
      "template": "{file:commands/build-fix.md}\n\n$ARGUMENTS",
      "agent": "build-error-resolver",
      "subtask": true,
    },
    "e2e": {
      "description": "Generate and run E2E tests with Playwright",
      "template": "{file:commands/e2e.md}\n\n$ARGUMENTS",
      "agent": "e2e-runner",
      "subtask": true,
    },
    "refactor-clean": {
      "description": "Remove dead code and consolidate duplicates",
      "template": "{file:commands/refactor-clean.md}\n\n$ARGUMENTS",
      "agent": "refactor-cleaner",
      "subtask": true,
    },
    "orchestrate": {
      "description": "Orchestrate multiple agents for complex tasks",
      "template": "{file:commands/orchestrate.md}\n\n$ARGUMENTS",
      "agent": "planner",
      "subtask": true,
    },
    "learn": {
      "description": "Extract patterns and learnings from session",
      "template": "{file:commands/learn.md}\n\n$ARGUMENTS",
    },
    "checkpoint": {
      "description": "Save verification state and progress",
      "template": "{file:commands/checkpoint.md}\n\n$ARGUMENTS",
    },
    "verify": {
      "description": "Run verification loop",
      "template": "{file:commands/verify.md}\n\n$ARGUMENTS",
    },
    "eval": {
      "description": "Run evaluation against criteria",
      "template": "{file:commands/eval.md}\n\n$ARGUMENTS",
    },
    "update-docs": {
      "description": "Update documentation",
      "template": "{file:commands/update-docs.md}\n\n$ARGUMENTS",
      "agent": "doc-updater",
      "subtask": true,
    },
    "update-codemaps": {
      "description": "Update codemaps",
      "template": "{file:commands/update-codemaps.md}\n\n$ARGUMENTS",
      "agent": "doc-updater",
      "subtask": true,
    },
    "test-coverage": {
      "description": "Analyze test coverage",
      "template": "{file:commands/test-coverage.md}\n\n$ARGUMENTS",
      "agent": "tdd-guide",
      "subtask": true,
    },
    "setup-pm": {
      "description": "Configure package manager",
      "template": "{file:commands/setup-pm.md}\n\n$ARGUMENTS",
    },
    "skill-create": {
      "description": "Generate skills from git history",
      "template": "{file:commands/skill-create.md}\n\n$ARGUMENTS",
    },
    "instinct-status": {
      "description": "View learned instincts",
      "template": "{file:commands/instinct-status.md}\n\n$ARGUMENTS",
    },
    "instinct-import": {
      "description": "Import instincts",
      "template": "{file:commands/instinct-import.md}\n\n$ARGUMENTS",
    },
    "instinct-export": {
      "description": "Export instincts",
      "template": "{file:commands/instinct-export.md}\n\n$ARGUMENTS",
    },
    "evolve": {
      "description": "Cluster instincts into skills",
      "template": "{file:commands/evolve.md}\n\n$ARGUMENTS",
    },
  },
  "mcp": {
    "serena": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/oraios/serena",
        "serena",
        "start-mcp-server",
        "--open-web-dashboard",
        "false",
      ],
      "enabled": true,
    },
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp@latest"],
    },
    "wallaby": {
      "type": "local",
      "command": ["npx", "-y", "-c", "node ~/.wallaby/mcp/"],
    },
    "Figma": {
      "type": "remote",
      "url": "https://mcp.figma.com/mcp",
      "headers": {},
      "enabled": false,
    },
  },
  "plugin": ["@tarquinen/opencode-dcp@latest"],
}