workstate-system

Shared workstate-system surface: skills, hooks, contracts, commands, prompts, and the validators that keep them coherent.

This repository is MVP-scope-private internal tooling. It is consumed by the workstate-bootstrap CLI, which clones it into <consumer-root>/.workstate/remote/ and symlinks selected surfaces into consumer repos. There is no LICENSE or CONTRIBUTING file by design.

The canonical sources are model-agnostic. Per-agent surfaces (.claude/skills/, .claude/commands/, .github/prompts/, .codex/skills/, .cursor/skills/, .grok/plugins/workstate-system/, ...) are generated into target repos by scripts/generate_agent_workflows.py during workstate-bootstrap install. They do not exist in this package's source tree.

Path	Purpose
`skills/<slug>/skill.yaml`	Canonical structured metadata per skill. Validates against `workstate_protocol.SkillManifest`.
`skills/<slug>/body.md`	Canonical prose body per skill. Plain Markdown, no frontmatter.
`config/agent-workflows/portable_commands.json`	Source-of-truth manifest for the portable command router.
`scripts/generate_agent_workflows.py`	Renders the manifest + skills into per-agent artifacts (Claude commands + skill packs, Copilot prompts, Codex router blocks, Codex/Cursor/grok skill copies).
`scripts/check_skills.py`	Skill-anatomy validator (delegates structured validation to `workstate_protocol.SkillManifest`).
`scripts/check_harness_sync.py`	Cross-harness contract validator.
`scripts/migrate_skills_to_neutral_layout.py`	One-shot migration helper from the legacy `.claude/skills/<slug>/SKILL.md` layout.
`scripts/hooks/`	Claude Code / Copilot shared hooks plus client-side git hooks.
`docs/workstate/contracts/`	YAML contracts (`harness-protocol.yaml` and friends).
`docs/workstate/maps/mcp-tool-routing.yaml`	Routing map consumed by `check_skills.py` to validate `mcp_tools` references.
`docs/plugin-distribution.md`	Operator guide for `make plugins-build` / `make plugins-check` and the Claude / Codex / Cursor / grok install flow. See also ADR-001.
`Makefile.d/plugins.mk`	Make-target fragment wiring `plugins-build` / `plugins-check` to `generate_agent_workflows.py --mode=plugin`.

Versioning

This repository uses Semantic Versioning. The current package release is workstate-system 0.4.0; the current monorepo distribution tag is v0.1.24. See CHANGELOG.md for the full history.

Provenance

v0.2.0 was extracted from a consumer repository snapshot. It expands the skill catalog to 21 populated skills, hoists the .claude/commands/, .github/prompts/, and docs/workstate/templates/ surfaces, and splits the docs/workstate/contracts/ directory so only the six agent/agentic contracts ship in the hoisted surface (the consumer-specific contracts were removed).
v0.1.0 was extracted from the first consumer repository snapshot used to seed this package.

Consumer Setup

The workstate-bootstrap CLI handles the clone + symlink + overlay-manifest write cycle for consumers. Consumer repos may publish repo-local setup notes that point back to this package.

Metadata

Release files for workstate-system 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for workstate-system 0.4.2
File	Size	Uploaded
workstate_system-0.4.2.tar.gz	539.6 kB	Jun 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for workstate-system 0.4.2
File	Interpreter	ABI	Platform	Reset
workstate_system-0.4.2-py3-none-any.whl 695.2 kB Jun 18, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / workstate_system-0.4.2.tar.gz

Download URL	workstate_system-0.4.2.tar.gz
Size	539.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`aa56642f1b1c1f7509be44ca4af4c294bdf113db49af6a60d569d73b550fa665`
BLAKE2b-256 checksum How to use checksums	`93c0a47e1957094b79eb1a5225c34e5a8012ae9f472a24a154dede78debaea6f`
Upload date	Jun 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`

Release files / workstate_system-0.4.2-py3-none-any.whl

Download URL	workstate_system-0.4.2-py3-none-any.whl
Size	695.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d36454befd8767d00046dcaab5f57a29d4f62de775cc5f22ce657805d4a549b7`
BLAKE2b-256 checksum How to use checksums	`9e7cd04d8b52068cd23552b61488ea2333039a62de77a02bf0f66f1d0de215de`
Upload date	Jun 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`