skills.rest
PolyArch
PolyArchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

humanize-refine-plan

Refine annotated gen-plans by removing CMT blocks and generating a QA ledger.

1.4k|123|Updated Jan 12, 2026
Search Tags:#workflow#plan#refine#ai-assist#gen-plan#qa-ledger
One-click install
npx skills add https://github.com/PolyArch/humanize --skill humanize-refine-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: humanize-refine-plan
Source: https://github.com/PolyArch/humanize/tree/main/skills/humanize-refine-plan
Command: npx skills add https://github.com/PolyArch/humanize --skill humanize-refine-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refine annotated plans into a clean, comment-free version along with a QA ledger.

Core Features & Use Cases

  • Preserve the original gen-plan structure and convergence state while removing all comment blocks.
  • Generate a QA ledger that captures classifications, decisions, and changes made during refinement.
  • Produce an atomic refined plan and QA artifacts, with optional support for translated variants.
  • Ensure required sections of the gen-plan remain intact and that routing tags remain restricted.

Quick Start

Provide an annotated plan with CMT blocks to the refine-plan flow to generate a clean refined plan and its QA ledger.

Frequently Asked Questions about humanize-refine-plan

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

FAQPage Schema
How do I remove comment blocks from an annotated plan?▼

Refine annotated plans by removing embedded CMT blocks to produce a clean, comment-free version. This process preserves the original gen-plan structure and convergence state while generating an atomic refined plan.

What is a QA ledger in AI-assisted plan refinement?▼

A QA ledger is a document generated during plan refinement that captures classifications, decisions, and changes. It provides a debuggable record of the modifications made when stripping comments from an annotated plan.

How do I generate a clean plan from a gen-plan workflow?▼

Provide an annotated plan with CMT blocks to a refine-plan flow. The workflow enforces CMT removal, retains required gen-plan sections, and outputs both an atomic clean plan and a corresponding QA ledger.

Does plan refinement preserve the original convergence state?▼

Plan refinement preserves the original gen-plan structure and convergence state. It strictly enforces the removal of CMT blocks while keeping required sections intact and restricting routing tags.

Can I generate translated variants of a refined plan?▼

Plan refinement produces atomic refined plans and QA artifacts with optional support for translated variants. It uses runtime bindings and templates to generate the debuggable QA document.

Related Skills

Explore More Software Engineering Skills→
dmedina-devdmedina-dev
1

executor-workflow

Orchestrate wave-based execution of multi-layer development plans with validation and checkpoints.

Community
Advanced
ianshankianshank
1

planning-protocol

Draft a specs file and issue a planning lock for development plans.

Community
Advanced
mslshaomslshao
1

converge

Orchestrate end-to-end plan convergence from tickets, threads, and drafts into structured work items.

Community
Advanced
AnveioAnveio
1

kpi-verification-pass-rate

Measure first-pass verification rates for automated code verification pipelines.

Community
Intermediate