mini-spec

github:zot/mini-spec · first committed 2026-01-05 · source · badge

use **whenever designing, updating, or implementing the design, code, or docs** or **whenever reverse engineering a design from code**

Skill Health: not yet scored

Listed, not yet scored. This skill has no public model test yet. It is in the scoring queue; submitted skills go first, then the most-installed.

Version history

55 commits to this file on GitHub (newest first).

2026-10-08 · commit 625c74b · #104: Languages chosen by path, glob or shebang
2026-10-03 · commit bf9094b · #100: The grep lookup is superseded by the range-aware queries
2026-09-29 · commit 1ee4016 · #94, #93, #92: Configuration moves from YAML to TOML; Traceability over sdom: one positioned harvest, languages, and the switch that retires
2026-09-24 · commit 17d362d · code-simplifier is a plugin that may be missing; the zip carries all four agents
2026-09-15 · commit 842ab15 · #88: Item identifiers Item 3 — the skill: one commit per batch naming its items, amend for the census
2026-09-15 · commit 93b188e · minispec: #85 update finished-carve, #86 the LANDED line names the item, not the commit (no bump)
2026-09-14 · commit d504272 · carves: trajectory-tool is done and moves to carves/done (no bump)
2026-09-07 · commit 0700965 · minispec: the skill re-derived as each verb returns (no bump)
2026-09-05 · commit 7e6e293 · minispec: validate trajectory returns over the reclaimed readers, and the tool adopts the fragment key (no bump)
2026-09-05 · commit eaf9604 · minispec: the pending verbs return over the reclaimed readers (no bump)
2026-09-05 · commit 7dd50a0 · minispec: the backup slot returns over the reclaimed readers (no bump)
2026-09-05 · commit 2a050a2 · minispec: the tool depends on simple-dom, and the carve census returns over its reader (no bump)
2026-09-05 · commit e69e9a0 · mini-spec: one commit per queue item, and the commit shows its steps (no bump)
2026-09-05 · commit 29b1c1b · mini-spec: reclaim `query alarms --brief` and the two agents from old-sdom, R363–R368 renumbered to R199–R204 (no bump)
2026-08-16 · commit c86c4b8 · mini-spec: a tool nobody is told about gets reinvented with a grep (no bump)
2026-08-14 · commit 9dfe5f8 · mini-spec: an authority does not replace a copy, it creates one (no bump)
2026-08-14 · commit 64b9fd6 · mini-spec: prose gets paraphrased, so the shapes get a normative home (no bump)
2026-08-13 · commit a6ccf33 · mini-spec: a renumber breaks everything and passes every check (no bump)
2026-08-13 · commit 5ad2d3c · mini-spec: an alarm that cannot say where it injects cannot be checked (no bump)
2026-08-05 · commit affc514 · mini-spec: a carve's status gets a shape, because one line of guidance grew three notations (no bump)
2026-07-28 · commit baf3c18 · mini-spec: carves, conformance gaps, and testing what you verified (no bump)
2026-06-25 · commit 2e63928 · mini-spec: expand Rn-Rm ranges + compose alternation comment prefixes (v2.11.0)
2026-06-25 · commit c8a4fba · mini-spec: credit bare-annotation requirement refs (v2.10.0)
2026-06-09 · commit 6cb322c · mini-spec: supersede-at-source — retire reminder + Core Principle (v2.9.0)
2026-06-07 · commit 520a783 · mini-spec: factor the structural model out into a standalone `minimap` skill
2026-06-05 · commit e684666 · mini-spec: trajectory tracking + root spec index + unindexed-specs check
2026-05-25 · commit 015b99d · Document summary specs in mini-spec SKILL
2026-05-13 · commit a0609c0 · Release 2.8.0: Numbered sequence-diagram anchors
2026-04-28 · commit e9bd3a7 · Release 2.6.0: Migration workflow and requirement retirement
2026-04-21 · commit 8744f37 · Release 2.5.0: Inline requirement traceability in code comments
2026-04-16 · commit b377a3a · Warn simplifier to preserve traceability comments
2026-04-13 · commit 2d1ab53 · Order-independent requirement validation + approved gaps suppress uncovered
2026-04-04 · commit 9114d9e · Release 2.4.1: Add anchoring rationale to skill docs
2026-03-07 · commit 0ef1676 · Release 2.4.0: Add approved (A) gap type and approve-gap command
2026-02-27 · commit a37c97b · Release 2.3.0: Add comment closers for block-comment languages
2026-02-23 · commit 03832b9 · Release 2.2.0: Make skill mandatory, add design-first rationale
2026-02-18 · commit 53a4f7e · Release 2.1.6: Add check-version command, enforce spec-first principle
2026-02-18 · commit b67c2fb · Release 2.1.5: Fix setCheckbox regex for artifact lines with → mapping
2026-01-26 · commit 5806407 · Release 2.1.4: Emphasize minispec commands in skill docs
2026-01-25 · commit ac9569b · Release 2.1.3: Add comment patterns for md/html/css, query command
2026-01-25 · commit d47f1bb · Release 2.1.0: Install to ~/.claude/bin, design validation
2026-01-25 · commit 892e680 · Release 2.0.0: Add minispec CLI tool
2026-01-24 · commit 8784d64 · Bump version to 1.2.0
2026-01-19 · commit 199e815 · Add code-simplifier phase and plugin install instruction
2026-01-16 · commit 292869a · Bump version to 1.1.1
2026-01-14 · commit 9fa5580 · Bump version to 1.1.0
2026-01-13 · commit 65dcb16 · Bump version to 1.0.0
2026-01-12 · commit 2bfbfd5 · Clarify spec changes workflow in SKILL.md
2026-01-11 · commit 4af1c4e · Add core principles and expand gap analysis docs
2026-01-08 · commit 76928fc · Add cross-cutting concerns to skill
2026-01-05 · commit dc282f1 · Add reverse engineering to skill/agent, add announcement
2026-01-05 · commit 6e85bec · Condense skill: 138→93 lines, add test case format
2026-01-05 · commit d2a8e70 · Prepare for publication: README, cleanup, example app
2026-01-05 · commit 2c5db70 · Update mini-spec skill with phase separation, remove old example
2026-01-05 · commit 12097e6 · Initial commit: mini-spec skill with contact manager example

Archived snapshots