290 — tp overview: move a story not yet defined back to an idea (#290)
Why
"Not yet defined" is what needs the human, and it counts against their
limit. On 2026-11-16 it held six cards against a limit of 7, and four
of them were not stories being written at all: life-weaver #128, #130,
#135 and #137 were opened by tp story issue at level 1, before the
repository declared level 3, and nothing has touched them since. Both
levels write the label story, so the board reads them as needing an
answer now.
The flow moves an issue forward only. A story that turns out to be
half formed, or one the flow never interviewed, has no way back to the
interview: tp idea adopt refuses an issue that carries a flow label,
and the only other exits are to define it or close it.
What changes
tp overview, every card in "Not yet defined": a button, "to idea".- The button relabels the issue:
ideaadded, thenstoryandcalledtaken off, with the token oftoken_env, under the same guards as "accept" (the page's secret, a POST, this machine's own host name, a forge of the user config, level 3). The board is then shown, the card in "Ideas", no longer counted against the limit. - Nothing else of the story is touched: its file, its branch, its worktree and any roadmap line stay as they are.
docs/overview.md,docs/idea.md(the labels table: who writesidea).
Acceptance
A card on the board, of a level 3 repository:
| Column | Story offered (#280) | Blocked | The card |
|---|---|---|---|
| Not yet defined | no | no | the button "to idea" |
| Not yet defined | yes, acceptance filled | no | "story", "accept" and "to idea" |
| Not yet defined | yes, a blank cell | no | "story" and "to idea" |
| Not yet defined | any | yes | as the rows above, and the flag |
| any other | — | any | no "to idea" |
| any, the page without its secret | — | any | no "to idea" |
Pressing "to idea" on the card of story N:
| The request | The repository | Issue N, read again | Open pull request from story/<N>-… |
Outcome |
|---|---|---|---|---|
| the page's form | level 3, a forge of the user config | open, story, not defined |
none | idea added, story taken off; the board shown, the card in "Ideas" |
| the page's form | the same | open, story, called, not defined |
none | the same, and called taken off |
| the page's form | the same | open, story, not defined, other labels (bug) |
none | the same; the other labels kept |
| the page's form | the same | open, idea, not story |
— | nothing written; the board shown |
| the page's form | the same | open, story and defined |
any | nothing written; the page says it is defined, and names tp story call -undefined |
| the page's form | the same | open, story, not defined |
open | nothing written; the page names the pull request |
| the page's form | the same | closed, or neither story nor idea |
any | nothing written; the page says why |
| the page's form | the same | open, story, the forge refusing idea |
none | the page says why, the forge's words included; story still on |
| the page's form | the same | open, story, idea added, the forge refusing to take story off |
none | the page says why; the card stays in "Not yet defined", and a second press finishes it |
| the page's form | no longer at level 3 | any | any | nothing written; the page says why |
| the page's form | not a forge of the user config | any | any | refused; nothing written |
| without the page's secret, or with another's | any | any | any | refused; nothing written |
| not a POST | any | any | any | refused; nothing written |
| under a host name other than this machine's own | any | any | any | refused; nothing written |
The limit line, after a press that moved a card: one fewer, as #275 counts.
Out of scope
- A command for it (
tp story …): the button alone, until an agent is seen to need it. - Removing the story's branch, worktree or file.
tp idea story Nrefuses a branch that exists already, so an idea moved back from a story with a branch needs the branch removed by hand, or another title, before it is a story again. - The roadmap line of a story that came from a roadmap item: it stays,
the issue now labelled
idea. - Moving a defined story, or a roadmap item, back to an idea.
- Starting the interview from the card (#289).
- Telling a level 1 story from a level 3 one on the board.
Decisions
none
Done when
- tests express the acceptance table and pass
- spec updated
- ADR written if a fork was resolved
- roadmap ticked and stamped; changelog entry
- issue closed with a link to the release