Start shipping →

Docs · Working with Claude Code

The crud-with-billing Skill

Walkthrough of scaffolding a new account-scoped, optionally paid resource.

crud-with-billing scaffolds a new account-scoped resource, in the exact shape as the kit's example Project resource. It's the skill you reach for, or that Claude Code reaches for on its own, any time you say something like "add invoices" or "let users create projects" in this repo. The concept-level version of this page lives at Adding a Resource; this page is the skill's own step-by-step.

What it needs from you

Two things: the resource name (for example Invoice) and its attributes (amount:integer note:text), and whether the feature is paid or free.

What it generates

Pattern-matched against app/models/project.rb, app/policies/project_policy.rb, app/controllers/projects_controller.rb, app/views/projects/*, and their specs:

  1. A model and migration, via bin/rails g model <Name> account:references <attrs>, with null: false added where sensible and belongs_to :account plus validations on the model.
  2. has_many :<name>s, dependent: :destroy on Account.
  3. A Pundit policy subclassing ApplicationPolicy, copied from ProjectPolicy, whose inherited Scope already filters to account_id.
  4. A controller that queries only through Current.account.<name>s, calling authorize and policy_scope, and including RequireEntitlement if (and only if) the feature is paid.
  5. Views for index, show, new, edit, and _form, using the Terminal design system classes already defined in application.css.
  6. A resources :<name>s route.
  7. If the resource introduces a new plan or tier: an extension to Billing::PLANS and a new price id in Billing::Stripe::PRICE_ENV, with the Stripe side managed through the Stripe MCP server or bin/rails console.
  8. Model, policy, and request specs, always including the tenant-isolation test (a foreign account's id must 404), and, for paid resources, an entitlement-gate test.

Verify

bin/check green. The tenant-isolation test carries the most weight here: it's the one test that catches a resource that quietly forgot to scope a query to the current account.

Next

If the new resource needs to talk to an external service, see The add-integration Skill.