Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/oddkit/ABOUT.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,14 @@
---
uri: oddkit://about
title: "About oddkit"
audience: docs
exposure: nav
tier: 1
voice: neutral
stability: stable
tags: ["oddkit", "odd", "definition", "outcomes-driven-development", "what-is-odd", "about", "orientation"]
---

# About oddkit

> **ODD** = **Outcomes-Driven Development** — see [/odd/README.md](/odd/README.md) for the full philosophy.
Expand Down
6 changes: 4 additions & 2 deletions docs/oddkit/SYSTEM-MAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,16 @@ exposure: nav
tier: 2
voice: neutral
stability: stable
tags: ["oddkit", "orchestrator", "librarian", "validation", "arbitration"]
tags: ["oddkit", "odd", "outcomes-driven-development", "orchestrator", "librarian", "validation", "arbitration"]
---

# Oddkit System Map

> A practical guide for understanding oddkit behavior, outcomes, and next actions.

This document explains **what oddkit does**, **how to interpret its outputs**, and **what actions are expected next**.
**ODD** = **Outcomes-Driven Development** — an approach to building software that prioritizes real-world results over artifacts. See [/odd/README.md](/odd/README.md) for the full philosophy.

This document explains **what oddkit does**, **how to interpret its outputs**, and **what actions are expected next**.
It is not a design doc, tutorial, or philosophy statement.

---
Expand Down
6 changes: 3 additions & 3 deletions odd/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
uri: klappy://public/odd
title: "ODD Manifesto — Public"
title: "What is ODD? — Outcomes-Driven Development"
audience: public
exposure: nav
tier: 0
tier: 1
voice: neutral
stability: semi_stable
tags: ["odd", "public", "overview"]
tags: ["odd", "definition", "outcomes-driven-development", "what-is-odd", "methodology", "philosophy", "public", "overview"]
relevance: routing
execution_posture: routing
assets: {"practice_video":"/assets/odd/odd-in-practice.mp4","misconception_image":"/assets/odd/odd-is-not-a-framework.png","deep_dive_audio":"/assets/odd/why-evidence-beats-confidence.m4a"}
Expand Down
5 changes: 3 additions & 2 deletions odd/index.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
---
uri: klappy://odd
title: "Outcomes-Driven Development"
title: "Outcomes-Driven Development (ODD)"
subtitle: "ODD = Outcomes-Driven Development — the philosophical and operational foundation for this repository."
audience: canon
exposure: nav
tier: 1
voice: neutral
stability: stable
tags: ["odd", "index"]
tags: ["odd", "index", "definition", "outcomes-driven-development", "what-is-odd", "methodology"]
relevance: routing
execution_posture: routing
---
Expand Down
2 changes: 1 addition & 1 deletion odd/manifesto.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ exposure: nav
tier: 2
voice: neutral
stability: stable
tags: ["odd", "philosophy"]
tags: ["odd", "philosophy", "outcomes-driven-development", "manifesto", "governance", "definition"]
relevance: background
execution_posture: exploratory
---
Expand Down
2 changes: 1 addition & 1 deletion odd/orientation-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ exposure: nav
tier: 3
voice: neutral
stability: semi_stable
tags: ["odd", "orientation", "mental-model"]
tags: ["odd", "orientation", "mental-model", "outcomes-driven-development", "hierarchy"]
relevance: supporting
execution_posture: operational
---
Expand Down
16 changes: 15 additions & 1 deletion odd/terminology.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ exposure: nav
tier: 1
voice: neutral
stability: evolving
tags: ["odd", "terminology", "disambiguation", "boundary"]
tags: ["odd", "terminology", "disambiguation", "boundary", "definition", "outcomes-driven-development", "glossary"]
relevance: supporting
execution_posture: operational
---
Expand Down Expand Up @@ -57,6 +57,20 @@ If terminology lived under `canon/`, language would appear post hoc. ODD would l

## Core Terms

### ODD (Outcomes-Driven Development)

**ODD meaning:** Outcomes-Driven Development — an approach to building software that prioritizes real-world results over artifacts. In an AI-accelerated environment, the limiting factor is no longer production speed; it is clarity of intent, quality of verification, and the ability to choose among outcomes. ODD makes those constraints explicit.

**Not:** A framework, a fixed workflow, or a claim that outcomes can be fully predicted.

**Core thesis:** The primary job of development is not writing code. It is defining outcomes, enforcing constraints, and verifying reality. AI accelerates execution; governance preserves trust.

**Test:** Are decisions governed by verifiable outcomes, or by artifacts and activity?

**See:** [/odd/README.md](/odd/README.md) for the public introduction, [/odd/manifesto.md](/odd/manifesto.md) for the extended operational framework.

---

### Outcome

**ODD meaning:** A verifiable state of reality that can be demonstrated, not just described.
Expand Down
Loading