Skip to content

Add writings directory with first two essays#35

Merged
klappy merged 1 commit into
mainfrom
writings/ship-essays
Feb 13, 2026
Merged

Add writings directory with first two essays#35
klappy merged 1 commit into
mainfrom
writings/ship-essays

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented Feb 13, 2026

Summary

  • Introduces writings/ as a new content directory alongside canon/, odd/, and docs/
  • Adds The Most Expensive Problem (essay) and The Parallel Architecture (appendix) with full frontmatter
  • All internal cross-references use klappy://writings/* URIs for oddkit resolution

What is writings/?

The authors voice -- essays, appendices, articles, posts. These are not canon, not methodology, not documentation. They are indexed and managed by the knowledge base but they are writing, not system output.

Documents

File Type Tags
writings/the-most-expensive-problem.md essay writings, essay, epistemics, knowledge-transfer, ai, verification, epistemic-os
writings/the-parallel-architecture.md appendix writings, appendix, epistemics, theology, biblical-worldview, knowledge-transfer, ai, apocrypha

Frontmatter includes

  • Discovery metadata (hook, description, slug)
  • Social graph (og_*, twitter_*)
  • Relationships (derives_from, related, parent)
  • Type system (type: essay|appendix, public: true)

Depends on

oddkit PR: klappy/oddkit feature/include-metadata (adds writings/ to index patterns so these docs are discoverable)

Test plan

  • Verify oddkit_search with tag writings returns both documents
  • Verify oddkit_get with klappy://writings/the-most-expensive-problem resolves
  • Verify klappy://writings/* cross-references in both documents are correct

Made with Cursor


Note

Low Risk
Content-only addition (new markdown documents) with no code or runtime behavior changes; main risk is navigation/indexing expectations if writings/ isn’t yet included in downstream tooling.

Overview
Adds a new writings/ content area with two public, cross-linked longform documents: The Most Expensive Problem (essay) and The Parallel Architecture (appendix).

Both files include rich frontmatter for discovery/social metadata and relationship links via klappy://writings/* URIs (including derives_from references into the canon), enabling them to be indexed and navigated like existing docs content.

Written by Cursor Bugbot for commit e53282d. This will update automatically on new commits. Configure here.

- writings/the-most-expensive-problem.md (essay)
- writings/the-parallel-architecture.md (appendix)

New content directory alongside canon/, odd/, and docs/ for the
authors voice -- essays, appendices, articles. Indexed by oddkit
but not canon, not methodology, not documentation.

Both documents include full frontmatter with discovery metadata,
social graph fields, and klappy:// URI cross-references.

Co-authored-by: Cursor <cursoragent@cursor.com>
@klappy klappy merged commit 5829b18 into main Feb 13, 2026
1 check passed
@klappy klappy deleted the writings/ship-essays branch February 13, 2026 19:13
klappy pushed a commit that referenced this pull request Feb 14, 2026
…timony; bump changelog to 0.32.0

Four new documents articulating the epistemic OS concept from a voice memo session:
- canon/values/shared-values-as-trust-proxy.md (Tier 1, draft)
- docs/architecture/epistemic-os-layers.md (Tier 2, draft)
- odd/appendices/cognitive-saturation-threshold.md (Tier 2, draft)
- docs/evidence/testimony-2026-02-13.md (Tier 2, final)

All documents cross-linked via complements metadata. Changelog bumped
to 0.32.0 covering PRs #29-#35 and this commit.

https://claude.ai/code/session_01PLTKACaCHAV239dounD4AS
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