From f157576356cbf536970a16d70dcf04f895122bee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D7=A0=CF=85=CE=B1=CE=B7=20=D7=A0=CF=85=CE=B1=CE=B7=D1=95?= =?UTF-8?q?=CF=83=CE=B7?= Date: Sat, 15 Aug 2026 21:25:06 -0700 Subject: [PATCH] docs: repoint the stale docs.just reference The docs module was renamed to docusaurus, and the parent README no longer carries per-module sections, so the anchor resolved to nothing. Point at the module's own README instead. Co-Authored-By: Claude Opus 5 (1M context) --- AGENTS.md | 3 ++- md/README.md | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 4a23c99..d856db6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -55,4 +55,5 @@ corrected on sight. ## Task tracking Implementation planning and execution uses the superpowers plugin workflows -(`writing-plans` and `executing-plans`). Plans live in `docs/plans/`. +(`writing-plans` and `executing-plans`). Plans live in `docs/plans/`, created +when the first plan is written. diff --git a/md/README.md b/md/README.md index 296c934..fc7cc7e 100644 --- a/md/README.md +++ b/md/README.md @@ -5,7 +5,7 @@ Formats every `.md` file in the repository with [uvx](https://docs.astral.sh/uv/). Use this for repos that keep documentation at the root. Use -[`docs.just`](../README.md#docsjust) for Docusaurus sites under `docs/`. +[`docusaurus.just`](../docusaurus/README.md) for Docusaurus sites under `docs/`. ## 📦 Usage @@ -61,7 +61,7 @@ Excluded by default: `node_modules/`, `.worktrees/`, `.claude/`, and `.just/`. them on `openspec update` — reformatting them creates a loop where CI and the generator fight each other. -**⚠️ Do not point `md.just` and `docs.just` at the same files.** They use +**⚠️ Do not point `md.just` and `docusaurus.just` at the same files.** They use different formatters (mdformat vs prettier) and produce different output, so each would undo the other. A repo may use both, but on disjoint paths. Since `md.just` scans the whole repo, a repo with a Docusaurus site under `docs/` must