steer

Internal brownfield adoption - bring an existing repo that never went through bootstrap (a "vibe-coded" app) onto the standards - reverse-engineer the /spec from the code, triage productionization (Keep/Refactor/Rewrite/Reject per area), author a root DESIGN.md, and sync the plugin's bundled scaffolding without clobbering working code.

Internal decision record - create a numbered ADR from the bundled template, then offer its Deciders in-session ratification; `accept` writes the Proposed -> Accepted transition.

Repeatable, read-only audits of a managed repo - code mode sweeps repo health against the standards and ranks findings; spec mode surfaces as-built vs intended drift; all runs both. Non-mutating: proposes only, never edits an existing file. Optionally renders an Artifact dashboard.

Guided flow for a non-technical product owner - idea -> interview -> approved spec -> working local app -> handoff for dev review.

Internal prerequisite path - detect what a managed repo needs locally before bootstrap or dev (git, mise and the runtimes it manages, Docker), flagging a shadowed runtime; installs mise + runtimes on confirmation, GUI and `sudo` steps handed over.

Internal renderer - one feature spec as a stakeholder-readable, shareable Claude Artifact (Markdown fallback): status pipeline, acceptance meter, user journey, scope and open-question boards. Read-only and derived; writes nothing back.

Internal renderer for the capability menu - the shipped skill set in plain language, essentials first, the rest by journey, every line built from live frontmatter. Read-only; optional Artifact menu.

Internal greenfield bootstrap - lay the /spec spine + scaffolding, pin the toolchain, leave the repo working spec-first, and resolve placeholders in a legacy template fork. Offers PR flow or solo-trunk mode.

Internal document absorb - commit a PO office document plus a normalized Markdown extraction under spec/sources/, diff it against the prior version, and route the real changes into the spine and tracker without clobbering human prose. `clarify` folds a client answers document; `status` prints the read-only ledger of every absorbed source.

Internal backlog layer for the /spec spine - capture, triage, brainstorm, materialize, decompose, epics, status, a ranked board, bounded reconcile, the publish-* family and bootstrap-labels. A thin orchestrator: /spec stays product truth, the issue is the work/decision layer.

Internal automation scaffolder - a scheduled GitHub Actions workflow that triages work (CI failures, open issues, drift) via /steer:audit + /steer:next, drafts fixes in reviewed worktrees, and opens draft PRs. Stops at every human gate; never merges or deploys.

Read-only workspace navigator and capability index - the default mode reconstructs workspace state cold (branch/PR, features, open questions, Proposed ADRs, tracker issues, claims, version drift) and arbitrates the single best next action; `capabilities` renders the plain-language capability menu. Never edits, commits, merges, or advances state.

Internal branch-protection path - diff policy/branch-protection.yml against live GitHub settings and apply the gaps on confirmation (protection, secret scanning, Dependabot). Graduation writes the CLAUDE.md delivery-mode marker and a /spec/history/ entry; `apply --solo` is the one-person profile, `waive` keeps a single-dev repo on trunk. Verifies by default.

Internal open-question sweep - gather every open question across the /spec spine, walk the PO/dev through each, fold decisions into the spec, promote what outlives the session to an issue, delete a legacy SPEC-QUESTIONS.md. `bundle` renders the PO-answerable ones as a fillable Artifact questionnaire (Markdown fallback).

Internal loader - one of steer's full reference docs, read-only: conventions, traceability, design-sources, context-hygiene, architecture-diagrams, artifacts, gates, polyrepo.

Internal phone-home - file a bug about the steer plugin itself upstream in element22llc/e22-plugins, scrubbed and deduped, via GitHub MCP or gh. Steer's own defects, not product bugs (those go to /steer:work issues).

Internal release timeline - turn the /spec spine's unshipped intent into issues grouped under release milestones, viewable as a GitHub Projects v2 roadmap (no-arg = preview). The issue + /spec stay canonical; never fabricates dates. Optionally renders an Artifact timeline.

One front door for getting a repo onto the standards - detect the /spec spine state and route to `init` (greenfield bootstrap of the spec spine + scaffold, or a template fork's leftover placeholders), `adopt` (reverse-engineer the spec from an existing vibe-coded repo) or `sync` (apply migrations and reconcile drift after a plugin release); `doctor` fixes the local prerequisites first, `protect` raises the branch-protection wall last.

Spec-only brainstorm for a feature - author and iterate intent.md (and contract.md where behavior demands it) and drive open questions to resolution WITHOUT writing any code; `clarify` sweeps the draft for gaps (edge cases, error paths, scope), `approve` flips intent Status, `validate` checks the open-question contract and intent/contract/tracker consistency. `questions` sweeps the whole spine's open questions, `adr` records a hard-to-reverse decision, `intake` absorbs a PO document and `roadmap` lays unshipped intent on a release timeline. Ends at an approved intent, not a build.

Create a feature's spec (intent.md + contract.md) from the bundled templates, or additively reconcile an existing one without overwriting filled-in content.

Load the always-on operating manual on demand where the SessionStart hook cannot inject it - reads every rules/*.md.

Client-facing progress reporting - the default modes cover the whole /spec spine over a time window (what shipped, what is in progress, what needs the client's input, what is next); `feature <id>` renders one feature in depth instead. A shareable Claude Artifact with a Markdown fallback, read-only and derived; never fabricates counts, dates, or status.

Internal steady-state update - apply ledger migrations, reconcile spine + scaffold against current templates, repair capability wiring and stale invocations, re-stamp /spec/.version, and land a PR. Read-then-propose, never clobbers.

Internal sweep - file the loose documents at the repo root into their home: source/research material to /spec/reference, diagrams to /spec/design. Confident strays move now; renames and deletes wait for a yes.

Internal gateway for all tracker metadata I/O (GitHub MCP-first, gh fallback, manual floor) - reads and writes issues, and folds pulled criteria into intent.md, for the owning skills.

Execute a GitHub issue end-to-end - claim through delivery (a PR, or a trunk commit in solo-trunk) and lifecycle transition. Pass --reviewed for independent plan- and code-review gates, --hotfix for the production-incident fast path. promote opens the production promotion PR and takes no issue; tidy sweeps the repo root into /spec and takes none. issues is the backlog layer above them - capture, triage, decompose, epics, a ranked board, reconcile and the publish-* family - which never edits code.