new-milestone
New Milestone
运行环境入口约定：本仓库的
.claude/skills以 Claude Code 为源，示例默认写/tunan:*。若同一 skill 在 Codex 中运行，所有面向 sponsor 的可复制入口在输出前改写为$tunan:*；Claude Code 中保持/tunan:*。
new-milestone is the brownfield next-cycle orchestrator — the complement of new-project. Where new-project stands a project up, new-milestone moves it forward: it reads the existing tunan:project issue, closes the current milestone, defines the next one, and optionally scopes its requirements — sequencing research and brainstorm into one guided flow so the next cycle starts from the project's current state.
It updates the same tunan:project issue in place (one per repo, issue-only, never a local file): marking the current milestone done, appending the next milestone to the ## Roadmap, and updating current_milestone. Requirements are new tunan:req feature issues linked under the new milestone.
Read references/project-issue-contract.md for the body shape and the gh read/write recipes.
Interaction Method
Default to the platform's blocking question tool: AskUserQuestion in Claude Code (call ToolSearch with select:AskUserQuestion first if its schema isn't loaded), request_user_input in Codex, ask_user in Gemini, ask_user in Pi (requires the pi-ask-user extension). Fall back to numbered options in chat only when no blocking tool exists in the harness or the call errors. Never silently skip the question.
Ask one question at a time. Prefer free-form for the "what's next" framing; single-select for routing and scope-boundary forks.
Alignment protocol. When asking the sponsor to choose between options, follow the align protocol: at least 3 ranked options, best pre-selected first with (Recommended). Load the align skill for the full protocol.