Skip to content

Release 0.3.1: follow the techsilon-oss kit standard - #8

Merged
jisujit merged 1 commit into
devfrom
chore/kit-standard
Nov 13, 2026
Merged

jisujit merged 1 commit into
devfrom
chore/kit-standard

Conversation

@jisujit

@jisujit jisujit commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

Release 0.3.1: docs-kit follows the techsilon-oss kit standard. Checklist: the "Kit standard checklist" issue.

Merge techsilon-oss/.github#2 first. This PR's CI calls the DCO and plain-words workflows that #2 adds. Until #2 merges, those two jobs fail with "workflow not found".

Security fix

/docs-kit-init and /docs-kit-pin pre-approved git branch *, git diff * and git symbolic-ref * in 0.3.0. Those can delete a branch, write a file (--output) and move HEAD without asking. Now the skills pre-approve only the plugin's own docs-kit commands, and a test enforces this for every skill.

What else

  • /pin is now /docs-kit-pin. The old name stays as an alias until the first release on or after 2026-12-13, and a test fails once that date passes.

  • New /docs-kit-help: answers from the docs of the installed version. Read-only.

  • Apache License 2.0 from 0.3.1, with NOTICE. Earlier releases stay MIT.

  • The README now says what you get, the quick start, what it does on your machine, and how to uninstall. The command reference moved to docs/reference/COMMANDS.md.

  • docs-kit's own docs/ follows the layout. It has how-tos to adopt, reorganise, print, upgrade and remove, plus a FAQ and upgrade notes. docs/DESIGN.md stays where it is and is protected, because released versions link to it.

  • New tests:

    • the layout check on docs-kit's own docs;
    • every docs-kit command the README and the how-tos show runs on a fixture repo;
    • the pinned version equals this release;
    • every relative link and anchor resolves.

    They are mutation-checked.

  • CI: the tests, the plugin manifests, DCO, plain words. Also CODEOWNERS.

  • CLAUDE.md: read the kit standard first; sign off commits; dev is protected.

Tests

npm test passes. claude plugin validate . passes. The plain-words check finds nothing.

After merge: release PR dev → main, tag v0.3.1, GitHub Release. Then make Validate and test a required check.

🤖 Generated with Claude Code

- Security: skills pre-approve only the plugin's own docs-kit commands;
  0.3.0 pre-approved git branch, git diff and git symbolic-ref. A test
  enforces the rule for every skill.
- /pin is now /docs-kit-pin (alias until 2026-12-13); /docs-kit-help added.
- License: Apache-2.0 from 0.3.1, with NOTICE. Earlier releases stay MIT.
- Docs follow the docs-kit layout: README says what you get, what it does
  on your machine and how to remove it; how-tos, command reference, FAQ,
  upgrade notes. Tests check the layout, run every command the docs show,
  and check the pinned version, links and anchors.
- CI: tests, manifests, DCO and plain-words checks. CODEOWNERS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Sujit Gangadharan <gsujit@gmail.com>
@jisujit jisujit mentioned this pull request Nov 13, 2026
14 of 16 tasks
@jisujit
jisujit merged commit 16283f5 into dev Nov 13, 2026
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