Repository source: docs/plans/backlog/codex_handoff_draft_quality_step1_solution_assessment.md
Codex Handoff Draft Quality Step 1 Solution Assessment
Problem Statement
Codex handoff drafts currently feel generic because the system uses a fixed deterministic template instead of adapting the user story, FDP Step 1 assessment, and confidence review to the actual request.
Option A: Improve Deterministic Drafting
Pros:
Keeps handoff preparation fast, local, cheap, and predictable.
Easy to test because output follows stable rules.
Can improve obvious repetition by deriving options, risks, and success criteria from tags, title, body, and thread context.
Cons:
Still limited for nuanced requests.
May produce shallow assessments when intent is implicit or ambiguous.
More heuristics can become hard to tune over time.
Option B: Use Existing Post Analysis As Draft Input
Pros:
Reuses already available summary, moderation, quality, related-content, and respondability signals.
Produces more request-aware confidence reviews without adding a new provider path.
Keeps Codex execution gated while improving the approval preview.
Cons:
Draft quality depends on whether analysis exists and is fresh.
Analysis is optimized for forum response decisions, not development planning.
Provider/config failures could reduce draft usefulness unless fallback behavior is clear.
Option C: Add A Dedicated LLM Drafting Step
Pros:
Best path to varied, context-sensitive user stories and FDP Step 1 options.
Can produce realistic implementation confidence and identify missing requirements.
Can use thread context and related posts more naturally than heuristics.
Cons:
Adds latency, provider dependency, cost, and failure modes to handoff creation.
Requires prompt/schema design and stronger test fixtures.
Must be careful not to imply execution has started before approval.
Recommendation
Recommend Option B first, with deterministic fallback from Option A. It should improve draft quality quickly by using existing analysis/context where available, while avoiding the complexity of a dedicated LLM drafting provider until the approval flow proves it needs one.