nw-mikado

Plan and execute refactoring projects using the Mikado Method.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/StudentCristian/nWave-github --skill nw-mikado
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nw-mikado
Source: https://github.com/StudentCristian/nWave-github/tree/main/.github/skills/nw-mikado
Command: npx skills add https://github.com/StudentCristian/nWave-github --skill nw-mikado

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Facilitates planning and execution of large-scale refactors by visualizing dependencies and guiding bottom-up implementation via the Mikado Method.

Core Features & Use Cases

  • Mikado planning: visually map dependencies and identify leaf tasks to implement bottom-up.
  • Iterative discovery: track exploration commits as work progresses toward the goal.
  • Proof of progress: generate lightweight documentation in docs/mikado for each goal.

Quick Start

Start a Mikado planning session by running *mikado for your refactoring goal.

Frequently Asked Questions about nw-mikado

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a complex refactoring project across multiple services?

Plan complex refactoring projects by applying the Mikado Method to visualize dependencies and guide bottom-up leaf-node implementation. It generates a visualization file in docs/mikado to track iterative discovery commits and verify tests.

What is the Mikado Method for architectural changes?

The Mikado Method is a technique for architectural changes that visually maps dependencies to identify leaf tasks. You implement these bottom-up tasks iteratively, recording exploration commits until the refactoring goal is fully satisfied.

How do I visualize code dependencies before starting a large refactor?

You visualize code dependencies by generating a lightweight markdown file in docs/mikado for each refactoring goal. This visualization tracks progress and records iterative discovery commits as you work toward the finished goal.

Can I use this for refactoring spanning multiple classes?

Yes, this approach specifically guides architectural changes spanning multiple classes or services. It applies bottom-up leaf-node implementation and iterative discovery to manage complex multi-class refactoring workflows effectively.

What's the best way to track progress during an iterative codebase refactor?

Track iterative refactoring progress by recording discovery commits and generating a dedicated visualization document under docs/mikado. This provides proof of progress and ensures verified tests accompany the finished goal.

When should I use bottom-up implementation for software refactoring?

Use bottom-up implementation when planning complex refactors with deep dependencies. The Mikado Method helps you identify and implement leaf nodes first, iteratively discovering requirements and recording commits until the overarching architectural goal is met.