intra-repo-parallel-work

Coordinate parallel repository work using git worktrees and touch-set management.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/FS-GG/FS.GG.Game --skill intra-repo-parallel-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intra-repo-parallel-work
Source: https://github.com/FS-GG/FS.GG.Game/tree/main/.agents/skills/intra-repo-parallel-work
Command: npx skills add https://github.com/FS-GG/FS.GG.Game --skill intra-repo-parallel-work

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, FS-GG.Coord.Cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of coordinating parallel work across multiple agents or people within a single FS-GG repository, ensuring that they work on different items without conflicts or collisions.

Core Features & Use Cases

  • Parallel Work Coordination: Assign tasks to multiple workers while preventing conflicts over shared resources.
  • Isolation: Isolate work in separate git worktrees for each item to avoid conflicts.
  • Touch-Set Management: Declare which files will be touched by the work to manage dependencies and avoid conflicts.
  • Worker Communication: Provide a channel for communication when work overlaps.
  • Use Case: When multiple developers are working on different features of a project in the same repository, this Skill helps ensure that their work can proceed in parallel without causing merge conflicts or overwriting each other's changes.

Quick Start

Use the intra-repo-parallel-work skill to coordinate work on a new feature within the 'FS.GG.Game' repository. Run 'scripts/fsgg-coord whoami --mint' to mint a unique worker ID, then use 'scripts/fsgg-coord take --repo <this-repo>' to claim the next available item.

Frequently Asked Questions about intra-repo-parallel-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate parallel development in a single git repository without merge conflicts?

Parallel development in a single git repository is coordinated by assigning tasks to multiple workers, isolating work in separate git worktrees, and managing touch-sets to avoid file conflicts.

What is a touch-set in git worktree isolation and how does it manage dependencies?

A touch-set in git worktree isolation declares which specific files will be modified by a worker, managing dependencies and preventing multiple workers from touching the same resources and causing collisions.

How do I assign tasks to multiple workers in the same repository using git worktrees?

You assign tasks to multiple workers by minting a unique worker ID, then using coordination commands to claim available items, which isolates each task in its own git worktree for safe parallel work.

Does intra-repo-parallel-work require any specific tools beyond git to manage work isolation?

Yes, work isolation requires the FS-GG coordination CLI tool in addition to git, enabling worker ID minting, task claiming, touch-set management, and worker communication when file overlaps occur.

What's the best way to handle concurrent feature development when workers overlap on the same files?

The best way to handle concurrent feature development overlaps is by using the built-in worker communication channel provided by the coordination tool to resolve dependencies before merging isolated worktrees.

When should I not use git worktrees for parallel work within a single repository?

You should not use git worktrees for parallel work if your development workflow involves frequent concurrent updates to the exact same files, as touch-set management relies on declaring distinct file modifications to prevent conflicts.