RFC/IMPL Document Generator

Convert a user's feature or fix idea into a paired RFC (design document for humans) and IMPL (implementation prompt for AI) in the ai-driven/ directory.

When to Use

• User says "I want to add X feature"
• User describes a bug fix or improvement
• User says "write an RFC for..."
• User gives a short idea that needs formalization before coding

Workflow

Step 1. Receive the User's Description

The user provides a short description of what they want. This could be a sentence, a paragraph, or a reference to a GitHub issue.

Step 2. Assess Information Completeness

Determine if the description is sufficient to write a meaningful RFC and IMPL. Ask yourself:

• Do I understand what problem this solves?
• Do I understand what the user expects to happen after the change?
• Do I understand when/where the user would use this?
• Do I know the scope (what's in, what's out)?

If any of these are unclear, proceed to Step 3. If all are clear, jump to Step 4.

Step 3. Ask Clarifying Questions (if needed)

Use AskUserQuestion to gather missing information. Focus on expected outcomes and user experience, NOT technical implementation details.

Good questions (ask these):

• "What should the user see or experience after this change?"
• "When would someone use this? Can you walk through a concrete scenario?"
• "What problem does this solve for you?"
• "How important is this compared to other features you're considering?"

Bad questions (avoid these):

• "Should this be a new parameter or a config option?"
• "Do you want to use threading or multiprocessing?"
• "What data structure should we use?"
• "Should we cache this in Redis or a file?"

Rules for asking:

• Ask 1-2 questions at a time
• After each answer, re-assess if you have enough information
• If still unclear, ask follow-up questions
• Stop once you can write a coherent RFC and IMPL

Step 4. Generate the Documents

Once you have sufficient information, generate both documents.

#### 4.1 Determine the filename

Use the naming convention from .claude/rules/ai-driven-coding.md:

• If there's a GitHub issue: {issue-number}-{short-name}.md
• If no issue: {prefix}-{short-name}.md (prefix = feat-, fix-, refactor-, perf-, docs-)

short-name should be 2-4 English words, kebab-case.

Before writing, ask the user to confirm the filename if you're unsure about the issue number or prefix.

#### 4.2 Write the RFC

Create ai-driven/rfc/{filename}. Read references/rfc-template.md for the exact structure and copy it as the starting scaffold.

RFC rules:

• Written in the user's natural language
• No concrete code (no diffs, no real implementation)
• No "future work" sections
• Focus on "what" and "why", not "how"

#### 4.3 Write the IMPL

Create ai-driven/impl/{filename}. Read references/impl-template.md for the exact structure and copy it as the starting scaffold.

IMPL rules:

• Written in English (AI-facing)
• Pseudocode only, no real runnable code
• Use "suggested", "recommended", "consider" — leave room for AI judgment
• Must end with a Checking List

Step 5. Present to User

After generating both files:

1. Show the user the two file paths
2. Summarize what was written in 2-3 sentences
3. Ask if they want to review or modify anything before handing off to a Coding Agent

Reference Files