# Project Creator

> Создание нового проекта в vault и всей стартовой документации: plan.md, tasks.md, context.md, log.md, README.md плюс обновление индексов. План агент пишет сам по методологии автономного планирования LLM-агентом (Intent Lock, Owner Interaction Policy, Milestones с Acceptance, Quality Criteria, Drift Guard). Работает в двух равноправных сценариях: проект рождается из текущего чата (агент извлекает цель, идею, решения, ограничения, открытые вопросы и контур прямо из беседы) или создаётся с нуля по команде. ОБЯЗАТЕЛЬНО используй, когда владелец говорит: «создай проект», «заведи проект», «зафиксируй это как проект», «оформи это в проект», «сделай из этого проект», «начни проект про X», «новый проект X». НЕ используй для разбора встреч (meeting-processing), парковки (parking), resume или обычного продолжения уже существующего проекта — только для создания нового контура проекта в 01_now/projects/.

- Skill: `dzhokhov/project-creator` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add dzhokhov/project-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dzhokhov/project-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dzhokhov (https://skillmd.com/u/dzhokhov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dzhokhov/project-creator

---


# Создание проекта в vault

Ты создаёшь новый проект в `01_now/projects/` и всю стартовую документацию: `plan.md`, `tasks.md`, `context.md`, `log.md`, `README.md`, и обновляешь индексы. **План и всю документацию ты пишешь сам** — по методологии автономного планирования LLM-агентом. Это главная гарантия скилла: владелец получает готовый проект, а не пустой бриф с просьбой заполнить.

## Главное правило

Агент сам составляет проектную документацию. **Нельзя** просить владельца написать план, пункты плана, критерии качества, рубежи или проверить план построчно. Уточняющие вопросы разрешены только тогда, когда без ответа нельзя безопасно выбрать **основу** проекта (цель, контур, границы, цена ошибки, источник правды). Всё остальное агент выводит из чата, команды и локальных правил и фиксирует как допущение.

Обоснование: [методология планирования для LLM-агента](../../03_knowledge/ai/agent-plan-methodology-research-2026-07.md) и [Правило 12 в AGENTS.md](../../AGENTS.md).

## Что прочитать перед работой

Устойчивые источники правды (не полагайся на память модели):

- [Методология планирования для LLM-агента](../../03_knowledge/ai/agent-plan-methodology-research-2026-07.md) — как писать план против дрифта.
- [Шаблон plan.md](../../meta/templates/project_plan.md) — канонические секции контракта проекта.
- [Инструкция восстановления намерения](../../03_knowledge/ai/agent-intent-reconstruction-instruction-2026-06.md) — как понять недосказанное.
- [Протокол записи](../../meta/rules/write-protocol.md) — frontmatter, ссылки, обновление индексов.
- [Task routing](../../meta/rules/task-routing.md) — что в plan.md, что в tasks.md, что вне проекта.

## Требуется доступ к файлам

Скиллу нужен доступ на запись в vault. В Cowork: подними целевые пути через device-tools, собирай файлы в рабочей папке и записывай на диск владельца через `device_commit_files`. В Claude Code / локальном агенте: пиши файлы напрямую. Если доступа к файлам нет — не выдумывай, попроси владельца подключить папку vault.

## Два сценария входа

Определи сценарий по формулировке владельца и состоянию чата.

### A. Проект рождается из текущего чата

Триггеры: «зафиксируй это как проект», «оформи это в проект», «сделай из этого проект», «давай заведём под это проект».

Перед любым вопросом **извлеки контекст из уже прошедшей беседы** и собери из него бриф:

- **Цель** — какой результат обсуждали, что должно измениться в мире.
- **Идея и суть** — что за инициатива, почему она возникла.
- **Принятые решения** — к чему уже пришли в чате.
- **Ограничения и не-цели** — что явно исключили или чего избегать.
- **Открытые вопросы** — что осталось нерешённым.
- **Обсуждённые материалы** — ссылки, файлы, данные, звучавшие в беседе.
- **Предполагаемый контур** — к какому направлению относится (по именам, продуктам, доменам из чата).
- **Причина отдельного проекта** — почему это выделяется в самостоятельный контур, а не строка в существующем.

Запрещено начинать с пустого брифа и запрещено просить владельца заново пересказать то, что уже есть в чате. Извлечённый бриф становится сырьём для `Goal`, `Intent Lock`, `context.md` и первой записи `log.md`.

### B. Проект создаётся с нуля

Триггеры: «создай проект X», «начни проект про Y», «новый проект по Z».

Восстанови намерение из команды, локальных правил и доступного контекста vault (README контуров, соседние проекты). Если данных достаточно для безопасного выбора основы — сразу пиши документацию. Если нет — задай один короткий пакет уточнений (см. ниже).

## Правило вопросов (бюджет)

Вопрос владельцу допустим, только если одновременно: ответ нельзя вывести из чата, команды и правил; разные ответы реально меняют цель, контур, границы, цену ошибки или источник правды; безопасного консервативного допущения нет.

- Один пакет за раз, максимум **три** коротких вопроса.
- Каждый вопрос содержит рекомендуемый вариант агента и формулируется как «подтверди или поправь», а не «напиши за меня».
- Формат: «Я понял цель так: … . Предлагаю А, потому что … . Б имеет смысл, если важнее … . Подтверди или поправь.»
- Нельзя просить владельца писать план, критерии, рубежи; нельзя показывать внутренний чеклист; нельзя объявлять театральную роль.

В Cowork используй инструмент множественного выбора, если он доступен; в неинтерактивном режиме задай пакет обычным текстом. Развилка контуров при неоднозначности — обязательна ([Правило 6](../../AGENTS.md)).

## Процедура

**Шаг 1. Проверь, что это действительно новый проект.**
Проект — инициатива с ясным результатом, ограниченным горизонтом и точкой закрытия. Проверь правило владельца данных из [AGENTS.md](../../AGENTS.md): если это долговременный реестр контура — место в `01_now/ops/<contour>/`, сырой импорт — в `00_inbox/`, переносимая методология — в `03_knowledge/`, а не новый проект. Если контур неоднозначен — останови и спроси, не угадывай.

**Шаг 2. Определи год, контур и slug.**
Год — текущий (узнай через `date +%Y`, не из памяти). Slug — kebab-case латиницей, описывает суть результата, без дат внутри. Префикс контура включается, если проект принадлежит известному направлению. Путь папки:

`01_now/projects/<год>-<slug>/` — например `YYYY-demo-product-positioning-strategy`, `YYYY-sample-trip`.

**Шаг 3. Выбери режим проекта.**
`operational` — ресёрч, анализ, контент, координация, knowledge-work. `development` — код, скрипты, тесты, schema/data contracts, runtime. Режим пишется в frontmatter `plan.md` и строкой в `tasks.md`. Для `development` дополнительно нужны артефакты dev-протокола (`AGENT_WORKFLOW.md`, `TEST_PLAN.md`, `RELEASE_CHECKLIST.md`, `CHANGELOG.md`, `INCIDENT_RUNBOOK.md`) из `meta/templates/` — см. [dev-protocol](../../meta/rules/dev-protocol.md); их создание не заменяет пять базовых файлов.

**Шаг 4. Восстанови намерение молча** (пять вопросов себе): что явно попросили; какой практический результат нужен; какие ограничения видны из контекста; что можно закрыть безопасным предположением; где ошибка предположения сломает результат и нужен вопрос. Разбор владельцу не показывай.

**Шаг 5. При необходимости — один пакет вопросов** по правилу бюджета. Иначе пропусти.

**Шаг 6. Напиши `plan.md`.**
Полная процедура и разобранный пример: [references/plan-authoring.md](./references/plan-authoring.md). Секции ([Правило 12](../../AGENTS.md)): `Goal`, `Intent Lock`, `Owner Interaction Policy`, `Non-goals`, `Appetite`, `Source of truth`, `Milestones` (каждый с `Acceptance` и статусом), `Quality Criteria`, `Blockers` (пусто), `Blockers — Resolved` (пусто), `Drift Guard`, `Contingency`, `Review Protocol`. Цель — как изменение состояния мира, не как список действий агента. Критерии качества и рубежи формулируешь ты.

**Шаг 7. Напиши `context.md`, `tasks.md`, `log.md`, `README.md`.**
Шаблоны и заполненные примеры: [references/starter-files.md](./references/starter-files.md). Кратко: `context.md` — только устойчивые инварианты; `tasks.md` — производная очередь текущего рубежа из `plan.md`: `Current Milestone`, один Active-шаг, локальные Exit Criteria, `Drift Guard (short)`, Next; `log.md` — первая запись о создании проекта (дата + 3–7 буллетов); `README.md` — точка входа со ссылками на служебные файлы.

**Шаг 8. Обнови индексы.**
Зарегистрируй проект в [01_now/README.md](../../01_now/README.md) и убедись, что новая LLM-сессия найдёт его через корневую навигацию. Если в твоём хранилище есть отдельный `01_now/projects/README.md`, обнови и его. Снипеты правок: [references/starter-files.md](./references/starter-files.md). Порядок слоёв записи — по [write-protocol §5](../../meta/rules/write-protocol.md).

**Шаг 9. Проверки и короткий отчёт.**
Прогони чеклист ниже, затем ответь владельцу коротко: где проект, что в плане, какой первый шаг, какие допущения принял.

## Создаваемые файлы

| Файл | Назначение | Обязательно |
|---|---|---|
| `plan.md` | Медленный контракт: цель, границы, рубежи, критерии, защита от дрифта | да |
| `tasks.md` | Очередь исполнения текущего рубежа из `plan.md`: Current Milestone, Active, Exit Criteria, Drift Guard (short), Next | да |
| `context.md` | Устойчивые инварианты проекта | да |
| `log.md` | Хронология: первая запись — создание проекта | да |
| `README.md` | Точка входа со ссылками на service-файлы | да |
| dev-файлы | `AGENT_WORKFLOW.md` и др. из `meta/templates/` | только `development` |

Плюс правки: `01_now/README.md`; если в конкретном хранилище есть отдельный индекс проектов, обнови и его.

## Проверки перед завершением

- [ ] У каждого `.md` есть frontmatter по [write-protocol](../../meta/rules/write-protocol.md): `id`, `type`, `status`, `created`, `updated`, `aliases` (≥1 русский), `tags`, `source_path`. Дата `created`/`updated` — сегодняшняя (через `date +%F`).
- [ ] `plan.md` содержит все секции Правила 12, включая заполненные `Intent Lock`, `Owner Interaction Policy`, `Quality Criteria`; `Blockers` и `Blockers — Resolved` пусты.
- [ ] `Goal` сформулирован как изменение состояния мира, а не как «сделать N действий».
- [ ] В `tasks.md` объявлен `Task Mode`, указан `Current Milestone` из `plan.md`, ровно один Active-шаг, есть локальные `Exit Criteria` и `Drift Guard (short)`, нет Goal/Milestones/Quality Criteria/Blocked.
- [ ] `context.md` не содержит эпизодику и хронику — только инварианты.
- [ ] Первая запись `log.md` — короткая (3–7 буллетов), без складирования контента.
- [ ] Все внутренние ссылки — кликабельные относительные `.md`, глубина путей проверена.
- [ ] Проект зарегистрирован в `01_now/README.md`; новая LLM-сессия найдёт его через цепочку README → plan → context.
- [ ] Владельцу не задан ни один запрещённый вопрос (написать план/критерии/проверить построчно).

## Антипаттерны

- Пустой бриф и просьба к владельцу заполнить план или критерии — прямое нарушение главного правила.
- В сценарии A — просьба пересказать то, что уже есть в чате.
- Театральная роль, показ внутреннего чеклиста, микросогласования по каждому пункту.
- `Goal`/`Milestones`/`Contingency`/`Quality Criteria` в `tasks.md`; блокеры в `tasks.md` (они — в `plan.md §Blockers`).
- Угадывание контура при неоднозначности вместо одного вопроса (Правило 6).
- Создание проекта под данные, чей дом — `ops/`, `00_inbox/` или `03_knowledge/` (Правило 2а).
- Английский жаргон без перевода в ответах владельцу ([Правило 6а](../../AGENTS.md)); имена секций плана остаются как есть.

## Ссылки

- [references/plan-authoring.md](./references/plan-authoring.md) — как автономно писать `plan.md` + пример.
- [references/starter-files.md](./references/starter-files.md) — шаблоны `README/context/tasks/log` и снипеты индексов.
- [references/worked-examples.md](./references/worked-examples.md) — два сквозных примера: из чата и с нуля.

