AI Agent Instructions

Project: {{PROJECT_NAME}}

Skills

This project uses forge skills:

Installing Skills

If skills are not already available, install them:

npx skills add codervisor/forge@codervisor-forge -g -y
npx skills add codervisor/lean-spec@leanspec-sdd -g -y

Conventions

• Version source of truth: Root package.json — never edit versions elsewhere directly
• Workspace protocol: Use workspace:* for internal deps during development
• Specs first: Create a spec before starting non-trivial work
• CI must pass: All PRs require passing CI (Node + Rust checks)

Build & Test

pnpm install          # Install dependencies
pnpm build            # Build all packages
pnpm test             # Run tests
pnpm typecheck        # Type check
pnpm lint             # Lint
cargo test --workspace  # Rust tests
cargo clippy --workspace  # Rust lints

Publishing

Publishing is handled by CI via .github/workflows/publish.yml. See publish.config.ts for configuration.

Manual version bump:

npm version patch     # Bump version in root package.json
pnpm tsx scripts/sync-versions.ts  # Propagate to all packages