Zasady

Statusy

Każdy komponent (*.docs.json, pole status) i każda strona treści (frontmatter, pole status) ma jeden z trzech statusów:

Status	Znaczenie
draft	Istnieje, ale kontrakt może się jeszcze zmienić bez zapowiedzi; przegląd a11y niekoniecznie zrobiony
stable	Kontrakt (propsy/treść) jest zamrożony; zmiana łamiąca wymaga nowej wersji semver pakietu, nie cichej edycji
deprecated	Nie używać w nowym kodzie; istnieje tylko dla zgodności wstecznej, ma wskazany zamiennik

Podniesienie statusu na stable wymaga: realnej treści (nie @todo), przeglądu a11y (a11y.reviewed: true w docs.json dla komponentów) i przejścia walidatorów statycznych. Status stable nie jest ustawiany „na wyrost”.

PR-flow

Ten pakiet (/design) jest samodzielnym workspace pnpm w tym samym repo co www//zenon/ — obowiązują go te same zasady co całe repo Polisoteki (patrz AGENTS.md w korzeniu repo): feature branch → commit (<type>(<scope>): <subject> + #<issue>) → PR → zgoda Human. Bez wyjątków dla „to tylko dokumentacja”.

Przed PR-em, w zależności od zmienionego pakietu:

Zmiana w	Komenda
tokens/src/**	pnpm -F tokens build && pnpm -F tokens check
ui/src/**	pnpm -F ui test && pnpm -F ui typecheck
docs/src/**	pnpm -F docs build
cokolwiek	bash run.sh (+ AUDIT=1 bash run.sh przed release)

AI-first-review

Agent AI (Claude Code lub inny) wykonuje zmiany w /design po przeczytaniu AGENTS.md, ale nowy krok pracy i każdy zapis do repo wyłącznie za wyraźną zgodą Human — deliverable najpierw do review, jeden krok naraz. To dotyczy też tej strony: zmiana zasad governance jest decyzją Human, nie czymś, co agent ustala sam i wpisuje.

Conventional Commits → changelog

CHANGELOG.md (korzeń /design) jest docelowo generowany z historii commitów Conventional Commits (feat/fix/task/…), nie edytowany ręcznie. Generator jeszcze nie istnieje: plik dziś jest utrzymywany ręcznie (sekcja [Unreleased], format Keep a Changelog) przy każdym PR zmieniającym /design. Render pliku na stronie → Governance → Changelog (dziś szkielet).