interview-framework

Featured

This skill should be used when running an interactive interview before a spec phase, gathering requirements through dialogue, asking the user clarifying questions before delegating to a subagent, or when any Ralph phase command (research, requirements, design, tasks) needs adaptive brainstorming dialogue. Covers the 3-phase algorithm (Understand, Propose Approaches, Confirm and Store).

AI & Automation 431 stars 38 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
88
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Interview Framework Adaptive brainstorming dialogue algorithm for all spec phases. Each phase command provides its own exploration territory (phase-specific areas to probe). ## Option Limit Rule Each question must have 2-4 options (max 4). Keep the most relevant options, combine similar ones. ## Recommendation Format Every question asked via `AskUserQuestion` in Phase 1 leads with the recommended option (except when options are symmetric, in which case `[Recommended]` may be omitted): ```yaml AskUserQuestion: question: "[Context-aware question referencing prior answers]. [One sentence rationale for the recommendation.]" options: - "[Recommended] [Option text -- the AI's suggested answer]" - "[Alternative 1]" - "[Alternative 2 if needed]" - "Other" ``` Rules: - `[Recommended]` is a label prefix on the first option only. - The rationale sits in the question text, not the option label. - Option count still 2-4 max (Option Limit Rule preserved). - If there is no meaningful recommendation (truly symmetric choice), omit the `[Recommended]` label rather than placing it arbitrarily. Example: ```yaml AskUserQuestion: question: "Where should the spec live? You only have one specs directory configured, so the default is fine unless you want to reorganize." options: - "[Recommended] ./specs/ (default)" - "Let me configure a different path" - "Other" ``` ## Codebase-First Exploration Before asking any question, determine whether the answer ...

Details

Author
tzachbon
Repository
tzachbon/smart-ralph
Created
6 months ago
Last Updated
5 days ago
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

interview-me

Clarify what the user actually wants before specs, plans, or code. Use when an ask is underspecified, when the user says "interview me", "grill me", "stress-test my thinking", or when you would otherwise fill in important product/architecture assumptions silently.

502 Updated today
kdlbs
Code & Development Listed

guided-interview

Conduct a structured, one-question-at-a-time interview to explore a specific topic or decision — each question offers 3-4 concrete, mutually exclusive options plus a free-text path, and later questions adapt to prior answers rather than following a fixed script. Ends with a recap the user confirms before finalizing, and only then produces a synthesized answer or (when the interview clearly feeds downstream work) a written brief. NOT for open-ended ambiguity-surfacing (use socratic-method) or single-fact lookups.

2 Updated today
pantheon-org
AI & Automation Listed

specify

Interview the user to produce a complete, agent-ready specification, then emit what is needed to build it: for a coded feature/agent a phase-scoped build prompt, or for a skill / declarative agent the artifact itself (SKILL.md / AGENT.md). Surfaces every assumption for review, slices the work into a phased plan, and runs a build-readiness (model/effort) check. Use when the user wants to design, specify, plan, or scope a new agent, feature, or skill; turn a vague idea, PRD, or plan into a rigorous spec; write requirements in EARS / SHALL with testable acceptance criteria; produce a build prompt for a coding agent; or amend, advance, review, audit or sweep an existing spec under specs/ for drift and staleness. Reasoning-driven, one question at a time.

2 Updated yesterday
hmbseaotter