Skip to content

feat: add Semantic Engineering docs section#80

Draft
jonathanprozzi wants to merge 2 commits intomainfrom
jp/eng-10545-docs-refinement-for-agentic-developer-quickstartdeveloper
Draft

feat: add Semantic Engineering docs section#80
jonathanprozzi wants to merge 2 commits intomainfrom
jp/eng-10545-docs-refinement-for-agentic-developer-quickstartdeveloper

Conversation

@jonathanprozzi
Copy link
Copy Markdown
Member

Summary

Adds a new Semantic Engineering section to the docs with three pages, addressing ENG-10545:

  • Overview — The three-layer model (identity onchain, context offchain, predicates connect)
  • Data Structures — How to format atom data using Schema.org classifications + the enrichment system
  • Predicates — Canonical predicate catalog, the I atom pattern, three classes of triples, common mistakes

Content distilled from the intuition-data-structures repo and the April 1 predicates workshop. Designed to be hackathon-builder-friendly while linking to the full repo for deep dives.

Open questions for team review

  • Naming: Is "Semantic Engineering" the right section name for builders? Could cause confusion vs existing Primitives section — mitigated with cross-reference callouts
  • Scope: Currently curated highlights, not the full 100-predicate catalog. Right balance?
  • Sidebar position: Currently at position 4 (after Intuition Concepts). Should it be closer to Quick Start?

Test plan

  • npm run build passes with no new broken links
  • Link validator passes on all new files
  • Spell check passes (added domain terms to cspell.json)
  • Team review of naming, scope, and positioning
  • Manual review of rendered pages on preview deploy

🤖 Generated with Claude Code

Adds three-page section covering how to structure atoms, use the
enrichment system, and connect atoms with enshrined predicates.
Content distilled from the intuition-data-structures repo and
predicates workshop decisions for hackathon builder accessibility.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@linear
Copy link
Copy Markdown

linear bot commented Apr 2, 2026

Place section after Tutorials (pos 7) and bump GraphQL API to pos 8.
Add 🧬 emoji to match sidebar icon convention.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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