Changelog

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).

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-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.md → user.md (heading becomes "User rules"; constants MACHINE / HARNESS).

  • Renamed examples HARNESS.example.md → harness.example.md, MEMORIES.example.md → machine.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 pins → pointer 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.