IDD · Quick Start

Write applications, not source code.

IDD is a repo-native contract for describing software in natural language. You and Copilot maintain the intent; the model maintains the code. It is dramatically more productive than hand-writing every line, and it gets better every time the model does.

Install

curl -fsSL https://raw.githubusercontent.com/dan1hc/idd/main/install.sh | bash

Flow

  1. Install

    Bootstraps the operating contract and the IDD artifact set.

  2. Bootstrap

    Run /idd-init for a new repo, or /idd-discover against an existing one. Copilot seeds architecture, conventions, and the first wiki entries.

  3. Think in the wiki

    You and Copilot flesh out a concept, subsystem, or feature as one or more wiki entries. This is the design surface. No code yet.

  4. Derive feature specs

    Run /idd-feature. The wiki entry holds the concept; each feature spec is one bounded change to it. A wiki entry can spawn many feature specs over time — initial build, additions, refactors.

  5. Execute

    Copilot works through specs sequentially under Red / Green TDD, then writes back so prose follows source.

  6. Review

    Run /idd-lint on demand to sweep for drift, duplicates, orphans, and broken anchors.

Footprint

.github/ ├── copilot-instructions.md ├── prompts/ │ ├── idd-discover.prompt.md │ ├── idd-init.prompt.md │ ├── idd-feature.prompt.md │ └── idd-lint.prompt.md └── idd/ ├── architecture.md ├── conventions.md ├── learned.md ├── wiki/ └── features/