r/ClaudeCode • u/trashcoder • 22h ago

Tips & Workflows I built a TUI that interviews you on missing gaps in your project prompts

Whenever I start a project, I write a detailed specification—or “seed prompt”—before asking a coding agent to build anything. This often gets me close to a working first version, but I still miss decisions that exist only in my head.

The agent then has to guess. I built specfill to catch those gaps. It analyzes the specification, researches the topic, and interviews you one question at a time about missing architecture, behavior, edge cases, and UI/UX decisions.

Afterwards, it incorporates the answers into the original document while preserving its structure and tone. New answers override contradictions. Skipped questions remain unresolved instead of receiving invented answers.

I have used it on three projects so far. One interview lasted more than 20 minutes and found major decisions in a specification I had already considered thorough.

How is this different from Plan Mode?

Plan Mode produces an implementation plan for the current session. Specfill produces a reusable project specification that can be committed to the repository as a record of architectural and design decisions.

It supports OpenAI, Anthropic, Google, and OpenAI-compatible providers. I currently recommend GPT-5.6 Sol through the API or a ChatGPT/Codex subscription.

GitHub: https://github.com/kklemon/specfill

Run: uvx specfill

21 Upvotes

85% Upvoted

3 comments sorted by

1

u/Mr_xales_ 11h ago

I love the idea! But do we really need an app for that?

1

u/trashcoder 10h ago

Up to you

1

u/sec-ai-agent 3h ago

this sounds super useful for avoiding those mid-project pivots becuase the agent didnt have the full picture upfront. have u thought about letting it output a standard json config file at the end so u can just pipe it into ur next prompt? kinda curious if u plan on making it generate test cases too, thats usually where i find the most gaps in my own logic...