Sources and status

This documentation site is an overview, not the project’s only source of truth.

What each source is for

• This mdBook (docs/) gives a reader-friendly explanation of the project’s purpose and research basis.
• The OpenSpec change specs are the main detailed design documents for the proposed tool as it is currently decomposed.
• Tracked research notes capture the reasoning and source synthesis behind the project’s design, including the archived monolithic draft.
• OpenSpec is the structured specification workspace where the monolithic draft is being decomposed into capability-focused specifications.

Current project status

dont is still a specification-first project. The repository contains design drafts, capability splits, and research artifacts, not a released implementation.

That means this book should be read as:

• an introduction to the project
• a guide to why the tool is designed this way
• a pointer to the more detailed project artifacts

How to read the project

If you are new here, read in this order:

1. this book for the overview
2. openspec/changes/*/specs/ for the detailed capability-by-capability design
3. .wai/projects/dont/research/ for the justification, research trail, and archived monolithic draft
4. openspec/ for the broader structured specification workspace

Important distinction

The mdBook explains the project in narrative form.

The OpenSpec change specs and related artifacts define the project more precisely.

The .wai research artifacts explain why those design choices were made.