E0005.1: Structure-Agnostic ODD#32
Merged
Merged
Conversation
Products/ contained 5 lanes (odd-teaser, agent-skill, fluent-mobile, website, ai-navigation). Lane products graduated into standalone repos (oddkit.klappy.dev, odd.klappy.dev, apocrypha.klappy.dev). Directory conventions superseded by OddKit dynamic epistemic routing. Valuable artifacts preserved in docs/archive/products/: - 10 ADRs and 10 history records (agent-skill) - 7 LEARNINGS.md files across lanes - All ATTEMPT.md, META.json, EVIDENCE.md, PRD.md files (87 total) D0016 documents the decision with evidence including the RITUAL IS MIND-NUMBING learning (70% ritual, 20% actual work). See D0016 for full rationale and supersession list. Co-authored-by: Cursor <cursoragent@cursor.com>
Moved to docs/archive/ with archived frontmatter: - 8 lane-specific appendices (product-lanes, lane-build-layout, etc.) - 3 additional lane-specific docs (ATTEMPTS, attempt-lifecycle, TRUTH_MAP) - 3 klappy.dev-specific infra docs (PREVIEW, CLOUDFLARE_CONFIG, branch-deploys) - PRD.md (lane routing index), slice-contract-sml.md (never operationalized) PRD_TEMPLATE.md relocated to docs/templates/ — portable and structure-agnostic. Lane-specific language cleaned up, URI updated. Co-authored-by: Cursor <cursoragent@cursor.com>
Phase 9 - Removed defunct implementation artifacts: - public/ (197 files - website content mirrors and compiled packs) - fluent-mobile/ (root-level leaked product with node_modules) - visual/ (5 files - design system contracts with no consumers) - projects/ (archived to docs/archive/projects/ - not deleted) - scripts/check-registry.js and klappy-dev-book-export.md Phase 10 - Archived infra/: - infra/ (52 files) moved to docs/archive/infra/ - Pre-commit hooks cleared (referenced defunct scripts) - package.json cleaned: removed all defunct script references - Version bumped to 0.6.0 Also fixes accidental re-addition of products/fluent-mobile/ files that were previously untracked and picked up by git add -A. Co-authored-by: Cursor <cursoragent@cursor.com>
Manifesto v1.2: - Values-First Foundation section added - Structure-agnostic language throughout - Confidence scores updated with evidence-based assessment - Cross-references updated for current repo structure Contract v3.0.0 (breaking): - Lane MUST requirements removed - OddKit epistemic tooling interface documented - Epoch table extended through E0005.1 - Structure-agnostic: canon must be addressable, layout is choice Epoch documentation: - epochs.md: E0005.1 entry added with full context - epoch-5.md: E0005.1 sub-epoch reference added Co-authored-by: Cursor <cursoragent@cursor.com>
… archive klappy-dev docs Phase 7 - Agent docs: - AGENT_KICKOFF.md rewritten: E0002 references removed, OddKit workflow - 6 agent docs updated with conceptual-origin framing and status field Phase 8 - Incoming triage: - _incoming/README.md archived (Epoch 4 migration complete) - agent-fault doc moved to docs/incidents/ (real incident record) Phase 11 - Derivative works: - docs/derivative-works.md created mapping 4 standalone projects (oddkit.klappy.dev, odd.klappy.dev, klappy.dev, apocrypha.klappy.dev) Phase 12 - klappy-dev docs: - website-closure, website-telemetry, poc-prd archived Co-authored-by: Cursor <cursoragent@cursor.com>
odd/ tier (7 files): - progressive-elevation: lanes -> projects, removed products/ paths - appendices/README: archived docs noted, categorized - TEMPLATE: removed products/<lane>/ path - terminology: Lane marked as historical concept - index: contract ref updated to v3.0.0 - alignment-reviews: lanes -> project boundaries - media-as-learning-layer: lanes -> projects canon/ tier (5 edited, 3 flagged for human review): - README: product-lanes.md link removed, meta rule flagged - constraints/README: Lane Self-Containment flagged for review (not deleted) - resonance/ooda-loop: removed archived doc links - resonance/lean-startup: removed archived doc links - meta/TEMPLATE: removed products/<lane>/ path - FLAGGED: weighted-relevance-and-arbitration.md, methods/README.md, verification-and-evidence.md (substantive lane content needs human review) docs/ tier (9 files): - README: navigation updated for post-lane structure - repo-topology: rewritten for current directory layout - online-evidence: lane paths removed - appendices/README: archived docs section added - decisions/README: template paths updated - memory-architecture: archived paths noted - scope-experiments migration: lanes archived note - CONTENT-MAP: updated for derivative-works, archive - Root README: projects -> derivative-works Co-authored-by: Cursor <cursoragent@cursor.com>
…_README - docs/agents/README.md: removed products/agent-skill and public/_compiled paths - docs/TEMPLATE_README.md: replaced lane template example with project template Co-authored-by: Cursor <cursoragent@cursor.com>
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
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
Made with Cursor
Note
Medium Risk
Mostly documentation and workflow-contract changes, but it rewires canonical guidance and deprecates prior commands/paths; reviewers should watch for broken links/tooling expectations and any downstream consumers relying on the old lane/manifest pipeline.
Overview
E0005.1 shifts the repo away from lane-based directory/workflow assumptions to a structure-agnostic model where meaning/routing comes from frontmatter + OddKit tools rather than
products/<lane>/conventions.This updates core orientation docs (README, Canon/Constraints, agent kickoff, appendices/topology/epochs) to remove lane/CLI workflow requirements, add explicit “under review/archived” notices where old lane principles remain referenced, and introduce
docs/decisions/D0016-structure-agnostic-odd.mdplusdocs/derivative-works.mdas the new navigation for graduated products.Lane-era operational docs are moved under
docs/archive/witharchived: truemetadata, references are retargeted to archived paths, and the Huskypre-commithook is pared down to remove defunct generation/staging steps tied to the old pipeline.Written by Cursor Bugbot for commit ff049d6. This will update automatically on new commits. Configure here.