project-onboarding.md

Подключение проекта

Project onboarding создаёт в проекте папку .pf/, связывает проект с workplace, добавляет launcher среды выполнения и формирует стартовые инструкции для агента.

Запускайте project onboarding только после того, как workplace существует и нужные общие ресурсы уже созданы, зарегистрированы или явно признаны необязательными для текущей области работ. Проектный .pf/ выбирает ресурсы из workplace, а не создаёт их вместо настройки workplace.

Корень проекта должен быть выбран явно. Не считайте текущую рабочую папку, корень дистрибутива ProcessForge или глобальную папку конфигурации агента проектом, пока оператор не подтвердил этот точный каталог как target project.

Из корня дистрибутива:

Для dry-run сначала создайте или выберите ../my-project. Режим apply может создать отсутствующий greenfield project root.

python bin/pf.py project-onboard --project-root ../my-project --workplace ../pf-workplace --type generic-software-project --apply
python bin/pf.py agent-start-prompt --project-root ../my-project

Внутри подключенного проекта:

cd ../my-project
python .pf/runtime/bin/pf.py doctor-project --project-root .
python .pf/runtime/bin/pf.py project-context-refresh --project-root .

Агент должен начинать с .pf/START_AGENT_HERE.md. Этот файл объясняет, какие локальные правила и snapshot нужно читать перед работой.

Coordination mode

Project mode задаётся отдельно от capability workplace:

python bin/pf.py project-onboard --project-root ../my-project --workplace ../pf-workplace --type generic-software-project --coordination-mode inherit --apply
python bin/pf.py project-mode status --project-root ../my-project --workplace ../pf-workplace --json
python bin/pf.py project-mode set --project-root ../my-project --mode simple
python bin/pf.py project-mode set --project-root ../my-project --mode organized --init-office

simple сохраняет обычный режим 1-1-1-1. organized нужен только проектам, которые должны использовать Director Office рабочего места, Director inbox, cases, leases, handoffs или error routes.

Lock-модель project context

Onboarding записывает context_requirements и context_policy в публичный .pf/process-forge.yaml, затем project-context-refresh создаёт разрешённый lock snapshot. Существующие capsules остаются закреплены за прежним snapshot id/checksum; новые capsules используют текущее поколение snapshot.