skills/planning/ticket-planning/SKILL.md
Drafts, classifies, and optionally creates tickets from an initiative plan. Use when the user provides a plan and wants ticket drafts, wants help shaping a plan into tickets, wants sprint-placement guidance, or wants tickets created in an issue tracker after the plan is approved.
npx skillsauth add igmarin/rails-agent-skills ticket-planningInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Normalize inputs, classify each work item, apply title conventions, draft tickets in a standard structure, then either return markdown drafts or create issues in the issue tracker after explicit approval.
See EXAMPLES.md for a complete plan → ticket draft example.
Extract planning inputs:
If the user already has a plan, do not re-plan unless there is a material gap.
Assign these core planning attributes to each ticket:
| Attribute | Values |
|-----------|--------|
| type | Story | Task |
| area | backend | web | mobile | cross-platform | external |
| execution_order | foundation | api | client | follow-up |
| dependency_level | unblocked | blocked |
| target_bucket | ready-to-refine | next-dev-sprint | later |
Additional attributes to apply when relevant: coordination_need (single-team | multi-team), external_dependency (yes | no), urgency (normal | priority).
Backend/API enablers generally come before dependent web/mobile tickets.
Use these prefixes:
BE | for backendFE | for web / frontendMobile | for mobileWhen writing the ticket title, leave a space after the |.
Do not add those prefixes to tickets that are not owned by those areas unless the user explicitly wants that.
Use this section order:
| Section | Job | |---------|-----| | Summary | State the outcome | | Background | Explain why | | Acceptance Criteria | List observable criteria | | Dependencies | Note blockers | | Technical Notes | Implementation details that affect sequencing or scoping only |
Keep the main sections business-facing.
Draft-only:
Create in issue tracker:
Example field shape for MCP/API creation:
{
"project": "<project-key>",
"issuetype": "Story",
"summary": "BE | Enable payment webhook processing",
"description": "<full ticket body>",
"labels": ["payments", "backend"],
"components": ["payments-service"],
"sprint": { "id": "<sprint-id>" },
"epic": "<epic-key>"
}
Omit fields the project does not require. Confirm actual field names from the tracker's create-metadata endpoint before issuing the call. Do not set status on create — use the project's default initial status.
Defaults unless the user overrides:
foundation and api tickets → placed before all dependent client ticketsclient tickets → blocked until the API surface they depend on is stableexternal confirmation tickets → excluded from active build sprintsfollow-up tickets → ready-to-refine or later until their enabling work is complete| Skill | When to chain | |-------|----------------| | generate-tasks | After tasks exist or in parallel — same initiative can feed ticket breakdown | | create-prd | When tickets should align with PRD scope and acceptance themes |
development
Entry point for Rails development workflows covering TDD, RSpec, Service Objects, DDD, GraphQL, Engines, and Code Quality. Use when the user asks about Ruby on Rails development patterns, needs RSpec test suites generated, wants service objects scaffolded, is setting up GraphQL schemas, performing Rails code review, refactoring .rb files, working with domain-driven design, implementing background jobs, conducting Rails security checks, or building Rails engines. Generates RSpec tests, structures service objects, enforces TDD workflows, configures GraphQL schemas, and coordinates domain-driven design patterns. Trigger keywords: Rails, RSpec, TDD, Rails testing, Rails refactor, Rails API, Rails code review, domain driven design, service objects, GraphQL, Rails engine, Ruby, .rb, background jobs, Rails migrations, Rails security check.
development
Use when shipping a Rails engine gem — FIRST run full test suite (`bundle exec rspec`) and fix ALL failures, verify gemspec metadata and dependencies match tested Rails/Ruby versions, dry-run: `gem build *.gemspec && gem push --dry-run *.gem` and verify contents, generate CHANGELOG.md organized by category (added/changed/deprecated/removed/fixed), produce step-by-step upgrade notes with before/after code, set semantic version in `lib/[engine_name]/version.rb`, document deprecations with migration paths, load release assets conditionally and state which one informed the output. Trigger words: version bump, changelog, deprecation, gemspec, upgrade, release, publish gem, ship gem.
development
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.
development
Complete Rails project setup loop with hard gates: verify Ruby version matches .ruby-version, Bundler installed, database connection successful, all env vars loaded, and ALL external CI actions pinned to immutable commit SHAs (never mutable tags like @v4) → configure CI/CD pipeline with linting, testing, and security scanning → validate end-to-end with bundle install, db:create, db:migrate, rspec, and write SETUP_CHECKLIST.md; phases context/onboarding→CI/CD configuration→environment validation. Use when starting a new Rails project, running `rails new`, configuring a Gemfile or .ruby-version, setting up a development environment, or wiring up CI/CD for a Ruby on Rails app. Trigger: setup project, new Rails app, configure CI/CD, dev environment setup, rails new, Gemfile setup, .ruby-version, Ruby on Rails project bootstrap.