Skip to content
cccskills
FreePublished on GitHub

define

Use when a new feature request, bug report, or work request needs requirements defined before implementation

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486 stars(GitHub 486 + cccskills 0)

Run score Not tested

See how to install

Files included (1)

  • SKILL.md3.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/define — Product Owner Interview

Overview

Define requirements by interviewing the user. The interview IS the value — a requirements doc produced without conversation is just guessing.

Core principle: Ask, don't assume. Every assumption is a question you didn't ask.

When to Use

  • User describes a new feature, bug, or change request
  • Work needs to be broken down before architecture or implementation
  • You need to understand scope, personas, and success criteria

The Process

1. Gather Context (silent — don't show this to user)

  • Read CLAUDE.md and recent commits
  • Identify relevant source files for the topic
  • Note existing patterns and constraints

2. Interview — One Question at a Time

Use AskUserQuestion with multiple-choice options where possible.

You MUST ask questions. You MUST NOT produce requirements without interviewing.

Cover these areas, one question per turn:

AreaWhat to Ask
ScopeWhat should this do? What should it NOT do?
PersonasWho uses this? What's their context/skill level?
SuccessHow will we know it works? What does "done" look like?
Edge casesWhat happens with empty/invalid/unexpected input?
ConstraintsBackward compat? Performance? Dependencies?

After each area, summarize what you heard (200-300 words) and ask the user to confirm before moving on.

3. Produce User Stories

Use INVEST format. Each story must be:

  • Independent, Negotiable, Valuable, Estimable, Small, Testable

Template:

### Story N: [Title]

**As a** [persona from interview],
**I want** [functionality],
**So that** [benefit].

#### Acceptance Criteria

```gherkin
Given [context]
When [action]
Then [expected result]

Edge Cases

Given [edge case context]
When [action]
Then [expected handling]

Present stories to user for validation before finalizing.

### 4. Save and Commit

Ask user for a short name, or derive from the topic.

docs/plans/YYYY-MM-DD-<name>-requirements.md


Commit: `docs: add <name> requirements`

### 5. Next Step

> Requirements saved. When ready, use `/architect` to design the solution.

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Producing requirements without interviewing | STOP. Ask questions first. Always. |
| Asking multiple questions at once | One question per `AskUserQuestion` call |
| Including implementation/architecture details | Stay in problem space. Code design is `/architect`'s job. |
| Listing "open questions" without asking them | If it's a question, ASK the user |
| Using FR-1/AC-1.1 format instead of user stories | Use "As a [persona]..." with Gherkin criteria |
| Assuming scope instead of scoping with user | Every assumption is a question you skipped |
| Massive document from a one-line request | Interview to right-size. Small request may mean small scope. |

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when requirements exist and a technical design is needed before implementation begins

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

Use when a design exists and it's time to break it into tasks and execute with subagent dispatch and review

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

qa

Free

Use when implementation is complete and you want to verify quality through adversarial testing that writes code and provides evidence

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

Use when code quality needs improvement after implementation, without changing behavior

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

test

Free

Use EVERY TIME you need to run tests, verify tests pass, or check for regressions. ALWAYS use this instead of running eldev directly.

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

The English summary is being prepared. Showing the original description.

Trevoke/org-gtd.el486Updated Aug 7, 2026

See all skills by Trevoke

Report a problem with this skill