spk-start-here

name: spk-start-here description: "Start here for Spec Kitty. Orient CLI users and supported agent-harness users; choose the right command, skill family, and recovery path."

Orient the user by where they are working: command line or supported agent harness.

Access Model

Command-line users run spec-kitty CLI commands. spk-* skills are not CLI commands.
Agent-harness users invoke installed command surfaces: /spec-kitty.* in slash-command hosts, $spec-kitty.<command> in Codex, or the host's skill syntax for skill hosts.
Public spk-* skills are agent operating guides. Use them by name in a skill-aware harness or let natural-language intent trigger them.
If commands or skills are missing, route to spk-admin-setup-doctor.

Operating Model

Spec Kitty has three visible layers:

Commands: /spec-kitty.* slash commands and CLI commands that create or advance mission artifacts.
Skills: spk-* operating guides that teach an agent how to use the product.
Doctrine: charter, glossary, profiles, directives, and tactics loaded on demand by the runtime or by specialist skills.

Do not turn this into a full tutorial. Identify entry mode first, then route to the smallest useful workflow.

First Route

New project or broken install: use spk-admin-setup-doctor.
New feature from scratch: use spk-start-first-feature.
User wants a command list: use spk-start-command-map.
User asks "will this work in Codex or Claude?": use spk-start-agent-surface.
Existing mission needs advancement: use spk-run-next.
Multi-mission or multi-repo program: use spk-run-program-orchestrate.
Review or approval work: use spk-run-review-wp, then spk-gate-accept.
Team, SaaS, tracker, or sync concern: use spk-team-sync or spk-team-tracker.
Doctrine or governance concern: use the spk-doctrine-* family.
Unsure which skill applies: use spk-meta-skill-map.

Agent Behavior

State the route, load only the routed skill, and continue. Prefer commands and runtime outputs over guessing from files. If the user asks for a plan, give the shortest workflow that gets them to the next concrete Spec Kitty action.