Quick Setup

Quick Setup — установка и первая задача

🇬🇧 English: Quick-Setup-EN

Источник: README.md, docs/HELP.md (разделы 2–3). Время: ~5 минут.

Требования

• Python 3.9+ — без pip-пакетов, CLI работает на чистом stdlib.
• git; любая LLM-среда: Claude Code, Cursor, Codex, OpenCode, Windsurf, Copilot.
• Опционально для PDF-источников: pdftotext (poppler) или pip install pypdf.

Установка и самопроверка

git clone https://github.com/Fighter90/product-factory-strategist.git
cd product-factory-strategist
python3 -m tools.pfs doctor                # Python, pdftotext/pypdf, число карт, активный проект
python3 -m unittest discover -s tests      # 103 теста

doctor показывает версию Python, наличие PDF-инструментов, число карт в базе знаний и активный проект. Ключи CLI не нужны. Ключи интеграций (например, LINEAR_API_KEY) кладите в .env — он не коммитится.

Первая задача

1. Откройте папку репозитория в вашей среде (в Claude Code — команда claude в папке).

2. Напишите задачу обычным языком:

   Платная защита от спама теряет подписчиков. Что делать с продуктом и что говорить абонентам?

3. Агент сам: создаст проект, задаст 1–3 уточняющих вопроса, построит план исследования, соберёт источники, предложит варианты с атакой red-team и сведёт стратегии. Прогресс — строка вида:

   Шаг 2/12 · research · собраны источники S001–S009 · дальше: discovery

4. Вы решаете в трёх точках: подтверждение брифа (шаг 0), выбор варианта (шаг 6), утверждение решения (шаг 10).

Управление по ходу работы

Что сказать	Что произойдёт
«стоп»	пауза; состояние записано в state.json
«уточни: …»	корректировка задачи; переделывается только затронутое
«переделай раздел X»	переработка раздела без повторения всего шага
«собери six-pager»	отчёт для комитета + 4 книги Excel (pfs export --six-pager)
«сделай презентацию»	HTML-дека 16:9 из six-pager (pfs export --deck)

Продолжение после перерыва

Состояние — в файлах проекта, не в памяти чата. Откройте новый чат в той же папке: хук SessionStart сам подаст агенту pfs status + pfs decision due. В средах без хуков начните чат с «прочитай AGENTS.md и python3 -m tools.pfs status». Выполненные шаги не повторяются (агент сверяется с log.jsonl).

Проверка, что всё работает

python3 -m tools.pfs new "Тест" "Проверочный запрос"   # создать проект
python3 -m tools.pfs status                            # где остановились
python3 -m tools.pfs list                              # список проектов
python3 -m tools.pfs use <slug>                        # переключиться

Дальше: FAQ (частые проблемы) · Architecture (как устроено) · CLI-Reference (все команды).