Skip to content

docs(spec): redefine processkit v1 from first principles - #182

Draft
projectious wants to merge 10 commits into
v1.x-devfrom
agent/processkit-v1-product-spec
Draft

docs(spec): redefine processkit v1 from first principles#182
projectious wants to merge 10 commits into
v1.x-devfrom
agent/processkit-v1-product-spec

Conversation

@projectious

@projectious projectious commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Objective

Define a coherent baseline for a clean Processkit v1 implementation from first principles.

Updated decisions

  • accept Python 3.12+ as the sole application language with one CLI/MCP application core
  • replace the mandatory 89-concept ontology with a small repository-memory kernel plus optional first-party packages
  • retain the 89 concepts as a disposition inventory rather than a universal release gate
  • initially reuse only the smallest fitting semantics: Dublin Core Terms for generic metadata and W3C PROV for provenance where meanings fit
  • defer general RDF, JSON-LD, OWL, SHACL, and knowledge-graph export work
  • preserve v0/alpha learning through a capability disposition matrix and black-box fixtures, not source-code reuse

Validation

  • scripts/validate-v1-spec.py: valid roadmap, links, dependency graph, and 412 unique normative requirements
  • git diff --check

Review focus

Please review the provisional kernel, optional-package boundary, minimal semantic-standard reuse, accepted Python architecture, and v0 capability-disposition requirement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant