skills.rest
Grupo-AFAL
Grupo-AFALOFFICIAL
Explore all skills by this author →
WebsiteGitHub

architecture

Generate refined architecture specifications for Rails features from requirements documents.

Updated Aug 27, 2026
Search Tags:#architecture#code review#specification#generate#rails#dhh
One-click install
npx skills add https://github.com/Grupo-AFAL/claude-plugins --skill architecture-grupo-afal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/Grupo-AFAL/claude-plugins/tree/main/rails-tools/skills/architecture
Command: npx skills add https://github.com/Grupo-AFAL/claude-plugins --skill architecture-grupo-afal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns ambiguous feature requests and requirement documents into precise, implementation-ready architecture specifications for Rails applications, reducing miscommunication and scope creep.

Core Features & Use Cases

  • Clarify requirements: Ask at least three targeted clarifying questions and append answers to a Clarifications section to tighten scope.
  • Research and reference fetch: Retrieve external library documentation when needed and summarize it for repeated reference in docs/stack.
  • Iterative spec generation and review: Invoke rails-architect to produce initial and refined specs, run DHH-style reviews with dhh-code-reviewer, and save versioned plan and feedback markdown files.
  • Use Case: Turn a product requirement in docs/requirements into a three-iteration, DHH-refined specification ready for implementation and handoff to engineering.

Quick Start

Generate a refined architecture specification from the requirements file at docs/requirements/user-notifications.md.

Frequently Asked Questions about architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Rails architecture specifications from a requirements document?▼

To generate Rails architecture specifications, apply this Skill to your requirements file to iteratively design models, controllers, views, and tests. It coordinates internal agents to produce versioned markdown plan files ready for engineering handoff.

What is a DHH-style code review for Rails features?▼

A DHH-style code review evaluates Rails feature specifications against conventions emphasizing developer happiness and pragmatic design. This Skill produces iterative spec files and runs automated DHH-style reviews to refine architecture plans before implementation.

Can I use this to clarify ambiguous product requirements before writing Rails code?▼

Yes, you can clarify ambiguous product requirements before writing Rails code. The process asks at least three targeted clarifying questions, appends answers to a Clarifications section, and tightens scope to prevent miscommunication and scope creep.

How do I structure iterative specification files for Rails applications?▼

Structure iterative specification files by saving versioned markdown plans and feedback artifacts in your docs directory. The workflow produces a three-iteration refined specification covering models, controllers, views, tests, and integration workflows.

Does this architecture tool work with AFAL conventions for Rails?▼

Yes, this architecture tool works with Rails applications following AFAL conventions. It designs full feature workflows including models, controllers, views, and tests based on your documented requirements while applying AFAL-specific structural standards.

Related Skills

Explore More Software Engineering Skills→
CraigtutCraigtut
1

doc-explorer

Load foundational Animus docs and explore topic-specific project documentation.

Community
Intermediate
williamzelesnywilliamzelesny
3

lets-dhh-rails-style

Enforce 37signals/DHH Rails coding conventions in Ruby and Rails applications.

Community
Advanced
EveryIncEveryInc
24.1k

dhh-rails-style

Enforce DHH RESTful Rails conventions in Ruby code reviews.

Official
Advanced
ysyecustysyecust
40

verification-loop

Automate end-to-end project verification across builds, type checks, linting, tests, and security scans.

Community
Intermediate