Mainark documentation
Mainark turns tickets into reviewed, stacked pull requests using isolated git worktrees and AI agents.
Guides
Parallel agent work
Start here if you run multiple features or epics at once.
- Overview — mental model and when to use what
- Git worktrees — one tree per branch per PR
- Stacked PRs — dependency chains on GitHub
- Linear setup — blockers, plans, what stays in Linear (current SoT; see ADR-001 for exit plan)
- Commands — CLI cheat sheet
- Anti-patterns — what not to add to target repos
Architecture
- ADR-001: Mainark owns the task graph — SQLite default (Phase 4); Linear opt-in rollback
- TaskProvider boundary — default
TASK_BACKEND=sqlite - Backend spike (Phase 2) — Beads design review; SQLite prior stands
Reference
- Local CLI — install, review loop, env vars (developer reference)
Audiences
| You are… | Start with |
|---|---|
| Human operator | Parallel agents overview |
| Cursor / coding agent | Same guide + repo rule .cursor/rules/mainark-parallel.mdc |
| Website visitor | mainark.com/docs (this content, rendered) |