Handbook

Task `doc_draft_expansion` v1

Expand a documentation seed into a reviewable draft page for a named surface and persona. The draft must preserve the seed's claims and maturity wording exactly; the output is review-only and never canonical.

Updated

Task doc_draft_expansion v1

Summary

Expand a documentation seed into a reviewable draft page for a named surface and persona. The draft must preserve the seed's claims and maturity wording exactly; the output is review-only and never canonical.

Inputs

Field Type Required Notes
seed_markdown string yes Seed content to expand.
target_surface string no e.g. forge_platform_architecture, forgesdlc_blog.
persona string no Primary reader persona (e.g. architect, c_level).
temperature number no Default 0.2.
timeout_sec integer no Transport timeout override.

Output

JSON object with draft_markdown (the draft), notes (list of reviewer checkpoints: ambiguities, weak evidence, guessed structure), and forced review_only: true.

Invariants

  • Output always carries review_only: true.
  • Maturity wording (vision/defined/demonstrated) must not be upgraded — reviewers verify via notes.

Failure modes

  • SchemaFailure — empty seed_markdown, empty draft, or non-list notes.
  • ParseFailure — invalid assistant JSON (one repair attempt).
  • TransportFailure — model/provider errors.

Changelog

  • v1 — Initial doc-hydration draft expansion task (Hydration v2, Phase 5).