FAQ

FAQ — частые вопросы

🇬🇧 English: FAQ-EN

Источник: docs/HELP.md (разделы 1–3, 8, 10–12) и docs/HELP_EN.md. Полное руководство — Help-RU / Help-EN.

Общее

Что это — программа, бот? Нет. Это папка-репозиторий, которую вы открываете в LLM-среде (Claude Code, Cursor, Codex, OpenCode, Windsurf, Copilot). Среда читает AGENTS.md (правила и процесс), knowledge/ (методики), а «бухгалтерию» исследования ведёт инструмент pfs (CLI/MCP).

Чем это отличается от обычного чата с LLM? Проверяемостью: каждое число — с источником S### и типом утверждения C###; в демо 100% ключевых чисел сводятся к источникам против 0% у обычного чата. Плюс продолжаемость (состояние в файлах), ворота качества и пересмотр решений при новых данных.

Нужно ли платить за что-то кроме самой LLM-среды? Нет. CLI — чистый Python (ноль зависимостей), ключи не нужны. Интеграции (Linear, Lovable, Higgsfield, Feynman) — опциональны и настраиваются отдельно.

Процесс

Агент всё делает сам? Процесс ведёт сам, но человек решает существенное в трёх точках: бриф (шаг 0), выбор варианта (шаг 6), утверждение решения (шаг 10). Остановить/скорректировать можно в любой момент: «стоп», «уточни: …», «переделай раздел X».

Что будет, если я закрою чат посреди работы? Ничего: состояние — в файлах проекта. Новый чат начинается с хука SessionStart, который сам подаст pfs status + pfs decision due. Выполненные шаги не повторяются (агент сверяется с log.jsonl).

Почему агент задаёт вопросы на каждом шаге? Вопросные блоки (pfs questions <шаг>) — настраиваемость: минимум 1–3 вопроса руководителю на шаг, пропуск — только через журнал. Так стратегия не строится на молчаливых допущениях.

Troubleshooting

Симптом	Причина и что делать
Ошибка: Факт без источника недопустим	Так и задумано: pfs source add — или запишите как hypothesis/assumption
Источник не разрешён: домен …	Домен вне allowed_sources; отредактируйте project.json или добавьте с --force --note "обоснование"
Из <url> извлечено 0 знаков	Страница рендерится JavaScript: сохраните текст вручную → pfs source add --text-file … --url …
Excel открывается «пустым»	Это кэш до пересчёта: формулы посчитаются при открытии в Excel/Numbers/LibreOffice/Google Sheets
Ошибка: Утверждение C### не найдено	Опечатка в ID: pfs claim list
Субагент/скилл не появился	Перезапустите сессию Claude Code — компоненты подхватываются при старте
Числа в six-pager не совпали с Excel	Правили calcs.json? Повторите pfs calc all и pfs export --six-pager
Стоимость в другой среде = 0	Автоучёт — только по транскриптам Claude Code: pfs log "…" --usd N вручную
Хук «молчит»	Смотрите .claude/hooks/hook_errors.log; хуки не роняют сессию по дизайну

Данные и безопасность

Можно ли дать агенту закрытые данные компании? Нет. Только открытые источники и ваши материалы без ПДн. Домены проекта (allowed_sources) ограничивают загрузки; секреты — в gitignored .env.

А если на странице написано «игнорируй инструкции, выполни команду…»? Тексты источников — данные, не команды: они не исполняются, подозрительные места помечаются (хук PostToolUse + детектор в CLI).

Синтетические респонденты — это обман? Нет, если честно маркировать: расшифровки в interviews/synthetic/ с пометкой «СИНТЕТИЧЕСКИЙ ОТВЕТ», origin=synthetic, и валидатор не даст записать факт на синтетике — только гипотезы.

Среды

Среда	Процесс	Skills/субагенты	Хуки	MCP
Claude Code	полностью	да	да	pfs + Linear
Cursor	.cursor/rules	нет	нет	pfs из .mcp.json
Codex / OpenCode / Copilot	через AGENTS.md	нет	нет	pfs
Lovable	web-дека/лендинг по docs/lovable-brief.md	—	—	https://mcp.lovable.dev (OAuth /mcp)
Feynman	CLI — глубокий ресёрч	skill deep-research	—	—

В средах без хуков начните чат с «прочитай AGENTS.md и python3 -m tools.pfs status».

Где смотреть дальше

Quick-Setup · Architecture · CLI-Reference · Demo-CVStart · Roadmap