# swarm-forge | Robert C. Martin | Knowledge Base | Instagit

A simple tool for coordinating several AI agents.

GitHub Stars: 2k

Repository: https://github.com/unclebob/swarm-forge

---

## Articles

### [How to Add a New Agent Role to SwarmForge: A Complete Guide](/unclebob/swarm-forge/how-to-add-new-agent-role-swarmforge)

Learn how to add a new agent role to SwarmForge with this comprehensive guide. Discover the simple steps for creating prompts, registering roles, and launching agents efficiently.

- Tags: how-to-guide
- Published: 2026-09-02

### [SwarmForge Handoff Protocol: Full Specification Location and Implementation Guide](/unclebob/swarm-forge/swarmforge-handoff-protocol-specification-location)

Find the complete SwarmForge handoff protocol specification in a single markdown file. Learn directory layouts, message types, and agent coordination for the unclebob/swarm-forge repository.

- Tags: api-reference
- Published: 2026-09-02

### [How SwarmForge Handles Agent Conflicts: Detection, Resolution & Escalation](/unclebob/swarm-forge/how-swarmforge-handles-agent-conflicts)

Learn how SwarmForge handles agent conflicts with Git merge detection, delegate resolution, and operator escalation. Understand the conflict resolution process.

- Tags: deep-dive
- Published: 2026-09-02

### [What Agent Backends Does SwarmForge Support? A Complete List of 8 LLM Providers](/unclebob/swarm-forge/swarmforge-supported-agent-backends)

Explore SwarmForge's 8 supported agent backends including OpenAI, Anthropic, Cohere, Grok, Groq, Google Vertex AI, Mistral, and a mock backend. Integrate your LLM provider seamlessly.

- Tags: api-reference
- Published: 2026-09-02

### [How to Define Task or Batch Processing Modes for SwarmForge Agents](/unclebob/swarm-forge/define-task-or-batch-processing-modes-swarmforge)

Learn how to define task or batch processing modes for SwarmForge agents by configuring the roles.tsv file and utilizing the role-receive-mode function for efficient workflow management.

- Tags: how-to-guide
- Published: 2026-09-02

### [SwarmForge Agent Queue Management: Key Scripts and File‑Based Architecture Explained](/unclebob/swarm-forge/swarmforge-key-scripts-agent-queue-management)

Explore SwarmForge agent queue management with key scripts like swarm_handoff.sh and ready_for_next.sh. Understand its file-based architecture for efficient AI workload handling. Learn more now.

- Tags: deep-dive
- Published: 2026-09-02

### [How the SwarmForge Daemon Validates Delivery Targets: A Complete Code Walkthrough](/unclebob/swarm-forge/how-swarmforge-daemon-validates-delivery-targets)

Understand how the SwarmForge daemon validates delivery targets. Learn about header parsing, duplicate detection, role verification, and more in this code walkthrough.

- Tags: deep-dive
- Published: 2026-09-02

### [What Is the Handoff Daemon (handoffd.bb) in SwarmForge?](/unclebob/swarm-forge/swarmforge-handoff-daemon-function)

Discover the SwarmForge handoff daemon (handoffd.bb) automates task handoffs by scanning outbox directories, validating .handoff files, updating project boards, and sending tmux notifications.

- Tags: internals
- Published: 2026-09-02

### [How to Manage Agent Tasks and Batches in Swarm Forge: A Complete Guide](/unclebob/swarm-forge/swarmforge-manage-agent-tasks-and-batches)

Learn to manage agent tasks and batches in Swarm Forge with ready_for_next_task and ready_for_next_batch scripts. Streamline your workflow efficiently. Get started now.

- Tags: how-to-guide
- Published: 2026-09-02

### [How the Swarm Forge Agent Queue Loop Works: File-Driven Orchestration Explained](/unclebob/swarm-forge/swarmforge-agent-queue-loop)

Understand the Swarm Forge agent queue loop. Discover how Babashka scripts process AI tasks through file-driven orchestration for atomic execution and dashboard updates.

- Tags: internals
- Published: 2026-09-02

### [SwarmForge Handoff Filename Format: Complete Spec with Examples](/unclebob/swarm-forge/swarmforge-handoff-filename-format)

Understand the SwarmForge handoff filename format <priority>[_<timestamp>_<sequence>]_from_<source>_to_<destination>.handoff. Learn the spec and see examples for effective routing and ordering.

- Tags: api-reference
- Published: 2026-09-02

### [SwarmForge Handoff Message Types: The Two-Type Protocol Explained](/unclebob/swarm-forge/swarmforge-handoff-message-types)

Discover the two essential handoff message types in SwarmForge: git_handoff and note. Learn how this protocol streamlines agent-to-agent communication for multi-role development.

- Tags: deep-dive
- Published: 2026-09-02

### [Agent Handoffs Directory Structure in Swarm Forge: Complete Guide](/unclebob/swarm-forge/swarmforge-agent-handoff-directory-structure)

Explore the Swarm Forge agent handoffs directory structure, detailing outbox, sent, failed, and inbox folders for robust agent communication. Understand the .swarmforge/handoffs/ work-tree.

- Tags: how-to-guide
- Published: 2026-09-02

### [How Handoff Message Transport Works in Swarm Forge: File-Based Role-to-Role Communication](/unclebob/swarm-forge/swarmforge-handoff-message-transport)

Discover how Swarm Forge uses file-based handoff message transport for seamless role-to-role communication. Learn about message exchange and daemon processing.

- Tags: internals
- Published: 2026-09-02

### [Pack vs Forge in SwarmForge: What's the Difference?](/unclebob/swarm-forge/swarmforge-pack-vs-forge)

Understand the key differences between Packs and Forges in SwarmForge. Learn how Packs manage single AI projects and Forges host multiple projects with a shared dashboard.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Configure SwarmForge: A Step-by-Step Guide to Role Hierarchies and Trust Settings](/unclebob/swarm-forge/how-to-configure-swarmforge)

Configure SwarmForge with this step-by-step guide. Learn to set up role hierarchies and trust settings by editing configuration files for seamless agent operation.

- Tags: how-to-guide
- Published: 2026-09-02

### [What Is the Purpose of the SwarmForge Constitution System? A Complete Guide](/unclebob/swarm-forge/swarmforge-constitution-system-purpose)

Understand the SwarmForge constitution system, the core rules guiding AI agent operation, collaboration, and decision-making in autonomous swarms. Learn how it ensures efficient teamwork.

- Tags: getting-started
- Published: 2026-09-02

### [How Agent Prompts Are Defined in Swarm Forge: The .prompt File System Explained](/unclebob/swarm-forge/how-are-agent-prompts-defined-in-swarmforge)

Learn how agent prompts are defined in SwarmForge using plain-text .prompt files. Understand the .prompt file system and how it works with the core swarmforge.bb script.

- Tags: deep-dive
- Published: 2026-09-02

### [SwarmForge Agent Roles Explained: The 7 Roles That Drive AI-Assisted Software Development](/unclebob/swarm-forge/swarmforge-agent-roles)

Discover the 7 SwarmForge agent roles: Specifier, Coder, Cleaner, Architect, Hardender, QA, and Lieutenant. Learn how these AI agents transform user stories into tested production code.

- Tags: deep-dive
- Published: 2026-09-02

### [How the SwarmForge Handoff Protocol Works: A Complete Technical Guide](/unclebob/swarm-forge/swarmforge-handoff-protocol-explained)

Master the SwarmForge handoff protocol with this technical guide. Understand how agents exchange work items via a daemon-backed file transport system for durable, auditable queues.

- Tags: deep-dive
- Published: 2026-09-02

### [How SwarmForge Uses tmux: Session Management, Transcript Capture, and Role Isolation](/unclebob/swarm-forge/role-of-tmux-in-swarmforge)

Discover how SwarmForge leverages tmux for isolated sessions, transcript capture, and role management. Optimize your swarm operations with powerful terminal orchestration.

- Tags: how-to-guide
- Published: 2026-09-02

### [How SwarmForge Orchestrates AI Agents: A Deep Dive into Declarative Agent Coordination](/unclebob/swarm-forge/how-swarmforge-orchestrates-ai-agents)

Learn how SwarmForge orchestrates AI agents using declarative configurations to manage tmux sessions, git work-trees, and shell commands for tools like Claude, Codex, and Grok.

- Tags: deep-dive
- Published: 2026-09-02

### [SwarmForge Prerequisites: What You Need to Run the tmux-Based AI Orchestration Platform](/unclebob/swarm-forge/swarmforge-prerequisites)

Discover SwarmForge prerequisites. Learn what you need to run this AI orchestration platform including zsh git tmux Babashka and an AI agent backend.

- Tags: getting-started
- Published: 2026-09-02

### [How to Install SwarmForge: Complete Setup Guide for AI‑Agent Orchestration](/unclebob/swarm-forge/how-to-install-swarmforge)

Install SwarmForge with our complete setup guide. Learn to install prerequisites, copy the helper script, and launch your AI agent orchestration dashboard quickly and easily.

- Tags: how-to-guide
- Published: 2026-09-02

### [Troubleshooting Invalid Commit Abbreviation Errors in SwarmForge Handoffs: A Complete Fix Guide](/unclebob/swarm-forge/troubleshooting-invalid-commit-abbreviation-errors-in-swarmforge-handoffs)

Fix invalid commit abbreviation errors in SwarmForge handoffs. Learn how to validate format and uniqueness in commit-check and canonical-commit for seamless file transfers.

- Tags: how-to-guide
- Published: 2026-09-01

### [Configuring Sleep Prevention Behavior Across macOS and Linux in SwarmForge](/unclebob/swarm-forge/configuring-sleep-prevention-behavior-across-macos-and-linux-in-swarmforge)

Learn how SwarmForge prevents macOS and Linux hosts from sleeping during swarm activity. Discover the OS-specific sleep inhibitor mechanism.

- Tags: how-to-guide
- Published: 2026-09-01

### [How to Handle Agent Recovery After an Unexpected Restart in SwarmForge](/unclebob/swarm-forge/how-to-handle-agent-recovery-after-an-unexpected-restart-in-swarmforge)

Learn how SwarmForge handles agent recovery after unexpected restarts. Discover the automated ready_for_next.sh script that resumes work or fetches new tasks securely.

- Tags: how-to-guide
- Published: 2026-09-01

### [How to Implement Merge-Only Copies Without Moving the Card in SwarmForge](/unclebob/swarm-forge/implementing-merge-only-copies-without-moving-the-card-in-swarmforge)

Learn to implement merge only copies in SwarmForge without moving cards. Keep your original card position while merging and processing branches efficiently.

- Tags: how-to-guide
- Published: 2026-09-01

### [How SwarmForge Terminal Auto-Detection Works and How to Override It Manually](/unclebob/swarm-forge/how-does-terminal-auto-detection-work-in-swarmforge-and-what-are-the-manual-override-options)

Discover how SwarmForge terminal auto-detection works using its priority flow and learn to manually override it with the SWARMFORGE_TERMINAL environment variable.

- Tags: internals
- Published: 2026-09-01

### [SwarmForge Performance Considerations for Large Numbers of Concurrent Projects](/unclebob/swarm-forge/performance-considerations-for-large-numbers-of-concurrent-projects-in-swarmforge)

Optimize SwarmForge performance for many concurrent projects. Understand limits of git worktrees, tmux sessions, file descriptors, pty, and memory.

- Tags: performance
- Published: 2026-09-01

### [SwarmForge Handoff File Lifecycle and Audit Trail Headers: Complete Technical Guide](/unclebob/swarm-forge/understanding-the-swarmforge-handoff-file-lifecycle-and-audit-trail-headers)

Master the SwarmForge handoff file lifecycle and audit trail headers. Learn how immutable .handoff files ensure complete auditability and eliminate traditional logbooks in this technical guide.

- Tags: deep-dive
- Published: 2026-09-01

### [How to Extend the Six‑Pack Workflow with Additional Roles in SwarmForge](/unclebob/swarm-forge/how-to-extend-the-six-pack-workflow-with-additional-roles-in-swarmforge)

Extend SwarmForge's Six-Pack workflow with custom roles. Learn to create role prompts, update constitutions, add handoff templates, and modify pack scripts for enhanced team collaboration.

- Tags: how-to-guide
- Published: 2026-09-01

### [Troubleshooting Agent Wake-Up Notifications Not Reaching tmux in SwarmForge](/unclebob/swarm-forge/troubleshooting-agent-wake-up-notifications-not-reaching-tmux-in-swarmforge)

Troubleshoot agent wake-up notifications not reaching tmux in SwarmForge. Fix socket path mismatches, session names, and handoff daemon issues for reliable alerts.

- Tags: how-to-guide
- Published: 2026-09-01

### [How Constitution Articles Layer with Pack-Specific Prompts in Swarm Forge](/unclebob/swarm-forge/how-do-constitution-articles-layer-with-pack-specific-prompts-in-swarmforge)

Discover how Swarm Forge's Constitution articles layer with pack-specific prompts. Learn about global baseline policies and specialized overrides for advanced control.

- Tags: deep-dive
- Published: 2026-09-01

### [How to Configure Lieutenant Backend and Override Options in SwarmForge](/unclebob/swarm-forge/how-to-configure-lieutenant-backend-and-override-options-in-swarmforge)

Learn to configure SwarmForge Lieutenant backend and override options. Master SwarmForge settings via config files or environment variables for efficient AI management.

- Tags: how-to-guide
- Published: 2026-09-01

### [Debugging tmux Session Isolation in Multi-Project SwarmForge Swarms: Complete Troubleshooting Guide](/unclebob/swarm-forge/debugging-tmux-session-isolation-in-multi-project-swarmforge-swarms)

Troubleshoot tmux session isolation issues in multi-project SwarmForge swarms. Learn how SwarmForge uses project-local tmux sockets to prevent interference and ensure smooth operation.

- Tags: tutorial
- Published: 2026-09-01

### [How to Implement the Handoff Protocol Using `swarmhandoff.sh` in Swarm-Forge](/unclebob/swarm-forge/how-to-implement-the-handoff-protocol-using-swarm_handoff.sh)

Easily implement the handoff protocol with swarmhandoff.sh. Parse, validate, and queue .handoff files for delivery to recipient roles directly from your worktree.

- Tags: how-to-guide
- Published: 2026-09-01

### [How Swarm Forge Creates and Manages Git Worktrees in the `.worktrees/` Directory](/unclebob/swarm-forge/how-are-worktrees-created-and-managed-under-the-.worktrees-directory-in-swarmforge)

Discover how Swarm Forge manages Git worktrees in .worktrees/. Learn about isolated worktrees for agent roles and special master role handling.

- Tags: how-to-guide
- Published: 2026-09-01

### [How to Troubleshoot SwarmForge Dashboard Connection Issues: A Complete Guide](/unclebob/swarm-forge/troubleshooting-swarmforge-dashboard-connection-issues)

Resolve SwarmForge dashboard connection issues by verifying the dashboard-url file, checking port 64002 for conflicts, and clearing stale state. Your complete troubleshooting guide.

- Tags: how-to-guide
- Published: 2026-09-01

### [What Is the Two‑Call Audit Gate in Git Handoffs?](/unclebob/swarm-forge/what-is-the-two-call-audit-gate-in-git-handoffs)

Understand the two-call audit gate in Git handoffs. This security pattern ensures code approval before reaching the target repository, separating submission from execution.

- Tags: best-practices
- Published: 2026-09-01

### [How to Configure Agent Backends per Role in swarmforge.conf](/unclebob/swarm-forge/how-to-configure-agent-backends-per-role-in-swarmforge.conf)

Configure agent backends per role in swarmforge.conf. Map roles to specific backend commands using the format <RoleName> <backend> [flags] for customized swarm-forge deployments.

- Tags: how-to-guide
- Published: 2026-09-01

### [How SwarmForge's Handoff Daemon (handoffd) Manages Inter-Agent Communication](/unclebob/swarm-forge/how-swarmforges-handoff-daemon-handoffd-manages-inter-agent-communication)

Discover how SwarmForge's Handoff Daemon handoffd manages inter-agent communication using a file-based message broker for efficient routing and real-time alerting.

- Tags: internals
- Published: 2026-09-01

### [How Local Prompt Naming Conventions Specialize Constitution Articles in Swarm-Forge](/unclebob/swarm-forge/how-do-local-prompt-naming-conventions-specialize-constitution-articles)

Learn how Swarm-Forge uses local prompt naming conventions to specialize constitution articles by merging pack-specific rules without altering upstream files.

- Tags: deep-dive
- Published: 2026-08-31

### [What Is the Terminal Watchdog in SwarmForge and How Does It Manage Window State?](/unclebob/swarm-forge/what-is-the-function-of-the-terminal-watchdog-in-swarmforge)

Discover the terminal watchdog in SwarmForge. Learn how this background process manages tmux sessions and window states, ensuring your environment stays active or shuts down gracefully.

- Tags: internals
- Published: 2026-08-31

### [How SwarmForge Ensures Codex Trust for Worktree Directories](/unclebob/swarm-forge/how-does-swarmforge-ensure-codex-trust-for-worktree-directories)

Learn how SwarmForge ensures codex trust for worktree directories by automatically configuring Codex, preventing prompts and enabling seamless automated workflows.

- Tags: how-to-guide
- Published: 2026-08-31

### [How SwarmForge Enforces Role Bylines in Commits: Inside commit_msg_hook.bb](/unclebob/swarm-forge/how-does-the-commit_msg_hook-bb-enforce-role-bylines-in-commits)

Learn how SwarmForge's commit_msg_hook.bb automatically adds role bylines to commits. Discover how it ensures consistent attribution using environment variables or roles.tsv for your repository.

- Tags: internals
- Published: 2026-08-31

### [How SwarmForge Extracts Status Information from Agent Output: Pane Parsing Logic Explained](/unclebob/swarm-forge/how-does-swarmforge-extract-status-information-from-agent-output)

Learn how SwarmForge extracts status information from agent output by parsing pane files backward. Discover the logic behind filtering and displaying the last valid status.

- Tags: internals
- Published: 2026-08-31

### [How Does Batch Receive Mode in SwarmForge Process Multiple Queued Handoffs?](/unclebob/swarm-forge/how-does-batch-receive-mode-in-swarmforge-process-multiple-queued-handoffs)

Learn how SwarmForge batch receive mode processes queued handoffs. It aggregates, merges payloads, and processes them as a single task for atomic receiving.

- Tags: how-to-guide
- Published: 2026-08-31

### [How SwarmForge Prevents System Sleep During Active Tasks: Sleep Inhibitor Deep Dive](/unclebob/swarm-forge/how-does-swarmforges-sleep-inhibitor-prevent-system-sleep-during-active-tasks)

Discover how SwarmForge prevents system sleep with its sleep inhibitor, keeping your system awake during active tasks on macOS and Linux. Learn more!

- Tags: deep-dive
- Published: 2026-08-31

### [How get-swarm-forge Composes a Forge from Multiple Git Branches](/unclebob/swarm-forge/how-does-get-swarm-forge-composite-a-forge-from-multiple-git-branches)

Discover how get-swarm-forge composes a SwarmForge from multiple Git branches by merging core components and pack branches into a unified environment. Learn the process now.

- Tags: how-to-guide
- Published: 2026-08-31

### [Window vs Window-Invisible Directives in SwarmForge: Visibility Control Explained](/unclebob/swarm-forge/what-is-the-difference-between-window-invisible-and-window-directives-in-swarmforge)

Understand SwarmForge window vs window-invisible directives. Learn how to control agent visibility for silent or visible terminal execution. Maximize your workflow efficiency.

- Tags: deep-dive
- Published: 2026-08-31

### [How SwarmForge Adapts to Different Terminal Backends: The Adapter Pattern Explained](/unclebob/swarm-forge/how-does-swarmforge-adapt-to-different-terminal-backends)

Discover how SwarmForge uses the Adapter pattern to adapt to various terminal backends. Learn about its modular shell script approach for flexible session management and window tracking.

- Tags: deep-dive
- Published: 2026-08-31

### [How SwarmForge Agents Use ready_for_next.sh and done_with_current.sh to Coordinate Work Cycles](/unclebob/swarm-forge/how-do-swarmforge-agents-use-ready_for_next-sh-and-done_with_current-sh)

Discover how SwarmForge agents use ready_for_next.sh and done_with_current.sh to coordinate work cycles. Learn how these scripts signal readiness and completion to the hand-off daemon for efficient task management.

- Tags: how-to-guide
- Published: 2026-08-31

### [How the forge.bb Module Manages Multiple Project Instantiation in SwarmForge](/unclebob/swarm-forge/how-does-the-forge-bb-module-manage-the-instantiation-of-multiple-projects)

Learn how the forge.bb module manages multiple project instantiation in SwarmForge. Discover its stateless registry and deterministic functions for unlimited concurrent projects.

- Tags: internals
- Published: 2026-08-31

### [How the pack_board.bb Module Manages Tasks in SwarmForge](/unclebob/swarm-forge/how-does-the-pack_board-bb-module-manage-tasks-within-swarmforge)

Discover how the pack_board.bb module manages SwarmForge tasks using a single TSV file and file-based locking for reliable data persistence and exclusive access.

- Tags: internals
- Published: 2026-08-31

### [How SwarmForge.bb Handles the Initial Startup Sequence: Complete Pipeline Breakdown](/unclebob/swarm-forge/how-does-swarmforge-bb-handle-the-initial-startup-sequence)

Discover how SwarmForge.bb executes its 21-step startup pipeline, from dependency validation and Git initialization to tmux sessions and AI agent launches via Clojure.

- Tags: internals
- Published: 2026-08-31

### [What Is the Function of the Lieutenant in the SwarmForge Architecture?](/unclebob/swarm-forge/what-is-the-function-of-the-lieutenant-in-the-swarmforge-architecture)

Discover the lieutenant's role in SwarmForge architecture. Learn how this host-level orchestrator manages dashboards, chat, and swarm state for efficient development workflows.

- Tags: architecture
- Published: 2026-08-31

### [How the Pack Cockpit Dashboard Functions in SwarmForge: Architecture and Implementation](/unclebob/swarm-forge/how-does-the-pack-cockpit-dashboard-function-in-swarmforge)

Explore the Pack Cockpit Dashboard in SwarmForge. Learn how this local web interface monitors project state and agent activities via a Clojure HTTP server.

- Tags: architecture
- Published: 2026-08-31

### [What Is the Two-Call Audit Gate in SwarmForge?](/unclebob/swarm-forge/what-is-the-purpose-of-the-two-call-audit-gate-in-swarmforge)

Understand the two-call audit gate in SwarmForge. Discover how this verification process prevents incomplete commits by requiring dual submission and confirmation for every git handoff.

- Tags: deep-dive
- Published: 2026-08-31

### [How SwarmForge Uses the Layered Constitution System to Direct Agent Behavior](/unclebob/swarm-forge/how-does-swarmforge-use-the-layered-constitution-system-to-direct-agent-behavior)

SwarmForge directs AI agents with a layered constitution system. It combines baseline rules with pack-specific overrides for a single source of truth and localized customization.

- Tags: deep-dive
- Published: 2026-08-31

### [How the SwarmForge Handoff Daemon Delivers Messages Between Agents](/unclebob/swarm-forge/how-does-the-handoff-daemon-deliver-messages-between-agents-in-swarmforge)

Discover how the SwarmForge handoff daemon uses file polling and tmux to deliver messages between agents. Learn about efficient agent communication in this technical guide.

- Tags: internals
- Published: 2026-08-31

### [Understanding the Handoff Daemon (handoffd.bb) in SwarmForge](/unclebob/swarm-forge/what-is-the-role-of-the-handoff-daemon-in-swarmforge)

Discover the SwarmForge handoff daemon (handoffd.bb). Learn how it monitors outboxes, routes messages, manages approvals, and syncs task boards for distributed work-trees.

- Tags: internals
- Published: 2026-08-31

### [How Git Worktrees Enable Agent Isolation in SwarmForge](/unclebob/swarm-forge/how-are-git-worktrees-utilized-in-swarmforge-for-agent-isolation)

Discover how SwarmForge uses Git worktrees for agent isolation. Each role gets a separate working directory sharing Git history, preventing conflicts and maintaining a single source of truth.

- Tags: how-to-guide
- Published: 2026-08-31

### [How SwarmForge Manages Local tmux Sessions for Project Isolation](/unclebob/swarm-forge/how-does-swarmforge-manage-local-tmux-sessions-for-project-isolation)

Learn how SwarmForge isolates local tmux sessions using unique Unix sockets. Discover its project isolation techniques for efficient development workflows.

- Tags: how-to-guide
- Published: 2026-08-31

### [What Are the Core Components of the SwarmForge Architecture?](/unclebob/swarm-forge/what-are-the-core-components-of-the-swarmforge-architecture)

Explore the SwarmForge architecture and discover its four essential components: Core Engine, Handoff Daemon, Role Prompts, and Terminal Adapters. Understand how they work together.

- Tags: architecture
- Published: 2026-08-31

### [How SwarmForge Orchestrates AI Agents for Software Engineering Tasks](/unclebob/swarm-forge/how-does-swarmforge-orchestrate-ai-agents-for-software-engineering-tasks)

Discover how SwarmForge orchestrates AI agents using role isolation and git worktrees for collaborative software engineering. Streamline your development workflow.

- Tags: how-to-guide
- Published: 2026-08-31

### [How SwarmForge Handles tmux Copy Mode Interference with Visible Windows](/unclebob/swarm-forge/how-swarmforge-handle-tmux-copy-mode-interference-visible-windows)

Discover how SwarmForge prevents tmux copy mode interference. Learn about its detect-and-recover strategy and watchdog process for seamless visible window management.

- Tags: how-to-guide
- Published: 2026-08-30

### [How the Swarm-Forge Dashboard Handles MAIL_WAITING vs NO_TASK Output](/unclebob/swarm-forge/how-dashboard-handle-mail_waiting-vs-no_task-output)

Understand how the Swarm-Forge dashboard differentiates MAIL_WAITING from NO_TASK by examining ready_for_next_task.sh. Learn about the UI changes for each status.

- Tags: internals
- Published: 2026-08-30

### [How Commit Validation in `swarm_handoff.sh` Ensures Unique Commit Abbreviations](/unclebob/swarm-forge/how-commit-validation-swarm_handoff.sh-ensure-unique-commit-abbreviations)

Learn how swarm_handoff.sh validates commit abbreviations using Git rev-parse and merge-base to guarantee unique short SHAs, ensuring clear commit references.

- Tags: how-to-guide
- Published: 2026-08-30

### [How `merge_and_process.sh` and `swarm_handoff.sh` Interact During a Swarm Handoff](/unclebob/swarm-forge/interaction-merge_and_process.sh-swarm_handoff.sh-handoff-lifecycle)

Understand how merge_and_process.sh and swarm_handoff.sh interact during a swarm handoff. Learn how they merge configurations and signal completion for the daemon.

- Tags: internals
- Published: 2026-08-30

### [How the Lieutenant Communicates with the Pack Cockpit Dashboard in SwarmForge](/unclebob/swarm-forge/how-lieutenant-communicate-pack-cockpit-dashboard)

Discover how the Lieutenant communicates with the SwarmForge pack cockpit dashboard using the pack_dashboard_request.sh script and Babashka for seamless request management.

- Tags: how-to-guide
- Published: 2026-08-30

### [How the Board Card's Audit Counter Persists Through Lane Changes and Approvals](/unclebob/swarm-forge/how-board-cards-audit-counter-persist-lane-changes-approvals)

Learn how the board card audit counter persists through lane changes and approvals. Discover its immutable data map, atomic increment, and serialization process in Swarm Forge.

- Tags: internals
- Published: 2026-08-30

### [How the Watchdog Reopens a Closed Tracked Window Without Losing State in Swarm-Forge](/unclebob/swarm-forge/how-watchdog-reopen-closed-tracked-window-without-losing-state)

Discover how Swarm-Forge's watchdog reopens closed windows, preserving state by serializing and recreating UI snapshots from JSON.

- Tags: internals
- Published: 2026-08-30

### [How Constitution Layering Works with Prompt Files in Swarm Forge](/unclebob/swarm-forge/how-constitution-layering-work-prompt-files)

Learn how constitution layering in Swarm Forge works with prompt files. Stack shared articles, project overrides, and role instructions for a unified agent context.

- Tags: how-to-guide
- Published: 2026-08-30

### [How `ready_for_next.sh` Dispatches to Task vs Batch Helpers in Swarm-Forge](/unclebob/swarm-forge/how-ready_for_next.sh-dispatch-task-vs-batch-helpers)

Discover how ready_for_next.sh dispatches to task or batch helpers in Swarm-Forge by inspecting the role's receive mode for efficient processing.

- Tags: internals
- Published: 2026-08-30

### [How the Swarm-Forge Two-Call Audit Gate Invalidates and Resets on Changes](/unclebob/swarm-forge/how-two-call-audit-gate-invalidate-reset-changes)

Discover how the Swarm-Forge two-call audit gate invalidates pending audits on handoff changes by deleting mismatched files. Learn how it resets for a fresh audit.

- Tags: internals
- Published: 2026-08-30

### [SwarmForge Sleep Inhibitor: How It Works on macOS vs Linux and How to Disable It](/unclebob/swarm-forge/how-sleep-inhibitor-work-macos-vs-linux-disable)

Learn how the SwarmForge sleep inhibitor works on macOS and Linux, discover its OS-specific commands, and easily disable it by setting SWARMFORGE_PREVENT_SLEEP=0.

- Tags: how-to-guide
- Published: 2026-08-30

### [Swarm-Forge Terminal Backend Adapter Contract: How to Add New Terminal Support](/unclebob/swarm-forge/what-is-terminal-backend-adapter-contract-add-new-terminal-support)

Learn the Swarm-Forge terminal backend adapter contract and easily add new terminal support. Implement the six-function shell interface for seamless session management and lifecycle queries.

- Tags: how-to-guide
- Published: 2026-08-30

### [How `window-invisible` vs `window` Lines in `swarmforge.conf` Control the Terminal Surface](/unclebob/swarm-forge/how-window-invisible-vs-window-lines-swarmforge.conf-control-terminal-surface)

Learn how window-invisible vs window lines in swarmforge.conf control your terminal surface. Run agents invisibly or create visible, tracked terminal sessions with ease.

- Tags: deep-dive
- Published: 2026-08-30

### [How SwarmForge Honors tmux base-index and pane-base-index Settings](/unclebob/swarm-forge/how-swarmforge-honor-tmux-base-index-pane-base-index-settings)

SwarmForge respects your tmux base-index and pane-base-index settings. Discover how it dynamically adjusts window and pane targeting to match your custom configurations for seamless integration.

- Tags: internals
- Published: 2026-08-30

### [How `get-swarm-forge` Composes Shared Articles with Local Overrides in Swarm Forge](/unclebob/swarm-forge/how-get-swarm-forge-compose-shared-articles-local-overrides)

Learn how get-swarm-forge composes shared articles with local overrides in Swarm Forge. Discover the article composition process and local file merging.

- Tags: how-to-guide
- Published: 2026-08-30

### [Swarm-Forge Handoffs Directory Layout and Agent Inbox State Management Explained](/unclebob/swarm-forge/directory-layout-swarmforge-handoffs-agent-interaction-inbox-state)

Understand the Swarm-Forge handoffs directory layout and agent inbox state management. Learn how agents atomically track work item lifecycles using .swarmforge/handoffs/ and handoff_lib.bb commands.

- Tags: internals
- Published: 2026-08-30

### [How the Pack Cockpit Persists Lieutenant Chat and Injects Responses in SwarmForge](/unclebob/swarm-forge/how-pack-cockpit-persist-lieutenant-chat-inject-responses)

Discover how the Pack Cockpit persists lieutenant chat and injects responses in SwarmForge. Learn about the text file persistence and pane-status-lines-for function.

- Tags: internals
- Published: 2026-08-30

### [How Back‑One and Back‑All Propagation Tokens Work Without Moving Task Cards in Swarm Forge](/unclebob/swarm-forge/how-do-back-one-back-all-propagation-tokens-work-without-moving-task-cards)

Learn how back-one and back-all propagation tokens work in Swarm Forge without moving task cards. Discover the mechanism behind non-forwarding copies and their impact on UI.

- Tags: internals
- Published: 2026-08-30

### [Terminal Broadcast vs Git Handoff: How Swarm-Forge Handles Workflow Completion](/unclebob/swarm-forge/how-terminal-broadcast-distinguish-normal-git-handoffs)

Discover how Swarm-Forge's terminal broadcast differs from standard git handoffs. Learn how this unique method signals recipients to merge and stop.

- Tags: comparison
- Published: 2026-08-30

### [Chain Forwarding Rule in Swarm‑Forge: Why Intermediate Roles Must Forward Git Handoffs](/unclebob/swarm-forge/what-is-chain-forwarding-rule-why-intermediate-roles-forward-git-handoffs)

Understand the Swarm-Forge chain forwarding rule. Learn why intermediate roles must forward git handoffs for deterministic pipeline progression. Ensure your Git workflows are seamless.

- Tags: deep-dive
- Published: 2026-08-30

### [How SwarmForge Isolates tmux Sessions Using Custom Socket Paths](/unclebob/swarm-forge/how-swarmforge-isolate-tmux-sessions-custom-socket-paths)

Learn how SwarmForge isolates tmux sessions with custom socket paths, ensuring complete separation for every run. Discover the `-S <socket-path>` flag in action.

- Tags: internals
- Published: 2026-08-30

### [Batch vs Task Receive Mode in Swarm‑Forge Handoff Processing](/unclebob/swarm-forge/difference-between-batch-receive-mode-task-mode-handoff-processing)

Understand the Swarm-Forge handoff processing difference: batch vs task receive modes. Learn how to process handoffs atomically or individually for efficient workflow management.

- Tags: deep-dive
- Published: 2026-08-30

### [How handoffd.bb Serializes tmux Access and Avoids Race Conditions in Swarm-Forge](/unclebob/swarm-forge/how-does-handoffd.bb-serialize-tmux-access-avoid-race-conditions)

Learn how handoffd.bb serializes tmux access and prevents race conditions with single-process ownership, sequential processing, and atomic file moves in Swarm-Forge.

- Tags: internals
- Published: 2026-08-30

### [How `swarm_handoff.sh` Audit Gate Enforces Two-Call Verification for Git Handoffs](/unclebob/swarm-forge/how-does-swarm_handoff.sh-audit-gate-enforce-two-call-verification-git-handoffs)

Learn how swarm_handoff.sh audit gate enforces two-call verification for Git handoffs by requiring a signed audit file before proceeding. Secure your code reviews.

- Tags: how-to-guide
- Published: 2026-08-30

### [How to Override the Default Terminal Backend in SwarmForge](/unclebob/swarm-forge/how-to-override-the-default-terminal-backend-in-swarmforge)

Learn how to override the default terminal backend in SwarmForge by setting the SWARMFORGE_TERMINAL environment variable. Force your preferred terminal emulator for seamless workflows.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Add a Custom Terminal Backend to SwarmForge: A Complete Guide](/unclebob/swarm-forge/how-to-add-a-custom-terminal-backend-to-swarmforge)

Learn how to add a custom terminal backend to SwarmForge. Follow this complete guide to implement init_terminal and run_command functions for your new adapter.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Stop a SwarmForge Swarm: Complete Shutdown Guide](/unclebob/swarm-forge/how-to-stop-a-swarmforge-swarm)

Effectively stop a SwarmForge swarm by running the close-swarm script. This guide details the shutdown process and ensures proper cleanup of your sessions.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Approve a Handoff in the SwarmForge Dashboard: A Complete Guide](/unclebob/swarm-forge/how-to-approve-a-handoff-in-the-swarmforge-dashboard)

Learn how to approve a handoff in the SwarmForge dashboard using our complete guide. Approve easily via the UI or programmatically with the API.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Start a New Task in the Swarm Forge Dashboard: A Step-by-Step Guide](/unclebob/swarm-forge/how-to-start-a-new-task-in-the-swarmforge-dashboard)

Learn how to start a new task in the Swarm Forge dashboard. Follow our easy step-by-step guide to create and manage your tasks efficiently.

- Tags: how-to-guide
- Published: 2026-08-29

### [SwarmForge Dashboard Components: A Complete UI Architecture Guide](/unclebob/swarm-forge/what-are-the-components-of-the-swarmforge-dashboard)

Explore the eight essential SwarmForge dashboard components including header, error bar, attention area, main board, queues, chat, and modal dialogs. Understand the UI architecture.

- Tags: architecture
- Published: 2026-08-29

### [How to Use the `done_with_current.sh` Helper Script in Swarm‑Forge](/unclebob/swarm-forge/how-to-use-the-done-with-current-sh-helper-script)

Learn to use the done_with_current.sh script in Swarm-Forge to signal task completion and trigger the hand-off daemon. Streamline your workflow now.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Use the ready_for_next.sh Helper Script in Swarm-Forge](/unclebob/swarm-forge/how-to-use-the-ready-for-next-sh-helper-script)

Learn to use the ready_for_next.sh script in Swarm-Forge. This Zsh wrapper with Babashka prepares your Swarm-Forge queue for the next task efficiently.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Use the `swarm_handoff.sh` Helper Script in Swarm-Forge](/unclebob/swarm-forge/how-to-use-the-swarm-handoff-sh-helper-script)

Learn to use the swarm_handoff.sh script from unclebob/swarm-forge. Validate draft handoff files and convert them into machine-ready payloads for Swarm-Forge roles.

- Tags: how-to-guide
- Published: 2026-08-29

### [What Is the Audit Gate in SwarmForge and How Does It Work?](/unclebob/swarm-forge/what-is-the-audit-gate-in-swarmforge)

Discover SwarmForge's Audit Gate, a mandatory two-step quality checkpoint. Learn how this essential feature verifies Git handoffs, ensuring code integrity before deployment.

- Tags: deep-dive
- Published: 2026-08-29

### [SwarmForge Handoff Directory Layout: A Deep Dive into the File-Based Queue System](/unclebob/swarm-forge/how-is-the-directory-layout-structured-for-handoffs-in-swarmforge)

Explore the SwarmForge handoff directory layout at .swarmforge/handoffs/. Understand how outbound, inbound, and audit folders manage your file-based queue system for efficient message handling.

- Tags: deep-dive
- Published: 2026-08-29

### [SwarmForge Handoff Protocol Message Types: `git_handoff` and `note` Explained](/unclebob/swarm-forge/what-are-the-message-types-in-swarmforge-handoff-protocol)

Understand SwarmForge's git_handoff and note message types. Learn how agents exchange work in this handoff protocol.

- Tags: api-reference
- Published: 2026-08-29

### [How Propagation Tokens Work in SwarmForge: `forward-only`, `back-one`, and `back-all` Explained](/unclebob/swarm-forge/how-do-propagation-tokens-work-in-swarmforge)

Understand SwarmForge propagation tokens like forward-only back-one and back-all. Learn how they control handoffs after role processing for efficient workflow management.

- Tags: deep-dive
- Published: 2026-08-29

### [SwarmForge Receive Modes Explained: Task vs Batch Processing](/unclebob/swarm-forge/what-are-the-receive-modes-in-swarmforge)

Understand SwarmForge receive modes task vs batch. Learn how to process single handoffs or continuously loop for multiple handoffs in your roles.

- Tags: deep-dive
- Published: 2026-08-29

### [How to Configure SwarmForge Using swarmforge.conf: A Complete Guide](/unclebob/swarm-forge/how-to-configure-swarmforge-using-swarmforge-conf)

Learn how to configure SwarmForge using swarmforge.conf. Define agent roles, LLM binaries, and worktrees in this comprehensive guide to setting up your swarm topology.

- Tags: how-to-guide
- Published: 2026-08-29

### [SwarmForge Branch Structures: Two-Pack, Four-Pack, and Six-Pack Explained](/unclebob/swarm-forge/what-are-the-different-branch-structures-in-swarmforge)

Explore SwarmForge branch structures: two-pack, four-pack, and six-pack. Understand these AI-driven workflows with 2, 4, or 6 roles to optimize your development process.

- Tags: deep-dive
- Published: 2026-08-29

### [How SwarmForge Handles Inter-Agent Communication: A File-Based Handoff Protocol Explained](/unclebob/swarm-forge/how-does-swarmforge-handle-inter-agent-communication)

Discover how SwarmForge handles inter-agent communication using a robust file-based handoff protocol for reliable, auditable AI agent swarm collaboration.

- Tags: deep-dive
- Published: 2026-08-29

### [What Is the Handoff Daemon (handoffd) in Swarm‑Forge?](/unclebob/swarm-forge/what-is-the-handoff-daemon-handoffd)

Discover the handoff daemon handoffd in Swarm-Forge. Learn how this background process manages handoff files, synchronizes the Kanban board, and notifies agents of new tasks.

- Tags: internals
- Published: 2026-08-29

### [How to Access the SwarmForge Pack Cockpit Dashboard: Complete Guide](/unclebob/swarm-forge/how-to-access-swarmforge-pack-cockpit-dashboard)

Learn how to access the SwarmForge Pack Cockpit dashboard. Find the URL in .swarmforge/dashboard-url after running ./swarm for easy access.

- Tags: how-to-guide
- Published: 2026-08-29

### [How SwarmForge Uses tmux Sessions for Role Isolation and Orchestration](/unclebob/swarm-forge/how-does-swarmforge-use-tmux-sessions)

Discover how SwarmForge leverages tmux sessions for role isolation and orchestration. Manage commands, ensure cross-platform compatibility, and automate cleanup efficiently.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Define Roles in SwarmForge: A Complete Guide to Role Configuration](/unclebob/swarm-forge/how-to-define-roles-in-swarmforge-conf)

Learn how to define roles in SwarmForge. Configure project roles using prompt files and map them to worktrees for efficient development workflow.

- Tags: how-to-guide
- Published: 2026-08-29

### [What Is a SwarmForge Swarm Topology? A Complete Guide to Configuration-Driven Agent Orchestration](/unclebob/swarm-forge/what-is-a-swarmforge-swarm-topology)

Discover what a SwarmForge swarm topology is. This guide explains configuration-driven agent orchestration and how agents arrange roles and communication without code.

- Tags: deep-dive
- Published: 2026-08-29

### [SwarmForge Handoff Message Types: Supported Formats Explained](/unclebob/swarm-forge/supported-message-types-swarm-forge-handoffs)

Discover SwarmForge handoff message types. Learn about git_handoff for code and note for user messages to streamline your project transitions.

- Tags: api-reference
- Published: 2026-08-28

### [SwarmForge Handoff Directory Structure: A Complete Guide to the Inbox/Outbox Protocol](/unclebob/swarm-forge/directory-structure-swarm-forge-handoffs)

Understand the SwarmForge handoff directory structure in unclebob/swarm-forge. Learn about the inbox/outbox protocol for reliable AI agent work exchanges using .swarmforge/handoffs/.

- Tags: architecture
- Published: 2026-08-28

### [How the `handoffd` Daemon Works in Swarm‑Forge: Architecture and Operation](/unclebob/swarm-forge/how-does-handoff-daemon-handoffd-operate)

Discover how the handoff daemon handoffd operates in Swarm Forge. Learn its architecture, message parsing, delivery, and agent notification for asynchronous work exchange.

- Tags: internals
- Published: 2026-08-28

### [SwarmForge Handoff Protocol: Complete File-Based Communication System for AI Agents](/unclebob/swarm-forge/what-is-swarm-forge-handoff-protocol)

Explore the SwarmForge handoff protocol, a robust file-based system enabling AI agents to share work items seamlessly. Discover its advantages for distributed AI communication.

- Tags: deep-dive
- Published: 2026-08-28

### [How SwarmForge Handles Agent Communication Through Its Layered Constitution System](/unclebob/swarm-forge/how-swarm-forge-handle-agent-communication-layered-constitution)

Discover how SwarmForge's layered constitution system manages agent communication. Explore core rules, behavioral articles, and role configurations for efficient interaction.

- Tags: how-to-guide
- Published: 2026-08-28

### [How the Propagation Token Works in Swarm‑Forge Configuration](/unclebob/swarm-forge/how-propagation-token-works-swarm-forge-configuration)

Discover how the Swarm-Forge propagation token controls handoff card movement between windows. Learn about forward-only, back-one, and back-all options for efficient workflow management.

- Tags: internals
- Published: 2026-08-28

### [SwarmForge Receive Modes Explained: Task vs Batch Processing](/unclebob/swarm-forge/what-are-receive-modes-task-batch-swarm-forge)

Learn SwarmForge receive modes task vs batch processing. Understand how task handles single items and batch processes grouped, priority-matched handoffs efficiently.

- Tags: deep-dive
- Published: 2026-08-28

### [How the `window` Directive Works in SwarmForge Configuration: A Complete Guide](/unclebob/swarm-forge/how-window-directive-works-swarm-forge-configuration)

Learn how the SwarmForge `window` directive creates editable UI regions. This guide explains specifiers, titles, and content for dynamic rendering in your configuration.

- Tags: how-to-guide
- Published: 2026-08-28

### [What Does `window-invisible` Mean in `swarmforge.conf`? Terminal Visibility Explained](/unclebob/swarm-forge/what-do-directives-like-window-invisible-mean-swarmforge-conf)

Understand the window-invisible directive in swarmforge.conf. Learn how to run SwarmForge agents headlessly in tmux for a clean UI. Maximize your terminal visibility.

- Tags: explanation
- Published: 2026-08-28

### [How SwarmForge Swarm Topology Is Configured: A Complete Guide to swarmforge.conf](/unclebob/swarm-forge/how-swarm-forge-swarm-topology-configured)

Configure SwarmForge swarm topology using swarmforge.conf. Define roles, LLM backends, tmux visibility, and git mappings for process materialization. Get the complete guide.

- Tags: how-to-guide
- Published: 2026-08-28

### [SwarmForge Six-Pack Roles: What Two Additional Roles Complete the Workflow?](/unclebob/swarm-forge/additional-roles-swarm-forge-six-pack)

Discover the two extra roles in the SwarmForge six-pack: hardender and QA. Learn how they enhance mutation hardening and ensure final quality assurance for your workflow.

- Tags: deep-dive
- Published: 2026-08-28

### [When to Use the Six-Pack Workflow in SwarmForge: A Complete Guide](/unclebob/swarm-forge/when-to-use-six-pack-workflow-swarm-forge)

Master the SwarmForge six-pack workflow. Learn when to apply its rigorous engineering discipline for projects with complex UI, QA, architecture, or mutation hardening needs.

- Tags: how-to-guide
- Published: 2026-08-28

### [What Is the Architect's Role in the SwarmForge Four-Pack? 5 Responsibilities Explained](/unclebob/swarm-forge/architects-role-swarm-forge-four-pack)

Discover the architect's vital role in the SwarmForge four-pack. Learn how they ensure design integrity, enforce rules, harden code, and signal project completion for unclebob/swarm-forge.

- Tags: architecture
- Published: 2026-08-28

### [How the Refactorer Agent Works in SwarmForge Four‑Pack: Back‑One Propagation Explained](/unclebob/swarm-forge/how-refactorer-agent-works-swarm-forge-four-pack)

Discover how the SwarmForge four-pack refactorer agent works by propagating work backward one hop using the back-one token. Understand its role in coding and architecture.

- Tags: internals
- Published: 2026-08-28

### [What Is the Purpose of the Specifier Agent in SwarmForge Four-Pack?](/unclebob/swarm-forge/purpose-of-specifier-agent-swarm-forge-four-pack)

Discover the specifier agent in SwarmForge four-pack. It translates user intent into Gherkin specs and gates progress with human approval before coding.

- Tags: internals
- Published: 2026-08-28

### [Four-Pack vs Two-Pack Workflow in Swarm-Forge: Key Differences Explained](/unclebob/swarm-forge/how-four-pack-workflow-differs-from-two-pack)

Understand the four-pack vs two-pack workflow in Swarm-Forge. Learn how the 4-agent pipeline enhances code quality with specifier, coder, refactorer, and architect roles.

- Tags: deep-dive
- Published: 2026-08-28

### [What Is the Role of the Coder Agent in SwarmForge Two-Pack Workflows?](/unclebob/swarm-forge/role-of-coder-agent-swarm-forge-two-pack)

Discover the coder agent's role in SwarmForge two-pack workflows. It converts specs to code, saves it, and passes tasks to the next stage, driving efficient development.

- Tags: deep-dive
- Published: 2026-08-28

### [How the Two-Pack Workflow Functions in SwarmForge](/unclebob/swarm-forge/how-does-two-pack-workflow-function-swarm-forge)

Understand SwarmForge's two-pack workflow, its coder and cleaner roles, and how tasks move through this minimal agent pipeline for efficient code management.

- Tags: how-to-guide
- Published: 2026-08-28

### [SwarmForge Pack Workflows Explained: Two-Pack, Four-Pack, Six-Pack, and Simple-Windows](/unclebob/swarm-forge/what-are-swarm-forge-pack-workflows)

Explore SwarmForge pack workflows: two-pack, four-pack, six-pack, and simple-windows. Understand these structured development pipelines for efficient agent configurations.

- Tags: deep-dive
- Published: 2026-08-28

### [How the `get-swarm-forge` Script Works: A Complete Guide to Installing a SwarmForge Forge](/unclebob/swarm-forge/how-does-get-swarm-forge-script-work)

Discover how the get-swarm-forge script works to download the SwarmForge repository, merge configurations, and build a self-contained development environment in your current directory. Get your forge up and running fast.

- Tags: how-to-guide
- Published: 2026-08-28

### [How to Install SwarmForge: Complete Setup Guide for AI Agent Orchestration](/unclebob/swarm-forge/how-to-install-swarm-forge)

Install SwarmForge quickly with our complete setup guide. Follow three simple steps to get your AI agent orchestration running today. Learn how to install SwarmForge now.

- Tags: getting-started
- Published: 2026-08-28

### [SwarmForge Babashka Orchestration Script: The Complete Guide to swarmforge.bb](/unclebob/swarm-forge/what-is-the-main-babashka-orchestration-script-for-swarmforge)

Discover swarmforge.bb, the core Babashka orchestration script for Uncle Bob's SwarmForge. Learn how it manages CLI args, dependencies, workspaces, tmux, and LLM agents for seamless agent orchestration.

- Tags: how-to-guide
- Published: 2026-08-11

### [SwarmForge Configuration File Location: Where swarmforge.conf Lives and How to Edit It](/unclebob/swarm-forge/where-is-the-swarmforge-configuration-file-located)

Find and edit your SwarmForge configuration file. Learn the swarmforge.conf location within the repository and how local copies are discovered.

- Tags: how-to-guide
- Published: 2026-08-11

### [How SwarmForge Prevents Agents from Interfering with Each Other's tmux Sessions](/unclebob/swarm-forge/how-does-swarmforge-prevent-agents-from-interfering-with-each-others-tmux-sessions)

Discover how SwarmForge prevents agent conflicts by isolating each agent in its own tmux session, ensuring seamless parallel execution and preventing interference with dedicated session management.

- Tags: internals
- Published: 2026-08-11

### [SwarmForge Handoff File Format: Complete Guide to Headers, Structure, and Naming](/unclebob/swarm-forge/what-is-the-format-of-a-swarmforge-handoff-file)

Understand the SwarmForge handoff file format. Learn about headers, structure, and naming conventions for plain-text files in .swarmforge/handoffs/ to manage priority, timestamp, and routing metadata.

- Tags: api-reference
- Published: 2026-08-11

### [SwarmForge Handoff Protocol Message Types: A Complete Reference](/unclebob/swarm-forge/what-are-the-message-types-defined-in-the-swarmforge-handoff-protocol)

Explore SwarmForge handoff protocol message types including handshake task task-ack result error ready shutdown and heartbeat for JSON communication between daemon and agents.

- Tags: api-reference
- Published: 2026-08-11

### [SwarmForge Predefined Workflow Configurations: Two-Pack, Four-Pack, and Six-Pack Explained](/unclebob/swarm-forge/what-are-the-predefined-workflow-configurations-in-swarmforge)

Explore SwarmForge predefined workflow configurations like Two-Pack, Four-Pack, and Six-Pack. Discover how each offers advanced agent roles and quality gates on dedicated Git branches for efficient CI/CD.

- Tags: deep-dive
- Published: 2026-08-11

### [How `swarm_handoff.sh` Validates Hand‑off Draft Files: A Deep Dive into SwarmForge's 7-Step Pipeline](/unclebob/swarm-forge/what-is-the-validation-logic-in-swarm-handoff-sh-for-handoff-drafts)

Uncover the validation logic in swarm_handoff.sh for handoff drafts. Discover SwarmForge's 7-step pipeline checking syntax, semantics, type compatibility, and Git integrity.

- Tags: deep-dive
- Published: 2026-08-10

### [How to Override Automatic Terminal Detection Using SWARMFORGE_TERMINAL Environment Variable](/unclebob/swarm-forge/how-to-override-automatic-terminal-detection-with-swarmforge_terminal)

Override Swarm-Forge terminal detection with SWARMFORGE_TERMINAL. Set this environment variable before running swarm to control terminal backend selection.

- Tags: how-to-guide
- Published: 2026-08-10

### [Swarm-Forge Agent Wake-Up Notification Behavior When Already Working](/unclebob/swarm-forge/what-happens-when-a-swarmforge-agent-receives-a-wake-up-notification-while-working)

Discover what happens when a Swarm-Forge agent gets a wake-up notification while already working. Learn how the agent prioritizes tasks and completes its current job.

- Tags: internals
- Published: 2026-08-10

### [How the Swarm-Forge `ready_for_next.sh` Script Dispatches Between Task and Batch Modes](/unclebob/swarm-forge/how-does-ready-for-next-sh-script-dispatch-between-task-and-batch-modes)

Learn how the Swarm-Forge ready_for_next.sh script dispatches between task and batch modes by checking the SWARMFORGE_ROLE environment variable. Understand its delegation logic for efficient workflow management.

- Tags: how-to-guide
- Published: 2026-08-10

### [Why SwarmForge Agents Use Helper Scripts Instead of Direct tmux Commands](/unclebob/swarm-forge/why-do-swarmforge-agents-use-helper-scripts-instead-of-direct-tmux-commands)

Discover why SwarmForge agents use helper scripts over direct tmux commands for consistent environments, cross-platform compatibility, safe arguments, testing, and error handling.

- Tags: internals
- Published: 2026-08-10

### [How SwarmForge Manages Git Worktrees Under the `.worktrees/` Directory](/unclebob/swarm-forge/how-does-swarmforge-manage-git-worktrees)

Learn how SwarmForge manages Git worktrees in .worktrees/ using swarmforge.bb for automated creation, registration, and synchronization. Keep worktrees out of version control.

- Tags: internals
- Published: 2026-08-10

### [Understanding project.prompt and local-*.prompt Files in Swarm-Forge's Constitution](/unclebob/swarm-forge/what-is-the-role-of-project-prompt-and-local-prompt-files)

Learn how project.prompt and local-*.prompt files define Swarm-Forge AI agent behavior. Understand mission constraints and environment specifics within the constitution hierarchy.

- Tags: internals
- Published: 2026-08-10

### [What Terminal Adapters Does Swarm-Forge Support? (Ghostty, iTerm2, Windows Terminal)](/unclebob/swarm-forge/what-terminal-adapters-does-swarmforge-support)

Swarm-Forge supports Ghostty, iTerm2, and Windows Terminal via a pluggable adapter system. Open terminals, attach tmux sessions, and automate window management efficiently.

- Tags: feature-support
- Published: 2026-08-10

### [How Swarm-Forge Implements Project-Isolated TMUX Socket Naming Conventions](/unclebob/swarm-forge/what-is-the-tmux-socket-naming-convention-and-how-is-it-project-isolated)

Discover Swarm-Forge's project-isolated tmux socket naming. Learn how it uses user temp directories and CRC32 checksums for unique, isolated sockets, preventing project conflicts.

- Tags: how-to-guide
- Published: 2026-08-10

### [How the Priority Field Is Processed in Swarm-Forge Handoff Message Files](/unclebob/swarm-forge/how-is-the-priority-field-processed-in-handoff-message-files)

Learn how the priority field is processed in Swarm-Forge handoff message files. Discover its role in file headers, filename embedding, and batch task grouping for efficient queue ordering.

- Tags: internals
- Published: 2026-08-10

### [How the Swarm-Forge Cleanup Window Shutdown Sequence Works](/unclebob/swarm-forge/how-does-the-cleanup-window-shutdown-sequence-work)

Discover how the swarm-forge cleanup window shutdown sequence works. Learn how swarm-cleanup.sh gracefully terminates daemons, kills sessions, and closes terminals.

- Tags: internals
- Published: 2026-08-10

### [Two-Pack, Four-Pack, and Six-Pack Workflows in SwarmForge: Choosing the Right Agent Topology](/unclebob/swarm-forge/what-are-the-differences-between-swarmforge-workflows)

Explore SwarmForge's two-pack, four-pack, and six-pack workflows. Understand how agent topology balances development speed and specification rigor for your AI projects.

- Tags: deep-dive
- Published: 2026-08-10

### [How to Configure Different Agent Backends (Claude, Codex, Copilot, Grok) per Role in SwarmForge](/unclebob/swarm-forge/how-do-i-configure-different-agent-backends-per-role)

Configure different AI agent backends like Claude, Codex, Copilot, and Grok per role in SwarmForge by editing the swarmforge.conf file. Learn how to assign specific agents to roles for tailored AI assistance.

- Tags: how-to-guide
- Published: 2026-08-10

### [.swarmforge/ Runtime Directory: Purpose and Structure in SwarmForge](/unclebob/swarm-forge/what-is-the-purpose-and-structure-of-the-swarmforge-runtime-directory)

Understand the .swarmforge/ runtime directory's purpose and structure in SwarmForge. Learn how it manages local state for reliable multi-agent orchestration.

- Tags: internals
- Published: 2026-08-10

### [How the Window Watchdog Mechanism Recovers Closed Agent Windows in Swarm Forge](/unclebob/swarm-forge/how-does-the-window-watchdog-mechanism-recover-closed-agent-windows)

Discover how Swarm Forge's window watchdog mechanism uses a Babashka script to automatically recover closed agent windows. Learn about the threshold for respawning.

- Tags: internals
- Published: 2026-08-10

### [SwarmForge Batch vs Task Receive Modes: How Handoff Processing Works](/unclebob/swarm-forge/how-does-swarmforge-handle-batch-versus-task-receive-modes-for-handoffs)

Discover how SwarmForge batch vs task receive modes manage handoffs. Learn about priority-grouped batches and individual processing in this technical guide.

- Tags: deep-dive
- Published: 2026-08-10

### [SwarmForge Layered Constitution System: How Constitution Articles Govern AI Agents](/unclebob/swarm-forge/what-is-the-layered-constitution-system-and-how-do-constitution-articles-work)

Explore SwarmForge's layered constitution system. Discover how plain-text articles govern AI agents with root entry points, shared defaults, and local overrides for deterministic behavior.

- Tags: deep-dive
- Published: 2026-08-10

### [How to Add a Custom Terminal Backend to SwarmForge: Complete Implementation Guide](/unclebob/swarm-forge/how-do-i-add-a-custom-terminal-backend-to-swarmforge)

Learn how to add a custom terminal backend to SwarmForge by creating a Zsh adapter script and setting the SWARMFORGE_TERMINAL environment variable. Implement the necessary API functions for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-10

### [How SwarmForge Achieves tmux Session Isolation Per Project](/unclebob/swarm-forge/how-does-swarmforge-achieve-tmux-session-isolation-per-project)

Learn how SwarmForge isolates tmux sessions per project using unique Unix sockets and the -S flag. Enhance your workflow with secure, project-specific terminal environments.

- Tags: internals
- Published: 2026-08-10

### [How the SwarmForge Handoff Protocol Works: File-Based Agent Coordination](/unclebob/swarm-forge/how-does-the-handoff-protocol-work-between-agents-in-swarmforge)

Discover how SwarmForge agents coordinate tasks using a file-based handoff protocol. Learn about atomic file naming and directory-based state machines for seamless agent communication.

- Tags: internals
- Published: 2026-08-10

### [How the SwarmForge Window Watchdog Prevents Data Loss in Tmux Sessions](/unclebob/swarm-forge/how-does-the-swarmforge-window-watchdog-prevent-data-loss)

Discover how the SwarmForge window watchdog prevents data loss in tmux by monitoring for missing windows and automatically respawning them.

- Tags: internals
- Published: 2026-08-09

### [What Is the Purpose of the SwarmForge Window Watchdog?](/unclebob/swarm-forge/what-is-the-purpose-of-the-swarmforge-window-watchdog)

Discover the SwarmForge window watchdog's purpose: it ensures agent terminal continuity by detecting lost sessions, recreating them, and preventing catastrophic failures. Learn how it safeguards your SwarmForge operations.

- Tags: how-to-guide
- Published: 2026-08-09

### [SwarmForge Script and Configuration Files: The Complete Architecture Guide](/unclebob/swarm-forge/what-are-the-key-swarmforge-script-and-configuration-files)

Explore the SwarmForge architecture, detailing essential scripts and configuration files like swarmforge.conf. Understand how Bash/Babashka scripts orchestrate AI agent swarms.

- Tags: architecture
- Published: 2026-08-09

### [When to Use the SwarmForge Six-Pack Workflow](/unclebob/swarm-forge/when-to-use-the-swarmforge-six-pack-workflow)

Discover when to use the SwarmForge six-pack workflow for complex projects needing strict specs and QA. Learn how SwarmForge optimizes large-scale development for robust software.

- Tags: best-practices
- Published: 2026-08-09

### [When to Use the SwarmForge Four-Pack Workflow: A Complete Guide](/unclebob/swarm-forge/when-to-use-the-swarmforge-four-pack-workflow)

Discover when to use the SwarmForge four-pack workflow for moderate projects. Get formal Gherkin specs & architectural oversight without full QA overhead.

- Tags: how-to-guide
- Published: 2026-08-09

### [When to Use the SwarmForge Two-Pack Workflow: A Guide to Lightweight AI Development](/unclebob/swarm-forge/when-to-use-the-swarmforge-two-pack-workflow)

Discover when to use the SwarmForge two-pack workflow for lightweight AI development. Learn how this TDD-driven approach streamlines small tasks with a coder and cleaner, boosting efficiency and quality.

- Tags: best-practices
- Published: 2026-08-09

### [Pre-Configured SwarmForge Workflow Branches: Two-Pack, Four-Pack, and Six-Pack Explained](/unclebob/swarm-forge/what-are-the-pre-configured-swarmforge-workflow-branches-two-pack-four-pack-six-pack)

Understand SwarmForge's pre-configured workflow branches two-pack four-pack and six-pack. Optimize your project roles and hand-offs for efficient quality assurance.

- Tags: getting-started
- Published: 2026-08-09

### [How to Override SwarmForge Terminal Backend Detection Using SWARMFORGE_TERMINAL](/unclebob/swarm-forge/how-to-override-swarmforge-terminal-backend-detection-using-swarmforge_terminal)

Override SwarmForge terminal detection with SWARMFORGE_TERMINAL environment variable. Force Ghostty, Terminal.app, or Windows Terminal before running ./swarm.

- Tags: how-to-guide
- Published: 2026-08-09

### [How to Integrate Custom Terminal Backends with SwarmForge: A Complete Guide](/unclebob/swarm-forge/how-to-integrate-custom-terminal-backends-with-swarmforge)

Integrate custom terminal backends with SwarmForge easily. Our guide shows how to add new terminal emulators without core code changes, leveraging SwarmForge's dynamic loading.

- Tags: how-to-guide
- Published: 2026-08-09

### [SwarmForge Handoff Protocol Helper Scripts: A Complete Guide to File-Based Workflow Automation](/unclebob/swarm-forge/what-are-the-helper-scripts-for-the-swarmforge-handoff-protocol)

Automate file-based workflows with SwarmForge handoff protocol helper scripts. Manage .handoff files between tmux roles efficiently. A complete guide to this powerful utility.

- Tags: how-to-guide
- Published: 2026-08-09

### [How the SwarmForge Handoff File Directory Structure Works: Outbox, Inbox, and State Management](/unclebob/swarm-forge/how-does-the-swarmforge-handoff-file-directory-structure-work-outbox-inbox)

Explore the SwarmForge handoff file directory structure. Learn how outbox, inbox, and state management enable atomic message queuing for efficient agent communication and task processing.

- Tags: internals
- Published: 2026-08-09

### [SwarmForge Handoff Protocol Message Types: git_handoff and note Explained](/unclebob/swarm-forge/what-are-the-message-types-in-the-swarmforge-handoff-protocol-git_handoff-note)

Explore SwarmForge handoff protocol message types git_handoff and note. Understand how these two message types facilitate code commits and status updates in the SwarmForge system.

- Tags: api-reference
- Published: 2026-08-09

### [How SwarmForge Manages Project-Specific tmux Sockets: Isolation and Discovery](/unclebob/swarm-forge/how-are-project-specific-tmux-sockets-managed-in-swarmforge)

SwarmForge isolates project tmux sockets in temp directories and saves paths to .swarmforge/tmux-socket. Discover how this ensures independent project operation.

- Tags: internals
- Published: 2026-08-09

### [What Files Are Synchronized Across Worktrees in SwarmForge?](/unclebob/swarm-forge/what-files-are-synchronized-across-worktrees-in-swarmforge)

Discover which files SwarmForge synchronizes across worktrees, including roles.tsv, handoffs, and global configs, ensuring consistent multi-agent swarm state. Learn more now.

- Tags: internals
- Published: 2026-08-09

### [How SwarmForge Ensures Worktree Isolation for Agents: Git Worktree Architecture Explained](/unclebob/swarm-forge/how-does-swarmforge-ensure-worktree-isolation-for-agents)

SwarmForge isolates agent worktrees in .worktrees/ to prevent file and history conflicts. Learn how Git worktrees ensure concurrent role isolation.

- Tags: internals
- Published: 2026-08-09

### [SwarmForge Supported Agents: Claude, Codex, Copilot, and Grok Explained](/unclebob/swarm-forge/what-are-the-supported-agents-in-swarmforge-claude-codex-copilot-grok)

Discover SwarmForge's supported agents: Claude, Codex, Copilot, and Grok. Learn how this LLM agent framework leverages a Babashka script for seamless integration and validated functionality.

- Tags: supported-agents
- Published: 2026-08-09

### [How to Configure Different Agent Roles and Their Worktrees in SwarmForge](/unclebob/swarm-forge/how-to-configure-different-agent-roles-and-their-worktrees-in-swarmforge)

Learn to configure SwarmForge agent roles and worktrees by editing the swarmforge.conf file. Define backends, worktrees, and runtime parameters for automated setup.

- Tags: how-to-guide
- Published: 2026-08-09

### [SwarmForge Configuration File Format: A Complete Guide to swarmforge.conf](/unclebob/swarm-forge/what-is-the-format-of-the-swarmforge-configuration-file-swarmforge-conf)

Explore the SwarmForge configuration file format. Learn how to define tmux windows using the declarative swarmforge.conf syntax for efficient agent management.

- Tags: api-reference
- Published: 2026-08-09

### [How Agent Behavior Is Defined Using the SwarmForge Constitution System](/unclebob/swarm-forge/how-is-agent-behavior-defined-using-the-swarmforge-constitution-system)

Discover how SwarmForge constitution defines AI agent behavior using a layered, file-based ruleset. Learn to enforce project-wide discipline with custom prompts.

- Tags: how-to-guide
- Published: 2026-08-09

### [How the SwarmForge Handoff Daemon Facilitates Inter-Agent Communication](/unclebob/swarm-forge/how-does-the-swarmforge-handoff-daemon-facilitate-inter-agent-communication)

Discover how the SwarmForge handoff daemon streamlines inter-agent communication through asynchronous polling, structured file parsing, and automated agent notifications.

- Tags: deep-dive
- Published: 2026-08-09

### [How the SwarmForge Launcher Works: Orchestrating AI Agents with Babashka and TMUX](/unclebob/swarm-forge/how-does-the-swarmforge-launcher-work)

Discover how the SwarmForge launcher orchestrates AI agents using Babashka and TMUX. Learn about context setup, dependency validation, and agent spawning.

- Tags: internals
- Published: 2026-08-09

### [What Are the Core Components of SwarmForge Architecture?](/unclebob/swarm-forge/what-are-the-core-components-of-swarmforge-architecture)

Discover the 8 core components of SwarmForge architecture. Learn how this system creates a disciplined AI agent software-engineering pipeline, transforming AI into effective tools.

- Tags: architecture
- Published: 2026-08-09

### [How to Set Up SwarmForge for AI Agent Orchestration: A Complete Guide](/unclebob/swarm-forge/how-to-set-up-swarmforge-for-ai-agent-orchestration)

Learn how to set up SwarmForge, a tmux-based platform for AI agent orchestration. This guide covers configuration and launching agents with ease.

- Tags: how-to-guide
- Published: 2026-08-09

### [SwarmForge Environment Variables: Complete Startup Configuration Guide](/unclebob/swarm-forge/environment-variables-control-swarmforge-startup-behavior)

Configure SwarmForge startup with essential environment variables. Learn how to control agent delays, sleep prevention, and more for optimal performance.

- Tags: how-to-guide
- Published: 2026-08-08

### [How to Handle Terminal Adapter Failures or Missing Window IDs in SwarmForge](/unclebob/swarm-forge/handle-terminal-adapter-failures-missing-window-ids)

Learn how SwarmForge handles terminal adapter failures and missing window IDs using capability flags and a watchdog script to automatically reopen windows and preserve tmux sessions.

- Tags: how-to-guide
- Published: 2026-08-08

### [Chain Forwarding in Pack Pipelines: When and Why It’s Required](/unclebob/swarm-forge/what-is-chain-forwarding-in-pack-pipelines)

Understand chain forwarding in pack pipelines. Learn when and why this SwarmForge rule ensures deterministic workflow progression after each task.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Add a Completely New Role to an Existing SwarmForge Workflow](/unclebob/swarm-forge/add-new-role-to-existing-workflow)

Easily add a new role to your SwarmForge workflow by creating a prompt file and registering it in swarmforge.conf. Restart swarm to apply changes and enhance your development process.

- Tags: how-to-guide
- Published: 2026-08-08

### [.swarmforge/handoffs/ Directory Structure Explained: A Complete Guide](/unclebob/swarm-forge/directory-structure-swarmforge-handoffs)

Explore the .swarmforge/handoffs/ directory structure. Understand the dual-queue filesystem, outbox, inbox, and lifecycle management for agent messages and task processing in Swarm Forge.

- Tags: how-to-guide
- Published: 2026-08-08

### [How to Migrate Existing Projects to a Newer Version of SwarmForge](/unclebob/swarm-forge/migrate-projects-to-newer-swarmforge-version)

Easily migrate existing projects to a newer SwarmForge version. Fetch the latest branch, use the swarm wrapper to auto-update scripts and articles, and commit your changes.

- Tags: migration-guide
- Published: 2026-08-08

### [Git Handoff vs Note Handoff Behavior in Swarm Forge](/unclebob/swarm-forge/git-handoff-vs-note-handoff-agent-behavior)

Understand the difference between Git Handoff and Note Handoff in Swarm Forge. Git handoffs trigger merges and forwarding, while note handoffs are simple acknowledgments.

- Tags: internals
- Published: 2026-08-08

### [Why the First Window in swarmforge.conf Is the Cleanup Window in SwarmForge](/unclebob/swarm-forge/why-first-window-in-swarmforge-conf-is-cleanup-window)

Discover why the first window in swarmforge.conf is the cleanup window. Learn how its closure signals SwarmForge to shut down your swarm and all tracked terminals.

- Tags: internals
- Published: 2026-08-08

### [Swarm-Forge Agent Backends: Supporting Claude, Codex, Copilot, and Grok for Different Roles](/unclebob/swarm-forge/supported-agent-backends-per-role-claude-codex-copilot-grok)

Discover Swarm-Forge agent backends supporting Claude, Codex, Copilot, and Grok. Configure LLM providers for different roles easily in your .swarmforge/roles.tsv file.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Override Terminal Detection in Swarm-Forge Using the SWARMFORGE_TERMINAL Environment Variable](/unclebob/swarm-forge/override-terminal-detection-swarmforge-terminal-env-var)

Override terminal detection in Swarm Forge by setting the SWARMFORGE_TERMINAL environment variable. Force a specific terminal adapter for your swarm command and bypass automatic detection.

- Tags: how-to-guide
- Published: 2026-08-08

### [How SwarmForge Prevents System Sleep During an Active Swarm](/unclebob/swarm-forge/prevent-system-sleep-during-swarm)

Discover how SwarmForge prevents system sleep during active swarms by using OS-specific sleep inhibitors like caffeinate on macOS and systemd-inhibit on Linux.

- Tags: how-to-guide
- Published: 2026-08-08

### [Task vs Batch Receive Modes in SwarmForge: How to Choose the Right Processing Strategy](/unclebob/swarm-forge/difference-between-task-and-batch-receive-modes)

Understand SwarmForge task vs batch receive modes. Learn how to choose the right processing strategy for your roles to optimize handoff consumption and ensure atomic unit processing.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Debug Handoff Delivery Failures or Missing Messages in SwarmForge](/unclebob/swarm-forge/debug-handoff-delivery-failures-missing-messages)

Debug SwarmForge handoff delivery failures. Inspect daemon logs, check failed directories, and validate handoff headers to resolve missing messages.

- Tags: how-to-guide
- Published: 2026-08-08

### [How the Window Watchdog Reopens Closed Agent Windows in SwarmForge](/unclebob/swarm-forge/how-window-watchdog-reopens-closed-agent-windows)

Discover how SwarmForge's window watchdog automatically reopens closed agent windows. Learn about its monitoring and recovery process for seamless swarm continuity.

- Tags: internals
- Published: 2026-08-08

### [How Constitution Articles Customize Agent Behavior in SwarmForge: A Layered Governance System](/unclebob/swarm-forge/how-constitution-articles-customize-agent-behavior)

Discover how SwarmForge constitution articles customize agent behavior using plain-text prompt files. Learn about layered governance and dynamic context loading for flexible agent control.

- Tags: deep-dive
- Published: 2026-08-08

### [How SwarmForge Creates and Manages Git Worktrees for Each Role](/unclebob/swarm-forge/create-and-manage-git-worktrees-for-roles)

Learn how SwarmForge creates and manages Git worktrees for each role using its configuration-driven startup for concurrent AI agent development without conflicts.

- Tags: how-to-guide
- Published: 2026-08-08

### [How SwarmForge Agents Use ready_for_next.sh and done_with_current.sh for Work Coordination](/unclebob/swarm-forge/how-agents-use-ready-for-next-sh-and-done-with-current-sh)

Discover how SwarmForge agents use ready_for_next.sh and done_with_current.sh to automate task coordination and create a continuous work loop for efficient batch and task modes.

- Tags: how-to-guide
- Published: 2026-08-08

### [Swarm Forge Handoff File Format and Commit SHA Validation Rules](/unclebob/swarm-forge/handoff-file-format-and-commit-sha-validation-rules)

Discover Swarm Forge handoff file format and commit SHA validation rules. Ensure your SHAs are exactly 10 hex characters and uniquely resolve to commit objects.

- Tags: api-reference
- Published: 2026-08-08

### [How to Add a Custom Terminal Adapter for WezTerm or Alacritty in Swarm Forge](/unclebob/swarm-forge/add-custom-terminal-adapter-wezterm-alacritty)

Easily add a custom terminal adapter for WezTerm or Alacritty in Swarm Forge. Create an executable script and set the SWARM_TERMINAL_ADAPTER environment variable for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-08

### [How SwarmForge Isolates tmux Sessions for Different Projects](/unclebob/swarm-forge/how-swarmforge-isolates-tmux-sessions-between-projects)

Learn how SwarmForge isolates tmux sessions for projects using unique Unix sockets and the -S flag for distinct, secure environments. Optimize your workflow today.

- Tags: how-to-guide
- Published: 2026-08-08

### [Two-Pack, Four-Pack, and Six-Pack Workflows in SwarmForge: A Complete Comparison](/unclebob/swarm-forge/differences-between-two-pack-four-pack-and-six-pack-workflows)

Compare SwarmForge two-pack, four-pack, and six-pack workflows. Understand agent topology and hand-off pipelines for tasks from backend to full project specifications.

- Tags: comparison
- Published: 2026-08-08

### [How to Configure Custom Roles and Worktrees in SwarmForge](/unclebob/swarm-forge/how-to-configure-custom-roles-and-worktrees-in-swarmforge-conf)

Learn to configure custom roles and worktrees in SwarmForge by creating prompt files, registering them with role-add, and setting worktree names in swarmforge.conf.

- Tags: how-to-guide
- Published: 2026-08-08

### [How the SwarmForge Handoff Daemon Delivers Messages Between Agents](/unclebob/swarm-forge/how-does-swarmforge-handoff-daemon-deliver-messages-between-agents)

Discover how the SwarmForge handoff daemon delivers messages between agents by polling files, routing to inboxes, and waking sleeping agents via tmux.

- Tags: how-to-guide
- Published: 2026-08-08