Changelog

2026-09-08 — Agent runtime renamed to harness

  • Renamed the DevCentr agent runtime from the Hornet working name to the generic harness name across active architecture, integration, and configuration guidance.

  • Reserved Cricket as a possible advisor/conscience-layer name rather than the runtime name.

  • See Detailed changelog.

2026-09-08 — Public web crawlability

  • Added the web-crawlability skill and portable policy: meaningful raw HTML for content routes, generated sitemap and robots artifacts, editorial feeds, and CI maintenance checks.

  • Clarified that client hydration and transitions remain compatible with SSG/SSR, while a sitemap cannot substitute for page content.

  • See Detailed changelog.

2026-09-08 — Themed SVG diagrams

  • Migrated the rules-geography and agent CLI authentication diagrams to reproducible Mermaid sources with explicit semantic palettes, adaptive SVGs, and host-runtime SVGs.

  • Corrected the canonical CSS namespace guidance to --themed-svg-*.

  • See Detailed changelog.

2026-09-07 — Themed SVG diagram contract

  • Added portable diagram-svg-output policy for accessible, responsive diagrams with bundled light/dark presets and fixed-output options.

  • Standardized semantic palette roles and the external <img> theme boundary across Mermaid, Kroki, PlantUML, Graphviz, and hand-authored SVG workflows.

  • See Detailed changelog.

2026-09-04 — Naming notes: Jiminy Cricket / Cricket

  • Agent harness: open naming notes — Hornet metaphor vs agents; Cricket as harness vs model/advisory voice; three dead U.S. JIMINY CRICKET USPTO serials (continued use not filed, un-revivable).

  • See Detailed changelog.

2026-09-03 — Voice/title fixes into rules and skills

  • agents/editorial/titles.md: lede check, slug = title, channel split, title≠body

  • general/documentation.md: post-draft Audience gate, channel split table, slug = H1 policy, pass checks 11–12

  • Skills writing-blog / writing-news: post-draft verify, chat residue anti-patterns, slug match

  • user.md one-liners + hub editorial-titles.adoc sections aligned

  • See Detailed changelog.

2026-09-03 — Case study: agent voice vs reader voice

2026-09-03 — Editorial titles (enthymeme + self-test)

2026-09-02 — gh --attach filing + provider mirror vision

  • Skills issues-repo-record / issue-reports / draft-pr: prefer GitHub CLI --attach (gh ≥ 2.99); keep .issues/images/ as durable backup; raw.githubusercontent.com is fallback only.

  • Always-on issue one-liners updated (AGENTS.md, user.md, creator.md, issue-reports rule).

  • See Detailed changelog.

  • Mixr routing and cost Related links Open Provider Registry / UniProvider as discovery (Mixr remains routing).

2026-09-01 — GitHub push routing (permissions)

  • Skill github-repo-access: probe viewerPermission, branch protection, fork layout; cache in $CODE_ROOT/machine.md; route direct push vs branch+PR vs fork PR vs blocked.

  • general/github-push-routing.md: explain PR when the user asked to push but access blocks upstream push; suggest sharing explanation with maintainer.

  • Hooks in push-code, draft-pr, end-of-run, user.md.

  • See Detailed changelog.

2026-09-01 — End-of-run rationale (docs + rules)

2026-08-30 — Antora nav titled-list absorption

  • House rule: do not mix .Title / dotted nav headers with sibling * xref:… linked parents — a titled list owns all following * items until the next .Title.

  • Buckets without a landing: unlinked * Label + children (not .Label). Buckets with index.adoc: linked parent + .

  • Detail: general/documentation.md. Pointers in agents/engineering/antora.md, skill antora-org-site.

2026-08-30 — site-nav-tree unwrap (no Component > Component)

  • Extension flattens Antora’s anonymous nav-tree wrapper and unwraps a leading start-page link that duplicates the component root (fixes empty expanded carets + BB > BB).

  • Companion site-nav-tree-current.js prefers deepest is-current-page when URLs collide across the forest.

  • House rule: under site-nav-tree, do not list the component start page as the first nav item; linked parents are for section landings only.

2026-08-30 — site-nav-tree include allowlist

  • Skill antora-org-site + agents/engineering/antora.md: content source ≠ forest root; prefer include allowlist; thin stubs = home portal or register+omit from include; breadcrumb picker shares curation.

  • Extension @antora-supplemental/site-nav-tree 0.2.0 adds include and publishes site.keys.site_nav_tree_*.

2026-08-30 — Linked parent section landings (drop Overview)

  • Replace the Overview exception: section landings use a linked parent whose link text equals the H1 (* Email + ** children). Do not use .Section + Overview; do not invent overview.adoc.

  • Keep index.adoc + urls.html_extension_style: indexify for folder URLs; do not advertise index.html.

  • Detail: general/documentation.md. Pointers in user.md, AGENTS.md, agents/editorial/titles.md, agents/engineering/antora.md, skill antora-org-site.

2026-08-30 — Folder URLs (indexify) for section landings

  • Public face for area landings is the folder path via urls.html_extension_style: indexify — keep index.adoc; do not rename to overview.adoc or advertise index.html.

  • Detail: general/documentation.md. Pointers in user.md, agents/engineering/antora.md, skill antora-org-site.

2026-08-30 — Site-wide component nav tree

  • Multi-component hubs: enable @antora-supplemental/site-nav-tree (wraps navigation data; keeps default nav-tree). Documented in skill antora-org-site and agents/engineering/antora.md.

2026-08-30 — Antora page title = nav label

  • House rule: document H1, nav.adoc link text, and :navtitle: must be the same string (prefer no :navtitle:). Section landings: linked parent = H1 (no Overview exception).

  • Detail: general/documentation.md. Pointers in user.md, agents/editorial/titles.md, agents/engineering/antora.md, skill antora-org-site.

2026-08-30 — PRs ready for review by default

  • Skill draft-pr and portable rules: never open draft PRs; always ready for review unless the user asks for draft. Overrides Cloud Agent draft defaults. Not an AGENTS.md tax.

  • Details

2026-08-30 — Demo selector hub and identity trail

  • Skill demo-site-wiring: multi-variant default is selector hub → separate pages; identity strip keeps Org → Demos → demo intermediates.

  • Details

2026-08-30 — Demo mockups inside tab faces

  • Skill demo-site-wiring: static per-variant mockups live in the tab faces; the tabpanel starts where title / blurb / desk change.

  • Details

2026-08-30 — Demo identity strip is site nav only

  • Skill demo-site-wiring: org/repo crumbs stay on the site (demos index + demo home); only the VCS logo links to the repository.

  • Details

2026-08-30 — Mixr cost routing and shadow/LSP design

  • On-device Mixr docs, Anthropic suppress defaults, Harness as t3code provider seam, shadow/LSP lag contract.

  • Details

2026-08-30 — Partner org single entry points

  • Footers and related strips: one entry point per org (homepage preferred); do not stack docs hub or GitHub beside it.

  • Details

2026-08-30 — Titles slimmed to cold-reader gate

  • agents/editorial/titles.md drops shape checklists (When…, [On], as vs is); cold-reader orientation is the only title rule.

  • Details

2026-08-30 — Editorial titles canonical + cold-reader gate

  • agents/editorial/titles.md is the house title doctrine (cold-reader gate; no forced When …).

  • Site STYLE.adoc treated as thin pointer only; skills writing-news / writing-blog point here.

  • user.md, general/documentation.md, harness-boundary, PR editorial pointer updated.

  • Details

Timeline of notable functional changes, reconstructed from git history and observed file content (not only commit subjects). Detail pages live under changelog-details/.

This repository’s reachable git history on main begins 2026-08-06 (cd9463d). Earlier design of RULES.md / profiles lived in personal forks (see AMDphreak/agent-rules).

2026-08-30 — Repo About homepage → docs

  • New project repos: GitHub About URL defaults to the org docs hub component page.

  • Exceptions: org main/marketing site, or a product with its own domain/subdomain.

  • Skills bootstrap-org, antora-org-site, public-readme; thin AGENTS.md pointer.

  • See Detailed changelog.

2026-08-29 — Release target patterns

  • Skill release-targets + patterns.sdl + general/release-target-patterns.md — year-dated common / desktop / lab / omnibus.

  • polyglot-ci defaults enable windows-arm64; expands named patterns.

  • See Detailed changelog.

2026-08-28 — Demo intro anchoring image

  • Suite/hub lede: exactly one anchoring screenshot or contextual mockup before the interactive demo (not a gallery).

  • Skill demo-site-wiring + agents/demos-and-push.md; thin AGENTS.md pointer.

  • See Detailed changelog.

2026-08-28 — Demos + push workflow (owned orgs)

  • agents/demos-and-push.md: new UI concepts auto-apply demo-site-wiring; do not suppress push/PR for demo prototyping; surface philosophy clashes when unresolved.

  • Skill demo-site-wiring extended with invent/ship UI triggers, anti-suppression, and conflict notes.

  • See Detailed changelog.

2026-08-28 — Demo site wiring skill

  • Skill demo-site-wiring: org-site + demos browser wiring, lay workflow copy, mandatory page order (org/repo identity strip → VCS logo line → demo lede → variant switcher → variant title/blurb/UI); grandfather existing demos.

  • See Detailed changelog.

2026-08-28 — gcloud multi-account workflow for agents

  • Document that repeated gcloud auth login accumulates accounts; one active (*); switch with config set account / named configurations; revoke/logout removes credentials.

  • See Detailed changelog.

2026-08-28 — Agent CLI auth how-tos (Bitwarden + gcloud)

  • Hub how-tos for optional Bitwarden session persist and gcloud user-login persistence for agents; orientation SVG; harness example stamps.

  • See Detailed changelog.

Schema evolution (quick map)

Observed transitions in forkable + machine-local names:

When Before After

Through 2026-08-18

RULES.md + $CODE_ROOT/MEMORIES.md

(unchanged names; org AGENTS.md added 2026-08-12)

2026-08-19 (55ec8f4)

Cursor-assumed templates; only MEMORIES

Harness-neutral: add $CODE_ROOT/HARNESS.md + HARNESS.example.md; constants MEMORIES + HARNESS

2026-08-19 (aea1a78)

RULES.md, HARNESS.md, MEMORIES.md

user.md, harness.md, machine.md (+ lowercase examples); gitignore keeps legacy MEMORIES.md

2026-08-28 — Docs illustrations default

  • general/documentation.md: teaching pages need an orientation figure by default (diagram / screenshot / mockup / source still); AsciiDoc comma-safe alts; pass checks.

  • user.md Docs one-liner.

  • See Detailed changelog.

2026-08-28 — Hornet v0–v2 reference runtime

  • dev-centr/harness (then Hornet) — disk store, Mixr, wait graph, desk UI, temporal engine.

  • See Detailed changelog.

2026-08-28 — Hornet harness and Mixr router

  • Product names: Hornet (harness), Mixr (model-routing meta-agent); HARNESS_NAME=hornet.

  • See Detailed changelog.

2026-08-28 — Actor-model design lock-in

  • Model-proposed spawn; disambiguation node; metathread refs; ACTOR_WAIT_GRAPH=warn default; temporal layout as planned view engine.

  • See Detailed changelog.

2026-08-28 — Actor-model agentic UI pivot

  • Renamed project inbox to actor-model agentic UI; node graph + disk persistence; ACTOR_AGENTIC_UI harness variables.

  • See Detailed changelog.

2026-08-28 — Project inbox harness contract

  • Second cross-org UX contract: parallel task grid, per-node disk store, chapter snapshots, actor mailboxes.

  • See Detailed changelog.

2026-08-28 — hive-watch remote fetch

  • Org tool hive-watch: scheduled git fetch for CODE_ROOT; writes hive-watch.status.json and stamps machine.md.

  • Skill hive-watch, general/hive-watch.md; bootstrap step; user.md 24h read-status rule vs per-chat fetch.

  • See Detailed changelog.

2026-08-28 — hive-layout fork placement

  • Skill hive-layout; strengthened general/folder-schema.md — org forks belong in .forks/, not org root.

  • See Detailed changelog.

2026-08-25 — Self-host web fonts

  • Portable rule general/self-host-fonts.md + skill self-host-fonts: prefer Fontsource / local woff2 + preload; do not @import Google Fonts or wait on a CDN for first paint.

  • Catalog row + user.md one-liner.

2026-08-25 — Facto page-context + attr/fallback policy

  • Facto compose pack includes @antora-supplemental/page-context and page-context-active.

  • Docs policy: generate page-* attrs; keep ifndef::page-context-active[] body fallback for audience / authors / last updated only.

  • See Detailed changelog.

2026-08-25 — Page-context metadata extension

  • Docs encode audience/authors as page-* attributes; @antora-supplemental/page-context formats lead + footer (agent-assisted: <agent> on behalf of <human>).

  • See Detailed changelog.

2026-08-25 — Docs audience / POV gate

  • Published docs must address naive readers and visitors — not the chat commissioner. Gate lives in general/documentation.md; skills that ship visitor copy re-check it.

  • See Detailed changelog.

2026-08-25 — Library registry vs local path

  • New skill library-registry-choice: before wiring path deps or scaffolding publishable libraries, check the registry, ask publish vs local disk, encourage publish, suggest which registry.

  • See Detailed changelog.

2026-08-25 — Rules geography illustration (layered)

  • Annotated-map SVG teaches layered deltas (personal fork is not template HEAD parity); rules-manager when the harness cannot stack.

  • See Detailed changelog.

2026-08-25 — skills-set human labels

  • Annotated tags skills-set/YYYY.MM.DD as the human label on top of the agent-rules SHA stamp (AGENT_RULES_SYNCED_LABEL).

  • See Detailed changelog.

2026-08-25 — Sync skills and rules on drift

  • Skill sync-agent-rules autoupdates local installs against the shared reference; stamps AGENT_RULES_SYNCED_SHA (set version = agent-rules SHA).

  • See Detailed changelog.

2026-08-25 — End-of-run commit and push

2026-08-25 — Facto compose pack + Internet Architecture nesting

  • Valentus stays lean; Facto (antora-supplemental/antora-facto) is the named compose pack for Lunr/math/Kroki.

  • Org engineering notes + antora-org-site skill/CATALOG updated; Internet Reliability nesting vs HCI Labels versus wires documented.

  • Broadened antora-org-site skill description / CATALOG triggers (docs site, antora theme, playbook, compose pack, Mermaid/PlantUML) so Facto is discoverable without naming it.

  • See Detailed changelog.

2026-08-24 — Changelog introduced

  • Added Antora changelog index + detail pages; linked from README, nav, and overview.

  • See Detailed changelog.

2026-08-19 — Layer rename: user.md, harness.md, machine.md

  • Renamed RULES.mduser.md (heading becomes "User rules"; constants MACHINE / HARNESS).

  • Renamed examples HARNESS.example.mdharness.example.md, MEMORIES.example.mdmachine.example.md.

  • Machine example text splits harness facts out to harness.md (table of "what does not belong here").

  • Vocabulary docs: Cursor User Rules ≠ file user.md.

  • See Detailed changelog.

2026-08-19 — Harness-neutral architecture

  • Before: templates and skills described Cursor paths inline.

  • After 55ec8f4: RULES.md gains HARNESS: $CODE_ROOT/HARNESS.md; skills harness-setup; general/harness.md + harness-boundary.md; docs harness-neutral.adoc.

  • Intermediate uppercase HARNESS.md lasted one commit before the lowercase rename.

  • See Detailed changelog.

2026-08-19 — Skills: push, issues record, speech, inventory

  • push-code, issues-repo-record, tool-inventory, plain-speech / record-rule.

  • Always-on policy: owned functional changes → owned-changelog; issues for bugs/blockers/external coordination.

  • See Detailed changelog.

2026-08-18 — Org agent-rules pointer wrappers

  • Content shift: wrappers described as git submodule SHA pinspointer overlays (README + thin AGENTS.md); setup-org-agent-rules-wrapper.ps1 rewritten; ASCII punctuation for PowerShell.

  • publish-to-dub requires registry categories; github-profile-assets; polyglot-ci.

  • See Detailed changelog.

2026-08-17 — Thin always-on rules; on-demand skills

  • Observed: skills/ grows from a shop entry + a few curricula to dozens of skill dirs; RULES.md / AGENTS.md stop carrying long curricula.

  • Added write-skill then renamed → write-a-skill; tag-release; always-on file-link .mdc.

  • See Detailed changelog.

2026-08-15 — bootstrap-org skill and SDL profiles

  • Skill bootstrap-org + SDL profile catalog (library, CLI, desktop, docs hub, nonprofit, …); catalog path /skills.

  • See Detailed changelog.

2026-08-12 — Org layer, writing skills, shell default

  • New file AGENTS.md (org layer) + agents/ orchestrator; layering table: Portable / Org / Product / Project.

  • Skills writing-news / writing-blog; Nushell default shell; PR voice; fix-docs-encoding; Cloudflare Access for private sister sites.

  • See Detailed changelog.

2026-08-11 — Math on every docs site

  • RULES.md / general/documentation.md: enable math rendering even when unused (Antora stem + KaTeX; Markdown remark-math).

  • See Detailed changelog.

2026-08-10 — Skills shop entry

  • Added skills/BOOTSTRAP.md as the in-repo Cursor skills shop entry (skills tree still thin until later days).

  • See Detailed changelog.

2026-08-08 — News/blog stance; README chrome; SPE pointers

  • Titles: News = outward, blog = inward in always-on rules.

  • Drop Docs/CI shield mandates; keep Explore the docs » hub CTA.

  • Expand README / Antora / changelog agent rules; point app-architecture at delivery-class auxiliaries + CentrMark checklists.

  • See Detailed changelog.

2026-08-07 — Antora docs component

  • Added docs/ Antora component; stripped personal-repo paths from public upstream text.

  • See Detailed changelog.

2026-08-06 — History root: one Antora site per org

  • Reachable main root: RULES.md already uses placeholder constants (REQUIRED_PATH), MEMORIES: $CODE_ROOT/MEMORIES.md, MEMORIES.example.md, general/* (no skills/, no docs/ pages yet).

  • Policy: one Antora site per org with a hub; dedupe secondary GitHub Pages Antora sites.

  • See Detailed changelog.