Rebrand yorient to orient (v1.5.0)

Rename YORIENT.md to ORIENT.md, switch managed blocks to ORIENT/ORIENT-README,
update skill slug and jqbit/orient URLs, and document legacy YORIENT migration.

Author: jqbit

.github/CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to yorient
+# Contributing to orient
 
-Thanks for your interest. `yorient` is small and focused: a Markdown-only orientation skill for AI coding agents. Most useful contributions fall into a few shapes.
+Thanks for your interest. `orient` is small and focused: a Markdown-only orientation skill for AI coding agents. Most useful contributions fall into a few shapes.
 
 ## Where to start
 
@@ -14,9 +14,9 @@ Thanks for your interest. `yorient` is small and focused: a Markdown-only orient
 The canonical files are:
 
 - `SKILL.md` — the skill body. Frontmatter `name:` and `version:` matter for ecosystem compatibility.
-- `references/` — `rebrand-and-pointer-blocks.md`, `example-YORIENT.md`, `by-ecosystem.md`. Reference material the skill body links to.
+- `references/` — `rebrand-and-pointer-blocks.md`, `example-ORIENT.md`, `by-ecosystem.md`. Reference material the skill body links to.
 - `README.md`, `CHANGELOG.md`, `LICENSE` — repo-only. Not synced to agent skill installs.
-- `YORIENT.md`, `AGENTS.md`, `CLAUDE.md` — the skill applied to its own repo (dogfood).
+- `ORIENT.md`, `AGENTS.md`, `CLAUDE.md` — the skill applied to its own repo (dogfood).
 
 ## Local checks before opening a PR
 

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -8,11 +8,11 @@ body:
         Thanks for taking the time to file a bug. A few sentences plus a pointer to the exact file and line is usually enough.
 
   - type: input
-    id: yorient-version
+    id: orient-version
     attributes:
-      label: yorient version
+      label: orient version
       description: From `SKILL.md` frontmatter `version:` field, or the GitHub release tag you cloned.
-      placeholder: "v1.4.0"
+      placeholder: "v1.5.0"
     validations:
       required: true
 

.github/SECURITY.md

@@ -1,16 +1,16 @@
 # Security Policy
 
-`yorient` is a documentation-only skill: Markdown files plus a small managed-block algorithm specification. It does not ship executable code, does not invoke remote services, and does not handle credentials. The realistic threat surface is therefore narrow:
+`orient` is a documentation-only skill: Markdown files plus a small managed-block algorithm specification. It does not ship executable code, does not invoke remote services, and does not handle credentials. The realistic threat surface is therefore narrow:
 
-- **Markdown injection** into a downstream agent's context (e.g., a `YORIENT.md` crafted to mislead an agent into a harmful action). Mitigated upstream by the agents that read the file; report cases where the skill's recommended shape makes injection materially easier.
-- **Supply-chain confusion** — a typosquatted clone of this repo or a malicious mirror under the `yorient` name.
+- **Markdown injection** into a downstream agent's context (e.g., a `ORIENT.md` crafted to mislead an agent into a harmful action). Mitigated upstream by the agents that read the file; report cases where the skill's recommended shape makes injection materially easier.
+- **Supply-chain confusion** — a typosquatted clone of this repo or a malicious mirror under the `orient` name.
 - **Documented attack patterns** in the skill body (e.g., recommending an unsafe command).
 
 ## Reporting a vulnerability
 
 For anything sensitive, please **do not** file a public issue. Use one of:
 
-1. **GitHub private security advisory** — open at <https://github.com/jqbit/yorient/security/advisories/new> (preferred).
+1. **GitHub private security advisory** — open at <https://github.com/jqbit/orient/security/advisories/new> (preferred).
 2. **Email** the maintainer via the address on the GitHub profile at <https://github.com/jqbit>.
 
 Include:
@@ -29,5 +29,5 @@ The latest `v1.x` release receives fixes. Older majors are not supported.
 ## Out of scope
 
 - Reports about an agent ecosystem's own behavior unrelated to this skill.
-- Reports about user-authored `YORIENT.md` content in third-party repos.
+- Reports about user-authored `ORIENT.md` content in third-party repos.
 - Reports about commercial support, downtime, or service-level concerns — this is an unstaffed open-source project.

AGENTS.md

@@ -1,11 +1,11 @@
-<!-- YORIENT:BEGIN v=1 -->
-# Yorient Map
+<!-- ORIENT:BEGIN v=1 -->
+# Orient Map
 
-This project uses `YORIENT.md` as the canonical repo/vault map.
+This project uses `ORIENT.md` as the canonical repo/vault map.
 
 Before broad file search or structural edits:
-1. Read `YORIENT.md`.
-2. Check for a nearer nested `YORIENT.md` or `AGENTS.md` in the target subtree.
+1. Read `ORIENT.md`.
+2. Check for a nearer nested `ORIENT.md` or `AGENTS.md` in the target subtree.
 3. Use the routing map there to choose files and commands.
-4. Keep this adapter thin; update `YORIENT.md` when structure changes.
-<!-- YORIENT:END v=1 -->
+4. Keep this adapter thin; update `ORIENT.md` when structure changes.
+<!-- ORIENT:END v=1 -->

CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
-All notable changes to `yorient` are documented here. This project follows [Semantic Versioning](https://semver.org/).
+All notable changes to `orient` are documented here. This project follows [Semantic Versioning](https://semver.org/).
+
+## [1.5.0] — 2026-06-05
+
+Full rebrand from `yorient` / `YORIENT.md` to `orient` / `ORIENT.md`. Canonical managed-block anchors are `ORIENT` and `ORIENT-README`; legacy `YORIENT` families are detected and upgraded in place. GitHub URLs point at `jqbit/orient`.
 
 ## [1.4.0] — 2026-05-25
 
@@ -15,17 +19,17 @@ Post-release audit pass. Three parallel review tracks (content correctness, repo
 
 ### Added
 
-- **[`agents.md`](https://agents.md) citation.** A new paragraph at the top of `## Agent Adapter Targets` names the convention, links the spec, and clarifies that yorient layers atop `AGENTS.md` rather than replacing it.
+- **[`agents.md`](https://agents.md) citation.** A new paragraph at the top of `## Agent Adapter Targets` names the convention, links the spec, and clarifies that orient layers atop `AGENTS.md` rather than replacing it.
 - **Community scaffolding (`.github/`).** `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` (Contributor Covenant 2.1), `SECURITY.md`, `ISSUE_TEMPLATE/bug-report.yml`, `ISSUE_TEMPLATE/feature-request.yml`, `PULL_REQUEST_TEMPLATE.md`. Community-health score expected to jump from 42% → ≥80%.
-- **Dogfood.** This repo now applies yorient to itself: a root `YORIENT.md` map, minimal `AGENTS.md` and `CLAUDE.md` adapter files (just the managed block), and a `YORIENT-README:BEGIN v=1` block appended to `README.md`. The repo is its own live demo.
+- **Dogfood.** This repo now applies orient to itself: a root `ORIENT.md` map, minimal `AGENTS.md` and `CLAUDE.md` adapter files (just the managed block), and a `ORIENT-README:BEGIN v=1` block appended to `README.md`. The repo is its own live demo.
 - **CI safety net.** `.github/workflows/checks.yml` runs `markdownlint-cli2` plus `lychee` link checks (internal hard-fail, external warn-only) on every push and pull request. `.markdownlint.json` provides a permissive baseline tuned to this repo's prose-and-table style.
 - **`.gitattributes`.** Normalizes line endings (`text=auto eol=lf`), marks `*.md` files as `linguist-language=Markdown` so GitHub's language bar counts them correctly.
 - **Branch protection.** `main` now requires linear history; force-pushes and deletions blocked.
 
 ### Fixed
 
-- **Nested fence in `references/example-YORIENT.md`.** The outer wrapper now uses 4 backticks so it correctly contains the inner 3-backtick `text` fences (CommonMark spec).
-- **README managed-block placement** added per the dogfood pass, demonstrating the YORIENT-README block on the repo's own README.
+- **Nested fence in `references/example-ORIENT.md`.** The outer wrapper now uses 4 backticks so it correctly contains the inner 3-backtick `text` fences (CommonMark spec).
+- **README managed-block placement** added per the dogfood pass, demonstrating the ORIENT-README block on the repo's own README.
 
 ### Deferred to v1.5+
 
@@ -38,13 +42,13 @@ Initial public release. Closes 10 gaps surfaced in an internal audit of the v1.2
 ### Added
 
 - **Managed block algorithm** (`SKILL.md § Managed Block Algorithm`). Explicit, idempotent rule for inserting, replacing, and de-duplicating pointer blocks. Re-running the skill on an unchanged file is now guaranteed byte-identical.
-- **Versioned block markers.** All managed blocks now use `<!-- YORIENT:BEGIN v=1 -->` / `<!-- YORIENT:END v=1 -->` (and `YORIENT-README:BEGIN v=1` / `YORIENT-README:END v=1`). Unversioned legacy blocks are detected as `v=0` and upgraded in place. Future schema versions can be added without breaking past content.
+- **Versioned block markers.** All managed blocks now use `<!-- ORIENT:BEGIN v=1 -->` / `<!-- ORIENT:END v=1 -->` (and `ORIENT-README:BEGIN v=1` / `ORIENT-README:END v=1`). Unversioned legacy blocks are detected as `v=0` and upgraded in place. Future schema versions can be added without breaking past content.
 - **Adapter-block placement rule.** Concrete rule for where the block goes in new vs existing adapter files (new file → under the first H1; existing file → appended at end with one blank line above/below).
-- **Worked example** (`references/example-YORIENT.md`). Fully filled-in `YORIENT.md` for a hypothetical Node monorepo. Calibration target for length, density, and voice.
+- **Worked example** (`references/example-ORIENT.md`). Fully filled-in `ORIENT.md` for a hypothetical Node monorepo. Calibration target for length, density, and voice.
 - **Ecosystem cheatsheet** (`references/by-ecosystem.md`). Per-ecosystem manifest files, source/test conventions, "read first" hints, and common no-go directories for Node/TS, Python, Rust, Go, polyglot monorepos, docs sites, and Obsidian vaults.
 - **Drift check** (`SKILL.md § Drift Check`). Five-step verification recipe — Tree Map paths still exist, commands still parse, top-level dirs match disk, no-go zones still real, `Last reviewed:` stamp.
 - **Smoke test** (`SKILL.md § Smoke Test`). Per-agent installation verification steps for Claude Code, Codex, Hermes, Cursor CLI, Factory, Pi, OpenCode, Gemini, and Antigravity.
-- **Commit stance** (`SKILL.md § Commit Stance`). Explicit guidance that `YORIENT.md` and managed pointer blocks are committed artifacts.
+- **Commit stance** (`SKILL.md § Commit Stance`). Explicit guidance that `ORIENT.md` and managed pointer blocks are committed artifacts.
 - **Slug source callout** (`SKILL.md § Branding Rules § Slug Source`). The footgun about frontmatter `name:` driving the callable slug is now surfaced at the top of the Branding Rules, not buried in pitfalls.
 - **Cursor IDE vs CLI distinction** in the Agent Adapter Targets table.
 - **Migration playbook** (`references/rebrand-and-pointer-blocks.md`). Now includes concrete detection regexes, a three-branch decision tree for legacy `ORIENT.md` files, and an explicit string replacement map.
@@ -62,4 +66,4 @@ Initial public release. Closes 10 gaps surfaced in an internal audit of the v1.2
 
 ## [1.2.0] — pre-release baseline
 
-Initial internal release covering portable `YORIENT.md` shape, agent adapter targets table, parallel subtree exploration, basic managed blocks, Obsidian/vault variant, and verification checklist. Used internally to rebrand from `orient-map`.
+Initial internal release covering portable `ORIENT.md` shape, agent adapter targets table, parallel subtree exploration, basic managed blocks, Obsidian/vault variant, and verification checklist. Used internally to rebrand from `orient-map`.

CLAUDE.md

@@ -1,11 +1,11 @@
-<!-- YORIENT:BEGIN v=1 -->
-# Yorient Map
+<!-- ORIENT:BEGIN v=1 -->
+# Orient Map
 
-This project uses `YORIENT.md` as the canonical repo/vault map.
+This project uses `ORIENT.md` as the canonical repo/vault map.
 
 Before broad file search or structural edits:
-1. Read `YORIENT.md`.
-2. Check for a nearer nested `YORIENT.md` or `AGENTS.md` in the target subtree.
+1. Read `ORIENT.md`.
+2. Check for a nearer nested `ORIENT.md` or `AGENTS.md` in the target subtree.
 3. Use the routing map there to choose files and commands.
-4. Keep this adapter thin; update `YORIENT.md` when structure changes.
-<!-- YORIENT:END v=1 -->
+4. Keep this adapter thin; update `ORIENT.md` when structure changes.
+<!-- ORIENT:END v=1 -->

YORIENT.md ORIENT.mdYORIENT.md renamed to ORIENT.md

@@ -1,8 +1,8 @@
-# YORIENT.md
+# ORIENT.md
 
 ## Purpose
 
-This is the public repo for the `yorient` skill — a Markdown-only orientation
+This is the public repo for the `orient` skill — a Markdown-only orientation
 layer for AI coding agents. The repo is its own demo: it ships the skill, and
 also uses the skill on itself.
 
@@ -11,21 +11,21 @@ also uses the skill on itself.
 - Want to read the skill itself? `SKILL.md`.
 - Want to install the skill into your agents? `README.md § Install`.
 - Want to extend or modify the skill? `.github/CONTRIBUTING.md`, then `SKILL.md`.
-- Want a worked example of a `YORIENT.md`? `references/example-YORIENT.md`.
-- Want to migrate from `orient-map` or `ORIENT.md`? `references/rebrand-and-pointer-blocks.md`.
+- Want a worked example of a `ORIENT.md`? `references/example-ORIENT.md`.
+- Want to migrate from `yorient`, `YORIENT.md`, or `orient-map`? `references/rebrand-and-pointer-blocks.md`.
 - Tracking releases? `CHANGELOG.md`.
 
 ## Tree Map
 
 ```text
-yorient/
+orient/
 |___SKILL.md                                # the skill body (canonical)
 |___references/
 |   |___rebrand-and-pointer-blocks.md       # migration playbook + detection regex
-|   |___example-YORIENT.md                  # fully worked YORIENT.md (Node monorepo)
+|   |___example-ORIENT.md                  # fully worked ORIENT.md (Node monorepo)
 |   |___by-ecosystem.md                     # per-ecosystem entrypoint cheatsheet
 |___README.md                               # public-facing pitch + install
-|___YORIENT.md                              # this file — yorient applied to its own repo
+|___ORIENT.md                              # this file — orient applied to its own repo
 |___AGENTS.md                               # thin adapter (managed block)
 |___CLAUDE.md                               # thin adapter (managed block)
 |___CHANGELOG.md                            # semver release log
@@ -65,7 +65,7 @@ yorient/
 
 - Markdown only. No scripts in the skill workflow (meta scripts in `.github/workflows/` are fine).
 - `SKILL.md` and `references/*.md` are the *canonical skill*; they get mirrored into agent skill directories.
-- `README.md`, `CHANGELOG.md`, `LICENSE`, `YORIENT.md`, `AGENTS.md`, `CLAUDE.md`, `.github/`, `.gitattributes`, `.markdownlint.json` are *repo-only*; they do not sync to skill mirrors.
+- `README.md`, `CHANGELOG.md`, `LICENSE`, `ORIENT.md`, `AGENTS.md`, `CLAUDE.md`, `.github/`, `.gitattributes`, `.markdownlint.json` are *repo-only*; they do not sync to skill mirrors.
 - Versioned managed-block markers (`v=1`). Legacy `v=0` blocks are detected and upgraded; never silently rewritten with a different format.
 - Semver. `CHANGELOG.md` entry per release.
 
@@ -77,10 +77,10 @@ yorient/
 
 ## Subsystem Notes
 
-This repo is small enough that no nested `<subtree>/YORIENT.md` files are needed.
+This repo is small enough that no nested `<subtree>/ORIENT.md` files are needed.
 
 ## Maintenance
 
 Update this file when top-level files change shape (new `references/*.md`, new repo-only file, ecosystem additions to the adapter table that would change the routing map).
 
-Last reviewed: 2026-05-25.
+Last reviewed: 2026-06-05.