Sandbox
Sign in
@alec-c4/claude-rails-dev
Agents#Claude Code#Coding#Testing#Security

Claude Code Rails agents and slash commands

This repo sets up a Rails-focused team for Claude Code, with an orchestrator that routes work to specialist agents like architect, developer, auditor, designer, and writer. It also includes shared templates and skills so your agent follows the same Rails workflow across tasks.

49 stars•7 forks•Shell•Updated 7mo ago
Who it's for

Builders who use Claude Code to work on Ruby on Rails apps with reusable agent roles and commands.

What it delivers

You can hand Rails tasks to the right specialist instead of re-explaining your workflow each time.

What it does

Orchestrator-led workflow

The `/dev` command routes work to the right role and can switch personas during a task.

Specialist slash commands

Commands like `/arch`, `/code`, `/audit`, `/design`, `/ops`, and `/writer` map to dedicated roles.

Rails-focused team roles

The kit includes architect, developer, auditor, product, UI/UX, i18n, DevOps, AI, and writer agent files.

Shared templates and rules

`templates/CLAUDE.md`, `templates/GLOBAL_RULES.md`, and `templates/IMPLEMENTATION_PLAN.md` provide reusable guidance.

Install script and bootstrap

`scripts/install.sh` sets up the kit, and `claude-init` bootstraps a project after install.

How to get it

  1. 1Run this command to install the kit and configure slash commands
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/alec-c4/claude-rails-dev/master/scripts/install.sh)"
  2. 2Enter your project root and run
    claude-init
  3. 3User
    /dev I need a blog system where users can comment on posts.
  4. 4User
    /audit Check my last commit for security issues.

README

Claude Rails Developer Kit

A modular, role-based AI coding environment designed for building modern Ruby on Rails (8.0+) applications using Claude Code.

This repository transforms a generic AI coding assistant into a specialized Rails Engineering Team that lives in your terminal.

🌟 Features

  • Autonomous Team: The Orchestrator (/dev) can dynamically adopt roles (Architect, Developer, Auditor) to solve complex tasks end-to-end.
  • Native Integration: Uses Claude's native Slash Commands (/arch, /code) for seamless interaction.
  • Modern Stack: Rails 8.0, Hotwire, Inertia.js, GraphQL, Solid Queue/Cache, Kamal.
  • Quality First: Strict TDD workflows, Security Audits (Brakeman), and "Definition of Done".
  • Production Ready: Built-in support for i18n, Feature Flags, and MCP tools (AppSignal, GitHub).

🤖 The Team (Slash Commands)

CommandRoleTriggers
/devOrchestratorStart Here. Smartly routes tasks and adopts personas.
/prodProduct ManagerStrategy, WSJF, A/B Testing, Analytics.
/archRails ArchitectSystem design, Schema planning, Stack selection.
/codeRails DeveloperImplementation, TDD, Refactoring.
/auditRails AuditorQA, Security, Code Review.
/designUI/UX DesignerTailwind, Accessibility, UX Flows.
/aiAI SpecialistLLM Integration, RAG, MCP Servers.
/i18ni18n SpecialistGlobalization, Timezones.
/opsDevOps EngineerKamal, Docker, CI/CD.
/writerTech WriterDocumentation, Releases, Licenses.

🚀 Installation

One-Line Install

Run this command to install the kit and configure slash commands:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/alec-c4/claude-rails-dev/master/scripts/install.sh)"

Manual Install

  1. Clone the repository: git clone ... ~/.claude/repo
  2. Run: ~/.claude/repo/scripts/install.sh

💡 Usage

0. Bootstrap

Enter your project root and run:

claude-init

1. Autonomous Mode (Recommended)

Just talk to the Orchestrator. It will figure out which specialist is needed.

User:

/dev I need a blog system where users can comment on posts.

Orchestrator:

"I see. I will activate the Architect to plan this feature first." (Reads agents/rails-architect.md) "Here is the Implementation Plan..."

2. Manual Specialist Mode

If you know exactly who you need, summon them directly.

User:

/audit Check my last commit for security issues.

🔌 Recommended MCP Servers

To unlock "X-Ray Vision" for your agents, install these servers:

  1. Rails MCP: repo url: https://github.com/maquina-app/rails-mcp-server

  2. AppSignal: documentation: https://docs.appsignal.com/mcp.html

  3. GitHub: repo url: https://github.com/github/github-mcp-server

  4. Chrome DevTools repo url: https://github.com/ChromeDevTools/chrome-devtools-mcp

  5. Context 7 url: https://context7.com

  6. Language Server MCP repo url: https://github.com/isaacphi/mcp-language-server ruby lsp: https://github.com/Shopify/ruby-lsp

🛡 License

MIT License.

Files in the repo

Repository payload•8 top-level entries
  • agents
  • bin
  • scripts
  • skills
  • templates
  • CHANGELOG.md
  • LICENSE.md
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More agents

Hmbown/
Codewhale
Hmbown/CodewhaleAgents

Open-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.

41k
nanocoai/nanoclawAgents

A lightweight alternative to OpenClaw that runs in containers for security. Connects to WhatsApp, Telegram, Slack, Discord, Gmail and other messaging apps,, has memory, scheduled jobs, and runs directly on Anthropic's Agents SDK

31k
TokenRhythm/
opensquilla
TokenRhythm/opensquillaAgents

OpenSquilla — Token-Efficient AI Agent with same budget, higher intelligence density

7k
QwenLM/qwen-codeAgents

An open-source AI coding agent that lives in your terminal.

28k
Untrivial-ai/
agent-orchestrator
Untrivial-ai/agent-orchestratorAgents

Run and supervise teams of coding agents from planning to merge. Any harness (Claude code, codex, +25 more). Desktop, web, mobile, and cloud agents.

11k