rails-agent-skills

Orchestrates the full Rails TDD cycle with hard gates: test MUST exist, be run, and FAIL for the correct reason (e.g. undefined method, not syntax error) before any implementation code — propose minimal implementation and wait for user approval → verify test PASSES → run full suite with rubocop, brakeman, rspec all green → produce YARD documentation and self-reviewed PR; phases context/test design→implementation→iterate→finish. Use when practicing test-driven development, red-green-refactor, TDD workflow, writing tests before code, adding tests first, or building a Rails feature where specs must gate implementation.

Use when planning tests for a Rails change — must present a Test Design Review checkpoint, pick the smallest strong slice matched to where the real risk lives, write exactly one minimal failing example as the initial TDD gate (list additional cases as follow-up), verify that the test fails because behavior is missing rather than broken setup, and use assets/first_slice_template.md to document the plan. TDD, first failing test, spec selection, vertical slice planning.

Use when creating or modifying REST API endpoints — must create or update the corresponding API collection JSON file using the {{base_url}} variable, ensure each request includes a description and at least one basic test script, validate the collection JSON using python -m json.tool or jq, and verify it imports into compatible API clients without errors. Sync API collections with REST endpoints. Trigger words: endpoint, API route, controller action, API collection, request collection.

Use when building or reviewing GraphQL APIs in Rails with graphql-ruby — must follow the TDD gates by writing a failing spec in spec/graphql/ using AppSchema.execute rather than HTTP controller dispatch, define arguments/return types without leaking internal model names (use connection_type for pagination), implement resolver/mutation classes that delegate to services, prevent N+1 queries by using and priming the dataloader on association loads, and ensure mutations return result and errors shapes on failure. Trigger words: graphql, graphql-ruby, resolver, mutation, dataloader, schema.

Use when applying code conventions to Rails files — must run linter (detect .rubocop.yml/.standard.yml, note absence, and state which linter was detected and that style defers to it), apply area-specific rules per path with concrete per-path recommendations, verify tests gate (state the failing spec, run command, expected failure, minimal implementation step, and passing rerun) BEFORE new behavior, chain to specialised skills, only recommend let_it_be if test-prof already in Gemfile.lock (otherwise default to let, reach for "let!" only if lazy evaluation breaks example, do not introduce test-prof), and load extended files (assets/checklist.md, assets/snippets.md) only when needed. Use when writing, reviewing, or refactoring Ruby on Rails code. Trigger words: code review, refactor, RoR, clean code, best practices.

1 hook across 1 event