Adds a dedicated "The Laws of UX" section covering all 30 laws from
lawsofux.com, grouped into five themes (perception & grouping, choice &
cognitive load, memory & attention, expectation & behavior, performance &
responsiveness). Each law gives a one-line principle, a concrete code/product
application, and a "↔ H#" cross-reference to the heuristic that already
operationalizes it — so the laws (the why) and the 50 heuristics (the check)
stay in sync without duplication.
Supporting edits: workflow step 3 applies the laws where relevant and lets
reviews cite them by name; step 5 notes which laws dominated; the intro credits
lawsofux.com; the description mentions the Laws of UX catalogue; skill bumped
to v1.1. CHANGELOG gets a 0.9.0 entry.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The description contained an unquoted colon-space ("when it exists: the
design system..."), which YAML parses as a nested mapping and rejects with
"mapping values are not allowed in this context". Replaced the colon with an
em dash, matching the aside style used elsewhere in the description. Verified
the frontmatter now parses.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The pipeline diagram was the one place Design Better wasn't represented.
Adds it to the Build column, aligned with the column body like Design System
in Plan & Design.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Reworks the ProductOS `studio-build-design-better` skill into a standalone
BuilderOS skill:
- Renamed `studio-build-design-better` -> `design-better` (kebab-case, matching
the folder and the rest of the catalog)
- Rewired document paths from ProductOS conventions (`docs/DESIGN.md`,
`docs/PRODUCT.md`, `design/1. Product Identity.md`) to BuilderOS ones
(`docs/design.md`, `docs/product-vision.md`)
- Softened the hard "stop if DESIGN.md is missing" dependency into a
codebase-convention fallback so the skill is fully standalone
- Repointed skill references from `studio-design-design-system` /
`studio-build-design-review` to the Design System skill and the Build Loop
review step
- Added BuilderOS license/author/version frontmatter
Also registers the skill in the catalog: README Build section, installation
list, docs/ consumption table, and getting-started, plus a CHANGELOG 0.8.0
entry mirroring the build-mvp migration.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
design.md (agent, source of truth) and design.html (human) are now twin
artifacts written and edited together so they never drift.
- New Step 6 builds a single self-contained, token-driven design.html
that renders every color, type level, spacing/radius step, elevation,
and component (with variants and states) live, with a light/dark
toggle when both modes exist
- Handoff renumbered to Step 7 and references both files
- Modes and Editing sections enforce md<->html sync; skill bumped to v1.1
- README skill row, docs-flow table, and changelog 0.7.0 updated
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Remove per-phase branch/push/PR workflow; phase boundaries are now
verification-only
- Add rule: no git/GitHub actions until every phase is complete
- New Wrap up section: git init with stack-appropriate .gitignore,
initial commit, then ask the user about connecting a remote
- README and changelog updated
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- All install commands and cross-skill links updated from
BuildGreatProducts/BuilderOS to BuildGreatProducts/builder-os
- README opens with a note that BuilderOS is the successor to PLAID,
linking to the original repo
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Rename all eight skill folders to kebab-case and align Build Loop
frontmatter names with their folders
- Product Planner Step 0: read docs/product-idea.md before the intake,
confirm direction, pre-fill sections 1-3; cold open only when absent
- README Installation section for npx skills add (bundle, by path, by
name, manual); MIT LICENSE.txt; Build Loops gain license/metadata
frontmatter; changelog 0.4.0
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Intake answers now saved as human-readable docs/VISION.md; VISION-SCHEMA.md
replaced by VISION-TEMPLATE.md defining the markdown structure, field rules,
and validation steps
- TECH-STACK-OPTIONS.md expanded across every category (web/mobile/desktop
frontend, backend, database, auth, payments) and reframed as a baseline,
not a boundary
- Skill now researches beyond the options file via web search for unlisted
tools, unusual product needs, or stale recommendations
- Design System skill reads docs/VISION.md for pre-filled context
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Idea Generator, Idea Validator, Product Planner, Design System, Launch Checklist
- All PLAID/ProductOS references removed; skills cross-reference each other
by BuilderOS name and work standalone
- All outputs standardized to docs/ at the project root (vision.json moved
from project root to docs/)
- Product Planner validates vision.json against VISION-SCHEMA.md directly,
dropping the Node validator script dependency
- README rewritten around the full lifecycle; changelog 0.2.0
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Chris Ashby