git-local-p4-workflow

What problem does it solve?

This Skill formalizes a local-first Git workflow for multi-repo development where remote constraints (LFS, CI runners, network) hinder automation, and Perforce (P4) operations must remain a human-controlled boundary. It reduces friction by prescribing repository junctions, UTF-8 commit practices for Chinese messages, atomic commit guidance, and clear agent-safe responsibilities.

Core Features & Use Cases

• Repository Junctions: Guidance to create directory junctions (D:\GitRepo) that provide a stable local workspace for both project and kit repositories.
• Commit Discipline & Encoding: Enforces atomic commits, UTF-8 commit message handling, and verification steps to avoid Chinese text corruption in history.
• Agent-safe Automation: Defines which tasks Agents may automate (Git, tests, scripts) and which remain manual (P4 edit/submit/reconcile), preventing accidental automated P4 operations.
• Use Case: A developer working on ManteumTower and the Illusion Cursor dev kit uses this workflow to run unattended tests, commit atomic changes in the correct repo, and keep P4 actions as explicit human steps.

Quick Start

As administrator, create the D:\GitRepo directory and create junctions linking your project and kit folders so automation and local-first workflows operate reliably.