git-local-p4-workflow

Manage local Git workflows with repository junctions and UTF-8 atomic commits.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill git-local-p4-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-local-p4-workflow
Source: https://github.com/moraluco/Illusion-Cursor-dev-kit/tree/main/.cursor/skills/git-local-p4-workflow
Command: npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill git-local-p4-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about git-local-p4-workflow

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

FAQPage Schema
How do I prevent Git from corrupting Chinese commit messages in Unreal Engine projects?

Preventing Git from corrupting Chinese commit messages requires enforcing UTF-8 commit message handling and verification steps. This local-first workflow ensures atomic commits and protects multi-repo history from text corruption.

Can I automate Perforce operations alongside local Git workflows?

You should not automate Perforce operations alongside local Git workflows. This workflow enforces agent-safe rules that prohibit automated P4 edit, submit, and reconcile actions, keeping them strictly as explicit human-controlled steps.

What's the best way to manage multiple local Git repositories for Unreal Engine development kits?

The best way to manage multiple local Git repositories is creating directory junctions using mklink. This provides a stable local workspace like D:\GitRepo, linking project and kit folders so automation and tests operate reliably.

Does this local-first Git workflow support atomic commits across project and dev kit repositories?

Yes, this local-first Git workflow supports atomic commits across project and dev kit repositories. It prescribes commit discipline and repository junctions to ensure changes are committed to the correct repo safely.

Why do I need directory junctions for local-first Git workflows?

You need directory junctions for local-first Git workflows to provide a stable local workspace where both project and kit repositories coexist. This reduces friction from remote constraints like LFS or CI runners, ensuring reliable automation.