Prepare odd-teaser lane for build-ready state#7
Merged
Conversation
Add standard lane files to make odd-teaser ready for implementation attempts: - KICKOFF.md: Attempt starting instructions with authority boundaries - HISTORY.md: Version tracking with v1.1 attempt learnings - behavior.md: LLM behavior contract (referenced in PRD but missing) - src/README.md: Implementation source placeholder - README.md: Enhanced with complete lane structure Key decision documented: odd-teaser MUST use LLM-based artifact detection (odd-scribe style) instead of manual categorization UI. https://claude.ai/code/session_01Hgj9vrpBzfwEsvUW9xtpgM
Makes the comprehensive kickoff instructions easier to find by pointing to the lane-root KICKOFF.md with clear reading order. https://claude.ai/code/session_01Hgj9vrpBzfwEsvUW9xtpgM
klappy
added a commit
that referenced
this pull request
Apr 19, 2026
Live validation of telemetry_policy canary (klappy/oddkit#106) against prod surfaced three gaps the original contract didn't name explicitly enough: 1. Response envelope shape is part of the contract. A tool that returns {action, result} but omits server_time/assistant_text/debug breaks the time-discipline system even if governance_source is present. Added as Runtime Invariant #3. 2. canon_url parameter must be in the Zod schema, not just documented as a concept. MCP silently strips unknown parameters. The canary shipped with schema={} and canon_url was unreachable. Added as Runtime Invariant #4. 3. Live-smoke against the MCP endpoint is a ship-blocker, not a nice-to-have. Internal parser tests passed while the tool shipped with broken envelope and silent param stripping. Added as Runtime Invariant #7, template referenced. Refactor Implications section expanded to a 7-point checklist and acknowledges the canary's partial completion + follow-up PR as the first documented test of the contract. Follow-up PR that closes the canary gaps: klappy/oddkit#108.
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.
Summary
∙ Add standard lane files to make odd-teaser ready for implementation attempts
∙ Create comprehensive KICKOFF.md with authority boundaries and sandbox rules
∙ Add HISTORY.md documenting v1.1 attempt learnings
∙ Create behavior.md (LLM behavior contract referenced in PRD but was missing)
∙ Update prompts/ATTEMPT_KICKOFF.md to point to lane-root KICKOFF.md
Note
Low Risk
Low risk: this PR only adds/updates documentation and prompt pointers; it doesn’t change runtime code paths, data handling, or build behavior.
Overview
Prepares the
odd-teaserlane for implementation attempts by adding missing lane docs and tightening contributor/agent guidance.Adds new lane-root docs:
KICKOFF.md(sandbox/authority boundaries and attempt workflow),HISTORY.md(PRD version tracking + v1.1 learnings/decision), andbehavior.md(LLM behavior contract referenced by the PRD).Updates
README.mdto include structured lane overview/links and clarifies non-goals, and updatesprompts/ATTEMPT_KICKOFF.mdto direct attempts to the lane-root kickoff. Addssrc/README.mdto document promoted-source vs attempt-sandbox expectations and build command.Written by Cursor Bugbot for commit 37683af. This will update automatically on new commits. Configure here.