workgraph-workflow
SolidHow to use WorkGraph for durable commitments, dependencies, claims, and evidence
AI & Automation 18 stars
5 forks Updated today Apache-2.0
Install
Quality Score: 77/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# WorkGraph Workflow
Use WorkGraph when work must survive sessions, compaction, restarts, schedules,
or coordination between agents. It is the shared commitment graph, not private
scratch space and not semantic memory.
## Operating Rules
- Use `workgraph_ready` to find eligible work. Do not infer readiness from item
fields, blocker counts, due times, or edges yourself.
- Claim an item before doing durable or shared work with `workgraph_claim`.
Include your typed owner and the current `revision`.
- If a write fails with a stale revision, reload the item with `workgraph_get`
or `workgraph_snapshot`, reconsider the current state, then retry only if the
work still makes sense.
- Use `workgraph_link` for real dependencies and relationships. Use `blocks`
only when the target should not be ready until the source is terminally
resolved.
- Attach evidence with `workgraph_add_evidence` for artifacts, PRs, logs,
summaries, external tickets, or other proof that the work changed state.
- Close with `workgraph_close` only when terminal truth exists. Use
`completed`, `failed`, or `cancelled` honestly.
- Release a claim with `workgraph_release` when you are stopping before terminal
completion and the work should be claimable by someone else.
## Boundaries
- Use builtin `task_*` tools for private, local, lightweight scratch tracking.
- Use WorkGraph for shared durable commitments, dependencies, readiness, claims,
and evidence.
- Use Schedule for time-based wakeups and...
Details
- Author
- lukacf
- Repository
- lukacf/meerkat
- Created
- 6 months ago
- Last Updated
- today
- Language
- TLA
- License
- Apache-2.0
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
task-workflow
How to use builtin task tools for private lightweight work tracking
18 Updated today
lukacf AI & Automation Solid
graph-engineering
Use when a workflow has explicit data dependencies, independently executable branches, typed joins, or node-local recovery needs that justify a bounded static dependency graph.
124 Updated 3 days ago
Mark393295827