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.)