maestro-fork

Solid

Create or sync session worktree for parallel dev

AI & Automation 549 stars 68 forks Updated 2 days ago

Install

View on GitHub

Quality Score: 86/100

Stars 20%

Recency 20%

100

Frontmatter 20%

Documentation 15%

100

Issue Health 10%

License 10%

Description 5%

100

Skill Content

<required_reading> @~/.maestro/workflows/run-mode.md @~/.maestro/workflows/codex-run-mode.md </required_reading> <purpose> Create or sync a session-level git worktree for parallel development. Supports `--sync` mode to pull latest main changes into an active worktree. </purpose> <deferred_reading> - [worktrees.json](~/.maestro/templates/worktrees.json) — read when updating registry - [worktree-scope.json](~/.maestro/templates/worktree-scope.json) — read when writing scope marker </deferred_reading> <context> $ARGUMENTS -- session ID (or slug) and optional flags. Modes (`Fork` / `Sync`), flags (`--session`, `--base`, `--sync`), session resolution, worktree layout, and artifact scoping are defined in workflow `fork.md`. </context> <execution> Follow '~/.maestro/workflows/fork.md' completely. Fork and sync algorithm steps are defined in workflow `fork.md`. ### Gates (MANDATORY, BLOCKING) **Fork mode:** **GATE 1: Validation → Worktree Creation** - REQUIRED: Session resolved from `state.json.sessions[]` by session_id or intent slug. - REQUIRED: No existing active worktree for this session (E008). - REQUIRED: Not running inside a worktree (E003). - BLOCKED if: session not found (E006), already forked (E008), or running inside worktree (E003). **GATE 2: Worktree Creation → Artifact Copy** - REQUIRED: Git worktree created with branch (`session/{slug}`). - REQUIRED: Shared `.workflow/` files copied (project.md, config.json, specs/). - BLOCKED if missing: worktree creation fa...

Details

Author: catlog22
Repository: catlog22/maestro-flow
Created: 5 months ago
Last Updated: 2 days ago
Language: TypeScript
License: None

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

worktree

Use when work needs isolation from the current workspace — when /execute (mode=solo) or the /dispatch funnel must run a phase on its own branch without touching the main working tree. Detects existing isolation, creates a fork via `doctrine worktree fork` (the sole creation+provision+mark verb; coordination tier excluded), runs the commit-before-spawn / branch-point / baseline guards, and hands back the fork branch.

2 Updated 3 weeks ago

davidlee

AI & Automation Listed

worktrees

Orchestrate parallel multi-session development: survey existing worktrees, reap finished ones, plan a wave of non-conflicting issues, create sibling worktrees, and spawn a seeded… Use for /worktrees requests.

2 Updated 3 days ago

amurshak

Code & Development Listed

fork

Fork a session into a NEW, independent same-harness sibling — the 'git branch' of sessions. Resolved across the fleet and seeded with a recap of the source (label, cwd, ticket, last state, changed files), so it works for a session on ANY device in ANY harness and picks up where the original left off. Where continue resumes the SAME thread, fork launches a new one. Triggers on: /sessions:fork, /fork, 'fork this session', 'branch this conversation', 'copy this session into a new one', 'explore an alternative direction without touching this thread', 'fork <id>'.

0 Updated today

phnx-labs