docs: redefine approval workflow

This commit is contained in:
2026-05-01 00:58:47 -04:00
parent 1722d65d22
commit 5077f557f4
8 changed files with 387 additions and 279 deletions

View File

@@ -0,0 +1,46 @@
# Task: Define approval workflow
## Feature
`docs/FEATURES/approval-workflow.md`
## Goal
Define the v1 approval workflow behavior for `ContentItem` approval.
## Context
Approval workflow has been split from production workflow. The object being approved is a `ContentItem`, and workspaces configure approval behavior without defining a fully custom state machine.
## Scope
- Define approval modes.
- Define approval actors.
- Define approval decisions.
- Define the state transitions affected by approval.
- Define notification and audit side effects.
- Define open questions that remain outside v1.
## Constraints
- Documentation-only task.
- Do not change backend or frontend code.
- Keep production workflow details out of this task except where needed to explain boundaries.
## Done When
- [ ] approval modes are defined
- [ ] actor permissions are defined
- [ ] approval decisions are defined
- [ ] state transition behavior is defined
- [ ] workspace configuration fields are described
- [ ] notification side effects are listed
- [ ] audit requirements are listed
- [ ] out-of-scope production behavior is explicitly separated
## Validation Commands
```bash
git diff -- docs/FEATURES docs/TASKS
```

View File

@@ -0,0 +1,42 @@
# Task: Define production workflow
## Feature
`docs/FEATURES/production-workflow.md`
## Goal
Define the v1 production workflow for how a `ContentItem` is planned, created, revised, and prepared for review.
## Context
Production workflow has been split from approval workflow. This task should be picked up later after approval workflow is defined.
## Scope
- Define production states or readiness markers.
- Define production actors.
- Define asset and revision expectations.
- Define assignment and ownership expectations.
- Define how production work prepares a `ContentItem` for review.
## Constraints
- Documentation-only task.
- Do not change backend or frontend code.
- Do not redefine approval modes or approval decisions here.
## Done When
- [ ] production scope is defined
- [ ] production actors are defined
- [ ] asset and revision rules are defined
- [ ] readiness-for-review behavior is defined
- [ ] approval workflow boundaries are explicit
## Validation Commands
```bash
git diff -- docs/FEATURES docs/TASKS
```

View File

@@ -1,39 +0,0 @@
# 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
```