Skip to content

docs: add layered-rails guidance to README and AGENTS.md#2709

Merged
mroderick merged 1 commit into
masterfrom
feature/layered-rails-docs
Jul 15, 2026
Merged

docs: add layered-rails guidance to README and AGENTS.md#2709
mroderick merged 1 commit into
masterfrom
feature/layered-rails-docs

Conversation

@mroderick

Copy link
Copy Markdown
Collaborator

Summary

Drafts documentation to explain and encourage the use of Layered Rails principles in the codebase, as described in Layered Design for Ruby on Rails Applications by Vladimir Dementyev.

Changes

README.md — new Architectural approach section:

  • Describes the four-layer architecture (Presentation, Application, Domain, Infrastructure)
  • Maps each layer to key directories in this project
  • Contributor guidelines: thin controllers, domain logic in models, no Current in models, extract queries/presenters/form objects

AGENTS.md — new For planning agents block:

  • Lists four commands (plan, analyze, review, spec-test) from the layered-rails skill for AI agents working on this codebase

References

@mroderick mroderick requested a review from olleolleolle July 15, 2026 06:31
@mroderick mroderick marked this pull request as ready for review July 15, 2026 06:32

@olleolleolle olleolleolle left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good! This adds necessary signposts for further study, and lays out some direct principles.

@mroderick mroderick merged commit 50bc98b into master Jul 15, 2026
9 checks passed
@mroderick mroderick deleted the feature/layered-rails-docs branch July 15, 2026 06:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants