Skip to content

AGENTS.md

Latest commit

 

History

History
47 lines (32 loc) · 1.71 KB

AGENTS.md

File metadata and controls

47 lines (32 loc) · 1.71 KB
Raw

Alpha Style

Alpha Style is a multi-provider skill repo that packages Alpha's design language for AI harnesses.

Repository Purpose

Maintain a single source of truth for Alpha-branded design skills, then transform them into provider-specific outputs for Codex, Claude Code, Cursor, Gemini CLI, Copilot-compatible agents, and related tools.

Source Of Truth

Edit files under source/skills/.

  • source/skills/alpha-style/ contains the primary Alpha design system skill
  • source/skills/teach-alpha-style/ contains the project setup flow
  • Other directories contain focused command skills such as audit, critique, normalize, polish, typeset, and overdrive

Do not hand-edit generated provider outputs unless you are debugging the build pipeline.

Key Directories

  • source/skills/ - canonical skills and references
  • scripts/ - build pipeline that transforms source into provider outputs
  • dist/ - generated bundles and provider directories
  • .codex/, .claude/, .cursor/, etc. - synced generated skill folders
  • public/ - static marketing site and supporting assets
  • server/ - local development server
  • tests/ - Bun test suite for transforms and downloads

Build Workflow

bun install
bun run build

The build regenerates:

  • provider skill outputs in dist/
  • synced local provider folders at the repo root
  • static API data for the marketing site

Contributor Notes

  • Preserve attribution in NOTICE.md
  • Keep Alpha defaults grounded in real Alpha frontend patterns
  • Prefer updating source/skills/alpha-style/ and its references over scattering brand guidance across command skills
  • When changing names, prefixes, or provider behavior, run the build and tests before shipping