refine

Refine design documents by resolving contradictions and updating CONTEXT.md and ADRs.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ForgePlan/marketplace --skill refine-forgeplan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/ForgePlan/marketplace/tree/main/plugins/fpl-skills/skills/refine
Command: npx skills add https://github.com/ForgePlan/marketplace --skill refine-forgeplan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires forgeplan, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a methodical approach to refining plans, designs, and proposals, ensuring clarity and accuracy before execution.

Core Features & Use Cases

  • Iterative Refinement: Walk through the design tree question by question to refine terminology and surface contradictions.
  • Decision Recording: Offers features for updating CONTEXT.md and ADRs inline, ensuring documentation remains in sync with decisions.
  • Integration with Forgeplan: Connects with Forgeplan tools for ADR and PRD management.
  • Use Case: Before beginning a sprint, use this Skill to review and refine a feature design, ensuring that all aspects are understood and documented.

Quick Start

Run the refine skill to start the refinement process for your plan.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I refine a design document and surface contradictions before execution?

To refine a design document, the Skill walks through the design tree question by question, clarifying terminology and surfacing contradictions. It updates documentation in sync with decisions, ensuring your design is pressure-tested and accurate before execution.

What is the best way to review and update ADRs during plan refinement?

The best way to update ADRs during plan refinement is to record decisions inline as contradictions are resolved. This keeps architecture decision records synchronized with the evolving design context and prevents documentation drift.

How do I keep CONTEXT.md synchronized with design decisions during a plan review?

Keep CONTEXT.md synchronized by updating the file inline during the plan review. As you resolve contradictions and refine terminology step by step, the documentation is continuously updated to reflect the latest decisions.

Does the plan refinement process require Forgeplan tools for decision tracking?

Yes, the plan refinement process requires Forgeplan tools for decision tracking and documentation management. It connects directly with Forgeplan to manage architecture decision records and product requirement documents throughout the refinement workflow.

Can I use iterative design refinement for sprint planning and feature proposals?

Yes, you can use iterative design refinement for sprint planning and feature proposals. Before beginning a sprint, the process reviews and refines your feature design step by step, ensuring all aspects are fully understood and documented.