kborovik

Create, file, open, log, ∨ track GitHub issue. Always-gated by `core:socratic` skill — concrete intent passes ≤ 1 turn, vague intent triggers dialogue until convergence. Triggers when user mentions GitHub issues, bug reports, feature requests, ∨ wants to track work on GitHub. Phrasings: "file an issue", "open a bug", "track this on GitHub".

Create GitHub PR from issue number ∨ objective. Triggers when user mentions GitHub PRs, pull requests, opening PR. Phrasings: "open a PR", "create a pull request", "PR for issue #N".

Merge GitHub PR into main w/ release-ready commit message. Triggers when user mentions merging PR, landing branch, shipping GitHub PR. Phrasings: "merge this", "land the PR", "merge PR #N".

Sole mutator of SPEC.md @ repo root — create, amend, ∨ backprop bugs. Triggers when user asks to write spec, start new spec, distill spec from code, add invariants, amend a section, ∨ record a bug. Common phrasings: "write the spec for...", "new spec", "distill spec from code", "spec this idea", "import existing repo", "pull invariants out of code", "this bug keeps biting", "post-mortem on Y".

Bug → spec protocol. On bug found ∨ test fail → trace cause, decide if new §V invariant catches recurrence, append to §B. Triggers: test failure, bug report, post-mortem, explicit user ask. Phrasings: "X broke", "we got bit by", "post-mortem on Y", "this should never recur", "add a §V for". ⊥ for mechanical typo ∨ one-off fix w/ ⊥ recurrence class — pure code fix only.

Math-glyph encoding — LLM-facing compression for SPEC.md ∧ spec-adjacent writes. Loaded by /sdd:spec, /sdd:build, /sdd:check. Triggers on any write to SPEC.md ∨ user says "math-glyph", "glyph", "compress this", "be brief".

Cut SemVer release for single-package repo — bump `version` in detected manifest, commit, create annotated tag `v<x.y.z>`. Local only, ⊥ push, ⊥ GitHub Actions. Triggers when user says "release", "tag", "ship", "cut a version", "bump version".

Read-only drift detector. Diffs SPEC.md vs current code ∧ reports violations grouped by severity. ⊥ writes — suggests remedies via spec ∨ build skills, ⊥ invokes them. Triggers when user asks to check drift, audit spec, verify invariants, ∨ ask if code still matches spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code", "is the spec st

Propose-then-critique structural design loop → draft to `designs/<slug>.md`. Distinct from socratic (which sharpens vague intent). Use when user wants to design a structural change, weigh tradeoffs between named alternatives, propose an architecture, or shape a subsystem before implementation. Triggers: "/sdd:design", "design the X", "shape the X subsystem", "tradeoffs between A and B", "how shoul

Parameterized single-question intent-sharpening gate. ⊥ user-invoked — invoked from consumer cmd pre-apply gate (/gh:issue, /sdd:spec).

Human-facing terse-prose register for non-author reviewers. Triggers: write/edit human-facing terse prose for review; user says "steno", "shorthand", "tighten this", "make this shorter".

Optional pre-design exploration tool — two-pass layer-primary divergence emitting a tradeoff matrix at `designs/<slug>-explore.md`. Sits ahead of `/sdd:design` in the funnel; matrix feeds `/sdd:design` (when shape choice remains) or `/sdd:spec` direct amend (when bail-out fires on a clearly-dominant layer). Distinct from `sdd:design`: no Open Questions loop, no A|B|C alternatives, ⊥ FOLD-IN candid

Commit staged git changes w/ descriptive Conventional Commits message. Triggers when user asks to commit, save changes, ∨ mentions GitHub commits. Phrasings: "commit", "save my changes", "commit this".

Math-glyph → prose. Expand any SPEC.md citation into plain English. Read-only. Inverse of the glyph skill (math-glyph encoder). Triggers when human wants to understand a §V invariant, §T task, §B bug, or §I interface without the encoding. Phrasings: "/sdd:explain", "what does §V.<n> mean", "decompress this", "explain in prose", "I don't read math-glyphs". ⊥ for writes — those go through /sdd:spec.