linear-iterate-on-plan

Refine OpenSpec proposals by detecting and fixing quality issues iteratively.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/jankneumann/agentic-content-analyzer --skill linear-iterate-on-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-iterate-on-plan
Source: https://github.com/jankneumann/agentic-content-analyzer/tree/main/.gemini/skills/iterate-on-plan
Command: npx skills add https://github.com/jankneumann/agentic-content-analyzer --skill linear-iterate-on-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams improve the quality of OpenSpec proposals by automatically identifying and fixing issues related to completeness, clarity, feasibility, scope, consistency, testability, and parallelizability before the proposal is approved.

Core Features & Use Cases

  • Automated Issue Detection: Scans proposal documents and spec deltas for critical quality problems.
  • Iterative Refinement Loop: Applies fixes, validates, and commits up to a configurable number of iterations.
  • Parallel Analysis Option: Can launch multiple exploration agents to assess different quality dimensions concurrently.
  • Coordinator Integration: Optionally uses coordination hooks for memory, handoff, and guardrails.

Quick Start

Ask the skill to iteratively refine proposal <change-id> using default settings.

Frequently Asked Questions about linear-iterate-on-plan

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

FAQPage Schema
How do I refine an OpenSpec proposal before approval?

To refine an OpenSpec proposal, this Skill iteratively validates and fixes completeness, clarity, feasibility, scope, consistency, testability, and parallelizability issues. It automatically applies corrections to proposals, tasks, and spec deltas up to a configurable number of iterations.

What issues should I check before approving an OpenSpec proposal?

Before approving an OpenSpec proposal, you should check for completeness, clarity, feasibility, scope, consistency, testability, and parallelizability issues. This Skill automatically scans proposal documents and spec deltas to detect and resolve these critical quality problems.

Can I automate git commits when iterating on spec deltas?

Yes, you can automate git commits when iterating on spec deltas. This Skill executes validation, applies fixes, and performs automated git commits during each iteration loop to track proposal refinements automatically.

How do I run parallel analysis on proposal documents?

To run parallel analysis on proposal documents, this Skill can launch multiple exploration agents to assess different quality dimensions concurrently. This optional feature accelerates the detection of issues across various proposal aspects.

Does this proposal validation method support coordination hooks for memory and handoff?

Yes, this proposal validation method supports optional coordination hooks for memory and handoff. It can integrate with a coordinator to utilize memory, handoff, and guardrails during the iterative refinement process.

What are the limitations of automated proposal refinement?

The main limitation of automated proposal refinement is the configurable iteration limit, meaning it stops after a set number of loops. Complex issues might require manual review if the automated iterations do not fully resolve feasibility or scope problems.