paw-work-shaping

Guide interactive ideation sessions to generate structured WorkShaping.md artifacts.

39|6|Updated Oct 8, 2025

Search Tags:#planning #specification #workflows #artifact #idea-shaping #workshaping #PAW

Ready to run

npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-work-shaping

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: paw-work-shaping
Source: https://github.com/lossyrob/phased-agent-workflow/tree/main/skills/paw-work-shaping
Command: npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-work-shaping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The paw-work-shaping skill guides PAW users through an interactive ideation session to transform vague ideas into structured, spec-ready work items.

Core Features & Use Cases

Interactive Q&A: you guide a focused questioning flow to uncover intent, constraints, and scope.
Artifact generation: synthesizes notes and decisions into a formal WorkShaping.md with sections for problem statements, work breakdown, edge cases, architecture sketch, risks, and session notes.
Direct PAW integration: runs inside the PAW session (not a subagent) to maintain context and flow.

Quick Start

Trigger the paw-work-shaping flow in your PAW session to begin guided ideation and generate a WorkShaping.md at the project workspace path.

Frequently Asked Questions about paw-work-shaping

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

FAQPage Schema

How do I convert vague project ideas into structured specifications?▼

To convert vague ideas into structured specifications, you need an interactive ideation process that clarifies intent, defines scope, and assesses risks. This skill guides an AI agent through focused Q&A to synthesize decisions into a formal spec-ready artifact with problem statements and work breakdowns.

What is the best way to define project scope and edge cases during early planning?▼

Defining project scope and edge cases during early planning requires an interactive ideation session that uncovers constraints and intent. This skill guides you through focused questioning to generate a structured artifact containing architecture sketches, risk assessments, and open questions.

How do I generate a WorkShaping.md artifact for my project workspace?▼

Generating a WorkShaping.md artifact involves running an interactive ideation flow within your PAW session. The skill synthesizes your notes and decisions, outputting the file directly to the .paw/work/<work-id>/ directory with sections for problem statements, session notes, and architecture sketches.

Does the paw-work-shaping skill run as a subagent or directly inside the PAW session?▼

The paw-work-shaping skill runs directly inside the PAW session rather than as a subagent. This integration maintains context and flow throughout the interactive ideation process, ensuring the generated WorkShaping.md artifact captures all session decisions accurately.

Can I use interactive ideation to create spec-ready work items from unclear requirements?▼

Yes, interactive ideation transforms unclear requirements into spec-ready work items by guiding a focused questioning flow. This skill uncovers intent and constraints, then synthesizes the answers into a structured artifact containing work breakdowns, edge cases, and architecture sketches.

What sections are included in a WorkShaping.md artifact generated from an ideation session?▼

A WorkShaping.md artifact generated from an ideation session includes sections for problem statements, work breakdown, edge cases, architecture sketches, risks, session notes, and open questions. These components ensure the structured artifact captures all necessary planning details.