suede-agent-teams

Orchestrates parallel agent lanes with file ownership, collision detection, quality gates, and evidence handoffs.

123|10|Updated May 24, 2026
One-click install
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-agent-teams-jasoncolapietro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: suede-agent-teams
Source: https://github.com/JasonColapietro/suede-creator-skills/tree/main/skills/suede-agent-teams
Command: npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-agent-teams-jasoncolapietro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Coordinating multiple AI agents on one shared change often leads to file collisions, unverified claims of completion, and handoffs that omit critical evidence. This Skill structures multi-agent work into explicit lanes with ownership rules, status vocabulary, and gates so parallel work stays safe and auditable. ## Core Features & Use Cases - Lane orchestration with WIP collision detection: Define a Team Contract and lane map, detect dirty-file conflicts via git status before any builder opens a file, and sequence or merge colliding lanes. - Quality gates and escalation thresholds: Run planning, review, and release gates as advisory recommendations, with hard stop conditions for repeated fix cycles, security findings, cost spikes, and contradictory constraints. - Public contribution program: Score, lease, and track repository contribution tasks through a deterministic JSON ledger script with atomic locking, one-shot publication grants, and outward artifact checks. - Use Case: A team needs to ship an auth rewrite safely. The orchestrator requires an accepted RFC, assigns a builder to auth files only, runs code grading and review lanes, verifies the release in production, and closes with a signed evidence handoff. ## Quick Start Use suede-agent-teams to split my feature work into coordinated lanes with a team contract, collision detection, and a final evidence handoff.

Frequently Asked Questions about suede-agent-teams

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple AI agents on the same codebase?

Define a Team Contract with objective, target, constraints, and a lane map assigning each agent explicit file ownership. Run WIP collision detection with git diff and status before opening parallel lanes, then route Lane Ready notices between dependent lanes.

How do I prevent parallel agents from editing the same files?

List every file each lane would touch and flag collisions where paths overlap or match dirty working-tree files. Sequence independent changes, merge overlapping changes into one lane, and never let two concurrent builders share responsibility for a single file.

What is the contribution ledger script used for?

The contribution-ledger.mjs Node.js script manages a shared task queue for public-repository contribution programs. It scores tasks, issues atomic leases to prevent duplicate work, validates outward artifacts like commit messages, and records one-shot publication grants.

When should I use an RFC before starting agent work?

Require an RFC for shared interface changes, schema migrations, auth flow rewrites, payment path changes, public API contract changes, or any approach discussed twice without resolution. No builder lane opens until the RFC status is accepted.

Can the quality gates block my requested action?

No. All gates and ship verdicts are advisory recommendations reported alongside the completed work, never blockers. The single exception is extreme-risk findings such as data loss or credential exposure, which pause for your explicit decision.

When is this orchestrator the wrong tool?

Skip it for a single repo change a bundled DAG can run end to end, findings-only diff review, A-F ship grading, or CI and merge-gate wiring. Those cases route to dedicated skills like suede-graph-flo-xr, suede-code-review, or suede-ci-gate.