maestro-fork

Solid

Create or sync session worktree for parallel dev

AI & Automation 482 stars 62 forks Updated today

Install

View on GitHub

Quality Score: 85/100

Stars 20%
89
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
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
4 months ago
Last Updated
today
Language
TypeScript
License
None

Similar Skills

Semantically similar based on skill content — not just same category