Workflows — Rails Agent Skills

flowchart TD
    START([What do you need to do?]) --> DECISION{What stage are you at?}

    DECISION -->|New project or setup| DISCOVERY[discovery]
    DECISION -->|Plan feature| PLANNING[planning]
    DECISION -->|Configure CI/CD or environment| SETUP[setup]
    DECISION -->|Develop code| DEV[development]
    DECISION -->|Review quality| QUALITY[quality]
    DECISION -->|Code review| REVIEW[review]
    DECISION -->|Build engine| ENGINES[engines]

    DISCOVERY --> NEXT{What next?}
    PLANNING --> NEXT
    SETUP --> DEV

    NEXT -->|Implement| DEV
    NEXT -->|Done| END([PR / Merge])

    DEV -->|Tests pass| YARD[yard-documentation]
    DEV -->|Need review| REVIEW

    YARD --> REVIEW
    REVIEW -->|Feedback received| RESPOND[rails-review-response]
    RESPOND -->|Re-implement| DEV
    RESPOND -->|OK| END

    QUALITY --> REVIEW
    ENGINES --> REVIEW

New to the project?
  ├─ Yes → rails-context-engineering → rails-project-onboarding
  └─ No → What do you need to do?

       Plan a feature?
       ├─ Yes → create-prd → generate-tasks → (ticket-planning optional)
       └─ No → Implement?

            Bug or refactor?
            ├─ Bug → rails-bug-triage
            ├─ Refactor → refactor-safely
            └─ New feature → rails-tdd-slices → rspec-best-practices

                 Code type?
                 ├─ Service → ruby-service-objects
                 ├─ REST API → ruby-api-client-integration
                 ├─ GraphQL → rails-graphql-best-practices
                 ├─ Migration → rails-migration-safety
                 ├─ Background job → rails-background-jobs
                 └─ Engine → rails-engine-author

                      Authorization/roles?
                      └─ rails-authorization-policies

                           Performance?
                           └─ rails-performance-optimization

Write test → Run test → Verify it FAILS → Implement → Verify it PASSES