Contributing

Please read the agent onboarding file at AGENTS.md and the full implementation plan at PLAN.md before contributing.

Quick start

git clone https://github.com/doeixd/flue-eve.git
cd flue-eve
npm install -g vite-plus
vp install
vp test

File	Purpose
`PLAN.md`	Authoritative implementation plan
`AGENTS.md`	Agent onboarding and project orientation
`DEPLOYMENT.md`	Production deployment guide
`test/ATTRIBUTION.md`	Eve-derived test provenance
`flue-eve/SKILL.md`	AI agent skill for migration workflows
`packages/`	Monorepo packages

vp test           # full suite (375+ tests, 67 files)
vp exec -- vitest run  # specific package

# Build all packages
pnpm -r run build

# Build docs
pnpm --filter @flue-eve/docs build

# Dev docs
pnpm --filter @flue-eve/docs dev

The repo includes a skills.sh-compatible skill at flue-eve/SKILL.md. Install it to guide AI coding agents through Eve → flue-eve migrations:

npx skills add doeixd/flue-eve