Task: Inventory compass commands and map them to skills

Goal
Status
Acceptance
Plan
Notes
PRs
Review
Result

This page documents a task in the Action-oriented skill cleanup story. It captures the goal, current status, acceptance, and any notes or results.

Goal

Catalogue every compass command and subcommand, pillar by pillar, and map each one onto a skill named per Skill naming conventions. The map is the work order for the two downstream tasks: the audit of existing skills and the creation of the new workflow skills. Gaps in both directions are first-class outputs: compass workflows with no skill, and skills with no compass backing.

Status

Field	Value
State	DONE
Parent story	Action-oriented skill cleanup
Now	Nothing.
Waiting on	Nothing.
Next	Nothing.
Last touched	2026-06-06

Acceptance

Every compass command and subcommand appears in the map exactly once.
Every mapped skill name parses against the prefix and verb registers.
Gaps are recorded explicitly, including verbs the registers lack.

Plan

(Transient implementation strategy. Written when work starts; distilled into the parent story's * Decisions and cleared when the task closes. Plans do not outlive their task.)

Notes

The inventory, by compass pillar. Skill names follow Skill naming conventions.

Command-to-skill map

Compass command	Pillar	Skill	Notes
`bearings` / `orient`	Bearings	`agile-find-bearings`	session cold-start
`where` / `status`	Orient	`agile-show-status`
`fleet`	Orient	`agile-show-fleet`
`journal where/log`	Journal	`agile-show-journal`	writes are side-effects of other skills
`sprint status`	Orient	`agile-show-sprint`
`sprint audit`	Orient	`agile-review-sprint`	with charts; absorbs sprint-reviewer
`sprint charts`	Orient	`agile-review-sprint`	sub-step
`story new`	Scaffold	`agile-add-story` + `agile-start-story`	split per lifecycle story
`task new`	Scaffold	`agile-add-task` + `agile-start-task`	split per lifecycle story
`task start`	Scaffold	`agile-start-task`
`task done`	Scaffold	`agile-close-task`	cascades to story
`add story/task/sprint/...`	Scaffold	per-type `add` skills	see expansion below
`add capture` / inbox flow	Capture	`agile-add-capture`	absorbs capture skill
`inbox/next/deferred/discarded`	Capture	`agile-show-backlog`	one skill, bucket argument
`search` / `find`	Search	`doc-find`	all documents
`list`	Search	`doc-find`	structured filters
`show`	Search	`doc-show`	by UUID/prefix
`index`	Search	`doc-sync-index`	with –org-roam-db-sync
`review list/reply/resolve/pending`	Review	`pr-address-review`	whole review round
`pr checks`	PR	`pr-show-checks`
`pr create`	PR	(step inside work skills)	no standalone skill; see gaps
`pr merge`	PR	`pr-merge`	sanctioned bare verb
`pr sync`	PR	`pr-sync-branch`
`pr record`	PR	(bookkeeping inside others)
`env init/diff/list/version`	Provision	`devops-setup-environment`	diff/list as read-only sub-steps
`db recreate/setup/drop/reset-*`	Provision	`devops-recreate-db`
`sql` / `db sql`	Provision	`devops-run-sql`
`services start/stop/status/clear-logs`	Operate	`devops-start-services`, `devops-stop-services`, `devops-show-services`
`client`	Operate	`devops-run-client`
`shell`	Shell	`devops-run-shell`	incl. -f scripted sessions
`test results/logging`	Test	`code-run-tests`	results/logging as sub-steps
`build`	Build	`code-run-build`
`build site`	Build	`devops-deploy-site`
`debug`	Search	(none)	internal diagnostics; no skill

`compass add` type expansion

Type	Skill
story, task	`agile-add-story`, `agile-add-task`
sprint	`agile-open-sprint` (ceremony, not bare add)
capture	`agile-add-capture`
recipe	`doc-add-recipe`
knowledge	`doc-add-knowledge`
manual	`doc-update-manual`
memory	`doc-add-memory`
skill	`skill-add`
component, entity_org	`codegen-add-component`, `codegen-add-entity`
diagram	`doc-add-diagram`
investigation, product_identity, dataset_overview, version	(no skill; rare, use `compass add` directly)

Gaps

Compass without skill: debug; env diff drift checking (potential devops-show-env, deferred — YAGNI); pr create is deliberately folded into the work-lifecycle skills rather than exposed standalone.
Skill without compass backing: skill-review, skill-sync-recipes, all codegen-* (ores.codegen CLI), code-write-tests, code-review-*, agile-brainstorm-idea — fine; compass is not the only substrate.
Verb register gaps found: none requiring extension — audit folds into review-sprint, capture becomes add-capture, brainstorm is the one candidate addition (agile-brainstorm-idea); flagged in the conventions decision log when the skill is created.

PRs

PR	Title

Review

Comment summary	File	Decision	Notes

Result

Complete command-to-skill map recorded in * Notes: 34 command rows across all pillars, the compass add type expansion, and the gap analysis in both directions. Every mapped name parses against the registers; no register extension required (brainstorm flagged as the single candidate). The map is the work order for the audit and creation tasks.