# Signum documentation

This index points to current Signum documentation. It separates runtime references from historical planning and research notes.

## Start here

- `../README.md` - short onboarding entry point.
- `../QUICKSTART.md` - setup and first-run walkthrough.
- `../examples/README.md` - small, validator-backed examples.
- `how-it-works.md` - pipeline narrative and phase details.
- `reference.md` - current behavior, artifacts, schemas, and reference details.

## Canonical runtime sources

- `../commands/signum.md` - source of truth for the main `CONTRACT -> EXECUTE -> AUDIT -> PACK` pipeline.
- `../commands/init.md` - source of truth for `/signum:init`.

## Runtime and integration reference

- `reference.md`
- `api-reference.md`
- `artifact-path-inventory.md`
- `migration-notes.md`
- `init-scanner-behavior.md`
- `signum-command-structure.md`
- `shared-receipt-mapping.md`

## Maintainer and reliability docs

- `../ARCHITECTURE.md`
- `RELIABILITY.md`
- `SECURITY.md`
- `QUALITY_SCORE.md`
- `PLANS.md`

## Historical context

- `plans/`
- `research/`

Files under `plans/` and `research/` are background material. They are not canonical runtime documentation unless a current runtime doc or test explicitly says so.
