Skip to content

feat: add cornerstone-docs-writer agent definition#1609

Merged
steilerDev merged 1 commit into
betafrom
feat/cornerstone-docs-writer-agent
May 29, 2026
Merged

feat: add cornerstone-docs-writer agent definition#1609
steilerDev merged 1 commit into
betafrom
feat/cornerstone-docs-writer-agent

Conversation

@steilerDev

Copy link
Copy Markdown
Owner

Summary

Adds a new .claude/agents/cornerstone-docs-writer.md agent definition — a refined and up-to-date version of the existing docs-writer agent, namespaced as cornerstone-docs-writer.

What Changed

  • New agent: .claude/agents/cornerstone-docs-writer.md with name: cornerstone-docs-writer

Key Improvements Over docs-writer

Aspect docs-writer (old) cornerstone-docs-writer (new)
Docs site URL https://steilerDev.github.io/cornerstone/ https://cornerstone.steiler.dev/
Config file extension references .ts correctly documents .js
Broken image policy not explicit uses :::info Screenshot needed admonitions, not broken refs ✅
Page inventory not embedded full EPIC-13 page list baked in ✅
Build caveat mentioned briefly explicit worktree workaround documented ✅
Memory read step not in workflow step 1 of workflow ✅
Branch naming generic docs/<issue>-<desc> convention ✅
Sidebar config sidebars.ts sidebars.js (correct) ✅

Notes

  • The docs-writer agent definition is preserved as-is for backward compatibility
  • The cornerstone-docs-writer agent shares the same agent memory directory (.claude/agent-memory/docs-writer/) so existing memory is inherited
  • Attribution trailer uses cornerstone-docs-writer (Opus 4.5)

Introduces a new .claude/agents/cornerstone-docs-writer.md agent definition
that serves as the dedicated documentation writer for the Cornerstone project.

Key differences from the existing docs-writer agent:
- Updated name to cornerstone-docs-writer for project-namespaced identity
- Corrected docs site URL to https://cornerstone.steiler.dev/
- Config files documented as .js (not .ts) per current implementation
- Embedded known page inventory from agent memory (EPIC-13 state)
- Added known build caveat for worktree environments
- Incorporated sidebar_position guidance and double-dash convention
- Added explicit memory-read step at workflow start
- Clarified broken image ref policy (use admonitions, not broken refs)
- Added docs branch naming convention (docs/<issue>-<desc>)

Co-Authored-By: Claude backend-developer (Haiku 4.5) <noreply@anthropic.com>
@steilerDev steilerDev merged commit f3031b6 into beta May 29, 2026
12 checks passed
@steilerDev steilerDev deleted the feat/cornerstone-docs-writer-agent branch May 29, 2026 15:29
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.7.0-beta.30 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

steilerDev added a commit that referenced this pull request May 29, 2026
Introduces a new .claude/agents/cornerstone-docs-writer.md agent definition
that serves as the dedicated documentation writer for the Cornerstone project.

Key differences from the existing docs-writer agent:
- Updated name to cornerstone-docs-writer for project-namespaced identity
- Corrected docs site URL to https://cornerstone.steiler.dev/
- Config files documented as .js (not .ts) per current implementation
- Embedded known page inventory from agent memory (EPIC-13 state)
- Added known build caveat for worktree environments
- Incorporated sidebar_position guidance and double-dash convention
- Added explicit memory-read step at workflow start
- Clarified broken image ref policy (use admonitions, not broken refs)
- Added docs branch naming convention (docs/<issue>-<desc>)

Co-authored-by: Claude backend-developer <noreply@anthropic.com>
@steilerDev steilerDev mentioned this pull request Jun 12, 2026
9 tasks
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.7.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants