Skip to content

Add organization community health defaults#13

Merged
justin808 merged 5 commits into
mainfrom
agent/org-community-health
Jul 23, 2026
Merged

Add organization community health defaults#13
justin808 merged 5 commits into
mainfrom
agent/org-community-health

Conversation

@justin808

@justin808 justin808 commented Jul 23, 2026

Copy link
Copy Markdown
Member

Summary

  • add organization-default contribution, conduct, security, and support guidance
  • add inherited bug/feature issue forms and a focused pull-request template
  • publish the ShakaCode repository-maintenance baseline and an adaptable AGENTS.md workflow template
  • add repository-local agent instructions, validation, and monthly GitHub Actions dependency updates
  • link the public organization profile to the new collaboration guidance

Maintainer intent

The defaults make contribution quality and maintenance cost explicit without discouraging useful outside work. Repository-specific files continue to take precedence, so mature projects such as React on Rails and Shakapacker keep their more detailed support/security/version policies.

The maintenance baseline treats inactivity as a review signal only:

  • about 6 months: classification review
  • 1 year: stale/maintainer attention
  • 2 years: archive candidate
  • 5 years: strong archive candidate

Nothing here automates archival, deletion, branch renaming, or repository settings.

Validation

  • .agents/bin/validate
  • actionlint .github/workflows/*.yml
  • YAML parsing for issue forms and Dependabot configuration
  • git diff --check and git diff --cached --check
  • independent codex review --uncommitted — clean after fixing staged/untracked whitespace coverage

Workflow and security audit

  • no existing Actions workflow behavior or permissions changed
  • no secrets added
  • .github/dependabot.yml requests monthly GitHub Actions update pull requests
  • security reports are directed to repository private vulnerability reporting, with contact@shakacode.com as a fallback that asks reporters to withhold exploit details until a private channel is arranged
  • the repository is public; the added guidance contains no private catalog data or internal repository names

Review receipt

  • base: origin/main at b4ec966
  • reviewed target: full uncommitted patch, committed as 92e7044
  • engine: codex review --uncommitted
  • lenses: public information safety, community-health inheritance, contributor UX, security-report routing, YAML/workflow syntax, and validation coverage
  • final result: no actionable findings

Summary by CodeRabbit

  • Documentation

    • Added contribution, support, security, maintenance, and community conduct guidance.
    • Added workflow and agent instruction templates for consistent repository practices.
    • Updated the public profile with open-source collaboration information.
  • Community

    • Added structured bug report and feature request forms.
    • Added issue contact links for security and commercial support.
    • Added a pull request checklist covering validation, risk, documentation, and disclosures.
  • Chores

    • Added repository validation checks for YAML, workflows, whitespace, and formatting.
    • Added automated monthly updates for GitHub Actions dependencies.

@coderabbitai

coderabbitai Bot commented Jul 23, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@justin808, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 3c010c2d-d1dd-4899-a5ab-8af7017b324f

📥 Commits

Reviewing files that changed from the base of the PR and between 92e7044 and 34021c4.

📒 Files selected for processing (5)
  • .agents/bin/setup
  • .agents/bin/validate
  • .github/ISSUE_TEMPLATE/config.yml
  • .gitignore
  • AGENTS.md

Walkthrough

This change establishes repository-wide community and governance defaults: a validation script, agent and contributor guidance, security and conduct policies, support documentation, GitHub issue and pull request templates, Dependabot configuration, and profile collaboration information.

Changes

Community governance baseline

Layer / File(s) Summary
Repository validation baseline
.agents/bin/validate
Adds YAML, optional actionlint, whitespace, staged-diff, and untracked-file validation checks.
Contributor and repository governance
AGENTS.md, AGENT_WORKFLOW_TEMPLATE.md, CLAUDE.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_MAINTENANCE.md, SECURITY.md, SUPPORT.md
Adds guidance for agent workflows, contributions, conduct reporting, security disclosures, repository maintenance, and support requests.
GitHub intake and update configuration
.github/ISSUE_TEMPLATE/*, .github/PULL_REQUEST_TEMPLATE.md, .github/dependabot.yml, profile/README.md
Adds structured issue and pull request forms, issue contact links, monthly GitHub Actions updates, and open-source collaboration links.

Estimated code review effort: 3 (Moderate) | ~20 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: adding organization-wide community health defaults.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/org-community-health

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@greptile-apps

greptile-apps Bot commented Jul 23, 2026

Copy link
Copy Markdown

Greptile Summary

This PR adds organization-wide collaboration and repository-maintenance defaults. The main changes are:

  • Community-health, security, support, and conduct guidance.
  • Inherited issue forms and a pull-request template.
  • Agent workflow instructions and a local validation command.
  • Monthly GitHub Actions dependency updates.
  • Organization profile links to the new guidance.

Confidence Score: 5/5

The policy and template changes look mergeable after tightening the local validation command.

  • Workflow linting can be skipped while validation still succeeds.
  • Valid YAML aliases can cause the validation command to abort.
  • No blocking issue was found in the community-health or reporting guidance.

.agents/bin/validate

Important Files Changed

Filename Overview
.agents/bin/validate Adds repository validation, but rejects YAML aliases and silently skips workflow linting when actionlint is unavailable.
.github/ISSUE_TEMPLATE/config.yml Adds inherited issue-chooser links for security guidance and commercial support.
.github/ISSUE_TEMPLATE/bug_report.yml Adds a structured bug-report form with reproduction and environment requirements.
.github/ISSUE_TEMPLATE/feature_request.yml Adds a structured feature-request form focused on user need and maintenance impact.
.github/dependabot.yml Adds monthly GitHub Actions dependency updates for this repository.
SECURITY.md Adds organization-default private vulnerability-reporting and supported-version guidance.
profile/README.md Links the organization profile to contribution, security, and maintenance guidance.

Reviews (1): Last reviewed commit: "Add organization community health defaul..." | Re-trigger Greptile

Comment thread .agents/bin/validate Outdated
Comment thread .agents/bin/validate Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
.github/ISSUE_TEMPLATE/config.yml (1)

1-1: 🔒 Security & Privacy | 🔵 Trivial | ⚡ Quick win

Disable public blank issue creation for security intake.

blank_issues_enabled: true exposes the blank issue option to repository users, allowing vulnerability reports or other security-related information to bypass the bug_report.yml acknowledgement and any guided intake flow. Set it to false and keep the security contact_link for researchers to use private security reporting.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/ISSUE_TEMPLATE/config.yml at line 1, Update the blank_issues_enabled
setting in the issue template configuration to false, while preserving the
existing security contact_link so researchers continue using the private
reporting flow.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.agents/bin/validate:
- Around line 4-8: Update the YAML validation command in .agents/bin/validate to
call YAML.safe_load_file with aliases enabled, while retaining safe loading.
This must allow anchors and aliases in repository-controlled GitHub Actions YAML
so validation can proceed to actionlint.

---

Nitpick comments:
In @.github/ISSUE_TEMPLATE/config.yml:
- Line 1: Update the blank_issues_enabled setting in the issue template
configuration to false, while preserving the existing security contact_link so
researchers continue using the private reporting flow.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c147a3bb-c15c-42ba-b297-f6fa80d31505

📥 Commits

Reviewing files that changed from the base of the PR and between b4ec966 and 92e7044.

📒 Files selected for processing (15)
  • .agents/bin/validate
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/feature_request.yml
  • .github/PULL_REQUEST_TEMPLATE.md
  • .github/dependabot.yml
  • AGENTS.md
  • AGENT_WORKFLOW_TEMPLATE.md
  • CLAUDE.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • OPEN_SOURCE_MAINTENANCE.md
  • SECURITY.md
  • SUPPORT.md
  • profile/README.md

Comment thread .agents/bin/validate

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 918649ba62

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/bin/validate

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8848aaec8b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/bin/validate
Comment thread .agents/bin/setup Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 889c2d8619

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/bin/setup

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 34021c48d5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/bin/setup
#!/bin/sh
set -eu

root="$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep setup and validation portable to macOS

On macOS and other BSD userlands, dirname does not accept GNU's -- end-of-options marker, so this root calculation exits with a usage error before setup can install the validator; the identical expression in .agents/bin/validate prevents validation too. These are organization-default contributor commands, so use a POSIX-compatible dirname "$0" invocation (with any needed path handling) instead.

AGENTS.md reference: AGENTS.md:L10-L15

Useful? React with 👍 / 👎.

@justin808
justin808 merged commit f5a2641 into main Jul 23, 2026
9 checks passed
@justin808
justin808 deleted the agent/org-community-health branch July 23, 2026 11:53
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