module-organisation

Community

Organize code by responsibility, not feature

AuthorTechyMT
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Organizes a codebase so responsibilities (capabilities, commands, services, app state, hooks, utilities, and components) are separated and discoverable, preventing business logic from leaking into UI and avoiding implicit state coupling.

Core Features & Use Cases

  • Clear layer boundaries: tools/ for capabilities, commands/ for user-facing commands, services/ for orchestration and external APIs, state/ for the single AppState, hooks/ for subscriptions, utils/ for pure functions, and components/ for TUI rendering.
  • Per-tool subdirectories and file-extension signals: each tool gets its own namespace and .tsx vs .ts signals rendering concerns.
  • Use Case: Add a new file-operation capability or trace why a UI action touches disk by following the directory conventions to find the tool, service, and state selectors involved.

Quick Start

Create a new capability by adding src/tools/[Name]Tool/[Name]Tool.tsx, export it as a named constant, and register it in src/tools.ts.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: module-organisation
Download link: https://github.com/TechyMT/claude-code-superpowers/archive/main.zip#module-organisation

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.