Skip to content

nWave-ai/nWave / nWave/skills/nw-mikado

nw-mikado

Verified

[EXPERIMENTAL] Complex refactoring roadmaps with visual tracking

Code facts — resolve structural facts about code through code-fact CLI (vendor-neutral, bundled adapters: AST then TextSearch). Degrade LOUD. Never ad-hoc grep. Example: code-fact query.callers-of SYMBOL --root ROOT.

NW-MIKADO: Complex Refactoring with Mikado Method

EXPERIMENTAL: Under active development. Behavior and output format may change between versions.

Wave: CROSS_WAVE Agent: Crafty (nw-software-crafter) Command: *mikado

Overview

Plan and execute complex refactoring using the Mikado Method. Builds dependency {visualization} through iterative exploration|tracks discoveries via commits|executes leaf-to-goal bottom-up. For architectural changes spanning multiple classes where simple refactoring is insufficient.

Context Files Required

  • src/* - Codebase to refactor
  • docs/product/architecture/brief.md - Target architecture (if available)

Agent Invocation

@nw-software-crafter

Execute *mikado for {refactoring-goal}.

Context Files:

  • src/*
  • docs/product/architecture/brief.md

Configuration:

  • refactoring_goal: "{goal description with business value}"
  • complexity: complex # simple/moderate/complex
  • visualization: {tree|graph} # tree = indented markdown checklist, graph = Mermaid dependency diagram

Success Criteria

  • Mikado {visualization} persisted at docs/mikado/{goal-name}.mikado.md
  • Discovery commits capture each exploration attempt
  • All leaf nodes implemented bottom-up
  • Goal node achieved with all tests passing
  • {visualization_label} stable (no new dependencies emerging)

Visualization labels: tree → "Tree", graph → "Graph". Use the selected visualization type in all output messages (e.g., "Wrote the Mikado tree" or "Wrote the Mikado graph").

Next Wave

Handoff To: {invoking-agent-returns-to-workflow} Deliverables: Refactored codebase + Mikado {visualization} documentation

Examples

Example 1: Extract shared domain model

/nw-mikado "Extract shared domain model from monolithic service layer"

Crafty builds Mikado dependency {visualization} through iterative exploration, discovers 12 leaf nodes across 4 modules, executes bottom-up from leaves to goal with discovery commits at each step.

Expected Outputs

docs/mikado/{goal-name}.mikado.md
src/*                                (refactored implementation)
Discovery-tracking commits in git log
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall