This repository is a working surface for ideas, experiments, and reference documents about how software is designed and built in an AI-accelerated world.
It is intentionally not a framework, product, or SDK.
It is a public record of thinking, constraints, and proofs of concept that evolve over time.
If you are new:
- oddkit is not an agent — it is a librarian and validator used by agents
- It exists to prevent hallucination, misalignment, and "done without proof"
Read this first:
→ docs/WHY.md
→ docs/CONTENT-MAP.md — Comprehensive index of ALL content (including apocrypha)
- A portfolio of projects and proofs of concept
- A canon of design principles, constraints, and verification standards
- A place to work in the open, with assumptions and tradeoffs made explicit
- A reference for how I think about AI-assisted development, architecture, and long-lived systems
Much of the content here exists to reduce repeated reasoning and to make decision-making easier to inspect and challenge.
- Not a step-by-step tutorial
- Not a prescriptive workflow
- Not a prompt collection
- Not a promise of stability or completeness
Most documents are orientation, not instruction. They describe how decisions are reasoned about, not rules that must be followed.
Start with ODD (Outcomes-Driven Development) — the core philosophy that shapes everything here.
If that resonates, the Canon contains the principles, constraints, and verification standards that guide decisions.
If you want to see the philosophy applied, browse the Derivative Works documentation.
There is no required order. Follow your curiosity.
/docs/appendices/WHAT_THIS_REPO_IS_NOT.md— what this repository is intentionally not/docs/derivative-works.md— how derivative products relate to ODD
The Canon is a curated set of documents that capture:
- assumptions and constraints
- decision heuristics
- definitions of completion
- evidence and verification standards
The Canon exists for clarity, not control.
It does not execute anything by itself and is intentionally separated from tooling or automation.
The Canon uses pack-level versioning with a single changelog:
/canon/CHANGELOG.md— record of changes
Individual files are not versioned independently to avoid unnecessary ceremony.
All content in this repository is released under the MIT License.
Reuse is encouraged.
If you're new and want a concrete path, here's a reasonable order:
-
About — context and trust surface
/about/bio.md/about/credibility.md/about/faq.md
-
ODD (Outcomes-Driven Development) — the core philosophy
/odd/README.md(public-facing)/odd/manifesto.md(extended)
-
Canon — how decisions and verification are shaped
/canon/index.md(orientation)- Supporting documents on constraints, decision rules, evidence, and verification
-
Derivative Works — how products relate to ODD (
/docs/derivative-works.md)
This repository is organized around a three-tier hierarchy:
/odd/— Universal ODD philosophy (timeless, product-agnostic)/canon/— Program constraints (shared governance)/docs/— Implementation details (how we do it here)/about/— Author context and credibility
This repository is active and evolving.
Some documents are stable; others are intentionally exploratory.
Where possible, documents label their stability and confidence level.
Feedback, questions, and challenges are welcome.
This repository is about preserving intent without freezing execution.
The goal is better outcomes, not perfect artifacts.