plan-tighten

Trim verbose planning documents while preserving API references and decision data.

157|12|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/dcosson/h2 --skill plan-tighten
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-tighten
Source: https://github.com/dcosson/h2/tree/main/internal/config/templates/styles/opinionated/skills/plan-tighten
Command: npx skills add https://github.com/dcosson/h2 --skill plan-tighten

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan Tighten surgically trims verbosity and restated rationale from planning docs without losing fidelity, removing review residue, duplicated sections, and unnecessary prose to keep the plan concise and auditable.

Core Features & Use Cases

  • Removes duplicate explanations, redundant sections, and lengthy rationale while preserving API, acceptance criteria, and decision rationale.
  • Keeps migration ordering, audit tables, and essential impact analysis intact.
  • Use Case: when a plan doc has gone through multiple review rounds, apply plan-tighten to produce a lean, auditable version ready for final approval.

Quick Start

Apply plan-tighten to a target plan document (docs/plans/your-plan.md) to generate a tightened, audit-ready version.

Frequently Asked Questions about plan-tighten

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

FAQPage Schema
How do I trim verbose planning documents without losing API references?

Trim verbose planning documents by applying a tightening workflow that removes restated rationale and duplicate sections while preserving API/interface signatures, acceptance criteria, and migration steps. This produces a lean, auditable plan ready for final approval.

What is the best way to remove duplicate sections from engineering plan docs?

Removing duplicate sections from engineering plan docs requires phase-preserving cuts that eliminate review residue and extraneous prose while retaining essential decision data. A baseline plan and its associated review history compute diffs to identify redundant content safely.

Can I tighten project plans that have gone through multiple review rounds?

Tightening project plans after multiple review rounds is the core use case. The process strips review residue and duplicated explanations while keeping migration ordering, audit tables, and essential impact analysis intact for a concise, auditable final version.

How does diff-based plan rewriting preserve acceptance criteria?

Diff-based plan rewriting preserves acceptance criteria by enforcing mandatory retention of API/interface signatures, URP/EO/AA commitments, and migration order steps during phase-preserving cuts. It computes differences against a baseline plan and review history to remove only extraneous prose.

What do I need to audit planning docs before final approval?

Auditing planning docs before final approval requires a baseline plan document and its associated review history. These inputs compute diffs to identify review residue, duplicate sections, and restated rationale for removal while maintaining essential decision data and audit tables.

When should I not use automated plan tightening on product plans?

Avoid automated plan tightening on product plans lacking a baseline document or associated review history, as diffs cannot be computed without them. The process requires these inputs to safely perform phase-preserving cuts without losing essential decision data and migration ordering.