v0.x This is the released v0.x line — the version that ships in release tarballs and is dogfooded in this repository. The v1.0 rebuild is documented separately in the v1.x preview.

Alpha Scope

First buildable vertical slice for processkit v1.0.

Purpose

The alpha proves that the v1.0 model improves real agentic project work before the project implements the full 89-concept ontology.

The alpha is a vertical slice, not a miniature final release.

Scope

Implement 10-15 high-value concepts covering:

  • WorkItem
  • DecisionRecord
  • Artifact
  • Discussion
  • Note
  • LogEntry
  • Binding
  • Gate
  • Role
  • TeamMember
  • Skill
  • Capability
  • Proposition or Risk
  • Scope
  • Migration

The exact list may change if implementation evidence shows a better slice, but it must cover work, decisions, artifacts, relations, gates, roles, skills, and event history.

Required Capabilities

  • Generate schemas for the alpha kinds.
  • Create and transition entities through MCP tools.
  • Query entities by ID, text, relation, and interface.
  • Preserve structured LogEntries.
  • Migrate a small v0.x corpus.
  • Export a conformant OKF bundle.
  • Publish the docs site locally and through GitHub Pages.
  • Run automated fixture tests without requiring aibox.
  • Run one real process cycle through the new model.

Out Of Scope

  • Full 89-concept implementation.
  • Complete migration of every historical entity.
  • Runtime-specific orchestration.
  • Vector database integration.
  • Public package stability guarantees.

Alpha Proof

The alpha is successful when:

  • a real work item moves from capture to completion
  • at least one decision is recorded and linked
  • artifacts and notes are attached as supporting evidence
  • a gate or approval is represented
  • event history is queryable
  • an agent can retrieve the relevant context through MCP
  • OKF export passes v0.1 conformance
  • processkit-native tests pass without aibox
  • a human can inspect the same state in files and docs