plan-flow

Solid

Use when deep architecture review or convergence planning requires analyzing repository-level duplicate/redundant design first, then building and executing a strict step-test-update plan in docs/plan.

AI & Automation 204 stars 21 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
77
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Plan Flow ## Overview Use this skill when the user needs: - A complete analysis of duplicated/redundant design in a codebase. - A detailed TODO plan with explicit file-level steps. - Strict execution evidence: change one step, test it, then update plan status. This skill is repository-agnostic. It defines how to analyze and plan, not only what was done in one specific repo. ## Core Workflow (Analyze -> Plan -> Execute) 1. Establish scope and constraints. - Confirm target directories/modules and out-of-scope areas. - Capture compatibility requirement, risk tolerance, and testing expectations. - Record baseline (`git status --short`, current branch, known blockers). 2. Run structured redundancy analysis first. - Build an inventory of architecture anchors: - Domain models and schemas - Factory/registry entry points - HTTP/storage/cache/logging abstractions - Route/service/provider adapters - Identify duplicate/redundant candidates with evidence: - Same concept, multiple conflicting definitions - Same responsibility, parallel implementations - Exported but unconnected modules - Dead/legacy paths still affecting readability - For each finding, record: - Exact files and symbols - Call path or usage evidence - Risk if changed - See `references/analysis-playbook.md`. 3. Prioritize and convert analysis into executable plan. - Score each finding by impact/effort/risk/confidence. - Group into phases (`P0`, `P1`, `P2`) and sequence low-risk/high-signal step...

Details

Author
majiayu000
Repository
majiayu000/spellbook
Created
6 months ago
Last Updated
2 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category