feat(storybook): prototype Kilo Pass for Organizations

[jeanduplessis]

Summary

Defines the Kilo Pass for Organizations product model and adds a complete Storybook prototype for reviewing its customer and operational journeys.

Why this change is needed

Kilo Pass currently models personal subscriptions. Organization-owned Kilo Pass needs different billing, seat coverage, pass assignment, Credit, bonus, child-organization, and lifecycle rules.

These prototypes make those rules concrete and reviewable before runtime implementation begins.

How this is addressed

• Defines organization-owned agreements, immutable term versions, seat-linked pass capacity, monthly Credit periods, pooled bonus progress, and child-organization pass assignments.
• Positions Kilo Pass for Organizations as an add-on to Teams and Enterprise seats.
• Adds customer journeys for discovery, setup, checkout, activation, active management, payment states, cancellation, seat changes, and assignment conflicts.
• Adds billing, member access, child-organization restrictions, admin operations, and status-reference stories.
• Adds plain-English scenario context to every story through Storybook Docs.
• Includes an executive overview with captured UI examples.
• Updates shared subscription components only where needed by the prototype.

Human Verification

Browser-verified the available add-on, setup, checkout, active subscription, blocked and failed Credit states, seat changes, mobile setup, Docs context grid, button variants, compact app shell, and pass-input alignment.

View locally

Requires Node.js 24 or newer and pnpm from the repository packageManager field.

git fetch origin
git switch --track origin/jdp/kilo-pass-orgs
pnpm install
pnpm --filter @kilocode/storybook storybook

Then open:

• Customer journeys: http://localhost:6006/?path=/docs/kilo-pass-for-orgs-customer-journey--docs
• Operations and access: http://localhost:6006/?path=/docs/kilo-pass-for-orgs-operations-and-access--docs
• Subscription Center entry: http://localhost:6006/?path=/story/kilo-pass-for-orgs-customer-journey--available-in-subscription-center

If the branch already exists locally:

git switch jdp/kilo-pass-orgs
git pull --ff-only

Reviewer Notes

Human Reviewer Flags

• This is a product and UI prototype, not runtime implementation.
• No database schema, Stripe integration, API routes, or automated Credit processing are included.
• Review should focus on product rules, customer language, state coverage, and interaction design before backend implementation begins.

Code Reviewer Agent

Code Reviewer Notes

• Organization Kilo Pass remains separate from personal Kilo Pass.
• Self-serve billing is modeled as an item on the existing seat subscription.
• Pass quantity always matches paid-seat quantity.
• Current monthly Credits remain fixed; ordinary assignment changes apply next month.
• Storybook Docs use per-story descriptions for scenario context without adding annotations to product UI.