Contributing

Contributions should preserve the repository contract: root .mdc files are the product, generated catalog assets are rebuilt from source, and project-control documentation stays in docs/openspec/.

Rule changes

1. Keep root-level .mdc files at the repository root.
2. Make rule guidance specific and reviewable.
3. Run npm test to validate rule structure.
4. Run npm run build:catalog to regenerate catalog assets and localized rule pages.

Pages changes

Use static VitePress pages, CSS, and small Node scripts. Do not introduce a frontend framework for this site.

Before submitting Pages changes, run:

npm test
npm run build:catalog
npm --prefix docs run build