development
Ведение проекта

Ведение проекта

@dev-project

1 000 000 токенов в подарок
бесплатно при регистрации — для знакомства с агентом
0 установокобновлено сегодняПубличный
О навыке

Ведёт проект разработки от старта до результата — заводит папку проекта, журнал (статус, решения, что дальше), чек-лист задач и память между сессиями, чтобы каждый раз продолжать с того же места, а не с нуля. Применяйте для «начнём проект», «на чём мы остановились», «что дальше», «сохрани прогресс», «возобнови работу», «покажи статус». Не подходит для самого написания кода (dev-build), тестирования (dev-test) или сбора требований (dev-spec).

Инструкции

Ведение проекта и память

Связующее звено между dev-spec → dev-build → dev-test: отслеживать этапы, помнить решения и продолжать с того же места. Без этого каждая сессия начинается с нуля — агент переспрашивает, переделывает, забывает, почему выбрали этот стек.

Когда активирован

  • «Начнём проект» / «создай проект» — заводит папку и журнал.
  • Возврат к работе: «продолжим», «на чём мы остановились», «что дальше».
  • «Сохрани прогресс», «запиши решение», «покажи статус проекта».
  • В начале любой новой сессии по существующему проекту — протокол возобновления.

Не активируй для написания кода (dev-build), тестов (dev-test) или ТЗ (dev-spec) — эти навыки сами делают свою часть; этот навык её фиксирует.

Два уровня памяти

  1. Память агента (глобальная,跨-проектная).agenthere/memory/ai-developer/:
    • stack.md — предпочтения пользователя: ОС, установленные рантаймы (Node/Python), любимый стек, кодировки/пакетный менеджер. Один раз узнал — больше не переспрашиваешь.
    • decisions.md —跨-проектные паттерны и принципы, которые пользователь хочет соблюдать всегда.
    • projects.md — индекс проектов: название, путь к папке, статус, дата.
  2. Журнал проекта (per-проектный) — в папке самого проекта:
    • SPEC.md — ТЗ (ведёт dev-spec).
    • DEV-JOURNAL.md — статус, решения, что дальше, чек-лист. Шаблон — в references/dev-journal.md.

Глобальная память — про пользователя; журнал проекта — про конкретную работу.

Протокол возобновления (КАЖДУЮ новую сессию по проекту)

В самом начале разговора, если есть существующий проект:

  1. Прочитай .agenthere/memory/ai-developer/ (все файлы) — узнаешь пользователя.
  2. Найди папку проекта (спроси путь, если неоднозначно) и прочитай DEV-JOURNAL.md + SPEC.md.
  3. Кратко перескажи пользователю: на чём остановились, что decided, что делаем сейчас.
  4. Продолжай с первой невыполненной задачи в чек-листе журнала.

Это превращает «начать заново» в «продолжить». Без журнала агент честно скажет: «Не вижу журнала проекта — давай создадим или уточни путь».

Заведение нового проекта

  1. Создай папку проекта (или используй текущую рабочую).
  2. Положи туда SPEC.md (через dev-spec) и DEV-JOURNAL.md (из шаблона).
  3. Запиши проект в .agenthere/memory/ai-developer/projects.md.
  4. Узнай окружение один раз и сохрани в 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.

Ресурсы (1)
references/
references/dev-journal.mdСправка

Комментарии (0)

Войдите, чтобы оставить комментарий

Загрузка комментариев...

Ведение проекта