Add agent workflow for phased development.

Introduce AGENTS.md, TODO maintenance rules, BACKLOG, and Cursor rules so agents can run the full cycle: changes, review, fixes, and commits. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-17 09:18:06 +07:00
parent 0622ccbb32
commit 0de128372f
5 changed files with 368 additions and 0 deletions
@@ -0,0 +1,50 @@
+# BACKLOG — pi-skill-reinject
+
+Журнал **открытых** ограничений и сбоев при разработке, ручном тесте с `pi`, интеграции с [pi-auto-compact](https://github.com/capyup/pi-auto-compact) или неясностях API Pi.
+
+Не путать с [`TODO.md`](./TODO.md): там план разработки; здесь — наблюдения из runtime, которые потом закрывают пачкой (правка кода, документация, issue upstream Pi).
+
+Правило для агентов: [`.cursor/rules/dev-backlog.mdc`](./.cursor/rules/dev-backlog.mdc).
+
+---
+
+## Когда добавлять пункт
+
+- Поведение Pi / extension API не совпало с [`SPEC.md`](./SPEC.md) или [документацией Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/extensions.md).
+- Ошибка или гонка при совместной работе с pi-auto-compact (`sendUserMessage`, `before_agent_start`, follow-up).
+- Ручной E2E не воспроизводится стабильно; обходной путь есть, но хрупкий.
+- Неясность в публичном API (события без `reason`, формат entries, settings merge).
+- Пришлось дублировать приватную логику Pi — зафиксировать риск и желаемый upstream.
+
+**Не добавлять:** ожидаемое «extension выключен по умолчанию»; отсутствие установленного `pi`; разовый сбой без воспроизведения; пункты из плана фаз (это `TODO.md`).
+
+---
+
+## Формат пункта
+
+Следующий свободный id: **`B-###`** (смотреть заголовки ниже, увеличивать номер).
+
+```markdown
+### B-001 · open · pi-api · 2026-06-17
+
+- **Сценарий:** что пытались сделать
+- **Проблема:** одно предложение — в чём затык
+- **Место:** `session_compact` / `before_agent_start` / pi-auto-compact / `src/…`
+- **Факт:** текст ошибки, неожиданное поведение, расхождение с SPEC
+- **Обход:** что сработало (или «нет»)
+- **Предложение:** правка в extension / SPEC / issue в Pi / pi-auto-compact
+```
+
+При закрытии: статус `open` → `done`, дата закрытия, ссылка на коммит/issue; блок перенести в [Закрыто](#закрыто).
+
+---
+
+## Открыто
+
+_Новые пункты — ниже (следующий id: **B-001**)._
+
+---
+
+## Закрыто
+
+_Пусто._