rollback-policy.md

Rollback Policy

Purpose

Цей документ визначає, як відкотити помилковий або шкідливий agent write у memory-system.

When rollback is needed

• agent створив некоректний canonical update;
• було зламано links або referential integrity;
• vault-index став неузгодженим із knowledge docs;
• був помилково переписаний decision замість створення нового superseding doc.

Rollback rules

1. Не виправляти безслідно

Rollback не повинен приховувати сам факт помилкового write. Якщо проблема суттєва, потрібно лишити короткий trace в note або task log.

2. Prefer Git as source of truth

Якщо помилка вже потрапила в робочу гілку, основний rollback виконується через Git diff/history, а не через ручне “згладжування” документа.

3. Canonical docs відновлювати обережно

Якщо пошкоджено canonical doc:

• відновити останню валідну версію змісту;
• перевірити links, supersedes, superseded_by;
• повторно прогнати validator.

4. Notes не знищувати без потреби

Якщо помилковий write був у note, краще:

• позначити його як archived, або
• залишити як trace з поясненням, чому він більше неактуальний.

Rollback checklist

1. Визначити, які docs були зачеплені.
2. Перевірити, чи зламалися links або vault-index.
3. Відновити валідний content state.
4. Прогнати memory_tool validate.
5. За потреби залишити короткий rollback note.