grayhook
0de128372f
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>
51 lines
2.7 KiB
Markdown
51 lines
2.7 KiB
Markdown
# 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**)._
|
||
|
||
---
|
||
|
||
## Закрыто
|
||
|
||
_Пусто._
|