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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workstate_system-0.4.2.tar.gz (539.6 kB view details)

Uploaded Jun 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

workstate_system-0.4.2-py3-none-any.whl (695.2 kB view details)

Uploaded Jun 18, 2026 Python 3

File details

Details for the file workstate_system-0.4.2.tar.gz.

File metadata

Download URL: workstate_system-0.4.2.tar.gz
Upload date: Jun 18, 2026
Size: 539.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for workstate_system-0.4.2.tar.gz
Algorithm	Hash digest
SHA256	`aa56642f1b1c1f7509be44ca4af4c294bdf113db49af6a60d569d73b550fa665`
MD5	`14be2267d7b525eefda27f50a6a7b7c0`
BLAKE2b-256	`93c0a47e1957094b79eb1a5225c34e5a8012ae9f472a24a154dede78debaea6f`

See more details on using hashes here.

File details

Details for the file workstate_system-0.4.2-py3-none-any.whl.

File metadata

Download URL: workstate_system-0.4.2-py3-none-any.whl
Upload date: Jun 18, 2026
Size: 695.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for workstate_system-0.4.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d36454befd8767d00046dcaab5f57a29d4f62de775cc5f22ce657805d4a549b7`
MD5	`fb6b6ac125be26ce335c2794f5f0c9f4`
BLAKE2b-256	`9e7cd04d8b52068cd23552b61488ea2333039a62de77a02bf0f66f1d0de215de`