humanize-refine-plan

Name: humanize-refine-plan
Availability: InStock
Author: PolyArch

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

Ready to run

npx skills add https://github.com/PolyArch/humanize --skill humanize-refine-plan

💬 Prompt for ChatGPT / Claude Chat▼

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.