Skip to content

v0.11.0 — diataxis-author skill

Choose a tag to compare

View all tags
@alexherrero alexherrero released this 22 May 21:16
· 461 commits to main since this release
v0.11.0
1e0dca9

diataxis-author skill — second major skill in the toolkit after memory. Author + maintain a Diátaxis-style wiki for any repo. One skill, five sub-commands covering the full lifecycle. Subsumes the harness's migrate-to-diataxis predecessor.

Paired with agentic-harness v2.4.3 (paired-doc-only on harness side — 4th consecutive paired-release-as-documentation pair).

What ships

Five new /diataxis sub-commands:

  • /diataxis author <slug> — live authoring guidance: mode classification + template selection + filename style. Pre-fills a wiki/<mode-dir>/<filename>.md skeleton you edit in your editor.
  • /diataxis classify <file> — single-page mode classification. Tier-1 deterministic heuristic + optional Tier-2 sub-agent dispatch for ambiguous mode-mixed cases.
  • /diataxis check [--strict] — drift detection. Wraps check-wiki.py (harness validator) + adds 4 skill-side heuristics: mode-mixed, stale-cross-ref, template-shape-drift, convention-drift.
  • /diataxis repair — interactive fix-application. Preview-first per finding; dispatches documenter sub-agent for mode-mixed splits.
  • /diataxis migrate — one-shot legacy → Diátaxis migration (subsumes harness's migrate-to-diataxis predecessor). Preview-first, blame-preserving, single-commit safety net.

Plus:

  • diataxis-evaluator read-only sub-agent — zero filesystem write scope; semantic Tier-2 classification.
  • AgentMemory integration — 3-tier convention fallback: per-repo <wiki>/.diataxis-conventions.md > vault _always-load/diataxis-*.md > ADR 0004 defaults.
  • 4 Diátaxis templates at skills/diataxis-author/templates/ matching ADR 0004's mode definitions.

Why this shape

The operator maintains three Diátaxis-shaped wikis (agentic-harness + agent-toolkit + dev-setup) plus the just-shipped MemoryVault parent design. Diátaxis discipline was previously supported only by check-wiki.py --strict (catch post-write) + documenter sub-agent (sweep at /release) + migrate-to-diataxis (one-shot). This skill ships the missing live-authoring-guidance + ongoing-drift-detection layer + subsumes the predecessor + repurposes documenter as mechanical-write worker (same orchestration + sub-agent pattern as /memory adapt-skills + adapt-evaluator from #7b).

Design rationale

ADR 0008 — diataxis-author skill — 4 locked design calls (scope = author+maintain+migrate; AgentMemory = read+write; documenter = worker; single skill with 5 sub-commands) + 4 load-bearing assumptions with re-audit triggers.

Parent design — diataxis-author — full architectural context (Status: launched).

Full changelog

CHANGELOG.md v0.11.0 entry

Assets 2
Loading