Human-AI collaboration flow for document updates. Keywords: collaboration, workflow, updates.
The canonical workflow is: AI Draft -> Human Review -> AI Revise
flowchart LR
A[AI Drafts] --> B[Human Reviews]
B -->|Approved| C[AI Finalizes]
B -->|Feedback| D[AI Revises]
D --> B
C --> E[Outcome Recorded]
| Decision Type | Record Location | Promotion Target |
|---|---|---|
| Task-specific decisions | workdocs/ (plan.md, context.md) | Archive when complete |
| Stable knowledge | workdocs/ initially | Promote into the relevant skill package under /.system/skills/ssot/** |
| Repeated patterns | workdocs/ observations | Abilities or workflows |
| Policy decisions | Review comments |
| Update AGENTS.md if applicable |
Humans provide review feedback using inline comments or structured blocks:
<!-- REVIEW: [reviewer_name] [date]
Status: approved | needs_revision | blocked
Feedback: Specific feedback text here
-->
AI must:
Certain actions require explicit human approval:
| Action Type | Approval Required | Record Method |
|---|---|---|
| Production deployment | Yes | workdocs/tasks.md checkpoint |
| Security-sensitive changes | Yes | workdocs/tasks.md checkpoint |
| Cross-module breaking changes | Yes | Integration scenario workdocs |
| Credential/secret access | Yes | DevOps scenario workdocs |
AI must stop and request approval when: