Цель
- Запуск устойчивого onboarding-flow, а не одиночного чат-агента.
- Единый owner состояния кандидата и прозрачные переходы этапов.
- Интеграции, шаблоны, audit trail и ручной fallback в критичных шагах.
Valletta
OpenClaw
Onboarding v1.0
Design Freeze + Infrastructure
Valletta AI Onboarding Visual Flow
Управляемый onboarding-контур с master-agent, единым state, предсказуемым роутингом и fallback на ручное ведение. Текущий шаг: локальная подготовка к согласованию перед разворачиванием в новый контейнер на SSH Hostinger.
Цель Реализации и MVP
MVP v1.0
- Старт от рекрутера по строгой форме и создание `onboarding_id`.
- Календарь, доступы, pre-onboarding письмо, show-up контроль.
- Анкета договора, передача документоведу, контрактный цикл.
- English flow, handoff к AL, статусы для рекрутера.
Архитектура Агентов
Onboarding Agent (Master of State)
Единственная точка управления процессом: принимает старт, ведет state кандидата, оркестрирует субконтуры, уведомляет рекрутера и эскалирует блокеры.
AI Admin
Google/Jira/Slack/VPN. Возвращает только факты выполнения и артефакты, не владеет процессом.
AI Document Specialist
Проверка документов, выбор шаблона, нумерация, генерация договора, статус signed flow.
AI Consultant
FAQ и onboarding checklist, English written scoring, эскалация speaking/listening в April School.
Decision Boundaries and Control Plane
Deterministic System Actions
- Google/Slack/Jira/VPN actions only via approved adapters.
- Calendar creation only via delegated/service account tool.
- Contract template copy and registry writes are tool-confirmed.
- No stage completion without explicit tool evidence.
AI Reasoning Actions
- Candidate guidance and first-day explanation.
- FAQ/checklist clarifications.
- Contract questionnaire dialogue and validation.
- Written English scoring by fixed rubric.
Human Approval Actions
- Unresolved contract-rule match or legal exceptions.
- Sensitive sanctions/local restrictions ambiguity.
- Manual VPN/account fallback after retry budget.
- Accounting/legal out-of-policy cases.
Channel Policy
- Recruiter control plane: Slack only.
- Candidate primary onboarding: Slack.
- Telegram: preboarding and fallback only.
- No dual active dialogue state across Slack and TG.
State Persistence
- Current State JSON: single source of truth per onboarding.
- Append-only Event Log JSONL for full traceability.
- Only Onboarding Agent writes current state.
- Workers return structured outputs only.
Визуальный Flow Онбординга
Реалистичный Порядок Внедрения
Инфраструктурные Требования
Контуры и доступы
- Slack/TG entrypoint и routing rule.
- Google Calendar + Gmail права для сервисного аккаунта.
- Jira invite и VPN request контур с audit trail.
- Ограниченный доступ к секретам и ротация.
Договорный контур
- Доступ к шаблонам договоров и реестрам Malta/Armenia.
- Папки кандидатов для документов и signed copy.
- Правила выбора шаблона и нумерации договора.
- Эскалация при неполном пакете документов.
State и мониторинг
- Единый JSON state на кандидата.
- Heartbeat проверки по SLA-окнам.
- Ошибки и эскалации в отдельном журнале.
- Retry и fallback на ручной процесс.
Блокеры dry run
- Нет утвержденного `agent_id/workspace_id`.
- Не проверены календарные права и маршрутизация.
- Не готовы шаблоны сообщений.
- Нет runbook rollback и fail-safe сообщений.
Readiness Checklist Перед Первым Dry Run
Process Freeze
- Роли и ownership утверждены.
- State schema утверждена.
- Fallback процесс согласован.
Integration Ready
- Slack/TG/Calendar/Jira/VPN проверки пройдены.
- Contract templates и registry доступны.
- April School канал связи подтвержден.
Operational Control
- Шаблоны сообщений готовы.
- Runbook сбоев доступен owner-команде.
- Понятен rollback на ручное ведение.