chore: moving towards agentic development

docs/TASKS/workspace-review-workflow/001-document-content-state-machine.md

@@ -0,0 +1,39 @@
+# Task: Document content state machine
+
+## Feature
+
+`docs/FEATURES/workspace-review-workflow.md`
+
+## Goal
+
+Define the current and intended content item states, transitions, and approval side effects before further workflow implementation.
+
+## Context
+
+The code already contains content items, approvals, comments, assets, notifications, and review queue screens. The workflow needs one durable spec so future agents do not infer state transitions from scattered UI code.
+
+## Files Likely To Change
+
+- `docs/FEATURES/workspace-review-workflow.md`
+- `docs/FEATURES/content-approval-workflow.md`
+- optionally `docs/DECISIONS/*.md`
+
+## Constraints
+
+- Documentation-only task.
+- Do not change backend or frontend code.
+- Distinguish current behavior from proposed behavior.
+
+## Done When
+
+- [ ] States are listed
+- [ ] Allowed transitions are listed
+- [ ] Actor permissions are listed
+- [ ] Notification side effects are listed
+- [ ] Open questions are explicit
+
+## Validation Commands
+
+```bash
+git diff -- docs/FEATURES docs/DECISIONS
+```