Ведение проекта
@dev-project
Ведёт проект разработки от старта до результата — заводит папку проекта, журнал (статус, решения, что дальше), чек-лист задач и память между сессиями, чтобы каждый раз продолжать с того же места, а не с нуля. Применяйте для «начнём проект», «на чём мы остановились», «что дальше», «сохрани прогресс», «возобнови работу», «покажи статус». Не подходит для самого написания кода (dev-build), тестирования (dev-test) или сбора требований (dev-spec).
Кому подходит навык Ведение проекта
- Тем, кто возвращается к работе через дни и недели — продолжить с того же места, а не с нуля.
- Разработчикам-одиночкам и фрилансерам — вести статус, решения и чек-лист в одном журнале.
- Командам MVP — связать этапы ТЗ → код → тесты единой памятью.
- Тем, кто ведёт несколько проектов — индекс проектов с путями и статусами.
Что можно сделать
- Завести проект — папку,
SPEC.mdи журналDEV-JOURNAL.md, плюс запись в индексе проектов. - Возобновить работу — в начале каждой сессии прочитать журнал и кратко пересказать, на чём остановились и что делаем сейчас.
- Записать решение — что выбрали, почему и какие альтернативы отвергли, сразу в момент выбора.
- Вести чек-лист задач — живой статус срезов: что сделано, что дальше, что отложено из MVP.
Связанные навыки: ТЗ и архитектура, Разработка, Тестирование.
Как это работает: два уровня памяти
Память агента (глобальная) помнит пользователя — ОС, установленные рантаймы, любимый стек икросс-проектные принципы; один раз узнал — больше не переспрашиваешь. Журнал проекта (per-проектный) помнит конкретную работу — статус, решения, баги и чек-лист. Каждая новая сессия по существующему проекту начинается с протокола возобновления: прочитать память → найти журнал → пересказать статус → продолжить с первой невыполненной задачи. Это превращает «начать заново» в «продолжить».
Полезные детали
- Правило немедленной фиксации: узнал, решил или закончил — сразу записать, не откладывая на конец сессии.
- Чек-лист срезов ведётся в журнале, а активная работа сессии — в todowrite; завершённая задача отмечается в обоих.
- Журнал до ~150 строк: если разросся — старое архивируется.
- Честный статус: «готово» пишется только когда запускалось и проверялось.
Готовы не терять прогресс? Запустите навык Ведение проекта или начните с целого ИИ-разработчика.
Что запоминается между сессиями?
Два уровня. Глобальная память помнит пользователя — ОС, установленные рантаймы, любимый стек икросс-проектные принципы. Журнал проекта помнит конкретную работу — статус, решения, баги и чек-лист срезов.
Нужно ли каждый раз пересказывать статус?
Да, в начале каждой сессии по существующему проекту выполняется протокол возобновления: прочитать память → найти журнал → кратко пересказать, на чём остановились и что делаем сейчас → продолжить с первой невыполненной задачи.
Где хранится журнал проекта?
В файле DEV-JOURNAL.md внутри папки самого проекта, рядом с SPEC.md. Шаблон — в references. Если журнал разрастается beyond ~150 строк, старое архивируется в DEV-JOURNAL.archive.md.
Можно ли хранить ключи API и токены в памяти?
Нет, никогда. Секреты, токены, пароли и ключи API в память и журнал попадать не должны — это риск. Память живёт на машине пользователя, и пихать туда секреты небезопасно.
Что если журнала проекта ещё нет?
Навык честно скажет: «Не вижу журнала проекта — давай создадим или уточни путь». Затем заводится папка, SPEC.md и DEV-JOURNAL.md, а проект записывается в индекс.
Это платно?
Навыком можно пользоваться в рамках тарифа AgentHere — оплата идёт за токены при работе модели. Точные лимиты смотрите на странице тарифов.
Ведение проекта и память
Связующее звено между dev-spec → dev-build → dev-test: отслеживать этапы, помнить решения и продолжать с того же места. Без этого каждая сессия начинается с нуля — агент переспрашивает, переделывает, забывает, почему выбрали этот стек.
Когда активирован
- «Начнём проект» / «создай проект» — заводит папку и журнал.
- Возврат к работе: «продолжим», «на чём мы остановились», «что дальше».
- «Сохрани прогресс», «запиши решение», «покажи статус проекта».
- В начале любой новой сессии по существующему проекту — протокол возобновления.
Не активируй для написания кода (dev-build), тестов (dev-test) или ТЗ (dev-spec) — эти навыки сами делают свою часть; этот навык её фиксирует.
Два уровня памяти
- Память агента (глобальная,跨-проектная) —
.agenthere/memory/ai-developer/:stack.md— предпочтения пользователя: ОС, установленные рантаймы (Node/Python), любимый стек, кодировки/пакетный менеджер. Один раз узнал — больше не переспрашиваешь.decisions.md—跨-проектные паттерны и принципы, которые пользователь хочет соблюдать всегда.projects.md— индекс проектов: название, путь к папке, статус, дата.
- Журнал проекта (per-проектный) — в папке самого проекта:
SPEC.md— ТЗ (ведёт dev-spec).DEV-JOURNAL.md— статус, решения, что дальше, чек-лист. Шаблон — вreferences/dev-journal.md.
Глобальная память — про пользователя; журнал проекта — про конкретную работу.
Протокол возобновления (КАЖДУЮ новую сессию по проекту)
В самом начале разговора, если есть существующий проект:
- Прочитай
.agenthere/memory/ai-developer/(все файлы) — узнаешь пользователя. - Найди папку проекта (спроси путь, если неоднозначно) и прочитай
DEV-JOURNAL.md+SPEC.md. - Кратко перескажи пользователю: на чём остановились, что decided, что делаем сейчас.
- Продолжай с первой невыполненной задачи в чек-листе журнала.
Это превращает «начать заново» в «продолжить». Без журнала агент честно скажет: «Не вижу журнала проекта — давай создадим или уточни путь».
Заведение нового проекта
- Создай папку проекта (или используй текущую рабочую).
- Положи туда
SPEC.md(через dev-spec) иDEV-JOURNAL.md(из шаблона). - Запиши проект в
.agenthere/memory/ai-developer/projects.md. - Узнай окружение один раз и сохрани в
stack.md: ОС, есть ли Node/Python, пакетный менеджер, любимый язык. Больше не переспрашивай.
Журнал — что и когда записывать
Журнал (DEV-JOURNAL.md) ведёт навык dev-project, но записывают все этапы:
| Событие | Что записать | Когда |
|---|---|---|
| Решение по архитектуре/стеку | что выбрали + почему + отвергнутые альтернативы | сразу в dev-spec |
| Готовая задача из чек-листа | [x] + дата | сразу в dev-build после коммита |
| Найденный/починенный баг | кейс + корень + фикс | сразу в dev-test |
| Новая задача всплыла | [-] строка в чек-лист | когда обнаружили |
| Решение «не делать в MVP» | что и почему отложено | сразу |
Правило немедленной фиксации: узнал/решил/закончил → сразу запиши. Не откладывай на конец сессии — к концу забудется половина, а контекст мог сжаться.
Чек-лист задач (todowrite)
Для активной работы используй инструмент todowrite — живой чек-лист текущей сессии
(быстро, в контексте). Журнал DEV-JOURNAL.md — долговечная запись между сессиями.
Связь: завершённую задачу из todowrite отметь и в журнале ([x] + дата).
Что НЕ хранить
- Болтовню, временные состояния, логи разговоров, дубликаты.
- То, что легко перепроверить (содержимое файлов — есть же
read). - Секреты, токены, пароли, ключи API — никогда. (РФ-резидентность данных: память живёт на машине пользователя; пихать туда секреты — риск.)
- Журнал — до ~150 строк; если разросся — архивируй старое в
DEV-JOURNAL.archive.md.
Границы (✅ / ⚠️ / 🚫)
- ✅ Всегда: протокол возобновления в начале сессии; запись решения сразу; обновлять чек-лист после каждого среза.
- ⚠️ Спросить: перед удалением/архивацией больших кусков журнала; перед сменой зафиксированного решения (объясни, что меняется и почему).
- 🚫 Никогда: не хранить секреты; не перезаписывать чужие файлы журнала без подтверждения; не врать в статусе («готово», когда не запускалось).
Выходные критерии
- В начале сессии по существующему проекту выполнен протокол возобновления.
- Каждое решение/завершённая задача/баг записаны в журнал.
-
stack.mdхранит окружение пользователя (чтобы не переспрашивать). - Чек-лист в журнале отражает реальное состояние (что сделано, что дальше).
- Нет секретов в памяти/журнале.
Шаблон журнала — references/dev-journal.md.