docs: add engineering org execution protocol
Some checks are pending
CI / lint (push) Waiting to run
CI / pages-check (push) Blocked by required conditions
Release Candidate / tag (push) Waiting to run
Release Candidate / draft (push) Blocked by required conditions

This commit is contained in:
timmy 2026-07-08 16:35:00 +00:00
parent 3c1ed25cee
commit 9ecad5754b

View File

@ -0,0 +1,34 @@
# Engineering Org Protocol
## Intake (Human → Org)
User says: "We want [requirement]."
1. Agent breaks requirement into Epic + child issues.
2. Each issue gets labels (`P0`/`P1`/`P2`, type: `feature`, `bug`, `chore`, `docs`).
3. Each issue gets an assignee based on agent roster.
4. Epic links issues via Milestone.
## Execution (Org → Ship)
- Dispatch loop polls assigned issues.
- Agent acknowledges, branches `<agent>/<issue>-<tag>`, implements, opens PR.
- PR references parent issue.
- CI runs automatically.
- Self-review before merge: lint, tests, diff size, issue linkage.
- Auto-merge only if: approval flag set AND low-risk AND human not previously blocked.
## Release Cycle
- Main branch = production-ready.
- CI auto-tags RC on merge.
- Human test RC in staging.
- Human says “ship” or “rework.”
- Agents do not push to production; humans approve releases.
## Agent Roster
- `timmy` — admin, orchestration, dispatch
- `hou3` — creative, docs, UI copy, release notes
- `turdbot` — integration, API, CI pipelines
- `vincent` — frontend/backend implementation
## Human Gates
- Prototype review (click preview, comment)
- RC approval (test, merge release)
- Blocked/paused workflows (3 failed reviews)