Link Repository to Multi-Repo Speck Root

Creates a .speck/root symlink to enable multi-repo mode and registers this repository in the Speck root's linked-repos.md file.

Usage

/speck:link <path-to-speck-root>

Examples

From frontend repo in my-product/ directory:

/speck:link ..

From nested monorepo package (e.g., packages/ui/):

/speck:link ../..

Using absolute path:

/speck:link /Users/dev/my-product

What This Does

1. Creates symlink: .speck/root → <path>
2. Enables multi-repo mode (automatic detection)
3. Specs now read/written to <path>/specs/
4. Plans/tasks/constitution remain local to this repo
5. Automatically updates <path>/.speck/linked-repos.md to register this repository
6. Creates reverse symlink: <speck-root>/.speck/repos/<repo-name> → relative path back to this repo

Multi-Repo Workflow

After linking, you can:

• Create shared spec: /speck:specify "Feature description" (creates spec at speck root)
• Generate local plan: /speck:plan (uses this repo's constitution)
• Check configuration: /speck:env (shows multi-repo status)

Implementation

Run the Speck CLI link command:

speck link <path-to-speck-root>

The CLI handles all the details:

• Creates .speck/ directory if needed
• Creates the symlink with proper path adjustment
• Sets up reverse symlink at speck root
• Updates linked-repos.md