Skip to content

feat(context): add auro context command for AI assistant onboarding#296

Open
lindseyo1123 wants to merge 3 commits into
devfrom
feat/context-command
Open

feat(context): add auro context command for AI assistant onboarding#296
lindseyo1123 wants to merge 3 commits into
devfrom
feat/context-command

Conversation

@lindseyo1123

Copy link
Copy Markdown

Summary

Adds a new auro context command that prints an AI-ready context document describing the Auro Design System — component list, package names, usage patterns, and coding rules — for priming AI coding assistants (Claude, Cursor, Copilot, etc.).

When a developer asks an AI assistant to "build a form with Auro," the assistant often hallucinates component names or falls back to plain HTML because it has no grounding in Auro's actual API. Piping this context document in fixes that cold-start problem.

Usage

# Print to stdout
auro context

# Write to a file to paste/attach in an AI tool
auro context --output AURO_CONTEXT.md

Changes

  • src/static/auroContext.ts — the context document, exposed via a new #static/* import alias
  • src/commands/context.ts — the command, supporting stdout and --output <file>
  • Wires #static/* into package.json imports, tsconfig.json paths, and the esbuild build config (build-scripts/build-config.js)
  • Registers the command in src/index.ts
  • Documents the command in the README.md

Testing

  • npm run build succeeds
  • auro context prints the document to stdout (exit 0)
  • auro context --output <file> writes the document and prints a success message

Prior art

Inspired by Meta's Astryx design system, which ships an npx astryx init flow that generates AI-agent documentation for consuming projects. This is the Auro equivalent as a first step toward broader agent-readiness.

Adds a new 'auro context' command that prints an AI-ready context document
describing the Auro Design System — component list, package names, usage
patterns, and rules — for priming AI coding assistants (Claude, Cursor,
Copilot, etc.).

- src/static/auroContext.ts: the context document, exposed via a new
  #static/* import alias
- src/commands/context.ts: the command, supporting stdout and --output <file>
- Wires #static/* into package.json imports, tsconfig paths, and the esbuild
  build config
- Documents the command in the README

Inspired by prior art in Meta's Astryx design system (npx astryx init).
@lindseyo1123
lindseyo1123 requested a review from a team as a code owner July 7, 2026 22:28

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @lindseyo1123, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🚀 PR Release Published! @aurodesignsystem-dev/auro-cli@0.0.0-pr296.0 View on npmjs.com

Addresses review findings — the doc shipped examples that would mislead the
AI assistants it exists to ground:
- auro-formkit: label is a slot, not an attribute; import via subpath
  (no root export) instead of a bare package import
- auro-icon: use a real icon name (plane-side-fill) and drop the non-existent
  customSize property
- design tokens: correct prefixes to --ds-basic-* / --ds-advanced-*
- auro-pane and auro-nav: accurate descriptions
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🚀 PR Release Published! @aurodesignsystem-dev/auro-cli@0.0.0-pr296.1 View on npmjs.com

Reconcile the component set with llms.txt and the auro cem component list so
all three sources agree.
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🚀 PR Release Published! @aurodesignsystem-dev/auro-cli@0.0.0-pr296.2 View on npmjs.com

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant