Block Generation Document Set

1. Покрытие набора документов

Для Block Generation сейчас покрыты:

  • продуктовый intent — PRD

  • архитектурное решение — ADR

  • системный срез — System Design

  • интеграционный контракт — Service Spec

  • оценка качества — Evaluation Plan

  • rollout discipline — Delivery Plan

  • эксплуатация — Runbook

  • security boundary — Security Note

  • prompt governance — Prompt Template

2. Что уже согласовано между документами

В текущем наборе согласованы:

  • explicit authoring nature функции;

  • separation between generation and publish;

  • IBlockGenerator as adapter boundary;

  • review-before-save workflow;

  • distinction between create mode and revise mode.

3. Оставшиеся пробелы

Что ещё можно усиливать в будущем:

  • формальный benchmark set;

  • versioned prompt governance;

  • curated revise corpus;

  • явные примеры representative failures.

4. Следующие обновления

Следующими полезно поддерживать в актуальном состоянии:

  • evaluation corpus;

  • prompt policy references;

  • links between ADR, prompt template and real provider implementation.

5. Входящие зависимости

6. Source of truth в коде

Основные code artifacts:

  • src/textfoundry_engine/tf/engine.h

  • src/textfoundry_engine/tf/engine.cc

  • src/textfoundry_ai/prompt_constants.h

  • src/textfoundry_ai/openai_compatible_block_generator.*

  • src/text_foundry_gui/viewmodels/block_editor_view_model.*