discipline-refactor

Reorganize any repository by discipline/domain with module-based structure. Code in src/<pkg>/modules/, documents in <folder>/modules/. Orchestrates Explore, Plan, and general-purpose subagents. Works standalone.

5 stars

byvamseeachanta

View on GitHub Installation ↓

Best use case

discipline-refactor is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Teams using discipline-refactor should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/discipline-refactor/SKILL.md --create-dirs "https://raw.githubusercontent.com/vamseeachanta/workspace-hub/main/.agents/skills/_internal/meta/discipline-refactor/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/discipline-refactor/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How discipline-refactor Compares

Feature / Agent	discipline-refactor	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

Best AI Skills for Claude

Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.

SKILL.md Source

# Discipline Refactor

## Sub-Skills

- [Core Principles](core-principles/SKILL.md)
- [Target Repository Structure](target-repository-structure/SKILL.md)
- [Orchestration Architecture](orchestration-architecture/SKILL.md)
- [Phase 1: Analysis](phase-1-analysis/SKILL.md)
- [Phase 2: Planning](phase-2-planning/SKILL.md)
- [Phase 3: Execution](phase-3-execution/SKILL.md)
- [Phase 4: Validation](phase-4-validation/SKILL.md)
- [Standard Folders → Module Structure (+1)](standard-folders-module-structure/SKILL.md)
- [How to Identify Disciplines](how-to-identify-disciplines/SKILL.md)
- [Python Package (+1)](python-package/SKILL.md)
- [Rollback](rollback/SKILL.md)
- [Verification Checklist](verification-checklist/SKILL.md)

Related Skills

module-based-refactor

from vamseeachanta/workspace-hub

Reorganize a repository from flat structure to a module-based 5-layer architecture (src/tests/specs/docs/examples) while preserving git history. Use when restructuring a codebase into modules, migrating import paths, cleaning up hidden folders, consolidating duplicate directories, removing root-level artifacts, or archiving completed plan files. Capabilities: parallel agent spawn strategy, hidden-folder consolidation patterns, benchmark fixture separation, 4-phase atomic commit workflow.