nw-mikado-method

Featured

Enhanced Mikado Method for complex architectural refactoring - systematic dependency discovery, tree-based planning, and bottom-up execution

AI & Automation 636 stars 68 forks Updated today MIT

Install

View on GitHub

Quality Score: 95/100

Stars 20%
93
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Mikado Method Use for complex refactoring where direct implementation causes cascading failures across multiple classes/modules. ## When to Use - Refactoring goal affects multiple classes/modules | Direct implementation causes cascade of failures - Dependencies not immediately clear | High risk of breaking existing functionality ## Core Process Cycle: Set Goal > Experiment > Visualize prerequisites > Revert to working state. Treat compilation/test failures as valuable information -- each failure reveals a prerequisite node in the dependency graph. Revert keeps codebase shippable at all times. ## Discovery-Tracking Protocol Commit immediately after each dependency discovery to preserve exploration history and enable interrupt/resume. ### Commit Formats - Dependency: `Discovery: [Class.Method(params)] requires [Prerequisite] in [File:Line]` - False leaf: `Discovery: False leaf - [Node] blocked by [Dependency]` - Exploration complete: `Discovery: No new dependencies found - exploration complete for [GoalArea]` - Ready: `Ready: True leaves identified - [Count] leaves ready for execution` ## Exhaustive Exploration Algorithm Sequence: EXPERIMENT > LEARN > GRAPH > COMMIT GRAPH > REVERT 1. **Experiment**: Attempt naive implementation of stated goal 2. **Learn**: Capture ALL compilation and test failures immediately 3. **Graph**: Create concrete prerequisite nodes with exact specifications 4. **Commit Graph**: Commit discovery with mandatory format 5. **Revert**: Revert A...

Details

Author
nWave-ai
Repository
nWave-ai/nWave
Created
9 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category