ia-planning

Guide software implementation planning with file-based persistence and measurable success criteria.

30|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/iliaal/whetstone --skill ia-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ia-planning
Source: https://github.com/iliaal/whetstone/tree/main/plugins/whetstone/skills/ia-planning
Command: npx skills add https://github.com/iliaal/whetstone --skill ia-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents AI coding agents from jumping straight into implementation without deciding what “done” means, how to verify it, and what scope boundaries to respect.

Core Features & Use Cases

  • File-persisted planning: Creates and uses a .plan/ working state so key decisions and progress survive context resets.
  • Goal quality gate: Forces measurable success criteria and explicit stop/ask points before planning.
  • Context window discipline: Treats conversation context as volatile memory and writes important plan artifacts to disk.
  • Test discovery for real projects: Detects existing test landscapes to plan verification against current conventions.
  • Structured, phase-based plan template: Produces concrete, phase-sized tasks with verifiable acceptance checks.
  • Guardrails against plan drift: Requires deviation documentation and traceability from completed tasks (including commit SHA recording).

Quick Start

Ask the agent to produce an implementation plan for a feature that touches multiple files and has ambiguous scope, and ensure it first gates success criteria with a measurable verification step.

Frequently Asked Questions about ia-planning

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

FAQPage Schema
How do I create a verifiable implementation plan for a multi-file refactor?

To create a verifiable implementation plan for a multi-file refactor, you must establish measurable success criteria, discover existing tests, and produce concrete, phase-sized tasks with verifiable acceptance checks using a file-persisted workflow.

Why does my AI coding agent lose context during complex software engineering tasks?

AI coding agents lose context during complex software engineering tasks because conversation history is volatile. Writing plan artifacts to a persistent `.plan/` directory on disk ensures key decisions and progress survive context resets.

What is a goal quality gate in software implementation planning?

A goal quality gate in software implementation planning is a checkpoint that forces measurable success criteria and explicit stop or ask points before planning begins, preventing agents from jumping straight into implementation without clear scope boundaries.

How do I prevent AI agents from drifting from the original software architecture plan?

To prevent AI agents from drifting from the original software architecture plan, use a workflow that requires deviation documentation and traceability from completed tasks, including recording commit SHAs for every phase-sized implementation step.

Can I use test discovery to plan verification against existing project conventions?

Yes, you can use test discovery to plan verification against existing project conventions. The planning workflow detects the current test landscape to ensure the multi-phase implementation plan aligns with your established testing frameworks.

Do I need a `.plan/` directory to structure multi-phase code changes?

Yes, you need a `.plan/` directory to structure multi-phase code changes. This file-persisted working state captures key architectural decisions and progress, treating conversation context as volatile memory while maintaining verifiable plan artifacts.