Skip to content

HDDS-15790. Add AGENTS.md and CLAUDE.md - #541

Open
shuan1026 wants to merge 2 commits into
apache:masterfrom
shuan1026:HDDS-15790
Open

HDDS-15790. Add AGENTS.md and CLAUDE.md#541
shuan1026 wants to merge 2 commits into
apache:masterfrom
shuan1026:HDDS-15790

Conversation

@shuan1026

@shuan1026 shuan1026 commented Aug 25, 2026

Copy link
Copy Markdown

What changes were proposed in this pull request?

Add AGENTS.md giving coding agents the local commands and conventions for this repo: preview (Docker/pnpm, port 3001), lint, build, spell check, branch rules (master vs asf-site), and change boundaries (e.g. don't touch versioned_docs/ outside backports).

CLAUDE.md is added as a symlink to AGENTS.md, matching the canonical-file + symlink convention apache/ozone established in HDDS-15316.

Note: the content of AGENTS.md is mainly adapted from HDDS-15316 (apache/ozone#10302).

Also adds ATX to cspell.yaml's word list, since AGENTS.md uses the Markdown term "ATX headings" and cspell otherwise flags it as unknown.

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-15790

How was this patch tested?

  • pnpm exec markdownlint AGENTS.md
  • pnpm build
  • Confirmed CLAUDE.md is a real symlink, not a copy (ls -l, git ls-files -s)

shuan1026 and others added 2 commits August 25, 2026 22:48
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