Summary

micode is an OpenCode plugin that enforces a structured Brainstorm → Plan → Implement workflow for code generation and project documentation. It targets developers seeking an opinionated, TDD-driven approach with session continuity, aiming to streamline development and maintain context across sessions.

How It Works

The plugin orchestrates a multi-agent system through a defined workflow. It begins with a brainstormer agent for design exploration, followed by a planner agent that translates designs into granular, TDD-focused implementation tasks. An executor agent then manages the implementer and reviewer agents within isolated git worktrees, leveraging parallel execution and a "fire-and-check" pattern for continuous verification. Session continuity is maintained via a structured ledger system.

Quick Start & Requirements

To integrate micode, add "micode" to the plugin array in ~/.config/opencode/opencode.json. Running the /init command generates initial project documentation (ARCHITECTURE.md, CODE_STYLE.md). For micode-specific settings (e.g., agent models, compaction thresholds), create ~/.config/opencode/micode.json. The plugin relies on the opencode framework and specified LLM models (e.g., github-copilot/gpt-5-mini, openai/gpt-4o).

Highlighted Details

• Opinionated Workflow: Enforces a strict Brainstorm → Plan → Implement sequence.
• Session Continuity: Maintains context across development sessions using a ledger system that summarizes past work.
• Parallelism & TDD: Executes up to 10-20 granular micro-tasks concurrently, strictly adhering to a Test-Driven Development methodology.
• Agent System: Utilizes specialized agents like commander, brainstormer, planner, executor, implementer, and reviewer, supported by tools like AST-aware search/replace and PTY interaction.
• Hooks: Features include "Think Mode" with large token budgets, automatic context compaction, and artifact auto-indexing.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap were provided in the README.

Licensing & Compatibility

The license type and any associated restrictions for micode are not explicitly stated in the provided README. This requires further investigation for commercial use or integration into closed-source projects.

Limitations & Caveats

micode is an opinionated plugin, offering less flexibility than more general frameworks. Its functionality is tightly coupled to the opencode ecosystem. The absence of explicit licensing information presents a significant adoption blocker for many organizations.