Skip to content

feat(cli): give agents a complete, ready-to-assemble page kit (not just a search result)#3103

Merged
josephfarina merged 1 commit into
mainfrom
feat/cli-build-kit
Jun 25, 2026
Merged

feat(cli): give agents a complete, ready-to-assemble page kit (not just a search result)#3103
josephfarina merged 1 commit into
mainfrom
feat/cli-build-kit

Conversation

@josephfarina

@josephfarina josephfarina commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

🎯 Why this exists

Part of a broader push to make Astryx the easiest design system for AI agents to build real UIs with — one-shot, no escape hatches, no broken renders. We're vibe-testing the full agent journey (install → init → discover → compose → build → typecheck → render) and fixing every friction point it surfaces, so an agent given a one-line prompt lands a correct, fully-styled, type-safe page using only design-system components.

Summary

Turns astryx build "<idea>" into a complete, agent-ready composition kit, grouped by role:

  • START — the single recommended path (scaffold a page vs compose).
  • PAGE — closest page template (direct match or layout reference).
  • FRAME (always) — the page shell (AppShell / Layout + nav).
  • BLOCKS — idea-specific composed patterns (relevance floor cuts noise).
  • DOMAIN COMPONENTS — idea-specific atoms (floored, excludes the always-on kit).
  • FOUNDATION (always) — layout/typography/action primitives.
  • SETUP — CSS imports + no-<div> reminder.

Why

An agent-grounded eval (what successful builds actually imported) showed build surfaced only ~15% of the pieces agents needed — because the structural primitives every page needs (AppShell, Stack, Grid, Card, Text, Button…) never keyword-match an idea, so search never returned them. Always-on FRAME + FOUNDATION + a relevance floor took component recall 15% → 71%, especially for off-template (compose-from-scratch) ideas.

Stacked on #3097 (build command + ranking).

Test plan

  • astryx build "a kanban board" shows FRAME + FOUNDATION + idea-specific blocks/components
  • astryx build "a settings page" direct-matches the page + still lists the kit
  • npx vitest run packages/cli green

Made with Cursor

@vercel

vercel Bot commented Jun 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
astryx Ignored Ignored Jun 25, 2026 6:51pm

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Jun 25, 2026
@josephfarina josephfarina changed the title feat(cli): build composition kit — always-on FRAME + FOUNDATION + relevance floor feat(cli): give agents a complete, ready-to-assemble page kit (not just a search result) Jun 25, 2026
@josephfarina josephfarina deleted the branch main June 25, 2026 18:47
@josephfarina josephfarina reopened this Jun 25, 2026
@josephfarina josephfarina changed the base branch from feat/cli-build-command to main June 25, 2026 18:49
…vance floor

`build "<idea>"` now returns a role-grouped kit: START → PAGE → FRAME (always)
→ BLOCKS → DOMAIN COMPONENTS (floored) → FOUNDATION (always) → SETUP. The
always-on FRAME/FOUNDATION surface the structural primitives every page needs
but that never keyword-match an idea (component recall 15% -> 71% on an
agent-grounded eval).

Co-authored-by: Cursor <cursoragent@cursor.com>
@josephfarina josephfarina enabled auto-merge (squash) June 25, 2026 18:52
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Vercel Preview Deployment

Status ✅ Deployed
Preview Open Preview
Commit 2bc982d
Inspect Vercel Dashboard
Workflow View Logs

No authentication required — anyone with the link can view the preview.

@josephfarina josephfarina merged commit 7f46cdb into main Jun 25, 2026
15 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

🧪 Sandbox Preview

View Sandbox for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

No new or modified components detected.

Bundle Size Summary

Package Size (ESM) Size (CJS) Gzipped
@astryxdesign/core N/A 4.6KB 0B

Accessibility Audit

Status: No accessibility violations detected.


Generated by PR Enrichment workflow | Storybook | Sandbox | View full report

github-actions Bot added a commit that referenced this pull request Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants