Агент проводит настоящее исследование: план от вопросов, меняющих решение, проверяемые источники, реестр утверждений, содержательно разные варианты и атака red team, продуктовая и коммуникационная стратегии, план проверки — и Excel-расчёты в six-pager для комитета. После решения — следит за обязательствами и пересматривает выводы при новых данных.
The agent runs real research: a plan built from decision-changing questions, verifiable sources, a claim registry, substantively distinct options, a red-team attack, product & communication strategies, a validation plan — and Excel models attached to a six-pager for the committee. After the decision, it tracks commitments and revisits conclusions on new data.
Обязательный минимум конкурса — реализован полностью; поверх — дополнительные возможности. Каждая цифра в документах имеет тип (факт/гипотеза/прогноз/допущение/вывод), силу A–D и источник S###.
The competition's required minimum is fully covered, plus advanced capabilities. Every number has a type (fact/hypothesis/forecast/assumption/inference), strength A–D, and a source S###.
Уточняет вопрос, цель, получателя, ограничения и данные. Спрашивает только то, что важно для следующего шага. Бриф подтверждает человек.
Clarifies question, goal, audience, constraints, data. Asks only what matters next. A human approves the brief.
Сайты, PDF, DOCX, XLSX, CSV, изображения — из разрешённых доменов. Дедупликация по URL и SHA-256, детектор фраз-инструкций.
Websites, PDF, DOCX, XLSX, CSV, images — from allowed domains. Deduped by URL and SHA-256, prompt-injection scanner.
План — от вопросов, меняющих решение. Факт без источника записать невозможно; синтетика ИИ-респондентов — только гипотезы.
The plan starts from decision-changing questions. A fact without a source cannot be stored; synthetic respondents yield hypotheses only.
≥3 содержательно разных вариантов, включая «оставить как есть» и «закрыть направление». Отдельный субагент атакует каждый.
≥3 substantively distinct options, including "do nothing" and "shut down". A dedicated subagent attacks each one.
Аудитория, осознанные отказы, экономика; барьер, сообщение, каналы. Таблица «обещание → подтверждение» проверяется автоматически.
Audience, trade-offs, economics; barrier, message, channels. The "promise → proof" table is verified automatically.
Отчёт FAQ-1…FAQ-6 + четыре книги Excel на формулах: юнит-экономика, рост, когорты, рынок. Считаются фоном, пересчитываются при открытии.
FAQ-1…FAQ-6 report + four formula-driven workbooks: unit economics, growth, cohorts, market sizing. Built in background, recalculated on open.
Основания, ответственные, обязательства, даты пересмотра. «Что решать сейчас», устаревшие основания, влияние новых данных.
Grounds, owners, commitments, review dates. "What to decide now", stale grounds, impact of new data.
Журнал действий, основания каждого вывода, стоимость в токенах и деньгах. Любой шаг виден и воспроизводим.
Action log, grounds behind each conclusion, cost in tokens and money. Every step is visible and reproducible.
Агент ведёт работу сам и зовёт человека только на существенный выбор. Прогресс — строкой: Шаг N/12 · research · источники S001–S009 · дальше: ситуация. Фазы двойного романа: Discover (0–3) → Define (4–6) → Develop (7–9) → Deliver (10–12).
The agent drives the work and calls the human only for a consequential choice. Progress shows as: Step N/12 · research · sources S001–S009 · next: situation. Double Diamond phases: Discover (0–3) → Define (4–6) → Develop (7–9) → Deliver (10–12).
Одна команда собирает отчёт в структуре стратегического референса, а расчёты идут фоном и прикрепляются книгами Excel на формулах.
One command assembles the report in the reference structure while calculations run in the background and attach as formula-driven Excel workbooks.
FAQ-1 Анализ текущего состояния · рынок, конкуренты FAQ-2 Сегменты и персоны · боли по этапам пути FAQ-3 Инициативы · варианты + возражения red team FAQ-4 Тактики · потребность → механика → эффект FAQ-5 План реализации и проверки FAQ-6 Метрики успеха · формулы и цели ───── Приложения: 4 книги Excel (лист «Ввод» + формулы)
unit_economics.xlsx CM · LTV/CAC · пейбек · чувствительность
growth_model.xlsx MAU → заказы → GMV → маржа, 12 мес
cohort_retention.xlsx когорты · кривая удержания · M1/M3/M6
market_sizing.xlsx PAM→TAM→SAM→SOM · PESTEL
$ pfs calc all # собрать книги
$ pfs export --six-pager # отчёт + приложения
unit_economics.xlsx CM · LTV/CAC · payback · sensitivity
growth_model.xlsx MAU → orders → GMV → margin, 12 mo
cohort_retention.xlsx cohorts · retention curve · M1/M3/M6
market_sizing.xlsx PAM→TAM→SAM→SOM · PESTEL
$ pfs calc all # build workbooks
$ pfs export --six-pager # report + attachments
Каждое значение на листе «Ввод» прослеживается до утверждения C###; формулы пересчитываются при открытии — допущения меняются на лету.
Every Input-sheet value traces to a claim C###; formulas recalculate on open — assumptions change on the fly.
Слои агента: среда (AGENTS.md, 120 skills, 8 субагентов, 4 хука) → CLI+MCP-ядро tools/pfs → база из 72 карт методик и интеграции. Гарантии — не в промптах, а в коде pfs; состояние — в файлах проекта, поэтому работа переживает перерывы и переезды между средами.
The agent's layers: environment (AGENTS.md, 120 skills, 8 subagents, 4 hooks) → the tools/pfs CLI+MCP core → a knowledge base of 72 method cards and integrations. Guarantees live in pfs code, not in prompts; state lives in project files, so work survives breaks and moves between environments.
Нужны Python 3.9+ и любая среда: Claude Code, Cursor, Codex, OpenCode, Windsurf, Copilot. Пакеты не устанавливаются.
You need Python 3.9+ and any environment: Claude Code, Cursor, Codex, OpenCode, Windsurf, Copilot. No packages to install.
Агент сам создаст проект, задаст 1–3 вопроса, проведёт исследование и покажет прогресс. «Стоп» — пауза, «уточни: …» — корректировка, «собери six-pager» — отчёт для комитета. После перерыва откройте новый чат — состояние подастся автоматически.
The agent creates the project, asks 1–3 questions, runs the research and shows progress. Say "stop" to pause, "clarify: …" to adjust, "build the six-pager" for the committee report. After a break, open a new chat — state is restored automatically.
Большинство действий агент выполняет сам — команды нужны для контроля и ручных операций.
The agent runs most actions itself — commands are for oversight and manual operations.
| Группа | Команды | Что делают |
|---|---|---|
| Проекты | new · list · use · status | создать/выбрать проект, где остановились |
| Шаги | step · next · questions <шаг> | отметка шага + обязательные карты; «что решать сейчас»; вопросные блоки |
| Источники | source add/list/show · source refresh S### | сайты, PDF, DOCX, XLSX → S###, с дедупликацией и защитой; обновление источника |
| Утверждения | claim add/list/supersede/retract/rebase | реестр C###: факт/гипотеза/прогноз/допущение/вывод, сила A–D |
| Качество | check --strict · impact | числа без тегов, мёртвые ссылки; что затронет изменение |
| Решения | decision add/due/done/rebase | основания, ответственные, обязательства, пересмотр |
| Данные | data profile/cohort | профиль таблицы, когортное удержание |
| Воронка и статистика | data funnel · data stats | воронка по событиям/колонкам; базовая статистика с ДИ 95% |
| Интервью, медиа, UX | interview guide/save · media add · ux scaffold | гайды интервью, медиа-источники, UX-каркас по материалу |
| Excel | calc all|unit-econ|growth|cohort|market | книги на формулах → outputs/attachments |
| Отчёты | export · export --six-pager · export --deck | REPORT.md; six-pager FAQ-1…6 + Excel; HTML-дека 16:9 |
| Знания | kb search/show/index | поиск по 72 картам методик |
| Модели | models show/pick/use/escalate | какая модель на какую задачу, профили сред |
| Стоимость | cost · log --usd | токены и деньги за задачу |
| DOCX | docx файл.md | Markdown → Word без зависимостей |
| Group | Commands | Purpose |
|---|---|---|
| Projects | new · list · use · status | create/select a project, resume point |
| Steps | step · next · questions <step> | step mark + mandatory cards; "what to decide now"; question blocks |
| Sources | source add/list/show · source refresh S### | websites, PDF, DOCX, XLSX → S###, deduped and protected; refresh a source |
| Claims | claim add/list/supersede/retract/rebase | C### registry: fact/hypothesis/forecast/assumption/inference, grade A–D |
| Quality | check --strict · impact | untagged numbers, dead links; what a change affects |
| Decisions | decision add/due/done/rebase | grounds, owners, commitments, revisions |
| Data | data profile/cohort | table profile, cohort retention |
| Funnel & stats | data funnel · data stats | funnel over events/columns; descriptive stats with 95% CI |
| Interview, media, UX | interview guide/save · media add · ux scaffold | interview guides, media sources, UX scaffold from the material |
| Excel | calc all|unit-econ|growth|cohort|market | formula workbooks → outputs/attachments |
| Reports | export · export --six-pager · export --deck | REPORT.md; six-pager FAQ-1…6 + Excel; 16:9 HTML deck |
| Knowledge | kb search/show/index | search across 72 method cards |
| Models | models show/pick/use/escalate | which model per task, environment profiles |
| Cost | cost · log --usd | tokens and money per task |
| DOCX | docx file.md | Markdown → Word, dependency-free |
Пишите обычным языком, как коллеге: опишите задачу, ответьте на вопросы, выберите вариант. Управляющие фразы: «стоп» — пауза; «уточни: …» — скорректировать задачу; «переделай раздел X» — переработать только затронутое; «собери six-pager», «пересчитай Excel», «что решать сейчас» (decision due), «что затронет новый источник» (impact). Агент не задаёт больше трёх вопросов за раз и всегда объясняет, чего ему не хватает.
Write in plain language as to a colleague: describe the task, answer questions, pick options. Control phrases: "stop" — pause; "clarify: …" — adjust; "redo section X" — rework only the affected part; "build the six-pager", "recalculate Excel", "what should I decide now" (decision due), "what will this new source affect" (impact). The agent never asks more than three questions at once and always states what it is missing.
0 · Бриф — до 3 вопросов (решение, цель, ограничения) → 00_brief.md, вы подтверждаете. 1 · Источники — файлы и сайты → S###. 2 · Исследование — план «вопрос → если да/нет», расчёты, интервью (ИИ-респонденты дают только гипотезы). 3 · Дискавери — персоны, JTBD, альтернативы пользователя. 4 · Ситуация — что известно, откуда, чего не знаем. 5 · Варианты — ≥3 содержательно разных, каждый с возражениями red team. 6 · Выбор — вы решаете. 7 · Стратегии — продуктовая и коммуникационная, обещания сверяются с продуктом. 8 · План проверки — метрика, база, срок, контрметрики. 9 · Review — автопроверка pfs check, оценка по рубрике, six-pager. 10 · Решение — вы утверждаете; основания и обязательства фиксируются. 11 · Мониторинг — сроки и пересмотр при новых данных (шаги 0–11).
0 · Brief — up to 3 questions (decision, goal, constraints) → 00_brief.md, you approve. 1 · Sources — files and pages → S###. 2 · Research — a "question → if yes/no" plan, calculations, interviews (AI respondents yield hypotheses only). 3 · Discovery — personas, JTBD, user alternatives. 4 · Situation — known / unknown / contradictions. 5 · Options — ≥3 substantively distinct, each with red-team objections. 6 · Choice — you decide. 7 · Strategies — product and communication; promises checked against the product. 8 · Validation — metric, baseline, duration, counter-metrics. 9 · Review — pfs check, rubric scoring, six-pager. 10 · Decision — you approve; grounds and commitments recorded. 11 · Monitoring — deadlines and revisions on new data (steps 0–11).
Параметры живут в projects/<slug>/calcs.json: секции unit_econ (arpu, vc_share, cac, churn_month), growth (mau_start, conv_order, aov, take_rate…), cohort (sizes, retention), market (pam, доли). Агент заполняет их числами из утверждений и помечает источник в note. Команда pfs calc all строит 4 книги в outputs/attachments/; лист «Ввод» — редактируемые параметры, остальные листы — формулы. Чего нет в calcs.json — подставится пример с пометкой «ПРИМЕР». После правки повторите calc и export --six-pager, чтобы текст и Excel совпали.
Parameters live in projects/<slug>/calcs.json: sections unit_econ (arpu, vc_share, cac, churn_month), growth (mau_start, conv_order, aov, take_rate…), cohort (sizes, retention), market (pam, shares). The agent fills them from the claim registry and marks sources in note. pfs calc all builds 4 workbooks into outputs/attachments/; the Input sheet holds editable parameters, other sheets hold formulas. Missing values fall back to examples marked "EXAMPLE". After edits rerun calc and export --six-pager so text and Excel match.
1 · Дождитесь шагов situation…validation (документы 02/03/04/06). 2 · Скажите «собери six-pager» — агент заполнит calcs.json из C### и запустит расчёты субагентом в фоне. 3 · Получите outputs/SIX_PAGER.md + 4 xlsx. 4 · Откройте Excel и замените допущения на фактические значения — формулы пересчитаются. 5 · Сверьте числа текста и книг; при правках — pfs calc all и pfs export --six-pager.
1 · Wait for situation…validation steps (documents 02/03/04/06). 2 · Say "build the six-pager" — the agent fills calcs.json from C### and runs calculations in a background subagent. 3 · You get outputs/SIX_PAGER.md + 4 xlsx. 4 · Open Excel and replace assumptions with actual figures — formulas recalculate. 5 · Match text and workbook numbers; after edits run pfs calc all and pfs export --six-pager.
Всё состояние — в файлах projects/<slug>/. Откройте новый чат в папке репозитория: хук SessionStart сам подаст агенту статус и «что решать сейчас». В средах без хуков напишите: «прочитай AGENTS.md и выполни pfs status». Перенос в другую среду — скопируйте папку проекта или git push/pull.
All state lives in projects/<slug>/ files. Open a new chat in the repo folder: the SessionStart hook feeds the agent its status and "what to decide now". In hook-less environments write: "read AGENTS.md and run pfs status". Moving environments: copy the project folder or git push/pull.
Claude Code — полный опыт: навыки, субагенты, хуки, автостоимость. Cursor — правило .cursor/rules, MCP из .mcp.json. Codex / OpenCode / Windsurf / Copilot — читают AGENTS.md; хуков нет — начните с pfs status. Linear: ключ в .env (не коммитится), сервер npx mcp-server-linear. Lovable: MCP-сервер https://mcp.lovable.dev подключён в .mcp.json; авторизация — один раз OAuth в клиенте (/mcp → lovable → Authenticate), после чего агент создаёт и дорабатывает проекты Lovable по запросу (create_project/send_message расходуют кредиты Lovable).
Claude Code — full experience: skills, subagents, hooks, auto-cost. Cursor — .cursor/rules, MCP from .mcp.json. Codex / OpenCode / Windsurf / Copilot — read AGENTS.md; no hooks — start with pfs status. Linear: key in .env (git-ignored), server npx mcp-server-linear. Lovable: MCP server https://mcp.lovable.dev wired in .mcp.json; authorize once via OAuth in your client (/mcp → lovable → Authenticate), then the agent creates and edits Lovable projects on request (create_project/send_message consume Lovable credits).
Добавьте источник, затем: pfs claim supersede --id C005 "новое значение" --reason "…" --source S012 — старое не удалится, история сохранится. pfs impact C005 покажет затронутые выводы, строки документов и решения; pfs claim rebase перенаправит выводы на замены; pfs decision due — какие решения и обязательства устарели.
Add the source, then: pfs claim supersede --id C005 "new value" --reason "…" --source S012 — the old record stays, history preserved. pfs impact C005 shows affected conclusions, document lines and decisions; pfs claim rebase redirects conclusions to replacements; pfs decision due lists stale decisions and commitments.
Только открытые источники и ваши материалы; домены проекта проверяются до запроса; секреты — только в .env (не коммитится); тексты источников — данные: «команды» внутри них не исполняются; ИИ-респонденты не выдаются за реальных людей; реальные интервью — только с согласием и без персональных данных.
Public sources and your own materials only; project domains checked before requests; secrets only in .env (git-ignored); source texts are data — "commands" inside are never executed; AI respondents are never passed off as real people; real interviews require consent and no personal data.
120 навыков в .claude/skills/ — базовые по шагам процесса, 27 product-skills (процедуры методов), личная библиотека ~59 (дизайн / маркетинг / наука / документы-медиа / режимы мышления / мета) и интеграции: hallmark — анти-слоп-гейты страниц, board-of-directors — совет 5 перспектив + Red Team на шаге options, premortem — предразбор провала на шаге decision, rea — reverse-engineering JS-страниц и закрытых форматов, sdd — дисциплина разработки, deck — презентация из six-pager. Вызов: автоматически — по триггерам описания; явно — «используй skill <имя>: <задача>»; в процессе — по шагам. Полный реестр — docs/SKILLS.md.
120 skills in .claude/skills/ — base ones per process step, 27 product-skills (method procedures), a personal library of ~59 (design / marketing / science / documents-media / thinking modes / meta) and integrations: hallmark — anti-slop gates for pages, board-of-directors — a council of 5 perspectives + Red Team at the options step, premortem — a failure pre-mortem at the decision step, rea — reverse-engineering of JS-rendered pages and closed file formats, sdd — development discipline, deck — a presentation built from the six-pager. Invocation: automatically — via description triggers; explicitly — "use skill <name>: <task>"; within the process — per step. Full registry — docs/SKILLS.md.
| Симптом | Что делать |
|---|---|
| «Факт без источника недопустим» | Так и задумано: добавьте источник или запишите как гипотезу |
| «Домен не входит в разрешённые» | Правьте project.json → allowed_sources или добавьте с --force --note |
| «Извлечено 0 знаков» | Сайт на JavaScript: сохраните текст вручную → --text-file --url |
| Excel «пустой» | Это кэш предпросмотра: формулы посчитаются при открытии |
| Скилл/субагент не появился | Перезапустите сессию Claude Code |
| Числа six-pager ≠ Excel | Повторите pfs calc all и pfs export --six-pager |
| Symptom | Fix |
|---|---|
| "A fact without a source is not allowed" | By design: add a source or record as hypothesis |
| "Domain not allowed" | Edit project.json → allowed_sources or use --force --note |
| "Extracted 0 chars" | JS-rendered page: save text manually → --text-file --url |
| Excel looks "empty" | Cached preview: formulas compute on open |
| Skill/subagent missing | Restart the Claude Code session |
| Six-pager numbers ≠ Excel | Rerun pfs calc all and pfs export --six-pager |
Полная справка: docs/HELP.md (RU) · docs/HELP_EN.md (EN) · docx-версии в docs/docx/.
Full manual: docs/HELP_EN.md (EN) · docs/HELP.md (RU) · docx versions in docs/docx/.