29 lines
1.3 KiB
YAML
29 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.)
|