G
GSD·Lean

Artifact Branding Reference

A proposed visual language for the HTML artifacts produced by /discuss, /plan, and /complete.

This is a style reference, not a generated artifact. It defines colors, type, and components only — it does not change any skill template, the CLI, or the structure (sections / IDs / dashboard JS) of the real documents. Porting these styles into skills/*/SKILL.md is separate follow-up work.

Direction: warm, editorial, Anthropic-adjacent — ivory paper, a clay accent, serif display headings. Distinct from the host-app lime (#C5F04A) the current examples inherited.

Foundations

Color palette

Defined as CSS custom properties; every artifact draws from this set.

Paper — page
#FAF9F5
Paper 2 — surface
#F2F0E9
Ink — text
#1F1E1C
Ink muted
#6B6862
Accent — clay
#C96442
Accent wash
#F3E2DC
Success
#5E7E4F
Warning
#9A7B2E
Danger
#A24B3C
Code surface
#2A2824
Foundations

Typography & prose

Headings: serif (Tiempos / Georgia). Body: system sans. Mirrors the prose blocks of REQUIREMENTS & DECISIONS.

A representative heading

Body copy sits in a warm system sans at a comfortable 1.6 line height. Inline references such as OnCourtHomeView.swift and links like the dependency graph use the clay accent so they read as interactive without shouting.

Captured during the discuss phase. Self-contained — a fresh session reads only this document.

Components

Status chips & progress dashboard

Used across PLAN (task states) and SUMMARY.

Done In progress Blocked Pending
9
Total tasks
5
Done
2
In progress
1
Blocked
1
Pending
Components

Tables

Affected files

Action tint: create modify delete — replaces the old #e6f4ea / #fef9e7 / #fce8e6 tints.

FileActionDescription
OnCourtHomeView.swiftcreateNew placeholder card reusing the empty-card token style.
OffCourtHomeView.swiftmodifyReorder body; surface the two shortcut rows above recents.
SearchView+legacy.swiftdeleteOverlay branch with no remaining trigger.

Task summary

IDWaveStatusTitleDeps
T-0011doneOn Court → coming-soon placeholder—
T-0042in-progressOff Court reorderT-001
T-0073blockedAnalytics wiringT-005
T-0093pendingFull verification passT-007, T-008
Components

Code blocks

Key-interface snippets in REQUIREMENTS / PLAN.

// OnCourtHomeView.headerBar — after
var headerBar: some View {
    HStack(spacing: 10) {
        Spacer(minLength: 0)
        ProfileAvatarLink(userEmail: userEmail, onSignOut: onSignOut)
    }
}
Components · issue #222

Dependency DAG

The legibility fix for many-task plans: wave swimlanes, two-line nodes, status shown by a left status bar + fill tint (survives crowding), de-cluttered edges, and a legend.

Wave 1 Wave 2 Wave 3 T-001 · On Court placeholder done T-002 · Token cleanup done T-003 · Remove search overlay done T-004 · Off Court reorder in progress T-005 · Shortcut rows done T-006 · Recents section in progress T-007 · Analytics wiring blocked T-008 · UI test sweep done T-009 · Verification pass pending
done in progress blocked pending critical path
Components · issue #222

Mockup frames

Frame the screen to its platform: an iOS app in scope → render inside an iPhone frame; a web app in scope → render inside a browser frame; a CLI tool in scope → render inside a terminal frame; a desktop app in scope → render inside a desktop-window frame. All four sit on a dark stage and embed inline. Used in REQUIREMENTS (target-layout mockups).

9:41 G Screen title Placeholder content area Component name A short supporting line of copy. Primary action Tab one Tab two
iPhone frame — for iOS app scope
app.example.com Product Docs Pricing Sign in Build it lean. A placeholder hero line describing the web surface in scope. Get started Learn more
Browser frame — for web app scope
gsd-lean — zsh — 120×32 ~/projects/my-app (main) $ uvx gsd-lean status Phase execute Cycle 1 Task T-003 Progress 2 / 9 done ~/projects/my-app (main) $ uvx gsd-lean plan-status Wave 1 · ✓ T-001 On Court placeholder ✓ T-002 Token cleanup ▶ T-003 Remove search overlay Wave 2 · ○ T-004 Off Court reorder ○ T-005 Shortcut rows ~/projects/my-app (main) $
Terminal frame — for CLI tool scope
GSD-Lean — Plan Plan Requirements Decisions Summary WAVES Wave 1 Wave 2 Wave 3 Wave 1 Run next task T-001 · On Court placeholder done · no deps T-002 · Token cleanup done · no deps T-003 · Remove search overlay in progress · no deps T-004 · Off Court reorder pending · deps: T-001 T-005 · Shortcut rows pending · deps: T-001, T-002 2 of 9 tasks complete
Desktop-window frame — for desktop app scope