Skip to content

docs(design): add shared design source #3507

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Drixled merged 3 commits into from
May 27, 2026
Merged

docs(design): add shared design source #3507

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b5ecdc4
docs(design): add shared design source
Drixled May 26, 2026
154d5c4
fix(design): use https design submodule url
Drixled May 26, 2026
e70e7c3
docs(design): update agent design references
Drixled May 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitmodules
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[submodule ".kilo/design"]
path = .kilo/design
url = https://github.com/Kilo-Org/kilo-design.git
1 change: 1 addition & 0 deletions .kilo/design
Open in desktop
Submodule design added at acdcc6
2 changes: 1 addition & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Target a specific test file: `pnpm test -- <path>`. Run tests for a specific ser

## apps/web UI Work

Before making or reviewing UI changes under `apps/web` — components, routes/pages, layouts, styling, Storybook, visual polish, UX copy, interaction states, responsive behavior, theming, or accessibility — read `design.md` and use `.agents/skills/kilo-design/SKILL.md`. This applies even when the prompt does not explicitly mention design. Skip only for backend-only or non-visual logic changes.
Before making or reviewing UI changes under `apps/web` — components, routes/pages, layouts, styling, Storybook, visual polish, UX copy, interaction states, responsive behavior, theming, or accessibility — read `DESIGN.md` and use `.agents/skills/kilo-design/SKILL.md`. This applies even when the prompt does not explicitly mention design. Skip only for backend-only or non-visual logic changes.

## Coding Standards

Expand Down
17 changes: 17 additions & 0 deletions DESIGN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Kilo Cloud Design

Canonical design source is vendored into this repo as a Git submodule:

```txt
.kilo/design
```

Read in order:

1. `.kilo/design/DESIGN.md`
2. `.kilo/design/products/cloud.md`
3. `.kilo/design/tokens.json`

Do not add independent design rules in this repo. Promote design changes back to `kilo-design`, then update product implementation here.

Update the `.kilo/design` submodule pointer when canonical design guidance changes.
2 changes: 1 addition & 1 deletion apps/web/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

When doing UI work in `apps/web` — including React components, routes/pages, layouts, styling, Storybook stories, visual polish, UX copy, interaction states, responsive behavior, theming, or accessibility — you must:

1. Read `../../design.md` before changing or reviewing UI.
1. Read `../../DESIGN.md` before changing or reviewing UI.
2. Load and follow the `kilo-design` skill at `../../.agents/skills/kilo-design/SKILL.md`.
3. Prefer existing Kilo tokens, components, and utilities before adding new visual primitives.

Expand Down
Loading
Loading