Skip to content

v1.3.0 — initial public release

Choose a tag to compare

View all tags
@jqbit jqbit released this 25 May 18:25
· 9 commits to main since this release
v1.3.0
537f802

First public release of yorient — a Markdown-only orientation layer for AI coding agents.

yorient drops a canonical YORIENT.md at the repo/vault root and adds thin managed pointer blocks to README.md, AGENTS.md, CLAUDE.md, and GEMINI.md so every agent (Claude Code, Codex, Cursor, Hermes, Gemini/Antigravity, OpenCode, Pi, Factory/Droid, GitHub Copilot) reads from the same source of truth.

Highlights

  • Explicit managed-block algorithm. Idempotent insert/replace/de-duplicate rules. Re-running the skill on an unchanged file is byte-identical.
  • Versioned block markers (v=1). Future schema upgrades won't trample user content. Legacy unversioned blocks are detected and upgraded in place.
  • Worked example. A fully filled-in YORIENT.md for a hypothetical Node monorepo as a calibration target.
  • Ecosystem cheatsheet. Manifest files, layout conventions, and "read first" hints for Node/TS, Python, Rust, Go, polyglot monorepos, docs sites, and Obsidian vaults.
  • Drift check. Five-step verification recipe to keep the map honest as the repo evolves.
  • Smoke test. Per-agent installation verification.
  • Measurable subagent fan-out. File-count buckets tied to git ls-files | wc -l, with explicit token-budget and concurrency-limit guidance.

Install

Clone and copy the folder into each agent's skill tree — see README.md for the per-agent paths.

Migration from orient-map / ORIENT.md

references/rebrand-and-pointer-blocks.md includes detection commands, a three-branch decision tree, and an explicit string replacement map.

Full changelog

See CHANGELOG.md.

Assets 2
Loading