-
Notifications
You must be signed in to change notification settings - Fork 8
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Summary
Add a lightweight code path in LoomManager that creates the minimum infrastructure needed for a swarm agent: worktree, branch, env file, metadata, and port — skipping IDE, terminal, dev server, and Claude launch.
Context
Part of the Autonomous Swarm Mode epic (#557). Swarm agents need isolated worktrees but don't need interactive tooling. This path must be fast since it's called once per child issue in the swarm.
Scope
New Lightweight Create Path
Add a new option to CreateLoomInput or a new method on LoomManager:
interface CreateLoomInput {
// ... existing fields
options?: {
// ... existing fields
swarmMode?: boolean // New: minimal setup for swarm agents
}
}When swarmMode: true:
- Creates: worktree, branch (off epic branch, not main), env file copy, metadata, port assignment
- Skips: IDE launch, terminal launch, dev server, Claude launch, dependency installation (agent handles this)
- Returns: structured data
{ id, path, branch, port, identifier }for supervisor consumption
Key Implementation Details
- Branch should be created off the epic branch (passed as
baseBranchinCreateLoomInput) - The loom should be marked as a child loom with
parentLoommetadata pointing to the epic loom - Port assignment follows existing logic (
3000 + issue number) - Metadata should include
{ swarmAgent: true }for identification - Environment file copying follows existing
EnvironmentManagerlogic
Integration with Existing Code
- This should work through the existing
LoomManager.createIloom()method with the swarmMode flag - The existing
enableClaude: false, enableCode: false, enableDevServer: false, enableTerminal: falseflags already skip most interactive tooling - The main addition is: ensuring the branch is off the epic branch (not main) and skipping dependency install
Acceptance Criteria
-
createIloom()withswarmMode: truecreates worktree + env + metadata in minimal time - Branch is created off the specified
baseBranch(epic branch) - Loom is correctly linked as child loom to the epic loom
- No IDE, terminal, dev server, or Claude launched
- Returns structured data needed by supervisor
- Unit tests verify minimal path with mocked git operations
Scope Boundaries
- Does NOT launch agents (supervisor does that)
- Does NOT handle agent lifecycle or monitoring
Dependencies
None — this is an independent infrastructure change to LoomManager.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request
Type
Projects
Status
No status