IDD Interrogation-Driven Development
Add repositories

Top repositories

    Interrogation-Driven Development

    Build the right thing, one decision at a time.

    Give the agent a spec. It starts building.
    When judgment matters, it asks.
    You answer. The work moves forward.

    Bring IDD to your project

    Start with your coding agent

    IDD's agent tools install from npm. Its hosted questionnaire runs at interrogation.dev.

    Read https://interrogation.dev and help me add IDD to this project. Install the agent tools with `npm install @debonet/idd`, then read the package instructions at the path printed by `node -p "require.resolve('@debonet/idd/INSTRUCTIONS.md')"`. Follow those instructions and use interrogation.dev for the hosted questionnaire.

    Human judgment is the scarce resource. Don't spend it reading walls of text. IDD surfaces the critical decisions—compactly, clearly, and when they matter. Your judgment is captured efficiently, so the work can follow it.

    Why

    Efficient capture of human judgement.

    What

    No walls of text. Just crisp questions.

    How

    Agent asks when it needs, you answer when you can.

    Built for real projects

    The essentials, handled

    ◆

    Secure

    GitHub controls access. Credentials stay protected.

    ⌁

    Access follows the code

    Repository permissions govern who can see and answer.

    ◉

    Public or private

    Works with GitHub projects you can access.

    ↗

    Answer anywhere

    Use a laptop, tablet, or phone.

    ✓

    No server to set up

    Use the hosted questionnaire with your project.

    ⑂

    Branch-aware

    Merge questions and resolve conflicting answers.

    A few decisions an agent might ask

    Real questions. Short answers.

    NOTIFICATIONS · PROJECT SETTINGS

    When should reminders arrive?

    A reminder is due while the user may be asleep. Which default should we use?

    • A At 9 AM in the user's time zone
    • B At the time they choose
    • C No reminders by default

    Answer · B Let each user choose.

    DEPENDENCIES · FORM VALIDATION

    Which schema package should we use?

    Both fit the API. Zod has a larger ecosystem; TypeBox shares schemas with JSON Schema.

    • A Zod
    • B TypeBox
    • C Neither; explain in a note

    Answer · B Keep runtime and API schemas aligned.

    MERGE REVIEW · CONFLICTING ANSWERS

    You chose A. Bob chose B. Which is correct?

    A: Send reminders at 9 AM. Bob's B: Let users choose a time. The branches now share this question.

    • A Keep your answer: 9 AM
    • B Use Bob's answer: user-selected time
    • C Neither; give a new ruling

    Clarification needed The agent applies the chosen ruling to the merged work.

    Optional for teams that want more structure

    Pair IDD with Concord

    IDD works on its own. Concord adds an agentic engineering process that keeps specifications, tests, and implementation aligned.

    [ ]

    Your questionnaires

    Add repositories

    Sign in with GitHub to see questionnaires in your repositories.