Skip to content

docs: keep maintainers' private workflow out of the agent instructions - #425

Merged
GraemeF merged 1 commit into
mainfrom
feat/public-agent-docs
Oct 5, 2026
Merged

GraemeF merged 1 commit into
mainfrom
feat/public-agent-docs

Conversation

@GraemeF

@GraemeF GraemeF commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

The agent instructions in this repo are read by anyone who clones it, and by their agents. They described one maintainer's private routine rather than how to contribute.

  • CLAUDE.md replaces the mandatory worktree routine with setup, build and test commands and the contribution workflow. The sections on what the repo owns stay as they were.
  • The /start and /automerge commands are removed. They encoded that same routine, and CLAUDE.md now carries the workflow.
  • Two step-by-step agent plans in docs/plans are removed. They drove work that has shipped and were built around a private issue tracker and local paths.
  • The remaining design docs, the server README and /implement-pattern drop private issue ids and local paths.

CLAUDE.md now gives setup, build and contribution steps a contributor
can follow, in place of a worktree routine specific to one maintainer's
machine. The /start and /automerge commands that encoded that routine
are removed, as are two step-by-step agent plans for work that has
shipped. The remaining design docs and the server README drop
references to issue ids in a private tracker and to local paths.
@sonarqubecloud

sonarqubecloud Bot commented Oct 5, 2026

Copy link
Copy Markdown

@GraemeF
GraemeF marked this pull request as ready for review October 5, 2026 11:01
@GraemeF
GraemeF merged commit 2ffdf08 into main Oct 5, 2026
2 checks passed
@GraemeF
GraemeF deleted the feat/public-agent-docs branch October 5, 2026 11:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant