Skip to content

v0.2.0

Choose a tag to compare

@dakiquang dakiquang released this 13 Nov 23:39
· 44 commits to main since this release
82a05ed

qk is a small set of agent skills for Claude Code, Codex and omp: compare approaches, plan, implement with verification, debug, test, hand off between sessions, coordinate a second model, commit, and draft release notes. Every skill runs only when you call it by name (configured and checked on Claude Code, Codex and omp), states what it may and may not do, and ends its report with Done, Evidence, Not verified and Needs your decision. It extends the runtime you already use and does not replace it.

This is the first release published on GitHub. Start with the README and Getting started; the full list of skills and what each one returns is in the docs index. Earlier changes are in the changelog.

Changed

  • qk-run follows your repository's commit convention. When most of the base branch's last 20 non-merge commits look like type(scope): subject, the runner prefixes the commit and PR title with a type (feat, fix, docs, test or refactor, taken from the plan title's first word) and lowercases the first letter, keeping acronyms such as README or CI. A plan title that is already conventional is kept as written, and repositories without the convention see no change. (#8)
  • Documentation rewritten for a public audience. A new README explains what qk is and why it exists. The docs index is grouped into Start here, Guides and Reference, and dated test records now live on one Test evidence page so the guides stay current. Both English and Vietnamese are updated. (#7)

Removed

  • Internal planning notes and a dated project summary that were not user documentation. (#7)

Upgrade notes

  • If you run qk-run on a repository that uses Conventional Commits, its commit and PR titles change from the bare plan title to type: subject. To choose the type yourself, give the plan a conventional title before approve.
  • No skill instructions, invocation syntax or configuration changed.

Install or pin

git clone https://github.com/dakiquang/qk ~/src/qk
git -C ~/src/qk checkout v0.2.0

Then link the skill folders into your runtime as described in Getting started. If you already have a clone, git -C ~/src/qk fetch --tags and check out v0.2.0.

Verified

  • CI on each pull request passed: scripts/validate.py and the unit tests on Python 3.9 and 3.12, plus a gitleaks scan.
  • The new title rules are covered by unit tests, including merge commits in history and acronyms. The runner has not yet been run end to end with this new code.
  • Runtime smoke results and their limits are recorded on the Test evidence page. Qwen Code is not yet checked.