|
| 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