Skip to content

Commit da2f427

Browse files
committed
feat(prototype): preview org KiloClaw billing UI plan
Adds /prototype/org-kc-billing — a design-review surface that renders every visual element from .plans/org-kiloclaw-billing-ui.md with mock data, role-aware variants (admin / member), and a journey-ordered TOC. Covers PR 1–4b plus Wave A–C: subscription page (admin + member), status banners, lock dialogs, destroy confirm, provisioning preflight, org settings tabs + Enterprise opt-out, subscription detail page + group + dashboard alert, associated-user banner, and instance owner chip. Sidebar nav and dashboard CTA mocks surface the cross-PR navigation deltas. Also adds: - PRODUCT.md and design.md (impeccable skill context) - .impeccable/design.json (design tokens manifest) - yellow color in shared Banner (additive, no behavior change for existing callers)
1 parent 3ece0bf commit da2f427

8 files changed

Lines changed: 4293 additions & 169 deletions

File tree

.impeccable/design.json

Lines changed: 305 additions & 0 deletions
Large diffs are not rendered by default.

PRODUCT.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Product
2+
3+
## Register
4+
5+
product
6+
7+
## Users
8+
9+
Kilo Cloud serves developers, team and organization admins, and internal operators who use or manage Kilo Code across editor, command line, and cloud workflows. Users are technical, time-constrained, and often switching between code, billing, integrations, security, deployment, and agent-session management.
10+
11+
Their job is to keep Kilo usage understandable and operational: manage Kilo Organizations, seats, credits, plans, model access, billing, integrations, Cloud Agents, Kilo Deploy, Code Reviews, Managed Indexing, Security Agent, Auto Triage, Kilo Autofix, App Builder, and KiloClaw infrastructure.
12+
13+
## Product Purpose
14+
15+
Kilo Cloud is the operational surface around Kilo Code, the open-source AI coding agent. It gives users one place to manage AI usage, model inference, Kilo Credits, paid plans, organizations, integrations, cloud-based agents, deployment automation, code review automation, security workflows, indexing, and infrastructure lifecycle tasks.
16+
17+
Success means users can quickly understand what is running, what it costs, who has access, what needs attention, and what action to take next. The interface should reduce uncertainty, not decorate it.
18+
19+
## Brand Personality
20+
21+
Expert, direct, utilitarian, transparent, and human. Write conversationally, like talking to a fellow developer. Use first-person and second-person naturally where helpful. Be enthusiastic about what Kilo is building, but avoid hype.
22+
23+
The product voice should feel like a technical teammate who has done the work: precise, candid, useful, and willing to explain complexity without talking down to the user.
24+
25+
Avoid robotic, generic, or AI-generated prose. Do not start messages with filler such as “Great,” “Certainly,” “Okay,” or “Sure.” Avoid marketing jargon and hype words such as “revolutionary,” “game-changing,” and “synergy.”
26+
27+
## Anti-references
28+
29+
Do not look or sound like a generic SaaS dashboard, neon AI hype product, decorative glass or gradient-heavy interface, playful consumer app, corporate enterprise portal, or vague marketing site.
30+
31+
Avoid these product and content patterns:
32+
33+
1. Blue-primary SaaS chrome when Kilo yellow-green should carry the primary action.
34+
2. Decorative gradients, glassmorphism, and AI-themed glow effects outside the rare agent-surface glow described in DESIGN.md.
35+
3. Repeated same-sized card grids with icon, heading, and text.
36+
4. Big-number hero metric sections that feel like template SaaS marketing.
37+
5. Buzzword copy that claims value instead of showing the concrete workflow impact.
38+
6. Ambiguous billing language. Use Kilo Credits for purchased usage credit. Reserve “token” for model input and output volume only.
39+
7. Old naming patterns such as “Kilo For Teams,” “Kilo for Enterprise,” “Kilo for Organizations,” “Kilo Code Deploy,” “Kilo Managed Indexing,” or “Kilo Cloud Agents.”
40+
41+
## Design Principles
42+
43+
1. **Utility before atmosphere.** Every screen should help the user decide what is happening, what matters, and what to do next. Visual style supports operational clarity.
44+
2. **Show the work.** Prefer concrete costs, states, timestamps, links, examples, and next actions over abstract reassurance.
45+
3. **Treat developers as peers.** Assume intelligence, explain context when needed, define niche concepts when introduced, and avoid performative simplicity.
46+
4. **Keep the brand action scarce.** Kilo yellow-green is the primary action and brand signal. Use it with intent so it retains meaning.
47+
5. **Be precise with naming and billing language.** Use product names consistently: Kilo, Kilo CLI, Kilo Plans, Kilo Teams, Kilo Enterprise, Kilo Deploy, Cloud Agents, Parallel Agents, Code Reviews, App Builder, Managed Indexing, Security Agent, Auto Triage, Kilo Autofix, and iOS App. Use paid plans for Teams and Enterprise collectively. Use Kilo Organization for the place where seats and credits are managed.
48+
49+
## Accessibility & Inclusion
50+
51+
Target WCAG AA. Prioritize keyboard navigation, visible focus states, readable dense data, sufficient contrast, reduced-motion-safe animations, and clear error recovery.
52+
53+
Use sentence case for user-visible product chrome. Avoid all caps except intentional eyebrow labels and rare role badges already defined by the design system. Avoid acronyms when possible; when acronyms are needed, expand them at least once in a conversation or document.
54+
55+
For timestamps and deadlines, account for distributed teams. Prefer exact dates, relative times, and timezone references over ambiguous phrases such as “end of day.” For internal content, use ISO dates in `yyyy-mm-dd` format and months in `yyyy-mm` format.
56+
57+
Use `open source` as a noun and `open-source` as an adjective before a noun. Refer to Kilo Code people as Kilo Code team members, not employees. Use “non-US” instead of “international,” “offshore,” or “overseas” when referring to team members outside the US.

0 commit comments

Comments
 (0)