Skip to main content
skill CX Codex

planning-codebase-restructuring — Claude Code skill

planning-codebase-restructuring is a Claude Code skill that maps a codebase and prepares a restructuring plan without changing files. It produces an evidence-backed report for a later implementation pass.

no license 100 installs ★ 3 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add b-mendoza/agent-skills --skill planning-codebase-restructuring -a claude-code
Open on GitHub

What planning-codebase-restructuring does

planning-codebase-restructuring maps the current architecture in read-only mode, examines domain language with DDD and Screaming Architecture, quarantines external references, and prepares a migration plan. Five subagents contribute to the workflow: an architecture cartographer, domain analyst, restructuring strategist, reference assessor, and plan reviewer.

The skill takes a repository path or URL, a target scope, business goals, and constraints. It can write the final report to ARTIFACT_PATH; a repository URL may also trigger a shallow temporary clone outside the target tree. Tests, builds, package installs, formatters, generators, file moves, refactors, and public-contract changes are outside its operation.

What it helps with

  • draft a restructuring plan for a codebase
  • map domain boundaries and business capabilities
  • compare the current structure with DDD and Screaming Architecture
  • assess an external architecture reference
  • prepare a report for a later implementation run

Example prompts for the agent

  • Create a restructuring plan for CODEBASE_PATH_OR_REPOSITORY_URL, covering TARGET_SCOPE and BUSINESS_GOALS_AND_PAIN_POINTS.
  • Map the current architecture through read-only inspection, check KNOWN_DOMAIN_LANGUAGE, and save the result to ARTIFACT_PATH.
  • Assess REFERENCE_URL against CONSTRAINTS and produce a report using SUCCESS_CRITERIA.

How to install planning-codebase-restructuring

1Skills CLI (Vercel)

npx skills add b-mendoza/agent-skills --skill planning-codebase-restructuring -a claude-code

2Manually: put the files in place

~/.claude/skills/planning-codebase-restructuring/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/planning-codebase-restructuring/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about planning-codebase-restructuring

How do I install planning-codebase-restructuring in Claude Code?

Run npx skills add b-mendoza/agent-skills --skill planning-codebase-restructuring -a claude-code, then use ~/.claude/skills/planning-codebase-restructuring/SKILL.md.

What does planning-codebase-restructuring do?

The skill reads a project, examines domain boundaries, reviews external references, and sends a candidate restructuring report to an independent reviewer. It does not modify the codebase.

What inputs does planning-codebase-restructuring need?

It needs CODEBASE_PATH_OR_REPOSITORY_URL, TARGET_SCOPE, and BUSINESS_GOALS_AND_PAIN_POINTS. Domain language, constraints, a reference URL, success criteria, and an artifact path are optional inputs.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set12

The whole set →
review-pull-request review-pull-request audits a single GitHub pull request across isolated stages, drafts a local Markdown report, and posts comments only when confirmed. CX Codex +1 161installs committing-scoped-changes committing-scoped-changes splits an explicit list of files or folders into separate git commits and leaves the rest of the working tree alone. CX Codex +1 153installs responding-to-pr-review-comments The responding-to-pr-review-comments skill gathers pull request comments, assesses the feedback, and drafts replies. With confirmation, it can post approved text to supported GitHub comment threads. CX Codex +1 144installs clarifying-assumptions clarifying-assumptions — a skill that runs the conversational layer for plan verification. Asks critical questions upfront or before individual tasks, delegates artifact analysis to subagents. CX Codex +1 129installs refactoring-code refactoring-code is a Claude Code skill that stages simplification refactors: approve the plan before edits, then check that behaviour stays the same. CX Codex +1 124installs diagnosing-root-causes The diagnosing-root-causes skill traces bugs, regressions, and CI/CD failures from supplied evidence, then produces a reviewed root-cause report. Use it when a problem report needs investigation rather than guesswork. CX Codex +1 122installs rewriting-code-strictly rewriting-code-strictly is a Claude Code skill that rewrites Python, TypeScript/JavaScript, or Go with stricter typing and boundary checks. It runs on requests to harden code or align it with static analysis tools. CX Codex +1 122installs improving-test-suites improving-test-suites is a Claude Code skill that reviews test suites and focuses them on important behavior. It activates for requests to trim, rewrite, review, or strengthen tests. CX Codex +1 119installs

Project sponsors

Companies that keep this analytics open