A collection of Claude code skills enables developers to design and review Ruby on Rails applications using layered architecture principles from the "Layered Design for Ruby on Rails Applications" book. It targets engineers aiming to improve application structure, maintainability, and identify architectural flaws through automated analysis and review commands within the Claude environment. The primary benefit is enforcing clean abstraction boundaries and facilitating incremental adoption of layered patterns.

How It Works

The skills provide a suite of commands to analyze Rails codebases for adherence to layered architecture. Core functionalities include comprehensive architecture analysis, identifying "god objects" via churn x complexity metrics, scoring model callbacks for extraction candidates, reviewing code changes for layer violations, and executing specification tests to validate layer placement. It also offers a command to plan incremental adoption of layered patterns.

Quick Start & Requirements

• Primary install / run command:
  1. Add to marketplace: /plugin marketplace add palkan/skills
  2. Install skill: /plugin install layered-rails@palkan-skills
• Non-default prerequisites and dependencies: Requires the Claude environment and the compound-engineering plugin for advanced integration.
• Links: No direct links to official quick-start guides, demos, or documentation are provided in the README.

Highlighted Details

• Provides commands for full codebase architecture analysis (/layers:analyze).
• Includes specific analysis for model callbacks and identification of god objects.
• Offers code review functionality focused on layer violations (/layers:review).
• Supports planning incremental adoption of layered patterns (/layers:gradual).
• Integrates with the compound-engineering plugin for enhanced planning and review workflows.

Maintenance & Community

The README does not specify maintainers, community channels (e.g., Discord, Slack), or a roadmap. The project is attributed to Vladimir Dementyev.

Licensing & Compatibility

• License type: MIT.
• Compatibility notes: The MIT license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

The utility of these skills is tied to the Claude environment and the compound-engineering plugin. The README does not detail performance benchmarks, known bugs, or unsupported Rails versions.