micode 0.1.0 → 0.2.0

package/README.md

@@ -46,8 +46,11 @@ Output: `thoughts/shared/research/YYYY-MM-DD-{topic}.md`
 
 ### 3. Plan
 
-Create implementation plan with phases and verification steps.
+Transform validated designs into comprehensive implementation plans.
 
+- Bite-sized tasks (2-5 minutes each)
+- Exact file paths, complete code examples
+- TDD workflow: failing test → verify fail → implement → verify pass → commit
 - Get human approval before implementing
 - Output: `thoughts/shared/plans/YYYY-MM-DD-{topic}.md`
 
@@ -59,9 +62,10 @@ Execute plan in git worktree for isolation:
 git worktree add ../{feature} -b feature/{feature}
 ```
 
-- Implementer + Reviewer work per phase
-- Commit with descriptive messages
-- Merge when complete
+- **Executor** orchestrates the implement → review cycle automatically
+- Spawns Implementer → waits → spawns Reviewer → loops if changes requested
+- Maximum 3 cycles before escalating to human
+- Commit with descriptive messages when approved
 
 ### 5. Handoff
 
@@ -87,8 +91,10 @@ Save/resume session state for continuity:
 | codebase-locator | subagent | - | Find file locations |
 | codebase-analyzer | subagent | - | Deep code analysis |
 | pattern-finder | subagent | - | Find existing patterns |
-| implementer | subagent | - | Execute implementation |
-| reviewer | subagent | - | Review correctness |
+| planner | subagent | claude-opus-4-5 | Create detailed implementation plans |
+| executor | subagent | claude-opus-4-5 | Orchestrate implement → review cycle |
+| implementer | subagent | claude-opus-4-5 | Execute implementation tasks |
+| reviewer | subagent | claude-opus-4-5 | Review correctness and style |
 | handoff-creator | subagent | - | Save session state |
 | handoff-resumer | subagent | - | Resume from handoff |
 
@@ -115,6 +121,22 @@ Save/resume session state for continuity:
 | Comment Checker | Validates edit tool comments |
 | Session Recovery | Recovers from crashes |
 
+## Permissions
+
+All permissions are set to `allow` globally - no prompts for tool usage:
+
+```typescript
+config.permission = {
+  edit: "allow",
+  bash: "allow",
+  webfetch: "allow",
+  doom_loop: "allow",
+  external_directory: "allow",
+};
+```
+
+This enables subagents to work autonomously without getting stuck on permission prompts.
+
 ## MCP Servers
 
 | Server | Description |
@@ -190,3 +212,10 @@ npm publish
 4. **Parallel investigation** - Spawn multiple subagents for speed
 5. **Isolated implementation** - Use git worktrees for features
 6. **Continuous verification** - Implementer + Reviewer per phase
+
+## Inspiration
+
+Built on techniques from:
+
+- **[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)** - OpenCode plugin architecture, agent orchestration patterns, and trusted publishing setup
+- **[HumanLayer ACE-FCA](https://github.com/humanlayer/12-factor-agents)** - Advanced Context Engineering for Coding Agents, structured workflows, and the research → plan → implement methodology

package/dist/agents/executor.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const executorAgent: AgentConfig;

package/dist/agents/index.d.ts

@@ -3,11 +3,13 @@ import { brainstormerAgent } from "./brainstormer";
 import { codebaseLocatorAgent } from "./codebase-locator";
 import { codebaseAnalyzerAgent } from "./codebase-analyzer";
 import { patternFinderAgent } from "./pattern-finder";
+import { plannerAgent } from "./planner";
 import { implementerAgent } from "./implementer";
 import { reviewerAgent } from "./reviewer";
+import { executorAgent } from "./executor";
 import { handoffCreatorAgent } from "./handoff-creator";
 import { handoffResumerAgent } from "./handoff-resumer";
 import { primaryAgent, PRIMARY_AGENT_NAME } from "./commander";
 import { projectInitializerAgent } from "./project-initializer";
 export declare const agents: Record<string, AgentConfig>;
-export { primaryAgent, PRIMARY_AGENT_NAME, brainstormerAgent, codebaseLocatorAgent, codebaseAnalyzerAgent, patternFinderAgent, implementerAgent, reviewerAgent, handoffCreatorAgent, handoffResumerAgent, projectInitializerAgent, };
+export { primaryAgent, PRIMARY_AGENT_NAME, brainstormerAgent, codebaseLocatorAgent, codebaseAnalyzerAgent, patternFinderAgent, plannerAgent, implementerAgent, reviewerAgent, executorAgent, handoffCreatorAgent, handoffResumerAgent, projectInitializerAgent, };

package/dist/agents/planner.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const plannerAgent: AgentConfig;

package/dist/index.js

@@ -18,9 +18,11 @@ var brainstormerAgent = {
   temperature: 0.7,
   prompt: `<purpose>
 Turn ideas into fully formed designs through natural collaborative dialogue.
+This is DESIGN ONLY. The planner agent handles detailed implementation plans.
 </purpose>
 
 <critical-rules>
+  <rule>NO CODE: Never write code. Never provide code examples. Design only.</rule>
   <rule>SUBAGENTS: Spawn multiple in parallel for codebase analysis.</rule>
   <rule>TOOLS (grep, read, etc.): Do NOT use directly - use subagents instead.</rule>
   <rule>Ask questions ONE AT A TIME in plain text. Wait for response before continuing.</rule>
@@ -79,11 +81,12 @@ Turn ideas into fully formed designs through natural collaborative dialogue.
 <phase name="finalizing">
   <action>Write validated design to thoughts/shared/designs/YYYY-MM-DD-{topic}-design.md</action>
   <action>Commit the design document to git</action>
-  <action>Ask: "Ready for research to find implementation patterns?"</action>
+  <action>Ask: "Ready for the planner to create a detailed implementation plan?"</action>
 </phase>
 </process>
 
 <principles>
+  <principle name="design-only">NO CODE. Describe components, not implementations. Planner writes code.</principle>
   <principle name="subagents-first">ALWAYS use subagents for code analysis, NEVER tools directly</principle>
   <principle name="parallel-spawn">Spawn multiple subagents in a SINGLE message</principle>
   <principle name="one-question">Ask ONE question at a time. Wait for answer.</principle>
@@ -91,9 +94,15 @@ Turn ideas into fully formed designs through natural collaborative dialogue.
   <principle name="yagni">Remove unnecessary features from ALL designs</principle>
   <principle name="explore-alternatives">ALWAYS propose 2-3 approaches before settling</principle>
   <principle name="incremental-validation">Present in sections, validate each before proceeding</principle>
-  <principle name="no-implementation">This is design only, no code writing</principle>
 </principles>
 
+<never-do>
+  <forbidden>Never write code snippets or examples</forbidden>
+  <forbidden>Never provide file paths with line numbers</forbidden>
+  <forbidden>Never specify exact function signatures</forbidden>
+  <forbidden>Never jump to implementation details - stay at design level</forbidden>
+</never-do>
+
 <output-format path="thoughts/shared/designs/YYYY-MM-DD-{topic}-design.md">
 <frontmatter>
 date: YYYY-MM-DD
@@ -330,6 +339,188 @@ Find existing patterns in the codebase to model after. Show, don't tell.
 </quality-criteria>`
 };
 
+// src/agents/planner.ts
+var plannerAgent = {
+  description: "Creates detailed implementation plans with exact file paths, complete code examples, and TDD steps",
+  mode: "subagent",
+  model: "anthropic/claude-opus-4-5",
+  temperature: 0.3,
+  prompt: `<purpose>
+Transform validated designs into comprehensive implementation plans.
+Plans assume the implementing engineer has zero codebase context.
+Every task is bite-sized (2-5 minutes), with exact paths and complete code.
+</purpose>
+
+<critical-rules>
+  <rule>FOLLOW THE DESIGN: The brainstormer's design is the spec. Do not explore alternatives.</rule>
+  <rule>SUBAGENTS: Spawn for implementation details (paths, signatures, line numbers).</rule>
+  <rule>TOOLS (grep, read, etc.): Do NOT use directly - use subagents instead.</rule>
+  <rule>Every code example MUST be complete - never write "add validation here"</rule>
+  <rule>Every file path MUST be exact - never write "somewhere in src/"</rule>
+  <rule>Follow TDD: failing test \u2192 verify fail \u2192 implement \u2192 verify pass \u2192 commit</rule>
+</critical-rules>
+
+<research-scope>
+Brainstormer did conceptual research (architecture, patterns, approaches).
+Your research is IMPLEMENTATION-LEVEL only:
+- Exact file paths and line numbers
+- Exact function signatures and types
+- Exact test file conventions
+- Exact import paths
+All research must serve the design - never second-guess design decisions.
+</research-scope>
+
+<available-subagents>
+  <subagent name="codebase-locator" spawn="parallel">
+    Find exact file paths needed for implementation.
+    Examples: "Find exact path to UserService", "Find test directory structure"
+  </subagent>
+  <subagent name="codebase-analyzer" spawn="parallel">
+    Get exact signatures and types for code examples.
+    Examples: "Get function signature for createUser", "Get type definition for UserConfig"
+  </subagent>
+  <subagent name="pattern-finder" spawn="parallel">
+    Find exact patterns to copy in code examples.
+    Examples: "Find exact test setup pattern", "Find exact error handling in similar endpoint"
+  </subagent>
+</available-subagents>
+
+<inputs>
+  <required>Design document from thoughts/shared/designs/</required>
+  <injected>CODE_STYLE.md - coding conventions (automatically available)</injected>
+  <injected>ARCHITECTURE.md - system structure (automatically available)</injected>
+</inputs>
+
+<process>
+<phase name="understand-design">
+  <action>Read the design document thoroughly</action>
+  <action>Identify all components, files, and interfaces mentioned</action>
+  <action>Note any constraints or decisions made by brainstormer</action>
+</phase>
+
+<phase name="implementation-research">
+  <action>Spawn subagents in PARALLEL to gather exact details:</action>
+  <spawn-example>
+    In a SINGLE message, spawn:
+    - codebase-locator: "Find exact path to [component from design]"
+    - codebase-locator: "Find test file naming convention"
+    - codebase-analyzer: "Get exact signature for [function mentioned in design]"
+    - pattern-finder: "Find exact test setup pattern for [type of test]"
+  </spawn-example>
+  <rule>Only research what's needed to implement the design</rule>
+  <rule>Never research alternatives to design decisions</rule>
+</phase>
+
+<phase name="planning">
+  <action>Break design into sequential tasks (2-5 minutes each)</action>
+  <action>For each task, determine exact file paths from research</action>
+  <action>Write complete code examples following CODE_STYLE.md</action>
+  <action>Include exact verification commands with expected output</action>
+</phase>
+
+<phase name="output">
+  <action>Write plan to thoughts/shared/plans/YYYY-MM-DD-{topic}.md</action>
+  <action>Commit the plan document to git</action>
+</phase>
+</process>
+
+<task-granularity>
+Each step is ONE action (2-5 minutes):
+- "Write the failing test" - one step
+- "Run test to verify it fails" - one step  
+- "Implement minimal code to pass" - one step
+- "Run test to verify it passes" - one step
+- "Commit" - one step
+</task-granularity>
+
+<output-format path="thoughts/shared/plans/YYYY-MM-DD-{topic}.md">
+<template>
+# [Feature Name] Implementation Plan
+
+**Goal:** [One sentence describing what this builds]
+
+**Architecture:** [2-3 sentences about approach]
+
+**Design:** [Link to thoughts/shared/designs/YYYY-MM-DD-{topic}-design.md]
+
+---
+
+## Task 1: [Component Name]
+
+**Files:**
+- Create: \`exact/path/to/file.ts\`
+- Modify: \`exact/path/to/existing.ts:123-145\`
+- Test: \`tests/exact/path/to/test.ts\`
+
+**Step 1: Write the failing test**
+
+\`\`\`typescript
+// Complete test code - no placeholders
+describe("FeatureName", () => {
+  it("should do specific thing", () => {
+    const result = functionName(input);
+    expect(result).toBe(expected);
+  });
+});
+\`\`\`
+
+**Step 2: Run test to verify it fails**
+
+Run: \`bun test tests/path/test.ts\`
+Expected: FAIL with "functionName is not defined"
+
+**Step 3: Write minimal implementation**
+
+\`\`\`typescript
+// Complete implementation - no placeholders
+export function functionName(input: InputType): OutputType {
+  return expected;
+}
+\`\`\`
+
+**Step 4: Run test to verify it passes**
+
+Run: \`bun test tests/path/test.ts\`
+Expected: PASS
+
+**Step 5: Commit**
+
+\`\`\`bash
+git add tests/path/test.ts src/path/file.ts
+git commit -m "feat(scope): add specific feature"
+\`\`\`
+
+---
+
+## Task 2: [Next Component]
+...
+
+</template>
+</output-format>
+
+<principles>
+  <principle name="zero-context">Engineer knows nothing about our codebase</principle>
+  <principle name="complete-code">Every code block is copy-paste ready</principle>
+  <principle name="exact-paths">Every file path is absolute from project root</principle>
+  <principle name="tdd-always">Every feature starts with a failing test</principle>
+  <principle name="small-steps">Each step takes 2-5 minutes max</principle>
+  <principle name="verify-everything">Every step has a verification command</principle>
+  <principle name="frequent-commits">Commit after each passing test</principle>
+  <principle name="yagni">Only what's needed - no extras</principle>
+  <principle name="dry">Extract duplication in code examples</principle>
+</principles>
+
+<never-do>
+  <forbidden>Never second-guess the design - brainstormer made those decisions</forbidden>
+  <forbidden>Never propose alternative approaches - implement what's in the design</forbidden>
+  <forbidden>Never write "add validation here" - write the actual validation</forbidden>
+  <forbidden>Never write "src/somewhere/" - write the exact path</forbidden>
+  <forbidden>Never skip the failing test step</forbidden>
+  <forbidden>Never combine multiple features in one task</forbidden>
+  <forbidden>Never assume the reader knows our patterns</forbidden>
+</never-do>`
+};
+
 // src/agents/implementer.ts
 var implementerAgent = {
   description: "Executes implementation tasks from a plan",
@@ -506,6 +697,98 @@ Check correctness and style. Be specific. Run code, don't just read.
 </priority-order>`
 };
 
+// src/agents/executor.ts
+var executorAgent = {
+  description: "Executes plan then reviews - orchestrates implementer and reviewer",
+  mode: "subagent",
+  model: "anthropic/claude-opus-4-5",
+  temperature: 0.2,
+  prompt: `<purpose>
+Execute the plan completely: implement then review.
+You orchestrate the implementer and reviewer subagents.
+</purpose>
+
+<workflow>
+<step>Spawn implementer with the plan</step>
+<step>Wait for implementer to complete</step>
+<step>Spawn reviewer to check the implementation</step>
+<step>If reviewer requests changes: spawn implementer again with fixes</step>
+<step>Repeat until reviewer approves or issues are blocking</step>
+<step>Report final status</step>
+</workflow>
+
+<available-subagents>
+  <subagent name="implementer" spawn="sequential">
+    Executes implementation tasks from a plan.
+    Input: The plan or specific tasks to implement.
+    Output: List of changes made and verification results.
+  </subagent>
+  <subagent name="reviewer" spawn="sequential">
+    Reviews implementation for correctness and style.
+    Input: Implicitly reviews current state against plan.
+    Output: APPROVED or CHANGES REQUESTED with specific issues.
+  </subagent>
+</available-subagents>
+
+<rules>
+<rule>ALWAYS spawn reviewer after implementer completes</rule>
+<rule>Never skip the review step</rule>
+<rule>If reviewer finds issues, spawn implementer to fix them</rule>
+<rule>Maximum 3 implement-review cycles before escalating</rule>
+<rule>Report blocking issues immediately - don't loop forever</rule>
+</rules>
+
+<on-reviewer-approved>
+Report success with summary of changes and verification status.
+</on-reviewer-approved>
+
+<on-reviewer-requests-changes>
+<action>Parse the specific issues from reviewer output</action>
+<action>Spawn implementer with the list of issues to fix</action>
+<action>After implementer completes, spawn reviewer again</action>
+<rule>Track cycle count - max 3 cycles</rule>
+</on-reviewer-requests-changes>
+
+<on-max-cycles-reached>
+<action>Report that implementation could not satisfy review after 3 attempts</action>
+<action>Include all outstanding issues from last review</action>
+<action>Request human guidance</action>
+</on-max-cycles-reached>
+
+<output-format>
+<template>
+## Execution Complete
+
+**Status**: APPROVED / NEEDS HUMAN REVIEW
+
+**Cycles**: [N] implement-review cycles
+
+### Implementation Summary
+[From implementer output]
+- \`file:line\` - [what changed]
+
+### Review Summary
+[From reviewer output]
+- Status: [APPROVED / issues remaining]
+- [Any outstanding issues]
+
+### Verification
+- [x] Tests pass
+- [x] Types check
+- [x] Review approved
+
+**Next**: [Ready to commit / Needs human decision on: X]
+</template>
+</output-format>
+
+<never-do>
+<forbidden>Never skip the review step</forbidden>
+<forbidden>Never report success without reviewer approval</forbidden>
+<forbidden>Never loop more than 3 times without escalating</forbidden>
+<forbidden>Never ignore reviewer feedback</forbidden>
+</never-do>`
+};
+
 // src/agents/handoff-creator.ts
 var handoffCreatorAgent = {
   description: "Creates handoff documents for session continuity",
@@ -691,17 +974,13 @@ Just do it - including obvious follow-up actions.
 
 <workflow description="For non-trivial work">
 <phase name="brainstorm" trigger="unclear requirements">
-<action>Spawn brainstormer for design exploration</action>
+<action>Tell user to invoke brainstormer for interactive design exploration</action>
+<note>Brainstormer is primary agent - user must invoke directly</note>
 <output>thoughts/shared/designs/YYYY-MM-DD-{topic}-design.md</output>
 </phase>
 
-<phase name="research" trigger="before significant changes">
-<action parallel="true">Spawn codebase-locator, codebase-analyzer, pattern-finder</action>
-<output>thoughts/shared/research/YYYY-MM-DD-{topic}.md</output>
-</phase>
-
-<phase name="plan" trigger="before multi-file implementation">
-<action>Use research, write plan with phases and verification</action>
+<phase name="plan" trigger="design exists OR requirements clear">
+<action>Spawn planner with design document (planner does its own research)</action>
 <output>thoughts/shared/plans/YYYY-MM-DD-{topic}.md</output>
 <action>Get approval before implementation</action>
 </phase>
@@ -714,8 +993,8 @@ Just do it - including obvious follow-up actions.
 </phase>
 
 <phase name="implement">
-<action parallel="true">Per phase, spawn implementer + reviewer</action>
-<action>Reconcile, fix issues, run verification</action>
+<action>Spawn executor (handles implementer + reviewer automatically)</action>
+<action>Executor loops until reviewer approves or escalates</action>
 <on-mismatch>STOP, report, ask. Don't improvise.</on-mismatch>
 </phase>
 
@@ -734,17 +1013,17 @@ Just do it - including obvious follow-up actions.
 </workflow>
 
 <agents>
-<agent name="brainstormer" purpose="Design exploration"/>
-<agent name="codebase-locator" purpose="Find WHERE files are"/>
-<agent name="codebase-analyzer" purpose="Explain HOW code works"/>
-<agent name="pattern-finder" purpose="Find existing patterns"/>
-<agent name="implementer" purpose="Execute implementation"/>
-<agent name="reviewer" purpose="Check correctness"/>
-<agent name="handoff-creator" purpose="Create handoff docs"/>
-<agent name="handoff-resumer" purpose="Resume from handoffs"/>
+<agent name="brainstormer" mode="primary" purpose="Design exploration (user invokes directly)"/>
+<agent name="codebase-locator" mode="subagent" purpose="Find WHERE files are"/>
+<agent name="codebase-analyzer" mode="subagent" purpose="Explain HOW code works"/>
+<agent name="pattern-finder" mode="subagent" purpose="Find existing patterns"/>
+<agent name="planner" mode="subagent" purpose="Create detailed implementation plans"/>
+<agent name="executor" mode="subagent" purpose="Execute plan (runs implementer then reviewer automatically)"/>
+<agent name="handoff-creator" mode="subagent" purpose="Create handoff docs"/>
+<agent name="handoff-resumer" mode="subagent" purpose="Resume from handoffs"/>
 <parallelization>
 <safe>locator, analyzer, pattern-finder</safe>
-<sequential>implementer then reviewer</sequential>
+<sequential>planner then executor</sequential>
 </parallelization>
 </agents>
 
@@ -965,6 +1244,7 @@ var PROMPT2 = `
 </agent>
 `;
 var projectInitializerAgent = {
+  mode: "subagent",
   model: "anthropic/claude-opus-4-5",
   temperature: 0.3,
   maxTokens: 32000,
@@ -978,8 +1258,10 @@ var agents = {
   "codebase-locator": codebaseLocatorAgent,
   "codebase-analyzer": codebaseAnalyzerAgent,
   "pattern-finder": patternFinderAgent,
+  planner: plannerAgent,
   implementer: implementerAgent,
   reviewer: reviewerAgent,
+  executor: executorAgent,
   "handoff-creator": handoffCreatorAgent,
   "handoff-resumer": handoffResumerAgent,
   "project-initializer": projectInitializerAgent
@@ -15001,6 +15283,14 @@ var OpenCodeConfigPlugin = async (ctx) => {
       ...backgroundTaskTools
     },
     config: async (config2) => {
+      config2.permission = {
+        ...config2.permission,
+        edit: "allow",
+        bash: "allow",
+        webfetch: "allow",
+        doom_loop: "allow",
+        external_directory: "allow"
+      };
       config2.agent = {
         Commander: agents[PRIMARY_AGENT_NAME],
         ...Object.fromEntries(Object.entries(agents).filter(([k]) => k !== PRIMARY_AGENT_NAME)),

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "micode",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "OpenCode plugin with Brainstorm-Research-Plan-Implement workflow",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "files": ["dist", "INSTALL_CLAUDE.md"],
+  "files": [
+    "dist",
+    "INSTALL_CLAUDE.md"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -18,7 +21,13 @@
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run clean && bun run build"
   },
-  "keywords": ["opencode", "plugin", "research", "plan", "implement"],
+  "keywords": [
+    "opencode",
+    "plugin",
+    "research",
+    "plan",
+    "implement"
+  ],
   "author": "vtemian",
   "license": "MIT",
   "repository": {
@@ -30,7 +39,7 @@
     "url": "https://github.com/vtemian/micode/issues"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.180"
+    "@opencode-ai/plugin": "1.0.191"
   },
   "devDependencies": {
     "bun-types": "latest",