Restructure and review engineering documents with source-fidelity-first rules. Preserve original meaning and useful source form, avoid adding new facts or forced decisions, and keep issue/risk-first feedback. Use for design docs, refactor plans, migration plans, PR narratives, and runbooks.
Restructure and review engineering documents so readers can follow the content in one top-down pass. Preserve source meaning first. Do not invent facts. Do not finalize decisions that were not finalized in the source. Preserve useful source form too. Do not flatten emails, checklists, ADRs, or handoff notes into one generic output shape unless readability clearly improves.
Primary Reader Flow from existing source content.Source fidelity first: every statement must be traceable to source text.might, seems, looks like, likely, maybe, and similar language should stay at similar strength.Open Questions or Unknown, not assumptions.Do not force a fixed template. Prefer source-native form first.
Use minimum sections first:
IntentCurrent FactsNext ActionsAdd sections only when needed:
Decisions (only confirmed decisions from source)RisksOpen QuestionsAppendixIf the source is already readable enough:
Issues/Risks (severity-ordered).Evidence and Required Changes.Open Questions/Assumptions only if needed.Compose or Review).