@donedev/claude-skill 0.2.0 → 0.3.0

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: done
-description: Done Agent Pack v2 — operate workspaces that follow the Done methodology. Use this skill when the user opens a folder containing `.done/`, `AGENTS.md` and `CLAUDE.md`, or when the user mentions "Done", "Done Agent Pack", "donepack init", or "act with Done". It enforces the intake-as-wall (LEY 1), the 3-tier master roadmap (LEY 2), an orchestration layer (Conductor + agent graph + handoff gates + build state), agent-owned QA including cross-layer Journey E2E, FULL_PRODUCT_MODE, and 13 explicit stop conditions. It is THE operating manual for any Claude Code session inside a Done workspace.
+description: Done Agent Pack — operate workspaces that follow the Done methodology. Use this skill when the user opens a folder containing `.done/`, `AGENTS.md` and `CLAUDE.md`, or when the user mentions "Done", "Done Agent Pack", "donepack init/check-product/gen-tokens", or "act with Done". It enforces the intake-as-wall (LEY 1), the 3-tier master roadmap (LEY 2), an orchestration layer (Conductor + agent graph + handoff gates + build state), agent-owned QA including cross-layer Journey E2E, FULL_PRODUCT_MODE, and 13 explicit stop conditions. It also ships a deterministic ENGINE (`donepack check-product` — product integrity + Done Design: computed contrast, anti-slop, reduced-motion) and `gen-tokens` (contrast-verified brand identity). It is THE operating manual for any Claude Code session inside a Done workspace.
 when-to-use: User opens a workspace containing `.done/` or `AGENTS.md` + `CLAUDE.md`. User mentions "Done", "Done Agent Pack", "donepack", or "act with Done". User asks Claude Code to scaffold a project using the Done methodology.
 ---
 
@@ -119,18 +119,40 @@ You stop **only** for these (write the gate in `OPEN_GATES.md`, continue with no
 
 ---
 
-## 9. CLI commands (if installed)
+## 9. The engine — verify, don't assert (`donepack`)
 
-```bash
-donepack init [target]      # initialize a v2 workspace
-donepack status [target]    # mode, phase, ticket, gates, risks
-donepack doctor [target]    # validate pack consistency
-donepack audit [target]     # programmatic Repo Audit (read-only)
-donepack upgrade [target]   # migrate a workspace to a newer pack version
-donepack --version
-```
+Done isn't only doctrine; it ships a deterministic **engine** that computes what an LLM can't be trusted to assert. Use it as your machine-readable check of reality (via `Bash`):
+
+- **`donepack check-product`** — the Product Definition of Done. Scans the built product for real failures (open `/admin`, missing auth, info-boundary leaks, missing data-rights/support/discovery, float money) **and Done Design** (contrast computed from the real tokens, raw hex bypassing tokens, AI-slop tells, type/spacing drift, reduced-motion). `(contrast-fail)`/`(contrast-bluff)` are HIGH and **block the build** — accessibility is a fact in CI, not a claim.
+- **`donepack substance`** — presence ≠ reality: does the auth authenticate, does data persist, are integrations wired (vs demoware)?
+- **`donepack maturity` / `score`** — where the product sits on the L0–L5 ladder, and a 0–100 score.
+- **`donepack verify`** — the runtime verification plan (e2e / journey gates).
+- **`donepack next` / `run`** — the autopilot: the next dispatchable build node / the continuous build loop.
+- **`donepack init` / `status` / `upgrade`** — scaffold a workspace · mode/phase/ticket/gates · refresh the vendored pack to the latest version.
+
+### Done Design — products WITH personality, provably accessible
+
+Every Done product ships with a **coherent identity**, not the scaffold default — and its accessibility is **computed, not asserted**. The **Design Director** (`.done/agents/21_DESIGN_DIRECTOR_AGENT.md`) runs the brand intake, picks or derives a design language (`DESIGN_LANGUAGES.md`), and calls **`donepack gen-tokens`** to produce a contrast-verified `BRAND.md` (no hand-typed hex). The **Experience Guardian** (`20`) judges taste on top of the engine's measured facts. Doctrine: `COLOR_SYSTEM`, `ANTI_AI_SLOP`, `TYPOGRAPHY_SYSTEM`, `CRAFT_BASELINE`, `DESIGN_RUNTIME_VERIFICATION`, `MOTION_SYSTEM`, `THEMING_RUNTIME`.
+
+<!-- BEGIN AUTO-GENERATED: regenerated by `pnpm sync-skill` from the pack. Do not edit by hand. -->
+
+### Engine surface (the `donepack` CLI)
+
+Run via `Bash` (all support `--json`). Prefer these over parsing files by hand:
+
+`donepack audit`, `donepack autonomy`, `donepack change`, `donepack check-intake`, `donepack check-pack`, `donepack check-product`, `donepack check-roadmap`, `donepack doctor`, `donepack eval`, `donepack gate`, `donepack gen-tokens`, `donepack impact`, `donepack ingest`, `donepack init`, `donepack maturity`, `donepack model`, `donepack next`, `donepack run`, `donepack scaffold-qa`, `donepack score`, `donepack status`, `donepack substance`, `donepack upgrade`, `donepack verify`, `donepack watch`.
+
+`donepack check-product` is the Definition-of-Done gate. **Product-integrity findings**:
+
+`(auth)`, `(backoffice)`, `(boundary)`, `(config-leak)`, `(copy-register)`, `(data-rights)`, `(dev-copy)`, `(discovery)`, `(money-precision)`, `(support)`.
+
+**Done Design findings** — computed, not asserted (`(contrast-fail)`/`(contrast-bluff)` are HIGH and block the build; the rest are advisory tells/drift):
+
+`(contrast-bluff)`, `(contrast-fail)`, `(dark-parity)`, `(emoji-icon)`, `(generic-design)`, `(raw-color)`, `(reduced-motion)`, `(slop-glass)`, `(slop-palette)`, `(slop-shadow)`, `(spacing-grid)`, `(type-scale)`.
+
+`donepack gen-tokens [language] [--seed <hex>] [--out <file>]` emits a contrast-verified design-token block — the **Design Director** (`.done/agents/21_DESIGN_DIRECTOR_AGENT.md`) calls it instead of hand-typing hex; the **Experience Guardian** (`20`) judges taste on top of these measured facts.
 
-All support `--json`. Use via `Bash` when faster than manual file ops.
+<!-- END AUTO-GENERATED -->
 
 ---
 
@@ -164,4 +186,4 @@ No closing question unless there's a real gate or the intake wall is still open.
 
 ---
 
-_This skill is `@donedev/claude-skill@0.2.0`. The full pack lives at https://github.com/Endyveloz/done-agent-pack._
+_This skill ships as `@donedev/claude-skill`. The **Engine surface** in §9 is auto-synced to the pack via `pnpm sync-skill` — CI fails if it drifts, so the skill can't silently fall behind the pack. The full pack lives at https://github.com/Endyveloz/done-agent-pack._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donedev/claude-skill",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Done Agent Pack — Claude Code skill. Drop SKILL.md into ~/.claude/skills/done/ to teach Claude Code how to operate Done workspaces natively.",
   "license": "MIT",
   "author": "Endyveloz",