Expose ODD definition in navigation, indexing, and metadata#14
Merged
Conversation
The primary ODD definition (odd/README.md) was tier 0, making it invisible to all compiled packs via FR-2 exclusion. Agents consuming packs could not find what "ODD" means. Multiple entry points also lacked searchable metadata. Key fixes: - odd/README.md: tier 0→1, title now "What is ODD?", added definition/ methodology/philosophy tags - odd/terminology.md: added "ODD (Outcomes-Driven Development)" as the first core term — previously defined every term except ODD itself - docs/oddkit/ABOUT.md: added full frontmatter (had none — invisible to all indexing) - docs/oddkit/SYSTEM-MAP.md: added ODD acronym expansion and tags - odd/index.md: added subtitle, definition/methodology tags - odd/manifesto.md: added outcomes-driven-development/definition tags - odd/orientation-map.md: added outcomes-driven-development tag Rebuilt docs index and synced content. https://claude.ai/code/session_01GnDQtvovXdJotMSSVZyBRT
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.
| "authority_inferred": "governing", | ||
| "uri": "klappy://odd", | ||
| "title": "Outcomes-Driven Development", | ||
| "title": "Outcomes-Driven Development (ODD)", |
There was a problem hiding this comment.
Index missing subtitle from odd/index.md frontmatter
Medium Severity
The subtitle field was added to odd/index.md frontmatter with value "ODD = Outcomes-Driven Development — the philosophical and operational foundation for this repository." but the compiled index at public/_compiled/index/docs.json shows "subtitle": null for this document. The index was regenerated (title and tags were updated), but the subtitle wasn't captured. This directly undermines the PR's goal of making ODD visible to indexing and searchable by agents.
Additional Locations (1)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The primary ODD definition (odd/README.md) was tier 0, making it invisible
to all compiled packs via FR-2 exclusion. Agents consuming packs could not
find what "ODD" means. Multiple entry points also lacked searchable metadata.
Key fixes:
methodology/philosophy tags
first core term — previously defined every term except ODD itself
all indexing)
Rebuilt docs index and synced content.
https://claude.ai/code/session_01GnDQtvovXdJotMSSVZyBRT
Note
Low Risk
Documentation-only changes plus regenerated compiled indices; primary risk is navigation/indexing drift (URIs, tiers, tags) if downstream tooling assumes previous metadata.
Overview
Makes the ODD definition and related orientation docs discoverable to agents by promoting
/odd/README.mdfrom tier 0 to tier 1, renaming it to “What is ODD?”, and adding consistentoutcomes-driven-development/definition tagging acrossodd/*(including adding an explicitODDterm inodd/terminology.md).Improves oddkit entry-point indexing by adding full frontmatter to
docs/oddkit/ABOUT.mdand adding an ODD acronym expansion + tags todocs/oddkit/SYSTEM-MAP.md, plus introduces a newdocs/CONTENT-MAP.mdfor comprehensive repo navigation.Promotes Epistemic Surface Extraction into Canon via new
canon/epistemic-surface-extraction.md, updatescanon/verification-and-evidence.mdto reference it, marks the apocrypha source doc as promoted/archived, and bumps compiled/public pack metadata + indices (pack.json,manifest.json,docs.json,canon/CHANGELOG.md).Written by Cursor Bugbot for commit 61b711a. This will update automatically on new commits. Configure here.