ruly: Command for Claude Code

/ruly:decompose Command

Overview

The /ruly:decompose command splits a markdown file into a directory of separate files based on its section headers. It uses git mv to preserve history, moving the original file to become the index file (_common-{tag}.md) that references all extracted sections via anchor links.

Usage

/ruly:decompose <file> <directory>

Arguments

• <file> - The markdown file to decompose
• <directory> - The name for the output directory (e.g., "standards", "patterns")

Examples

# Decompose common.md into a "standards" directory
/ruly:decompose rules/workaxle/core/frameworks/common.md standards

# Decompose debugging.md into a "troubleshooting" directory
/ruly:decompose rules/bug/debugging.md troubleshooting

Example Transformation

Before (rules/core/common.md):

---
description: Common Ruby patterns
globs:
  - '**/*.rb'
---

# Ruby Language Patterns

## Code Style

Content about code style...

## Error Handling

Content about error handling...

## Testing

Content about testing...

After decomposition into standards/:

rules/core/standards/
├── _common-ruby-language-patterns.md  # Index (original file, moved via git mv)
├── code-style.md                      # Extracted section
├── error-handling.md                  # Extracted section
└── testing.md                         # Extracted section

standards/_common-ruby-language-patterns.md (index):

---
description: Common Ruby patterns
globs:
  - '**/*.rb'
requires:
  - ./code-style.md
  - ./error-handling.md
  - ./testing.md
---

# Ruby Language Patterns

## Code Style

See [Code Style](#code-style) for code style patterns.

## Error Handling

See [Error Handling](#error-handling) for error handling patterns.

## Testing

See [Testing](#testing) for testing patterns.

standards/code-style.md:

---
description: Code style guidelines
alwaysApply: false
---

# Code Style

Content about code style...