Skip to content

0.4.0: /docs-kit-reorg, docs-kit audit, docs-kit snapshot - #10

Merged
jisujit merged 2 commits into
devfrom
feat/0.4
Nov 13, 2026
Merged

jisujit merged 2 commits into
devfrom
feat/0.4

Conversation

@jisujit

@jisujit jisujit commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

0.4.0: the guided reorganisation and snapshot routing (DESIGN §6.3, §6.6). Built against invented test repos, before Trial 2.

What

  • /docs-kit-reorg runs:

    1. a read-only audit;
    2. one proposal that applies the least-change defaults L1 to L10;
    3. two questions only: the roles, and one approval;
    4. the moves in slices: maps, moves, generators, how-tos, close.

    It commits only on a yes and never pushes. /docs-kit-init hands off to it.

  • docs-kit audit [--json]: the inventory a reorganisation starts from: what must move, folders without a map, exports trees, code inside the docs folder, generators, ignored files and .gitignore rules, docs that immutable files name, agent instructions, how-to look-alikes, and every reference to a doc from outside the docs folder. It writes nothing.

  • docs-kit snapshot path <topic> and docs-kit snapshot archive <topic>: a generator in any language asks where today's snapshot goes, and archives the older ones to archive/<subject>/snapshots/<topic>/. The archive refuses any other folder (H1), and exits 1 when an ignored snapshot would become visible (H4).

  • check: a snapshot topic whose folder git ignores is reported as local-only, instead of failing as "no dated snapshots". Generators that keep their outputs out of git are common.

  • New how-to: route generated docs to snapshots, with Python and Node snippets that the tests run.

Tests

npm test passes. New tests cover snapshots (H1, H4, local-only), audit, every skill using only real CLI commands and options, and the how-to snippets. All nine new guards were mutation-checked. claude plugin validate . passes. The plain-words check finds nothing, and docs-kit's own docs pass its check.

This PR also brings dev level with main: it includes the 0.3.1 release merge.

🤖 Generated with Claude Code

jisujit and others added 2 commits November 13, 2026 07:20
Release 0.3.1: follow the techsilon-oss kit standard
…0.4.0

- docs-kit audit: read-only inventory before a reorganisation.
- docs-kit snapshot path|archive: snapshot routing any generator can call;
  archive refuses other folders (H1) and fails loudly when an ignored
  snapshot would become visible (H4).
- check: a gitignored snapshot topic is local-only, not missing.
- /docs-kit-reorg: audit, one proposal with the least-change defaults,
  roles and one approval, then slices. /docs-kit-init hands off to it.
- How-to for generators, with Python and Node snippets the tests run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Sujit Gangadharan <gsujit@gmail.com>
@jisujit
jisujit merged commit d93e65e into dev Nov 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant