SyncytiumMD / rules

---
description: >-
  Every change ships green: typecheck, build, tests, lint, and zero context
  drift
alwaysApply: true
---
<!--
  ⚠️ AUTO-GENERATED BY SYNCYTIUM-MD ⚠️
  This file is automatically synchronized from .syncytium/
  Do not edit manually unless you plan to run reverse-sync.
  Source of truth: .syncytium/
-->

# Release Criteria

A change is not done until all of these pass locally:

```bash
npm run typecheck   # tsc --noEmit over src/ and tests/
npm run build       # tsup, ESM + .d.ts
npm test            # 114 tests, node --experimental-strip-types
npm run verify      # all three, in order
```

## Before opening a PR

- `node dist/cli/index.js lint` — canonical rules and frontmatter are valid.
- `node dist/cli/index.js diff` — **no** drift between `.syncytium/` and the
  committed bridge files. Commit the regenerated files together with the change.
- `node dist/cli/index.js doctor` — no `error` checks. Warnings are acceptable
  only when they are pre-existing and unrelated.

## Releasing

`npm run release` runs the whole pipeline and **fails loudly**:

1. `typecheck` → `build` → `test`
2. `npm publish`
3. polls `npm view` with exponential backoff until the version is served
4. `npm install -g` and verifies the installed version

Never hand-edit `src/version.ts` or `package.json` version independently: a unit
test asserts they match, and `--bump` updates both together.

## Definition of done

- New behaviour has a test that fails without the change.
- Public behaviour changes are reflected in `README.md` **and** `README.tr.md`.
- Architectural decisions go into `.syncytium/memory/decisions.md` via
  `syncytium adr add`.
- The handoff baton is updated before the turn ends:
  `syncytium handoff --from "<agent>" -g "<goal>" -d "<done>" -t "<todo>"`.