pmai-quick-fix

Applies small fixes in isolated git worktrees with drift scanning and PM-approved merges.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-quick-fix-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-quick-fix
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/quick-fix
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-quick-fix-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Small changes like typos, link fixes, formatting, or minor style tweaks should not require a full design and build cycle, but applying them directly to the main branch risks breaking product contracts. This Skill provides a lightweight, isolated path for minor fixes that still enforces consistency checks and human approval. ## Core Features & Use Cases - Isolated Worktree Workflow: Creates a temporary tmp-quick-* git worktree so fixes never touch the main branch until approved. - Mandatory Drift Scan: Before committing, scans affected files against long-term product contracts (spec.md, decisions.md, PRODUCT-RULES.md, DESIGN.md) to detect required synchronization. - PM Approval Gate: Shows the full diff and waits for explicit approve / redo / cancel before committing and fast-forward merging into main. - Use Case: A PM notices a typo in a module spec and a broken link in the docs. Instead of launching the full design pipeline, they run a quick fix, review the drift scan output, approve the diff, and the change is merged to main with [quick-fix] commits. ## Quick Start Ask the assistant to run a quick fix with a one-line description such as fixing a typo in the documentation, then review the drift scan and approve the resulting diff.

Frequently Asked Questions about pmai-quick-fix

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

FAQPage Schema
How do I make a small fix without a full design workflow?

Run the quick fix command with a one-line description of the change. It creates an isolated temporary worktree, applies your edits there, runs a drift scan against product contracts, and merges to main only after you approve the diff.

What kinds of changes are appropriate for a quick fix?

Quick fixes cover typos, formatting, broken links, constant values, minor styles, and very small code patches. Anything that changes module specifications, adds features, or alters acceptance criteria must go through the design or build workflow instead.

Why does quick fix refuse to start sometimes?

It refuses when you are inside a build worktree, on a non-main branch, or when any module has an active build in progress. In those cases, return to the main repository and continue the change inside the active build session.

What is the drift scan in a quick fix workflow?

The drift scan is a mandatory pre-commit check that maps changed files to related long-term contracts like spec.md, decisions.md, PRODUCT-RULES.md, and DESIGN.md. It determines whether related documents must be synchronized before the fix is committed.

Can I cancel a quick fix after the worktree is created?

Yes. Choose the cancel option at the approval prompt or run the script with the cancel subcommand and the worktree name. This removes the temporary worktree and branch, leaving main unchanged.