Optional developer tooling. Nothing here is part of the Roller build, the source or binary distributions, or the runtime; the source assembly does not include this directory. You can ignore it entirely and work on Roller normally.
Each subdirectory is a “skill”: a SKILL.md describing a project procedure, plus supporting reference notes, templates and helper scripts. They exist so that recurring project chores are written down in one reviewable place instead of living in one committer's head.
| Skill | Covers |
|---|---|
roller-release | Preparing, building, signing, verifying, staging, voting on and publishing a release, plus the release website and announcement drafts. |
roller-security | Security report triage, private case tracking, CVE preparation, reporter coordination and disclosure planning. |
roller-board-report | Drafting, reviewing and submitting the quarterly report to the ASF board, and following up on board feedback. |
SKILL.md and the files under references/ are plain Markdown. Read them directly for a written account of how a release is put together. No tooling is required for this.
The layout follows the convention used by Claude Code and similar agent tools, which discover skills under .claude/skills/. To make them available without duplicating the files:
mkdir -p .claude/skills ln -s ../../skills/roller-release .claude/skills/roller-release
.claude/ is not tracked by this repository, so this is a local choice that affects only your checkout. Copying the directories instead of symlinking works equally well.
These skills describe procedure; they do not grant authority. The PMC owns release decisions, and ASF policy governs what a release requires. Where a skill and current ASF policy disagree, policy wins and the skill needs fixing.
The helper scripts under scripts/ are deliberately conservative: they preview by default, they do not commit, tag, push, sign on your behalf, or send mail, and they are not a substitute for reading the diff and verifying a candidate yourself. Verify current ASF policy from its authoritative sources rather than trusting a summary here.
Corrections are welcome as ordinary pull requests.