pmai-build-close

Resumes and completes interrupted build finalization, merge retries, and documentation sync for product modules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a product build workflow is interrupted mid-finalization—by session loss, merge conflicts, or documentation failures—PMs need a safe way to resume exactly where things stopped without re-running completed merges or guessing state from branch names. This Skill provides that compatibility and recovery entry point for the finalize stage. ## Core Features & Use Cases - Checkpoint-based recovery: Reads the build contract lifecycle state (building, iterating, final_check, landed, documenting) and resumes only the missing mechanical or semantic items, never replaying completed work. - Merge conflict retry: Preserves worktree and branch state after merge conflicts so the PM can resolve conflicts and re-run finalization safely. - Documentation recovery: For modules already landed on main with pending or failed docs, it recompiles the context pack, regenerates the doc-impact map, and syncs only affected truth-source documents. - Use Case: A PM's session crashes after a module implementation merged to main but before specs were updated. Invoking this entry point detects the landed + docs_pending state and completes only the documentation alignment without re-merging. ## Quick Start Ask the assistant to resume the interrupted build finalization for the current module using the pmai-build-close entry point.

Frequently Asked Questions about pmai-build-close

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

FAQPage Schema
How do I resume an interrupted build finalization?

Invoke the build-close entry point, which reads the module's build contract lifecycle state and resumes from the exact checkpoint. It only executes missing mechanical or semantic items and never replays merges or checks that already passed with fresh evidence.

How to retry a merge after resolving conflicts in a build worktree?

Resolve the conflicts in the preserved worktree, then re-run the close entry point. It keeps the final_check state, branch, and worktree intact, so the retry continues landing without cleaning or resetting unrelated changes.

What happens if documentation sync fails after implementation lands on main?

The module stays in landed state with docs marked pending or failed, and the failure reason is recorded. The next run only resumes the documentation section—recompiling the context pack and updating affected documents—without repeating the merge.

Does the close entry point run full acceptance checks again?

No. The final_check stage only validates evidence freshness, confirming source hashes and commits match the contract. Full acceptance runs once when transitioning from iterating, and evidence is never replayed for the same commit.

When should I not use the build-close recovery entry?

Do not use it for new product feedback, implementation gaps, or business code changes—those route back to the build stage. It also cannot help if no active build contract exists for the module, since it never guesses state from branch names or directories.