The whole issue in one call
get_work_context hands an agent what it needs before it starts, cut to a size, with a note of what was cut. No chain of six calls to find out what the work is.
- The goal and its parents
- What blocks it
- Acceptance criteria
- Open threads
Document-first issues
Reads like a doc. Argues like a thread.
Write descriptions in Markdown or a rich editor. Select any sentence and start a thread right there: the discussion stays next to the words it is about, not buried at the bottom of the page.
Inline comments follow their text through a rewrite
When someone pastes new text over a paragraph that holds a thread, the thread should not be lost just because a few words changed. Re-attach the anchor by matching the quoted text inside the pasted block before giving up.
Re-match only when most of the quoted words are still there.
Should the threshold be per thread? Short quotes will flap.
Scale it by quote length, min 5 words.