Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/behavior.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,24 @@ documented in `docs/beads-prefix-migration.md`.
Repository-local Beads stores (for example `<repo>/.beads`) are not used for
Atelier planning state. They are treated as external ticket sources.

## Refined Planning Readiness Contract

- A changeset is refined only when metadata includes
`execution.strategy: refined`.
- Refined changesets must include a typed `planning.contract_json` payload.
- Planner guardrails fail closed when refined contract data is missing,
malformed, or conflicts with finalize semantics.
- Refined planning remains in review with `planning.stage: planning_in_review`
until operator approval.
- Promotion approval persists auditable metadata: `planning.stage=approved`,
`planning.approved_by`, `planning.approved_at`, and
`planning.approval_message_id`.
- Worker startup applies the same shared validator across next-changeset,
explicit review-feedback, merge-conflict, and global selector paths.
- Startup claim selection fails closed for refined changesets that are not
approved or have invalid contract evidence.
- Non-refined changesets keep existing startup/promotion behavior.

## Command behavior (high level)

- `atelier init`
Expand Down
288 changes: 288 additions & 0 deletions docs/plans/2026-03-26-trycycle-ready-planner-contract-test-plan.md

Large diffs are not rendered by default.

Loading
Loading