conventions/programming_general/multi_agent_workflow.yaml
Natalie 3dc5a9b321 feat(conventions): codify lilith v0-v4 conventions (py/rust/gd + 7 general)
Mined the egirl->cocotte lineage + the prose agentic configs. Per-language
standards (py/rust/gd) and general conventions: service_architecture,
multi_agent_workflow, error_handling_logging, mcp_server_patterns,
naming_conventions, tenancy_patterns (draft), database_patterns. Captures the
canonical/latest where versions diverged. 14/14 lint:yaml-valid.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 08:42:44 -04:00

28 lines
1.3 KiB
YAML

apiVersion: conventions/v1
version: 0.1.0
updated: "2026-06-29"
name: multi_agent_workflow
title: Trunk-only multi-agent workflow
scope: general
status: active
summary: Concurrent agents work on main directly, commit only their own narrow diff with explicit pathspecs, and never clobber another session's WIP. From v2 lilith concurrent-agent protocol.
appliesTo: ["~/Code/**"]
rules:
- id: trunk_only
level: must
text: Work on `main` directly; no feature branches unless the project requires them.
- id: fresh_state
level: should
text: "Before committing, sync fresh: `git fetch && git merge --ff-only origin/main`."
- id: scoped_pathspec
level: must
text: "Concurrent agents share one working tree — stage with explicit pathspecs (`git add <your paths>` / `git commit -- <paths>`), never blind `git add -A`."
- id: own_commit
level: must
text: Each agent commits + pushes the work it produced; never defer to a parent or daemon.
- id: leave_wip_alone
level: must
text: Other agents' staged/uncommitted files are not a blocker and not yours — never `git checkout`/`git stash`/revert another session's WIP; commit only your narrow diff.
- id: atomic_conventional
level: must
text: One logical change per commit; conventional message + Co-Authored-By trailer. (See convention:git_commit.)