Skip to content

borghei/Claude-Skills / project-management/discovery/plan-grilling

plan-grilling

Verified

Interrogate a plan, design or idea one round of questions at a time until every decision is settled. Use when stress-testing a plan before building, when a design feels underspecified, or turning a fuzzy workflow into a spec.

assets/workflow_spec_template.md

View on GitHub
# Workflow Spec — <name>

**Status:** draft | implementable
**Grilling sessions:** <n> (log: <link to question log>)
**Owner:** <person who runs or answers for this workflow>

## Summary

<Two sentences: what recurs, and what each run leaves behind.>

## Trigger

- **Type:** event | schedule | manual
- **Detail:** <the exact event, or the cadence with time and timezone>
- **Not triggered when:** <the cases that look like triggers but are not>

## Inputs

| Name | Source | Shape / example |
|------|--------|-----------------|

## Steps

| ID | Actor (agent / human / script) | Action | Uses |
|----|--------------------------------|--------|------|

## Human checkpoints

Put each checkpoint as late as it can go, so the person is asked once and
handed everything they need.

| After step | Decision asked | Brief presented (not raw output) | Default if no answer by |
|------------|----------------|----------------------------------|-------------------------|

Or: **Autonomous** — no checkpoint, because <reason the risk is acceptable>.

## Outputs

| Output | Destination | Who reads it |
|--------|-------------|--------------|

## Failure handling

<What happens when a step fails, when an input is missing, and who hears about it.>

## Done definition

Each line must be checkable by someone who was not in the grilling.

- <Every … / No … / … within N minutes>

## Vocabulary

| Term | Meaning in this workflow |
|------|--------------------------|

## Open questions

Must be empty before the status changes to implementable.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall