layered-rails

palkan/skills

A collection of Claude Code skills by Vladimir Dementyev.

Available Skills

Layered Rails

Design and review Rails applications using layered architecture principles from the Layered Design for Ruby on Rails Applications book.

Install:

/plugin marketplace add palkan/skills
/plugin install layered-rails@palkan-skills

Commands:

Command	Purpose
/layers:analyze	Full codebase architecture analysis
/layers:analyze:callbacks	Score model callbacks, find extraction candidates
/layers:analyze:gods	Find god objects via churn x complexity
/layers:review	Review code changes for layer violations
/layers:spec-test	Run specification test on specific files
/layers:gradual [goal]	Plan incremental adoption of layered patterns

Integration with compound-engineering

We recommend asking Claude itself to update the instructions for Compound Engineering to include Layered Design features according to your needs. Below you can find some examples.

If you use the compound-engineering plugin, add explicit instructions to include layered-rails planning and reviewing agents.

In your compound-engineering.local.md file:

---
review_agents:
  - layered-rails
  - rails-reviewer
  - security-sentinel
  # - ...
---

# ...

# also worth adding something like:

We are **gradually adopting layered design principles** from "Layered Design for Ruby on Rails Applications" — clean abstraction boundaries, explicit layers, and specification tests...

Similarly, for planning features, add to your CLAUDE.md (or AGENTS.md, or whatever) smth like:

# ...

### For planning agents

When planning new features or architectural changes, use the `layered-rails` skill for analysis:
- `/layers:gradual` — plan incremental adoption of layered patterns
- `/layers:analyze` — full codebase architecture analysis
- `/layers:review` — review code from a layered architecture perspective
- `/layers:spec-test` — apply the specification test to evaluate layer placement

Alternatively, you can try to add shorter instructions to CLAUDE.md:

Extend the list of **review agents** with the `layered-rails:layered-rails-reviewer` agent to check for architecture layer violations. Must be applicable to such commands from the compound-engineering plugin as `/workflow:review`, `/plan_review`, and similar.

Extend the list of **planning agents** with the `layered-rails:layered-rails-gradual` agent to plan refactoring according to the layered design principles. Must be applicable to such commands from the compound-engineering plugin as `/workflow:plan`, `/deepen_plan`, and similar.

License

MIT