cpm:pivot

Amend planning artefacts and propagate changes to downstream documents.

Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ninthspace/claude-code-marketplace --skill cpm-pivot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cpm:pivot
Source: https://github.com/ninthspace/claude-code-marketplace/tree/main/cpm/skills/pivot
Command: npx skills add https://github.com/ninthspace/claude-code-marketplace --skill cpm-pivot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Revisit any planning artefact (problem brief, product brief, ADR, spec, or epic) and make surgical edits, then cascade changes to downstream documents. Pivot is lighter than re-running the entire workflow — amend what exists instead of starting over.

Core Features & Use Cases

  • Artefact chain discovery: locate and map related planning documents across briefs, ADRs, specs, and epics.
  • Surgical amendment workflow: edit the selected artefact with minimal, focused changes while preserving upstream work.
  • Cascading updates: present downstream documents for user-guided updates to reflect changes.
  • State tracking and safety: maintain a progress trace and ensure changes are written atomically to disk.

Quick Start

Provide a direct path to the target document, or allow artefact-chain discovery, then initiate the surgical pivot to amend the document and cascade changes.

Frequently Asked Questions about cpm:pivot

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

FAQPage Schema
How do I update a planning artefact without re-running the entire workflow?

To update an existing ADR or spec without restarting, provide a direct path to the document or use artefact-chain discovery. The workflow applies focused edits to the target document and then interactively guides cascading updates to downstream artefacts.

What is artefact chain discovery for cascading planning updates?

Artefact chain discovery locates and maps related planning documents across problem briefs, product briefs, ADRs, specs, and epics. It identifies the downstream documents that require cascading updates after a surgical amendment is applied to a target artefact.

Does surgical planning amendment preserve upstream work when changes occur?

Yes, the surgical amendment workflow preserves upstream work while applying strict edits via an Edit tool. It maintains stepwise state tracking and prompts user approval before propagating any cascading changes to downstream documents.

Can I cascade changes from a problem brief to downstream specs and epics?

Yes, you can cascade changes from a problem brief to downstream specs and epics. After amending the target brief, the workflow presents downstream documents for user-guided interactive updates to accurately reflect the new changes.

What is the best way to maintain state tracking when amending planning documents?

The best way to maintain state tracking is through a workflow that enforces stepwise progress traces and atomic writes to disk. This ensures changes to briefs, specs, and epics are recorded safely and consistently throughout the amendment process.