Skip to content

AGENTS.md

Latest commit

 

History

History
60 lines (50 loc) · 2.35 KB

AGENTS.md

File metadata and controls

60 lines (50 loc) · 2.35 KB

Repository Guidelines

Project Structure (Bun Monorepo)

mcp-css-first/
├── packages/
│   ├── core/           # @css-first/core - shared CSS services
│   │   └── src/        # MDN client, suggestions, features, types
│   ├── cli/            # @depthark/css-first - npm package (stdio/HTTP)
│   │   └── src/        # MCP server entrypoint
│   └── worker/         # @css-first/worker - Cloudflare Workers (SSE)
│       └── src/        # McpAgent class for remote MCP
├── wrangler.toml       # Cloudflare Workers deployment config
└── smithery.yaml       # Smithery registry config

Build, Test, and Development Commands

bun install               # Install all dependencies
bun run build             # Build all packages
bun run build:core        # Build @css-first/core only
bun run build:cli         # Build @depthark/css-first only
bun run typecheck         # Type check all packages
bun run lint              # Run ESLint
bun run deploy:worker     # Deploy to Cloudflare Workers
bun run publish:cli       # Publish CLI to npm

Package-specific commands (run from package directory)

  • packages/cli: bun run build - bundles with @vercel/ncc
  • packages/core: bun run build - compiles TypeScript
  • packages/worker: bun run dev - local Cloudflare development

Coding Style & Naming Conventions

  • TypeScript with strict mode enabled
  • Indentation is 2 spaces; prefer double quotes
  • Use camelCase for variables/functions, PascalCase for types/classes
  • Follow ESLint rules (unused args prefixed with _)

Package Dependencies

  • @css-first/core is internal (private: true), shared between cli and worker
  • @depthark/css-first is publishable to npm
  • @css-first/worker is private, deployed to Cloudflare only

Testing Guidelines

  • No automated test runner configured
  • Rely on bun run typecheck and manual CLI testing
  • Test worker locally with cd packages/worker && bun run dev

Commit & Pull Request Guidelines

  • Conventional Commits style: feat:, fix:, chore:, docs:, refactor:
  • Keep commits scoped to single changes
  • PRs should pass: build, lint, typecheck

Deployment

  • npm: bun run publish:cli from root or npm publish from packages/cli
  • Cloudflare Workers: Auto-deploys on git push via wrangler.toml
  • Runtime target: Node.js 18+ / Bun