Skip to content

Elevate DesignOS quality system and onboarding #10

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
ardamoustafa1 merged 1 commit into from
Jul 17, 2026
Merged

Elevate DesignOS quality system and onboarding #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
16 changes: 9 additions & 7 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,13 +27,14 @@ This file is the kernel. It tells you **what to load, in what order, and what st
```
1. READ brain/design-intelligence.md → how to think
2. READ brain/decision-framework.md → how to choose
3. ROUTE via the table below → load only relevant modules
4. LOAD industries/<sector>.md → sector conventions, if known
5. LOAD memory/ project files → client, brand, prior decisions
6. RUN loops/design-loop.md → produce the work
7. SCORE scoring/rubric.md → self-review, iterate under 95
8. GATE workflows/final-gate.md → run deterministic review if files exist
9. WRITE memory/ updates → record decisions and open items
3. COMPILE brain/brief-compiler.md → turn the request into a testable contract
4. ROUTE via the table below → load only relevant modules
5. LOAD industries/<sector>.md → sector conventions, if known
6. LOAD memory/ project files → client, brand, prior decisions
7. RUN loops/design-loop.md → produce the work
8. SCORE scoring/rubric.md → self-review, iterate under 95
9. GATE workflows/final-gate.md → run deterministic review if files exist
10. WRITE memory/ updates → record decisions and open items
```

Do not skip steps. If a module doesn't exist for the task, say so — do not improvise silently.
Expand All @@ -44,6 +45,7 @@ Do not skip steps. If a module doesn't exist for the task, say so — do not imp

| Task signal | Load |
|---|---|
| Vague brief, prompt writing, "premium/beautiful/modern" without specifics | `brain/brief-compiler.md`, `brain/originality.md`, `PROOF_STANDARD.md` |
| Landing page, marketing site | `patterns/landing-pages.md`, `components/hero.md`, `psychology/` (attention, persuasion, trust), `components/footer.md` |
| Hero section | `components/hero.md`, `psychology/attention.md`, `foundations/typography.md` |
| Glow, gradients, grain, glass, "wow" effects | `components/visual-effects.md`, `brain/originality.md`, `motion/performance.md` |
Expand Down
2 changes: 1 addition & 1 deletion CHEATSHEET.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ MOTION 100/150/200/300/500ms · ease-out default · exits < entrances
interactive ≤300ms · stagger ≤60ms × ≤6 · transform/opacity ONLY
TARGETS 44×44px touch · 48px inputs · 40–48px buttons · 44–48px table rows
PERF LCP <2.0s · CLS <0.1 · INP <200ms · Lighthouse ≥95 · page ≤1.5MB
SCORE 6 dimensions · threshold 95 · AA failure caps at 60 · max 3 loop cycles
SCORE 7 dimensions · threshold 95 · AA failure caps at 60 · max 3 loop cycles
```

## The one-of-each laws
Expand Down
16 changes: 9 additions & 7 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,13 +27,14 @@ This file is the kernel. It tells you **what to load, in what order, and what st
```
1. READ brain/design-intelligence.md → how to think
2. READ brain/decision-framework.md → how to choose
3. ROUTE via the table below → load only relevant modules
4. LOAD industries/<sector>.md → sector conventions, if known
5. LOAD memory/ project files → client, brand, prior decisions
6. RUN loops/design-loop.md → produce the work
7. SCORE scoring/rubric.md → self-review, iterate under 95
8. GATE workflows/final-gate.md → run deterministic review if files exist
9. WRITE memory/ updates → record decisions and open items
3. COMPILE brain/brief-compiler.md → turn the request into a testable contract
4. ROUTE via the table below → load only relevant modules
5. LOAD industries/<sector>.md → sector conventions, if known
6. LOAD memory/ project files → client, brand, prior decisions
7. RUN loops/design-loop.md → produce the work
8. SCORE scoring/rubric.md → self-review, iterate under 95
9. GATE workflows/final-gate.md → run deterministic review if files exist
10. WRITE memory/ updates → record decisions and open items
```

Do not skip steps. If a module doesn't exist for the task, say so — do not improvise silently.
Expand All @@ -44,6 +45,7 @@ Do not skip steps. If a module doesn't exist for the task, say so — do not imp

| Task signal | Load |
|---|---|
| Vague brief, prompt writing, "premium/beautiful/modern" without specifics | `brain/brief-compiler.md`, `brain/originality.md`, `PROOF_STANDARD.md` |
| Landing page, marketing site | `patterns/landing-pages.md`, `components/hero.md`, `psychology/` (attention, persuasion, trust), `components/footer.md` |
| Hero section | `components/hero.md`, `psychology/attention.md`, `foundations/typography.md` |
| Glow, gradients, grain, glass, "wow" effects | `components/visual-effects.md`, `brain/originality.md`, `motion/performance.md` |
Expand Down
9 changes: 5 additions & 4 deletions GETTING-STARTED.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,9 @@ node DesignOS/bin/designos.js elevate src/ --no-fail
node DesignOS/bin/designos.js report src/ --no-fail
```

Treat the agent's own score as a draft. The real score is the output from
`node DesignOS/bin/designos.js review <target>`. If the command reports findings, paste
Treat the agent's own score as a draft. `node DesignOS/bin/designos.js review <target>`
is a static risk gate, not the final design score; complete the evidence ledger in
`workflows/final-gate.md` before making a numeric claim. If the command reports findings, paste
`node DesignOS/bin/designos.js review <target> --fix-prompt --no-fail` back into the
agent and make it fix the file before accepting the delivery.

Expand Down Expand Up @@ -78,8 +79,8 @@ directly observable, not a black box:
`patterns/landing-pages.md`, …) — see `CLAUDE.md`'s routing table for how that
decision gets made.
2. It works through the Design Loop stages (`loops/design-loop.md`), not straight to code.
3. It ends with a scorecard (`scoring/rubric.md`) — and if any dimension is under 95,
it iterates *before* showing you, not after.
3. It ends with an evidence-backed scorecard (`scoring/rubric.md`) — unchecked dimensions
remain NOT ASSESSED, and reviewed failures route back into the loop.
4. It creates `memory/` files recording the decisions it made, with reasons.

Don't want to write a real brief yet? `examples/README.md` has four complete pages
Expand Down
Loading
Loading