Severity: High — found during a deep project review (2026-07-06).
Defect
Two docs agents exist — .claude/agents/docs-writer.md and .claude/agents/cornerstone-docs-writer.md — with ~40 divergent hunks. Both are registered as launchable agents (ambiguous routing), and CLAUDE.md's agent table plus the skills (.claude/skills/release/SKILL.md:32,237, .claude/skills/review-pr/SKILL.md:76) reference only docs-writer — which is the stale copy:
| Fact |
docs-writer.md (referenced everywhere) |
cornerstone-docs-writer.md (referenced nowhere) |
Actual |
| Site URL / baseUrl |
https://steilerDev.github.io/cornerstone/, /cornerstone/ (:14,67) |
https://cornerstone.steiler.dev, / (:14,67) |
docs/docusaurus.config.js:9-10 = cornerstone-docs-writer's version |
| Config files |
docusaurus.config.ts / sidebars.ts (:44-45,141,215,228) |
.js files (:43-44) |
.js files exist |
| Trailer |
Claude docs-writer (Opus 4.6) (:20) |
Claude cornerstone-docs-writer (Opus 4.5) (:20) |
— |
Both also write to the same memory directory (.claude/agent-memory/docs-writer/ per cornerstone-docs-writer.md:297), so two "different" agents share one memory. Git history: cornerstone-docs-writer.md was added later (#1609); docs-writer.md last touched in #931 and never updated.
Net effect: the docs agent everything routes to has the wrong site URL and wrong config-file names.
Suggested fix
Keep exactly one agent named docs-writer (the name CLAUDE.md and skills use), merge in the corrected facts from cornerstone-docs-writer.md (URLs, .js config names), fix the trailer model string, and delete the duplicate.
Severity: High — found during a deep project review (2026-07-06).
Defect
Two docs agents exist —
.claude/agents/docs-writer.mdand.claude/agents/cornerstone-docs-writer.md— with ~40 divergent hunks. Both are registered as launchable agents (ambiguous routing), and CLAUDE.md's agent table plus the skills (.claude/skills/release/SKILL.md:32,237,.claude/skills/review-pr/SKILL.md:76) reference onlydocs-writer— which is the stale copy:docs-writer.md(referenced everywhere)cornerstone-docs-writer.md(referenced nowhere)https://steilerDev.github.io/cornerstone/,/cornerstone/(:14,67)https://cornerstone.steiler.dev,/(:14,67)docs/docusaurus.config.js:9-10= cornerstone-docs-writer's versiondocusaurus.config.ts/sidebars.ts(:44-45,141,215,228).jsfiles (:43-44).jsfiles existClaude docs-writer (Opus 4.6)(:20)Claude cornerstone-docs-writer (Opus 4.5)(:20)Both also write to the same memory directory (
.claude/agent-memory/docs-writer/percornerstone-docs-writer.md:297), so two "different" agents share one memory. Git history:cornerstone-docs-writer.mdwas added later (#1609);docs-writer.mdlast touched in #931 and never updated.Net effect: the docs agent everything routes to has the wrong site URL and wrong config-file names.
Suggested fix
Keep exactly one agent named
docs-writer(the name CLAUDE.md and skills use), merge in the corrected facts fromcornerstone-docs-writer.md(URLs,.jsconfig names), fix the trailer model string, and delete the duplicate.