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.
Contents
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.0was extracted from a consumer repository snapshot. It expands the skill catalog to 21 populated skills, hoists the.claude/commands/,.github/prompts/, anddocs/workstate/templates/surfaces, and splits thedocs/workstate/contracts/directory so only the six agent/agentic contracts ship in the hoisted surface (the consumer-specific contracts were removed).v0.1.0was 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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file workstate_system-0.4.1.tar.gz.
File metadata
- Download URL: workstate_system-0.4.1.tar.gz
- Upload date:
- Size: 515.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d36a8b5e657a8d401d9f85b760591fbbba12f81d8273f961f21abde3332b3784
|
|
| MD5 |
93915dc617277c19f2d51e1023acbd45
|
|
| BLAKE2b-256 |
0c4126f0fded29fda3bb7bf7ce13fa29e91437699639cd2b7ceb724a7666f810
|
Provenance
The following attestation bundles were made for workstate_system-0.4.1.tar.gz:
Publisher:
release-publish.yml on darce/workstate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
workstate_system-0.4.1.tar.gz -
Subject digest:
d36a8b5e657a8d401d9f85b760591fbbba12f81d8273f961f21abde3332b3784 - Sigstore transparency entry: 1809474274
- Sigstore integration time:
-
Permalink:
darce/workstate@36625fb29e60ff838e211b7a9b15fa846e6f683e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/darce
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-publish.yml@36625fb29e60ff838e211b7a9b15fa846e6f683e -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file workstate_system-0.4.1-py3-none-any.whl.
File metadata
- Download URL: workstate_system-0.4.1-py3-none-any.whl
- Upload date:
- Size: 666.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db703995cbe0b8770548b2f668eac1c01375402de6ebb077ed64fdfea4d72afd
|
|
| MD5 |
84a2e74858d9a5301f1e4a7ced751335
|
|
| BLAKE2b-256 |
dc1f8c4b7266182d6354b9dd5a70a07094c6e93248178fbbea02d8a78fd690ed
|
Provenance
The following attestation bundles were made for workstate_system-0.4.1-py3-none-any.whl:
Publisher:
release-publish.yml on darce/workstate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
workstate_system-0.4.1-py3-none-any.whl -
Subject digest:
db703995cbe0b8770548b2f668eac1c01375402de6ebb077ed64fdfea4d72afd - Sigstore transparency entry: 1809474291
- Sigstore integration time:
-
Permalink:
darce/workstate@36625fb29e60ff838e211b7a9b15fa846e6f683e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/darce
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-publish.yml@36625fb29e60ff838e211b7a9b15fa846e6f683e -
Trigger Event:
workflow_dispatch
-
Statement type:
