Skip to content

docs: add workflow evidence lifecycle - #2

Open
butcer0 wants to merge 1 commit into
mainfrom
feature/workflow-evidence-lifecycle
Open

docs: add workflow evidence lifecycle#2
butcer0 wants to merge 1 commit into
mainfrom
feature/workflow-evidence-lifecycle

Conversation

@butcer0

@butcer0 butcer0 commented Jul 13, 2026

Copy link
Copy Markdown
Owner

Summary

Adds documentation for the workflow evidence lifecycle used by codex-mesh.

The document describes how work should move from a Beads-backed goal through bounded agent activity, evidence capture, review, and closeout. It is written as an architectural guide rather than a tutorial, and it keeps the project’s ownership model explicit: Beads owns durable work state, CUE owns contract semantics, and shell scripts remain transport adapters.

Changes

  • Added docs/workflow-evidence-lifecycle.md
  • Added a README pointer to the new workflow evidence lifecycle document
  • Documented lifecycle phases for goal selection, claim, execution, review, verification, and closure
  • Clarified the relationship between Beads formulas, typed result envelopes, reviewer output, and verification evidence
  • Tightened language using the repository-local academic-humanizer guidance to remove inflated or informal phrasing

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