v0.11.0 — Zettelkasten links, artifact clarity, MCP path fixes

What's new in v0.11.0

Added

• Note schema: links field — qualified Zettelkasten note-to-note links with target, relation (7 types: elaborates, contradicts, supports, is-example-of, see-also, refines, sourced-from), and a required context sentence. Tags group notes by topic; links build arguments.
• note-management SKILL.md: linking section — relation table, usage guidance, template example.

Changed

• Note type taxonomy aligned with Luhmann/Ahrens: insight = permanent note (never discarded); reference = literature note. Schema description and SKILL.md updated.
• Artifact schema — documents self-hosted (content in Markdown body) vs pointer (external location) patterns; location removed from required.
• config.py _skill_config_dir — tries processkit/ subdirectory first, fixing config/ID generation after v0.10.0 reorganization.
• .mcp.json — all 12 MCP server paths corrected for post-v0.10.0 layout.
• AGENTS.md — lean-scope principle added; context/ layout table expanded to all 15 directories.

See CHANGELOG.md for full details.

v0.10.0 — Skills categories, word-pair ID resolution, error-on-not-found

What's new

Skills directory reorganized into 7 categories

126 skills moved from a flat context/skills/ layout into category subdirectories:

Category	Count	Contents
processkit/	30	Skills for operating the processkit system
engineering/	46	Software design, architecture, backend, languages
devops/	15	Infrastructure, CI/CD, ops, monitoring
data-ai/	11	Data science, ML, AI/LLM, embeddings
product/	11	Product management, discovery, communication
documents/	8	Document and content authoring
design/	5	Visual, UI, and frontend design

All SKILL.md files updated with a consistent category: frontmatter field. skill-finder updated with a directory reference table.

Word-pair ID resolution (resolve_entity)

New index.resolve_entity() function enables 3-stage ID resolution:

1. Exact match
2. Prefix match — handles missing slug (e.g. KIND-DATETIME-WordPair)
3. Word-pair match — handles bare word-pair (e.g. StoutCrow)

All _load_* helpers and get_* tools updated to use it.

Error on not-found (no more null)

get_workitem, get_decision, and get_entity (index-management) now return {"error": "..."} instead of null/None for not-found IDs.

Release assets

• processkit-v0.10.0.tar.gz — reproducible source tarball (aibox preferred consumption path)
• processkit-v0.10.0.tar.gz.sha256 — SHA-256 checksum sidecar

v0.8.0

src/ target-root mirror (GrandLily), auto-log side effects (SolidSky), Note ID format fix

v0.7.0 — skill commands, MCP tool annotations, model-recommender

Added

• Skill commands convention — skills declare user-invocable slash commands
  via metadata.processkit.commands; each command gets a thin adapter file at
  commands/<skill>-<workflow>.md. Provider-neutral intent in SKILL.md,
  Claude-specific adapter in commands/. See src/skills/FORMAT.md → ### commands/.
• 23 commands across 13 skills: session-handover, standup-context,
  morning-briefing, context-grooming, skill-builder, skill-reviewer,
  research-with-confidence, decision-record, workitem-management,
  release-semver, note-management, model-recommender, owner-profiling
• MCP tool annotations — all 62 tools across all 12 MCP servers now carry
  explicit readOnlyHint, destructiveHint, idempotentHint, openWorldHint
• model-recommender skill — spider-chart AI model profiles and task-plan
  routing; 34-model roster (25 validated + 9 estimated); MCP server with 8 tools;
  Setup Questionnaire and Roster Refresh workflows
• skill-reviewer: 11-category checklist (was 8) — Category 10 (command
  adapter hygiene) and Category 11 (security & permission audit) added
• skill-builder: Step 8 (command adapter creation) and MCP annotation rules

Changed

• FORMAT.md: commands/ directory layout, metadata.processkit.commands
  field, MCP annotation spec with ToolAnnotations usage examples

v0.6.0

Historical release v0.6.0 — no CHANGELOG section; backfilled for release_integrity completeness (see pk-doctor).

processkit v0.5.1 — BACK-001 complete: three-level rewrite of all 85 migrated skills

v0.5.1 is a focused content release. All 106 shipped skills under src/skills/ now follow the canonical three-level format.

What's in this release

BACK-001 — three-level rewrite (85 skills)

The 85 migrated skills shipped in v0.2.0 have been rewritten to match the three-level format already used by the 21 process-primitive skills introduced in v0.4.0/v0.5.0. Per-skill changes:

• metadata.version bumped 1.0.0 → 1.1.0
• explicit spec.when_to_use field added
• spec.description condensed (drops the duplicated "Use when..." clause)
• body restructured into ## Level 1 — Intro (1-3 sentences), ## Level 2 — Overview (### subheadings, key workflows), ## Level 3 — Full reference (deeper material, anti-patterns, edge cases)
• 80-column hard wrap on prose (tables, code blocks, URLs, frontmatter exempt per the v0.5.0 line-width policy)
• references/ subdirectories left untouched; relevant material promoted into Level 3 inline or by reference

Reference exemplar

src/skills/python-best-practices/SKILL.md was rewritten first as the canonical structural reference. Subsequent rounds used it as the gold-standard exemplar.

Execution model

14 parallel general-purpose subagent invocations across 7 rounds (one to two categories per round, two agents per round). 8 commits total (1 exemplar + 7 rounds). The orchestrator verified format markers (Level 1/2/3 headers, version 1.1.0, when_to_use field) before each round commit.

What's NOT in this release

No code or schema changes from v0.5.0. The 11 MCP servers, 18 primitive schemas, 4 Process entities, and lib code are unchanged. Smoke test still green.

Verifying the release asset

```sh
sha256sum -c processkit-v0.5.1.tar.gz.sha256
```

Expected:
```
processkit-v0.5.1.tar.gz: OK
```

Full notes in context/HANDOVER.md and context/BACKLOG.md.

processkit v0.5.0 — provider-neutral install + 11 MCP servers + all 18 schemas

processkit v0.5.0 lands the consumer-side install layout (per the aibox handover v2) and fills the major content gaps from BACK-002, BACK-003, BACK-004.

Highlights

Provider-neutral install paths

• All mcp-config.json fragments use context/skills/<name>/mcp/server.py
• The lib resolves consumer-installed schemas at context/schemas/ and state machines at context/state-machines/
• _find_lib() walks up to context/skills/_lib/processkit/ in installs
• Runtime cache moved to context/.cache/processkit/index.sqlite (gitignored)
• All references to .claude/skills/ removed from shipped content
• Reference-templates model documented (replaces processkit.manifest)

AGENTS.md as canonical agent entry

• New AGENTS.md at the repo root holds the authoritative instructions (per the agents.md ecosystem convention)
• CLAUDE.md is a thin pointer
• New src/scaffolding/AGENTS.md template for consumer projects

BACK-002 — all 18 primitive schemas

• 14 new: Actor, Role, Scope, Gate, Discussion, Binding, Category, Metric, Schedule, Constraint, Context, Process, StateMachine, Artifact
• 2 new state machines: scope, discussion

BACK-003 — 11 MCP servers (was 6)

• 5 new: actor-profile, role-management, scope-management, gate-management, discussion-management
• Each follows the existing boilerplate, validates against its schema, and is exercised end-to-end in scripts/smoke-test-servers.py

BACK-004 — 4 Process entities under src/processes/

• bug-fix, code-review, feature-development, release
• Promoted from legacy aibox .md files to formal kind: Process entities

BACK-007 — WAL mode in the SQLite index

Release-asset tarball convention (DEC-025 / aibox BACK-106)

• This release is the first to ship a processkit-<version>.tar.gz release asset alongside the source tag
• Reproducible via scripts/build-release-tarball.sh
• Top-level entry inside the tarball is processkit-v0.5.0/ so consumers can untar without --strip-components
• Sibling .sha256 file for verification

Other

• 80-column line-width policy with smart exemptions (encoded in .editorconfig, documented in AGENTS.md and CONTRIBUTING.md)
• Aibox issues filed: projectious-work/aibox#33 (AGENTS.md scaffolding), projectious-work/aibox#34 (sync perimeter docs)

Verifying the release asset

sha256sum -c processkit-v0.5.0.tar.gz.sha256

Expected:

processkit-v0.5.0.tar.gz: OK

Full notes in context/HANDOVER.md and context/BACKLOG.md.

v0.4.0

Historical release v0.4.0 — no CHANGELOG section; backfilled for release_integrity completeness (see pk-doctor).

v0.3.0

Historical release v0.3.0 — no CHANGELOG section; backfilled for release_integrity completeness (see pk-doctor).

v0.2.0

Historical release v0.2.0 — no CHANGELOG section; backfilled for release_integrity completeness (see pk-doctor).