Task: Implement the goto command
This page documents a task in the compass goto: start a unit of work in one command story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Implement compass goto: one command that fetches main, creates a
feature branch, scaffolds a linked story + task (codegen as a library),
sets the task's #+branch:, and prints the remaining manual steps.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | compass goto: start a unit of work in one command |
| Now | Implemented; dry-run + real run verified. |
| Waiting on | Nothing. |
| Next | Review. |
| Last touched | 2026-05-25 |
Acceptance
compass goto --slug … --title … --description … [--tags …] [--task …]fetchesmain,git switch -c feature/<slug>, scaffolds the story (current sprint) + a linked task, and sets the task#+branch:.--dry-runprints the plan (branch / story / task / sprint) with no side effects;--baseoverrides the branch base.- Generation goes through
v2_doc_generate(shared_import_generatorwithadd) — no duplicated generator logic. - Prints next steps (wire into sprint table, set states, push/PR); does not silently edit the sprint table.
Plan
- Share the lazy generator import between
addandgoto(_import_generator). cmd_goto: argparse (slug/title/description/tags/task/base/dry-run); resolve current sprint;git fetch+git switch -c; twov2_doc_generate.maincalls;_set_frontmatter_branch; next-steps.- Short-circuit
gotoinmain()(own argparse); register for--help.
Notes
Dogfooded — though goto can't scaffold its own story (that already
exists), it was verified by --dry-run and a throwaway real run
(branch + story + task created, #+branch set), then cleaned up.
PRs
| PR | Title |
|---|---|
| #834 | [ores.compass] Add the Goto pillar (compass goto) |
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|