Documentation
This is the curated documentation set of the Bridlewise development floor. It is published as a record, not as a stable specification.
[!WARNING] Bridlewise is a developer preview. It is not production-ready and must not be used with sensitive, proprietary, regulated, or production codebases.
Start here
| Document | What it covers |
|---|---|
| ../README.md | What this repository is, the fresh-clone gate, and the full-suite prerequisites |
| testing.md | The test map, commands, prerequisites, and how to add a test |
| cli.md | The CLI, dev lifecycle, ledger inspection, database keys, and guardian |
| extending.md | Blocks, tools, providers, MCP, embedding, and quality packs |
| shipping.md | Build outputs, verification, release assets, and rollback |
Records
| Collection | Contents |
|---|---|
| decisions/ | The decision records, one file per rule, with status and implementation state (the index is generated) |
| floor/ | The generated development-floor site: atlas, status, promotion contract, and evidence |
| design/ | Selected cockpit, performance, structure, and guard-universe essays |
| Product architecture | The public architecture page |
Some records are historical. They may name the private development branches (testing, master), files that are not in the public snapshot, or measurements taken on a different machine. They are published as evidence of the reasoning, not as a description of the public release topology.
What is not here
- The private trackers, working session state, and round history.
- The private evidence corpus and frozen records.
- The internal process manuals and agent operating instructions.
- A hosted demo or a stable API reference.