Spec Kit · coordinated multi-repo branching
A community preset for GitHub Spec Kit that detects which repositories a feature affects and generates the tasks needed to create matching branches in all of them.
The problem
Spec Kit is GitHub’s toolkit for spec-driven development (SDD): you describe a feature in a specification, and an AI agent turns it into a technical plan and a list of tasks. Out of the box, however, it only works on the root repository. In projects made up of several components, each with its own git history or included as a submodule, the same feature branch had to be created by hand in every affected repo.
What the preset does
| Phase | Without the preset | With the preset |
|---|---|---|
| Plan | Analyzes only the root repo | Discovers child repos and identifies which ones the feature affects |
| Tasks | No branching tasks | Adds Phase 1 tasks that create the feature branch in every affected repo |
independentmode: looks for folders with their own.gitdirectory, respecting.gitignore.submodulemode: reads the repositories listed in.gitmodules.automode: chooses the right strategy for the project automatically.- The scan depth can be configured in
.specify/init-options.json.
Why it matters
The preset came out of a real need: applying agent-driven SDD to brownfield projects where the backend, frontend and shared libraries live in separate repositories. It’s a small piece, but it removes friction exactly where agent workflows tend to break down.