nwave-ai/nw-mikado
nWave/skills/nw-mikado/SKILL.md
[EXPERIMENTAL] Complex refactoring roadmaps with visual tracking
$ install --global
skillsauthnpx skillsauth add nwave-ai/nwave nw-mikadoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 9, 2026, 2:43 AM6.2s1 file scanned
SKILL.md
- name:
- nw-mikado
- description:
- [EXPERIMENTAL] Complex refactoring roadmaps with visual tracking
- user-invocable:
- true
- argument-hint:
- [refactoring-goal] - Optional: --complexity=[simple|moderate|complex] --visualization=[tree|graph]
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
Related Skills
nwave-ai/nw-fp-scala
testing
VerifiedTrustedCommunity
Scala 3 language-specific patterns with ZIO, Cats Effect, and opaque types
602SKILL.mdUpdated Apr 16, 2026
nwave-ai/nw-fp-kotlin
testing
VerifiedTrustedCommunity
Kotlin language-specific patterns with Arrow, Raise DSL, and coroutine-based effects
602SKILL.mdUpdated Apr 16, 2026
nwave-ai/nw-fp-haskell
testing
VerifiedTrustedCommunity
Haskell language-specific patterns, GADTs, type classes, and effect systems
602SKILL.mdUpdated Apr 16, 2026
nwave-ai/nw-fp-fsharp
testing
VerifiedTrustedCommunity
F# language-specific patterns, Railway-Oriented Programming, and Computation Expressions
602SKILL.mdUpdated Apr 16, 2026