survey

Structures design interviews at one fixed altitude to agree system decomposition and scope.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/vinzenz/workflows --skill survey-vinzenz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: survey
Source: https://github.com/vinzenz/workflows/tree/main/.agents/skills/survey
Command: npx skills add https://github.com/vinzenz/workflows --skill survey-vinzenz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design and requirements conversations often dive into implementation detail before the high-level shape is agreed, leaving teams with deep answers to the wrong questions. This Skill runs a structured interview that covers one level of detail completely — decomposing a system into parts, defining scope, and pinning down what is wanted and explicitly not wanted — before any deeper discussion begins. ## Core Features & Use Cases - Fixed-altitude interviews: Sweeps the whole surface at one level (A0 Intent through A4 Ready) and parks any question that belongs deeper, with a labeled parked list. - Strawman-first sweep: Drafts a complete decomposition with best guesses filled in so the human reacts to a concrete proposal instead of composing from a blank page. - Standing readbacks and paper trail: Ends every round with a numbered agreed/open/parked summary and writes glossaries and ADRs as decisions crystallise. - Use Case: When starting a new service whose requirements are vague, run a survey at A1 Parts to agree the component list, what each part owns, and what is explicitly out of scope, before any prototyping or implementation. ## Quick Start Ask the agent to run a survey at A1 Parts to decompose your system idea into components and agree scope before writing any code.

Frequently Asked Questions about survey

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

FAQPage Schema
How do I break down a vague system idea into agreed components?▼

Run a survey at the A1 Parts altitude: draft a strawman decomposition of every part, ask 4-6 recommendation-first questions per round, and read back a numbered standing of agreed, open, and parked items until the level's exit test passes.

What is the difference between survey and grilling for design decisions?▼

Survey works breadth-first at one fixed altitude, covering the whole level before sharpening anything, and outputs the level's shape plus wanted/not-wanted lists. Grilling works depth-first, descending wherever the interesting question is, and outputs decisions and ADRs.

When should I not use a fixed-altitude design interview?▼

Skip it when the question has one obvious answer, when the level cannot be settled by talking and needs a prototype, when the effort spans several altitudes (use pathfinder), or when the shape is agreed and only one deep decision remains (use grilling).

How do I keep a design discussion from diving into implementation detail?▼

State the altitude and what is off-limits before the first question. When a lower-altitude question arrives, name it, park it with its altitude label, and return the conversation upward in the same breath.

Does the survey skill write application code?▼

No. A survey writes only CONTEXT.md glossaries, ADRs, spec text, and its own scratch notes. If implementation feels like the next step, the survey is done and the work should be handed off.