Implement Folder Architecture

Execute a large-scale folder architecture refactor based on an audit report or user-defined architecture. Moves files into correct locations, splits oversized folders, refactors imports, updates barrel files, and verifies builds after each phase. Use after audit-codebase has generated its structural report, or when a systematic folder reorganization is needed.

9 starsSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Drakaniia/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Drakaniia/skills --skill implement-folder-architecture
Manual install
git clone --depth 1 https://github.com/Drakaniia/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/implement-folder-architecture ~/.claude/skills/implement-folder-architecture

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Implement Folder Architecture

Use this skill to act as a **Structural Refactoring Engineer** — systematically executing a folder architecture migration based on an existing audit report or user-defined architecture. This skill bridges the gap between **detecting** structural issues (the domain of `audit-codebase`) and **preventing** future decay (the domain of `folder-architecture`).

## Core Principles

- **Incremental safety**: Perform the migration one phase at a time, verifying the project builds and tests pass after each phase.
- **Preserve functionality**: All public APIs, exports, and imports must work identically before and after the migration.
- **Follow existing conventions**: Match the project's detected naming convention and architecture pattern — do not introduce new conventions during a migration.
- **Language-agnostic**: Every operation applies to any language. Language-specific mechanics are in the shared reference files.
- **Report-driven**: When an audit report exists, follow it strictly. The report is the implementation contract.
- **Test before, verify after**: Write or identify tests that capture the current behavior before moving code, then verify after each phase.
- **Semantic tools over text replacement**: Move files and rewrite imports with tools that understand the language (see [Import Refactoring Protocol](#import-refactoring-protocol)). Regex/sed rewrites are a last resort and must be reviewed diff-by-diff.
Read the full skill on GitHub

Details

Skill name
implement-folder-architecture
Path
skills/implement-folder-architecture/SKILL.md
License
MIT
Repo updated
7 November 2026

FAQ

What does the Implement Folder Architecture skill do?

Execute a large-scale folder architecture refactor based on an audit report or user-defined architecture. Moves files into correct locations, splits oversized folders, refactors imports, updates barrel files, and verifies builds after each phase. Use after audit-codebase has generated its structural report, or when a systematic folder reorganization is needed.

How do I install the Implement Folder Architecture skill?

Claude Code plugin: /plugin marketplace add Drakaniia/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Implement Folder Architecture popular?

It lives in Drakaniia/skills, which has 9 GitHub stars and 0 forks.

Related skills

Audit Codebase

9

Drakaniia/skills

Scan any codebase (language-agnostic) and flag structural health issues including folder bloat, oversized files, deep nesting, naming inconsistencies, orphaned files, doc sprawl, and empty directories. Generates a markdown report with ASCII tree diagrams for folder structure issues and Mermaid graphs for file-level diagrams. Use when a codebase feels cluttered, disorganized, or hard to navigate.

Software Development

Code Design

9

Drakaniia/skills

Use when writing or reviewing functions that are deeply nested, do too many things, have unclear side effects, or are hard to follow linearly. Also when an agent produces code with high cognitive load — nested if-else pyramids, functions mixing validation+business logic+IO, mutable state leaks, or control flow that jumps around. Complements folder-architecture (file/dir level) with function-level design principles.

Software Development

Codebase Health

9

Drakaniia/skills

Use when starting any session, or when unsure which codebase-health skill applies. Routes to audit-codebase, folder-architecture, code-design, and implement-folder-architecture. Establishes that codebase health is continuous practice, not a one-time audit.

Software Development

Postgresql Expert Best Practices Code Review

9

wispbit-ai/skills

PostgreSQL database design, migration, and performance optimization best practices. This skill should be used when writing, reviewing, or refactoring database schemas, migrations, or query patterns. Triggers on tasks involving PostgreSQL databases, schema design, migration optimization, or data modeling.

Software Development

Graphql Expert Best Practices

9

wispbit-ai/skills

GraphQL performance optimization and best practices for building scalable APIs. This skill should be used when writing, reviewing, or refactoring GraphQL schemas, resolvers, or query execution code. Triggers on tasks involving GraphQL APIs, resolver optimization, query performance, or data fetching patterns.

Software Development

Prismatic Embedded

9

prismatic-io/agent-skills

Embed Prismatic in a customer-facing web application, including a backend endpoint that signs embedded-user JWTs, frontend setup of the @prismatic-io/embedded SDK, and the integration marketplace or other embedded screens. Use when a user wants their customers to find, activate, or configure integrations inside the user's own app, or asks about embedded authentication, signing keys, or the embedded SDK.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.