Plane Task Template (AI Agents)

Стандартный шаблон для Plane-задач, которые выполняют AI-агенты в репозитории MyHoreca Pay.

Использование:

• скопировать в описание Plane issue при создании или импорте задачи;
• заполнить и сохранить в docs/docs/ai-agents/current-plane-task.md как активную задачу агента;
• при CSV/import package каждая строка обязана содержать уникальный Import key (например MHPAY-AI-001).

См. также: Plane Task Execution Rules, AI Agents Rules, корневой AGENTS.md.

---

Title

<Краткое название задачи>

Meta

Field	Value
Project	myhoreca-pay
Project ID	6d869637-4d3a-4836-9627-841d112da980
Issue	MHPAY-XXX
Issue ID	<UUID из Plane>
Import key	MHPAY-XXX-NNN
State	Backlog / Todo / In Progress / Done
Priority	urgent / high / medium / low / none
Labels	plane, MVP, ai-agent, docs, p0, …
Plane URL	https://dev.serty.top/myhoreca-pos/browse/MHPAY-XXX/
Updated	YYYY-MM-DD

Context

<Почему задача нужна сейчас; какой продуктовый/технический контекст; ссылки на ADR, отчёты, инциденты.>

Goal

<Одно предложение: измеримый результат для оператора/разработчика/агента.>

Required Decisions And Rules

- <Уже принятые решения, которые агент не должен переоткрывать без ADR/новой задачи.>
- <Ссылка на ADR, permission matrix, adapter policy, если применимо.>

Scope / What To Do

- [ ] <Конкретное действие 1>
- [ ] <Конкретное действие 2>
- [ ] <Обновить docs/tests по затронутой области>

Out of Scope / Non-goals

- Не менять unrelated-код.
- Не расширять scope без отдельной Plane-задачи или ADR.
- Не коммитить реальные банковские файлы, secrets, raw bank lines, полные номера счетов.
- <Другие явные исключения для этой задачи.>

Acceptance Criteria

- [ ] <Проверяемый критерий 1>
- [ ] <Проверяемый критерий 2>
- [ ] Документация обновлена там, где требуется задачей.
- [ ] Тесты добавлены/обновлены или явно указано, почему не требуются.

Definition of Done

- Все пункты Scope и Acceptance Criteria выполнены.
- Запущены Verification Commands; в handoff указаны точные команды и результаты.
- current-implementation-state.md обновлён (date, summary, changed files, API/routes, tests, gaps).
- codegraph/manifest.yaml обновлён, если менялись architecture/API/routes/hooks/contracts/tests boundaries.
- Plane issue переведён в Done; в комментарии — краткий отчёт и commit hash (если был коммит).
- Не заявлено «тесты прошли», если команды не запускались.

AI Agent Instructions

- Прочитать AGENTS.md, codegraph/manifest.yaml, project-prompt, current-implementation-state, current-plane-task.
- Targeted repo inspection only — не сканировать весь репозиторий.
- Сначала найти существующие реализации, тесты, docs и паттерны; переиспользовать.
- Не расширять scope без отдельной Plane-задачи.
- После итерации обновить документацию, тесты и current-implementation-state.md.

Targeted Repo Inspection

Files to read first

1. AGENTS.md
2. codegraph/manifest.yaml
3. docs/docs/ai-agents/project-prompt.md
4. docs/docs/ai-agents/current-implementation-state.md
5. docs/docs/ai-agents/current-plane-task.md
6. <domain-specific paths из manifest api_surface / modules.backend / frontend pages>

How to find existing implementations

- codegraph/manifest.yaml → api_surface, shared_symbols, test pointers
- docs/docs/backend/api.md для контрактов API
- frontend/src/api, hooks, pages по manifest
- backend tests: ArchitectureTests, domain-specific *Tests.csproj
- grep/поиск по символу только после сужения области из manifest

Prohibitions

- Запрещён broad repo scan «на всякий случай».
- Запрещено менять runtime backend/frontend, если задача docs-only.
- Запрещено добавлять бизнес-решения без ADR.

Implementation Notes

- <Технические подсказки: какие классы/модули трогать, порядок шагов, feature flags.>
- <UUID v7 через IUuidGenerator для новых entity ID; JSON только через PayJsonSerializer.>

Test Plan

- Unit: <проект/класс/сценарий>
- Integration: <если нужен PostgreSQL container / live profile>
- Architecture: <MyHoreca.Pay.ArchitectureTests при смене слоёв>
- Frontend: npm test / lint для затронутых hooks/components
- Не удалять существующие regression tests.

Documentation Plan

- docs/docs/backend/api.md — при изменении API
- permission matrix — при изменении RBAC
- adapter changelog/fixtures — при изменении bank adapter
- docs/docs/.vitepress/config.ts — при новой странице в sidebar
- ADR в docs/docs/architecture/adr/ — при архитектурном решении

Security / Audit / Safety

- Не логировать secrets, tokens, credentials, raw bank files, raw bank lines, полные номера счетов.
- Критичные действия (payment write, Syrve/iiko write, credential rotation) — audit trail.
- Syrve/iiko writes: idempotent, approval-gated, feature-flagged где требуется продуктом.

Data & Privacy

- Только sanitized fixtures в тестах и docs.
- No real bank files.
- No secrets in source, appsettings, .env commits, logs, comments, or test output.
- No raw bank lines / full account numbers in logs, docs, or Plane comments.

Permission / RBAC Impact

None — <или перечислить новые/изменённые permissions и обновление permission matrix>

Bank Adapter Impact

None — <или: adapter id, version bump, changelog, sanitized fixtures, adapter tests>

API / Frontend Impact

None — <или: endpoints, DTOs, routes, hooks, apiContracts.ts>

Verification Commands

# Указать узкий набор команд для этой задачи, например:
dotnet test backend/tests/MyHoreca.Pay.ArchitectureTests/MyHoreca.Pay.ArchitectureTests.csproj
cd frontend && npm run lint && npm test
cd docs && npm run build

Handoff / State Update Checklist

- [ ] current-implementation-state.md обновлён
- [ ] current-plane-task.md переключён на следующую задачу (если применимо)
- [ ] codegraph/manifest.yaml обновлён (если применимо)
- [ ] Plane: комментарий с отчётом + commit hash
- [ ] Plane: state → Done
- [ ] Указаны команды verification и фактический результат (pass/fail/skip + причина)

---

Example (filled skeleton)

См. активную задачу: current-plane-task.md.