plan

Create living plan documents with goals, scope, milestones, and next-slice contracts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/scripness/skills --skill plan-scripness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/scripness/skills/tree/main/src/plan
Command: npx skills add https://github.com/scripness/skills --skill plan-scripness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Organize work that requires durable state across sessions into living plan documents, enabling safe handoffs and reproducible execution loops.

Core Features & Use Cases

  • Create and update living plans in plans/ with goals, scope, milestones, blockers, and a transparent decision log.
  • Define bounded milestones with explicit done conditions and slice-level specs/tests that keep execution and verification aligned across sessions.
  • Sync repo truth (AGENTS.md, specs, tests) with executable truth to allow resume-from-plan in new sessions.

Quick Start

Create a new plans/YYYY-MM-DD-short-task-slug.md describing a bounded, resumable plan for the task.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I create a durable task plan that survives across multiple sessions?

To create a durable task plan, you generate a living plan document in the plans/ directory that defines goals, scope, milestones, and an explicit next-slice contract. This ensures execution state persists safely across sessions and restarts.

What's the best way to resume work on a multi-milestone task after a context loss?

Resuming multi-milestone tasks requires a resumable plan document that syncs repo truth like AGENTS.md and tests with executable truth. This allows new sessions to pick up execution and verification exactly where the previous session left off.

How do living plan documents help manage blockers and task handoffs?

Living plan documents manage blockers and handoffs by maintaining a transparent decision log alongside milestone tracking. This durable state captures what happened, what remains, and what the next slice of work is for safe reproducible execution.

When do I need to use a structured plan document for my milestones?

You need a structured plan document when work spans multi-milestone tasks that may experience interruptions or require handoffs. It enforces done conditions and spec-test alignment to guide execute and verify phases across bounded milestones.

Can I sync my repository specs and tests with a resumable execution plan?

Yes, the plan structure syncs repository truth such as AGENTS.md, specs, and tests with executable truth. This alignment keeps slice-level specs and tests verifiable when you resume execution from the plan in a new session.

What should I avoid when defining next-slice contracts in a task plan?

When defining next-slice contracts, avoid creating unbounded milestones without explicit done conditions. The plan structure requires slice-level specs and tests to stay aligned, so missing these conditions breaks execution and verification continuity across sessions.