Contributing

Prism is currently a single-owner project, there's no external-contributor process yet beyond GitHub issues. This page summarizes the real workflow used in the repository (docs/engineering/development-workflow.md and docs/engineering/contribution-guide.md are authoritative).

BranchingCopy Anchor Link

Two permanent branches: main (stable, release-ready, protected, PR + review + passing CI required) and dev (integration branch for completed phase work). All implementation happens on a phase/NN-short-name branch cut from dev.

Before a change is considered completeCopy Anchor Link

• pnpm verify passes, format check, lint, typecheck, unit tests, type-level tests, build.
• Documentation under docs/ is updated in the same change, not as a follow-up.
• The relevant log under docs/logs/ is updated with what actually happened.
• A merge into main requires the project owner's explicit, separate approval, always, never inferred from "the phase is done."

StandardsCopy Anchor Link

TypeScript strict mode throughout, no any as a shortcut, no global mutable registries, no dependency added without a one-line justification. See CLAUDE.md and .claude/rules/ in the repository for the full, current rule set.