Automatic Branch Management

When a story moves to In Progress, AIDEN automatically:

1. Creates a branch: feature/s-{number}-{title-slug} (max 50 characters)
2. Optionally creates a Git worktree at a separate path for isolated work
3. Tracks all commits made by the AI agent

Git Worktrees

AIDEN leverages Git worktrees to enable parallel agent execution. Each story gets its own working directory, so multiple agents can work simultaneously without conflicts.

# AIDEN creates worktrees like:
git worktree add .worktrees/feature/s-1-auth feature/s-1-auth
git worktree add .worktrees/feature/s-2-api feature/s-2-api

Why Worktrees?

• Isolation — Each agent works in its own directory
• No stashing — No need to stash/pop changes when switching context
• Parallel builds — Each worktree can run its own dev server or tests
• Clean merges — Each feature branch stays independent until merge

GitHub Integration

When connected to GitHub (via OAuth), AIDEN can:

• Create Pull Requests automatically when a story completes
• Track PR status — link PRs to stories on the board
• Merge PRs — auto-merge when approved
• Sync branches — push and pull from remote

Commit Tracking

AIDEN tracks all Git commits per story, providing a clear audit trail of what the AI agent changed and why. Each commit is linked to the story and visible in the story detail view.