OddKit docs audit: 7 new tool docs, updated prompts, IMPL status, consistency fixes#33
Closed
klappy wants to merge 1 commit into
Closed
OddKit docs audit: 7 new tool docs, updated prompts, IMPL status, consistency fixes#33klappy wants to merge 1 commit into
klappy wants to merge 1 commit into
Conversation
…e drift fixes Gap 1: Created tool docs for search, get, catalog, validate, preflight, version, cleanup_storage - each with oddkit:// URIs, observed response shapes from live v0.14.0, behavioral rules, and canon references. Gap 2: Updated epistemic guide prompt to document all 12 tools in 4 clusters (discovery, epistemic core, implementation bookends, maintenance). Gap 3: Added file path alongside odd:// URI in epistemic-instructions.md. Gap 4: Marked IMPL-A (explain) and IMPL-B (mode headers) as superseded. Marked IMPL-content-addressed-caching as implemented. Gap 5: Updated modes.md with E0005 epoch, values-first axiom reference, and current tool names replacing historical Librarian/Promotions refs. Gap 6: Updated input schemas and response shapes in orient, challenge, gate, encode docs to match live observed behavior from oddkit v0.14.0. Co-authored-by: Cursor <cursoragent@cursor.com>
Deploying klappy-dev-agent-skill with
|
| Latest commit: |
3e0fd7c
|
| Status: | 🚫 Build failed. |
Deploying klappy-dev-website with
|
| Latest commit: |
3e0fd7c
|
| Status: | 🚫 Build failed. |
6 tasks
klappy
pushed a commit
that referenced
this pull request
May 5, 2026
…decision) Records the operator's acceptance decision made 2026-05-05 during the recurrence-escalation conversation immediately following verification that agent-messaging-service PR #33 (D0023, 2026-05-04) shipped the hosted /mcp wrapper as 1003 lines of handrolled JSON-RPC dispatch with no MCP SDK dependency — the sixth occurrence of the pattern, and the second within AMS itself. Per docs/promotions/README.md status vocabulary: - proposed: evidence gathered, awaiting review - accepted: approved for promotion to Canon - executed: canon has been updated with backlink to this doc This commit moves proposed -> accepted only. Per klappy.dev/AGENTS.md 'Canon is read-only', the three coordinated canon edits this promotion proposes (Bide as 6th B in canon/methods/borrow-bend-break-beget-build, canon/constraints/borrow-evaluation-before-implementation, bootstrap bullet in canon/bootstrap/model-operating-contract) remain operator- pending. Acceptance does not imply execution; the Execution Record section is left for operator commits to fill. Per docs/promotions/README.md 'Why Humans, Not Agents': agents do not decide what becomes canon. The decision was made by the operator; this commit records it.
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
1 participant
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.
Summary
Test plan
Depends on: #32 (E0005.1) — merge that first, then rebase/merge this.
Made with Cursor
Note
Low Risk
Docs-only changes; main risk is confusion if any documented tool schemas/response shapes don’t exactly match the live MCP server behavior.
Overview
Adds operator-facing docs for 7 previously undocumented OddKit tools (discovery, implementation bookends, and maintenance), including input schemas and documented/observed response shapes.
Updates the
epistemic-guideprompt to acknowledge the full 12-tool surface and clusters beyond the four core epistemic tools, and refreshes existing tool docs (orient,challenge,gate,encode) to match the current API shape (notablyinput+ optionalcanon_url) and observed responses.Marks older implementation instruction sets as superseded (
IMPL-A,IMPL-B) and the content-addressed caching migration as implemented, plus small consistency updates to mode/contract references inmodes.mdandepistemic-instructions.md.Written by Cursor Bugbot for commit 3e0fd7c. This will update automatically on new commits. Configure here.