v3.0 Vision — SDD-Native Agentic Platform¶

Статус: T3.2 Synthesis | Дата: 2026-08-08 | Автор: Planner База: аудит 843 строки × исследование 993 строки × конкурентная матрица × gap-matrix 67 находок Целевой baseline: v3.0.0 release (W1-W5)

1. Vision Statement¶

opencode_initializer v3.0 — SDD-native agentic platform: одна команда bash setup.sh разворачивает dev-машину + project harness с полным spec-driven циклом (constitution → specify → plan → tasks → implement → converge) для двух аудиторий: энтузиастов (instant productivity) и корпоративных пользователей (air-gapped, auditable, governed).

Specifications don't serve code — code serves specifications. Каждый change начинается со spec://, заканчивается archive. Без исключений.

Ключевые отличия v3.0 от v2.0.3: - v2.0.3: dev machine bootstrap + agent harness. v3.0: SDD-native platform с executable specifications - v2.0.3: 43 модуля, линейный source. v3.0: fault-tolerant core + governance layer - v2.0.3: empty SDD skill stubs. v3.0: полный spec→code→converge цикл в каждом новом проекте - v2.0.3: personal use. v3.0: personal + corporate (governed, air-gapped, auditable)

Паритет+превосходство над codex/claude-code/kimi: - SDD-цикл, которого нет у конкурентов (Claude Code: plan mode без traceability; Codex: нет SDD; Kimi: нет SDD) - Infrastructure as Code (PostgreSQL+Qdrant+Redis+Prometheus+Grafana) — ни у кого нет - 22 провайдера + isolated circuit — уникально - Lifecycle hooks + Agent SDK — догоняем Claude Code, опережаем Codex/Kimi

2. Стратегические принципы¶

Выведены из синтеза исследований (spec-kit, OpenSpec, Red Book, AI-Native Infra, Competitive Matrix).

3. Target Architecture v3.0¶

Слои (с маппингом на текущие модули)¶

┌──────────────────────────────────────────────────────────────────┐
│ L7: User Interface — Cockpit TUI (31-cockpit.sh) + Web GUI (:4200)│
├──────────────────────────────────────────────────────────────────┤
│ L6: Agent Harness — AGENTS.md, .opencode/skills/, WAL, commands   │
│    (17-project.sh + 37-wal.sh — пересборка под SDD)               │
├──────────────────────────────────────────────────────────────────┤
│ L5: SDD Layer ★NEW★ — constitution, specs/, changes/, templates   │
│    skills: /specify, /plan, /tasks, /implement, /analyze, /converge│
│    (НОВЫЙ модуль: 41-sdd.sh)                                      │
├──────────────────────────────────────────────────────────────────┤
│ L4: Hooks Layer ★NEW★ — lifecycle hooks (pre/post tool call)      │
│    policy enforcement, PII filtering, audit logging                │
│    (НОВЫЙ модуль: 42-hooks.sh)                                    │
├──────────────────────────────────────────────────────────────────┤
│ L3: Provider & Model Layer — 22 providers + model router          │
│    (26-providers.sh + 36-model-router.sh — SSOT fix + gateway)    │
├──────────────────────────────────────────────────────────────────┤
│ L2: Infrastructure & Services — PG, Qdrant, Redis, Prom, Grafana  │
│    (30-infra.sh + 33-services.sh + 34-observability.sh — secure)  │
├──────────────────────────────────────────────────────────────────┤
│ L1: Core — error handling, WAL, progress, dry-run, helpers        │
│    (00-core.sh + helpers.sh — per-step recovery, atomic ops)     │
└──────────────────────────────────────────────────────────────────┘

3.1 Core Layer (W1 Foundations)¶

Что меняется: - Error handling (F1): _run_step оборачивает source "$module" в subshell — падение модуля не роняет весь setup.sh - Atomic WAL (F4): запись через временный файл + mv — защита от corruption при параллельной установке - Safe cleanups (F2.4): ~/.cache/opencode защищён от очистки — модули используют mktemp -d, cleanup чистит только свою временную директорию - Dry-run guards (F4.1): DRY_RUN=true → все деструктивные операции (rm, mv, sed -i, docker stop) блокируются или логируются - Thread-safe WAL (F2.3): flock на WAL-файл при параллельной установке — нет гонок - TOTAL_STEPS fix (F4.2): TOTAL_STEPS вычисляется динамически (подсчёт _run_step в setup.sh), а не hardcoded - setup.conf single-source (F8): один source "$SETUP_CONF" в начале, кеширование в ассоциативный массив - _sudo fix (F9): убран 2>/dev/null, stderr сохраняется для логирования - Progress rotation (F12): _reset_progress при --reinit, ротация при >1000 строк

3.2 Provider Layer (W1 Foundations)¶

Что меняется: - SSOT-реестр (C1): единый PROVIDER_REGISTRY в 26-providers.sh. 18-opencode-json.sh и AGENTS.md генерируются из него, а не дублируют - Minimax чистка (C2): удаление 2 из 3 копий minimax в реестре — оставить одну - Cost-table (C3): обновление из models.dev, добавить minimax, verifицировать все цены - Policy engine (H1): OPENCODE_ALLOWED_PROVIDERS, OPENCODE_ALLOWED_MODELS, OPENCODE_MAX_COST_PER_SESSION → policy.json → enforcement в hooks - Model-call audit (H4): каждый вызов LLM логируется: провайдер, модель, токены in/out, latency, cost → audit.jsonl - ai-router/model-router унификация (H2): один источник конфигурации маршрутизации, не два - Fallback валидация (H3): CI-тест: симулируем отказ провайдера → проверяем что fallback сработал за <500ms - embed-proxy multi-backend (H5): поддержка Ollama + vLLM + SGLang через EMBED_BACKEND env var

3.3 SDD Layer (W2 — ядро v3.0)¶

НОВЫЙ модуль 41-sdd.sh — генерирует SDD-инфраструктуру при setup.sh --new.

Структура проекта после v3.0:

my-project/
├── constitution.md              ← декларация принципов (MUST/SHOULD)
├── specs/                       ← истина: как система работает СЕЙЧАС
│   └── [capability]/
│       └── spec.md              ← FR-### / SC-### / NFR / Given-When-Then
├── changes/                     ← дельта-предложения: что меняется
│   └── [change-name]/
│       ├── proposal.md          ← intent, scope, approach
│       ├── design.md            ← технический подход
│       ├── tasks.md             ← декомпозиция с [US], [P]-маркерами
│       └── specs/               ← дельта-спеки (ADDED/MODIFIED/REMOVED)
├── .opencode/
│   ├── commands/                ← slash-команды
│   │   ├── specify.md           ← /specify — создать spec из NL-описания
│   │   ├── plan.md              ← /plan — технический план из spec
│   │   ├── tasks.md             ← /tasks — декомпозиция на фазы
│   │   ├── implement.md         ← /implement — реализация по задачам
│   │   ├── analyze.md           ← /analyze — coverage/consistency check
│   │   └── converge.md          ← /converge — sync code↔spec
│   ├── templates/               ← шаблоны артефактов
│   │   ├── spec-template.md
│   │   ├── plan-template.md
│   │   ├── tasks-template.md
│   │   ├── proposal-template.md
│   │   └── design-template.md
│   ├── skills/                  ← agent instructions (не пустые!)
│   │   ├── specify/SKILL.md
│   │   ├── plan/SKILL.md
│   │   ├── tasks/SKILL.md
│   │   ├── implement/SKILL.md
│   │   ├── analyze/SKILL.md
│   │   └── converge/SKILL.md
│   └── constitution.md → ../../constitution.md (symlink)
├── wal/
│   ├── state.yaml               ← checkpoint (overwrite, ≤1 page)
│   └── audit.jsonl              ← append-only audit trail
└── AGENTS.md                    ← system prompt (обновлён: SDD workflow)

Ключевые артефакты:

SDD workflow (6-командный цикл):

/specify ──→ /plan ──→ /tasks ──→ /implement ──→ /converge
    │           │          │            │               │
    │     /analyze (опционально, перед implement)       │
    │                                                  │
    └─ [human review gate] ────────────────────────────┘

3.4 Memory Layer (W2 SDD Core)¶

WAL v2 — checkpoint + audit trail:

wal/
├── state.yaml          ← checkpoint (overwrite, Red Book §3)
│   ## Текущая фаза
│   ## Ограничения (НЕ ТРОГАТЬ без обсуждения)
│   ## Что сделано
│   ## Следующее действие
│   ## Известные проблемы
│   ## Решения: [{decision, rationale, alternatives, revisit_condition}]
│
└── audit.jsonl          ← append-only audit trail
    {"ts":"ISO","domain":"...","decision":"...","rationale":"...",
     "impact":["file1"],"confidence":0.85,"spec_ref":"spec://auth#FR-003"}

Что меняется: - WAL checkpoint перезаписывается (≤1 страница) — не растёт бесконечно - Структурированные решения: rationale + alternatives + revisit-condition (RB3) - spec:// привязка: каждое решение ссылается на spec (RB6) - audit.jsonl для долгосрочного трейла — tamper-evident hash-chain опционально

3.5 Hooks Layer (W4 — НОВЫЙ)¶

НОВЫЙ модуль 42-hooks.sh — lifecycle hooks по модели Claude Code/Kimi.

# hook.sh — sourced перед/после каждого tool call
# pre_tool_call() → reject/resolve;  post_tool_call() → log/modify

HOOKS_DIR="$HOME/.config/opencode/hooks"

# Типы хуков:
# - pre_bash: before any bash execution
# - pre_edit: before file modification
# - pre_read:  before file read (PII/secret detection)
# - post_bash: after bash — audit log + output sanitization
# - post_edit: after edit — auto-format, lint
# - post_model: after LLM call — token+latency+cost tracking

Точки enforcement: - Audit (H4, A2, CP4): post_bash + post_model → audit.jsonl - PII (A4): pre_read → reject если файл содержит секреты - Policy (H1, A5): pre_model → reject если модель не в allowlist - Budget (AI5): post_model → если лимит превышен → degraded mode - Compliance (A1): ISOLATED_CIRCUIT=true → pre_bash reject внешних сетевых вызовов

3.6 Corporate Profile (W3)¶

DEPLOYMENT_PROFILE=airgapped vs standard — универсальный gate:

# _is_isolated() — единый gate для ВСЕХ внешних вызовов
_is_isolated() {
  [ "${ISOLATED_CIRCUIT:-false}" = "true" ] || \
  [ "${DEPLOYMENT_PROFILE:-standard}" = "airgapped" ]
}

# Применение:
_is_isolated && { warn "network blocked in isolated mode"; return 0; }
curl ...

Что закрывает: - Telemetry (A1): _is_isolated && export OLLAMA_NOPRUNE=true - Version checks (A1): _is_isolated && return 0 в version-check.sh - Autoupdate (A1): _is_isolated && systemctl disable --now opencode-autoupdate.timer - MCP фильтрация (A1): внешние MCP (websearch, GitHub) исключаются из opencode.json при изоляции - Offline installer (A6): pre-cached Docker images + npm/pip packages → tarball

Corporate governance:

3.7 Сохраняем уникальное¶

4. Две аудитории¶

4.1 Enthusiast Journey (3 команды до ценности)¶

# 1. Dev machine
bash setup.sh

# 2. New project with SDD
bash setup.sh --new my-feature
cd my-feature

# 3. First spec-driven change
# (AI агент в проекте, AGENTS.md + skills загружены)
/specify "Add dark mode toggle"  → specs/dark-mode/spec.md
/plan                             → plan.md + design.md
/tasks                            → tasks.md
/implement                        → код + тесты
/converge                         → sync + archive

4.2 Corporate Journey (regulated environment)¶

# 1. Air-gap deployment
export DEPLOYMENT_PROFILE=airgapped
export ISOLATED_CIRCUIT=true
export OPENCODE_ALLOWED_PROVIDERS=ollama
bash setup.sh --offline

# 2. Policy setup
cat > ~/.config/opencode/policy.json <<EOF
{
  "allowed_providers": ["ollama"],
  "allowed_models": ["qwen3:14b", "deepseek-r1:32b"],
  "max_cost_per_session": 0,
  "data_regions": ["local"],
  "audit_retention_days": 365,
  "pii_patterns": ["email", "phone", "card", "ssn"],
  "wal_mode": "600"
}
EOF

# 3. Compliance check
dev doctor              # validate policy + providers + isolation
dev audit               # view audit trail
dev sbom                # software bill of materials

Compliance matrix (target vs audit T1.5):

5. Competitive Positioning¶

Матрица «мы после v3.0» vs codex/claude-code/kimi:

Где паритет: hooks, sub-agents (догоняем в W4), multi-provider (уже есть) Где превосходство: SDD-цикл (уникально), infra-as-code (уникально), corporate profile (уникально), 22 providers + isolated circuit (уникально)

6. Wave Plan¶

W1: Foundations & Fixes (10-14 дней, 29 находок)¶

Цель: устранить CRITICAL/HIGH баги ядра, сделать платформу надёжной перед добавлением SDD.

Результат W1: платформа надёжна, все CRITICAL закрыты, core готов к SDD-надстройке.

W2: SDD Core (14-21 день, 28 находок)¶

Цель: полный spec-driven цикл в каждом новом проекте.

Результат W2: новый проект получает полный SDD-цикл, spec:// traceability, delta-changes для brownfield.

W3: Enterprise & Governance (10-14 дней, 14 находок)¶

Цель: corporate readiness — governance, аудит, air-gap seals.

Результат W3: corporate profile проходит матрицу T1.5 на "Есть", SOC2-ready audit trail.

W4: Hooks & Automation (7-10 дней, 5 находок)¶

Цель: lifecycle hooks + Agent SDK — паритет с Claude Code/OpenCode SST.

Результат W4: платформа покрывает полный цикл от dev-машины до production-grade agentic infrastructure.

W5: Release v3.0.0 (5-7 дней)¶

• Документация: README, AGENTS.md обновление, migration guide v2→v3
• Тесты: расширение test suite до ≥200 assertions, coverage новых модулей (41-sdd, 42-hooks)
• Health-mode: bash setup.sh --health для новых фич (SDD, hooks, policy)
• Changelog: v3.0.0 release notes
• ShellCheck sweep: все новые модули на -S error
• git tag v3.0.0, push to github + gitverse

7. Success Criteria v3.0¶

8. Non-Goals v3.0 (явно)¶

Источники¶

• Аудит: .opencode/audit/2026-08-08/01-05-*.md (843 строки, 47 находок)
• Исследования: .opencode/research/2026-08-08/ (5 дайджестов, 993 строки)
• Gap-матрица: .opencode/synthesis/2026-08-08/gap-matrix.md (67 находок)
• Competitive matrix: .opencode/research/2026-08-08/competitive.md
• Red Book: https://oleg.guru/redbook/ru/ (Олег Чир, 2026)
• spec-kit: https://github.com/github/spec-kit
• OpenSpec: https://github.com/Fission-AI/OpenSpec
• AI-Native Infra: https://jimmysong.io/book/ai-native-infra/ (Jimmy Song, Jan 2026)