Skip to content

v2.0.0 — Cline toolchain & versioned framework

Latest

Choose a tag to compare

@jpbaking jpbaking released this 05 Jul 01:14

DOX v2 turns the framework into a toolchain: Cline skills for every core workflow, an always-on rule, a one-line installer, and — the reason this is a major version — framework versioning with an upgrade path.

Why v2

From this release on, every framework copy carries a DOX vX.Y.Z marker at the top of AGENTS.md. Everything before is deliberately left unmarked: any AGENTS.md without a marker is the untracked v1 era. The mental model is one sentence — has a marker: v2+; no marker: run /dox-upgrade once to enter the versioned era. Your project content (User Preferences, Feature Map, Child DOX Index, imported rules) survives the migration.

Cline skills

Install from your project root:

curl -fsSL https://raw.githubusercontent.com/jpbaking/dox/main/install-cline.sh | sh

(sh -s -- --global installs for every project; re-run anytime to update.)

  • /dox-init — initialize the tree; detects new project vs. existing codebase, and fetches the framework AGENTS.md if it is missing.
  • /dox-child — give it a folder path; it runs the boundary test and either initializes a child doc (wired into the parent) or explains why the folder does not deserve one.
  • /dox-audit — read-only health check (lint) by severity; now includes a best-effort framework version-drift check.
  • /dox-fix — audit + auto-repair of the mechanical problems; nested roots are off-limits, judgment calls come back to you.
  • /dox-upgrade — migrate the framework rules in the root AGENTS.md to the latest release without losing project content, then reconcile the tree.

Cline rule

A small always-on rule: finds each edited file's DOX root (one workspace can hold several independent projects, each with its own root), complies with that chain when it exists, and merely suggests /dox-init — once, one sentence — when it does not. It never initializes on its own.

Also

  • README now states who this fork is for (smaller/weaker models), quantifies the root-doc context overhead (~15 KB ≈ 3.5–4k tokens/session), and points consistent frontier-model users to the leaner original: https://github.com/agent0ai/dox

Full changelog: v1.2.0...v2.0.0