planning

Convert ambiguous software intent into validated, file-backed planning artifacts.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/vexjoy-agent --skill planning-notque
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning
Source: https://github.com/notque/vexjoy-agent/tree/main/skills/process/planning
Command: npx skills add https://github.com/notque/vexjoy-agent --skill planning-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents wasted execution by converting unclear user intent into a structured, file-backed software planning artifact with explicit scope boundaries, validation, and controlled session pause/resume.

Core Features & Use Cases

  • Spec-first planning: Produces a software spec (user stories + testable acceptance criteria) to anchor downstream design and implementation.
  • Pre-plan ambiguity resolution: Surfaces gray areas and resolves assumptions before a plan is created.
  • File-backed plan workflow: Creates, manages, checks, and validates plans using persistent artifacts so progress survives across sessions.
  • Pause/resume handoff: Supports stopping mid-work and resuming from handoff artifacts without losing decisions or plan state.
  • Interview-style clarity pass: Uses depth-first questioning with recommended answers to resolve interdependent decisions efficiently.

Quick Start

Use planning to write a software spec and acceptance criteria from your idea by saying: Write spec for a feature that adds login with email and password, including user stories and testable acceptance criteria.

Frequently Asked Questions about planning

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

FAQPage Schema
How do I write a software spec with user stories and testable acceptance criteria from a vague feature idea?

To write a software spec from a vague idea, you convert ambiguous intent into structured artifacts containing user stories and testable acceptance criteria. This spec-first planning approach anchors downstream design and implementation by enforcing explicit scope boundaries before execution begins.

What is the best way to resolve project ambiguity and assumptions before creating an implementation plan?

The best way to resolve project ambiguity is using an interview-style clarity pass with depth-first questioning and recommended answers. This surfaces gray areas and resolves interdependent decisions efficiently, ensuring assumptions are addressed before a file-backed plan is created.

How do I manage software planning artifacts so progress survives across multiple work sessions?

You manage planning artifacts across sessions by using a file-backed plan workflow that creates, checks, and validates persistent files. This ensures progress survives independently of active sessions, preventing lost decisions and maintaining continuous plan lifecycle management.

Can I pause mid-work and resume software planning from handoff artifacts without losing plan state?

Yes, you can pause mid-work and resume from handoff artifacts without losing plan state. The workflow supports stopping and restarting from persistent file-backed artifacts, ensuring all previous decisions and validation gates remain intact during session handoff.

When do I need to use plan validation gates during software requirements definition?

You need plan validation gates during requirements definition when converting ambiguous intent into structured plans. These gates enforce explicit scope boundaries and validate the generated software spec, preventing wasted execution on unvalidated or incomplete user stories.