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[write-yard-docs]
    DEV -->|Need review| REVIEW

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

    QUALITY --> REVIEW
    ENGINES --> REVIEW

New to the project?
  ├─ Yes → load-context → setup-environment
  └─ No → What do you need to do?

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

            Bug or refactor?
            ├─ Bug → triage-bug
            ├─ Refactor → refactor-code
            └─ New feature → plan-tests → write-tests

                 Code type?
                 ├─ Service → create-service-object
                 ├─ REST API → integrate-api-client
                 ├─ GraphQL → implement-graphql
                 ├─ Migration → review-migration
                 ├─ Background job → implement-background-job
                 └─ Engine → create-engine

                      Authorization/roles?
                      └─ implement-authorization

                           Performance?
                           └─ optimize-performance

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