Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
26 lines (19 loc) · 998 Bytes

CONTRIBUTING.md

File metadata and controls

26 lines (19 loc) · 998 Bytes
Raw

Contributing

Solo-curated playbook. PRs welcome -- open an issue first, it saves rework.

Before you code

  • Bugs: issues. Ideas: discussions
  • New command: read commands/core/pb-new-playbook.md. Structure is enforced by lint and tests
  • Existing command: metadata schema in .playbook-metadata-schema.yaml -- 13 required front-matter fields (+ optional tags)

Local checks (all must pass)

python3 -m pytest tests/ -q
python3 scripts/validate-conventions.py
python3 scripts/check-links.py
npx markdownlint-cli --config .markdownlint.json 'commands/**/*.md'
./scripts/build-mdbook.sh

PR expectations

  • Atomic commits, conventional-commit format (feat(scope): ...)
  • One concern per PR
  • Touching a Related Commands list? Check all siblings for back-links
  • Dependabot PRs: patch + security auto-merge after green CI, minor = check release notes, major = real review