Версия: 1.0.0 | Дата: 2026-05-01 | Автор: Элис
Источник: Paperclip: целеполагание
Цель = Work Package типа Epic (id: 5) или Feature (id: 4).
Не является целью: Task (id: 1), Bug (id: 7), User story (id: 6), Milestone (id: 2) — это операционные единицы.
├── [Epic] Стратегическая цель Q2
│ ├── [Feature] Тактическая цель 1
│ │ ├── [Task] Конкретная задача
│ │ └── [Task] Конкретная задача
│ └── [Feature] Тактическая цель 2
│ ├── [Task] Задача
│ └── [Task] Задача
└── [Epic] Стратегическая цель Q3 (будущее)
GET /api/v3/work_packages?filters=[{"type_id":{"operator":"=","values":["5"]}}]
Параметры:
type_id=5 — Epictype_id=5 OR type_id=4 для Epic + FeatureGET /api/v3/work_packages/{id}/children
Возвращает все дочерние WP независимо от типа.
Дерево целей — не динамическая структура. Достаточно 1 запроса в сессию (при старте исследования). Исключение: если заходишь после PATCH/создания WP — перезапросить.
Агент, получив дерево, должен оценить:
Результат анализа — краткий отчёт в комментарии к родительской Epic.
Человек создаёт Epic/Feature WP → агенты видят в дереве → без дополнительного аппрува → агент может:
[Предложение цели]## 🎯 Предложение цели
Краткое название предлагаемой цели
## 💡 Обоснование
Почему эта цель нужна прямо сейчас. Какая от неё польза.
## 🔗 Связь с существующими целями
Какие существующие Epic/Feature эта цель дополняет или заменяет.
## 🏷️ Предлагаемый тип
- [ ] Epic — стратегическая
- [ ] Feature — тактическая
## 📊 Примерная декомпозиция
- Задача 1
- Задача 2
- Задача 3
## ⏱️ Ориентировочные сроки
Когда можно начать, когда завершить.
Лимит: 3 предложения на агента в день. Счётчик сбрасывается в 00:00 UTC.
Когда человек аппрувит (комментарий «Принято», статус меняется на Accepted/Approved):
Создать дочерние WP (Task, Feature) с _links.parent.href на цель.
Пример создания дочерней задачи:
{
"_links": {
"type": {"href": "/api/v3/types/1"},
"project": {"href": "/api/v3/projects/{project_id}"},
"parent": {"href": "/api/v3/work_packages/{parent_id}"},
"assignee": {"href": "/api/v3/users/{user_id}"}
},
"subject": "Название задачи",
"description": {
"format": "markdown",
"raw": "## Что сделать\n\n...\n\n## DoD\n- ..."
}
}
Если новая цель связана с существующей — создать relation:
POST /api/v3/work_packages/{id}/relations
{
"_links": {
"to": {"href": "/api/v3/work_packages/{related_id}"},
"type": {"href": "/api/v3/relations/relation-types/{type_id}"}
}
}
Типы связей:
follows / precedes — последовательностьblocks / blocked — блокировкаparent / child — иерархия (через parent, не relation)related — просто связано| Ситуация | Аппрув? |
|---|---|
| Человек ставит цель | ❌ Не нужен |
| Агент предлагает новую цель (Epic/Feature) | ✅ Нужен |
| Агент предлагает декомпозицию для уже поставленной цели | ❌ Не нужен (если Task'и не затрагивают ресурсы других агентов) |
| Агент предлагает Task другому агенту | ✅ Нужен (нельзя назначать задачи другим агентам без аппрува) |
| Агент предлагает изменить приоритет цели | ✅ Нужен |
| Агент закрывает свою задачу | ❌ Не нужен (если DoD выполнена) |
| Агент предлагает закрыть чужую задачу | ✅ Нужен (комментарий исполнителю) |
| Декомпозиция затрагивает инфраструктуру/безопасность/деньги | ✅ Нужен |
Сводное правило: агент действует без аппрува в своей зоне ответственности. Всё, что выходит за её пределы (другие агенты, приоритеты, ресурсы, инфраструктура) — требует аппрува через Inbox.
| Параметр | Лимит |
|---|---|
| Предложений на агента в день | 3 |
| Максимум декомпозиции одной цели | 10 дочерних WP |
| Минимальный срок дочерней задачи | 30 минут (не плодить микрозадачи) |
| Время без реакции на Inbox-предложение | 24ч → эскалация комментом «⏰ Жду решения >24ч» |
## 🔄 Research-отчёт — {дата}
### Анализ дерева
| Цель | Статус | Прогресс | Замечания |
|------|--------|----------|-----------|
| [WP] | On track | 60% | — |
| [WP] | At risk | 30% | ⚠️ 2 задачи без assignee >24ч |
### Выводы и предложения
1. [Вывод/предложение]
2. [Вывод/предложение]
### Что сделано за период
- [Список действий со ссылками на WP]
### Требуется решение
- [Вопрос к человеку, если есть]
## ✅ Результат предложения
### Статус: {Принято / Отклонено}
**Если принято:**
- Создан: [WP#N](https://projects.poreklame.tech/work_packages/N)
- Дочерние задачи: список
- Деадлайн: {дата}
**Если отклонено:**
- Причина: {причина из комментария человека}
1. Агент (Мила) видит дерево целей: нет цели по GTM-анализу
2. Мила создаёт Inbox-задачу:
[Предложение цели] GTM-003: Анализ рынка AI-агентов маркетинга
3. Роман пишет комментарий: «Принято. Сделай Epic в проекте Агенты»
4. Мила:
a. Создаёт Epic WP#200 в проекте «Агенты и разработка»
b. Связывает с Inbox-задачей
c. Создаёт дочерние Feature/Task (декомпозиция)
d. Закрывает Inbox-задачу
5. Мила выполняет Task'и, закрывает их
6. При достижении прогресса 100% — закрывает Epic WP#200