Skip to content

docs: state-md skill — project state manager#20

Merged
bketelsen merged 2 commits intomainfrom
docs/state-md-skill
Apr 30, 2026
Merged

docs: state-md skill — project state manager#20
bketelsen merged 2 commits intomainfrom
docs/state-md-skill

Conversation

@bketelsen
Copy link
Copy Markdown
Contributor

Reusable skill for any agent system that needs to work with STATE.md task graphs. Covers session start protocol, parallel dispatch with worktree isolation, orchestrator-only state updates, YAML validation, and anti-patterns table.

Installed in Pie's shared skills dir in the same session.

…aphs

Reusable skill teaching agents to:
- Read STATE.md at session start
- Identify unblocked tasks and dispatch in parallel with worktree isolation
- Update STATE.md as orchestrator after merge (never delegate)
- Validate YAML before committing
- Anti-patterns table covering the known failure modes
…lot)

Primary audience is now any agent CLI user, not Pie-specific.
Dispatch is described as git worktrees + agent CLI in terminal.
Pie/dispatch_subagent moved to a Note at the bottom as an optimization.
@bketelsen bketelsen merged commit 3652d4c into main Apr 30, 2026
1 check passed
@bketelsen bketelsen deleted the docs/state-md-skill branch April 30, 2026 00:47
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