Skip to content

E0005.1: Structure-Agnostic ODD#32

Merged
klappy merged 7 commits into
mainfrom
e0005.1/structure-agnostic
Feb 13, 2026
Merged

E0005.1: Structure-Agnostic ODD#32
klappy merged 7 commits into
mainfrom
e0005.1/structure-agnostic

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented Feb 13, 2026

Summary

  • Removes product lanes directory, archives 16 superseded docs, and preserves valuable artifacts (ADRs, learnings, ledger) in docs/archive/products/
  • Updates ODD Manifesto to v1.2 and System Contract to v3.0.0 — drops lane requirements, adds structure-agnostic framing, documents OddKit as primary epistemic interface
  • Creates D0016 decision record, derivative-works doc, cleans up defunct directories (public/, visual/, infra/, projects/), and fixes cross-references across 21+ operational docs

Test plan

  • Review D0016 decision record for accuracy and completeness
  • Verify odd/manifesto.md v1.2 content matches E0005 values-first framing
  • Verify odd/contract.md v3.0.0 removes lane requirements while preserving three-tier hierarchy
  • Spot-check docs/archive/ for proper frontmatter (archived: true, archived_reason)
  • Run oddkit_search for "products/" — should return zero active docs
  • Run oddkit_catalog — verify count and categories reflect cleanup
  • Check for ghost references: grep for register/nuke/finalize/promote outside archive/decisions

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.md plus docs/derivative-works.md as the new navigation for graduated products.

Lane-era operational docs are moved under docs/archive/ with archived: true metadata, references are retargeted to archived paths, and the Husky pre-commit hook 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.

Automation and others added 7 commits February 12, 2026 23:11
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>
@klappy klappy merged commit 991c70a into main Feb 13, 2026
1 of 3 checks passed
@klappy klappy deleted the e0005.1/structure-agnostic branch February 13, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant