Skip to content

docs: refresh org READMEs (automated) - #1337

Merged
don-petry merged 4 commits into
mainfrom
chore/readme-refresh
Aug 2, 2026
Merged

don-petry merged 4 commits into
mainfrom
chore/readme-refresh

Conversation

@don-petry

@don-petry don-petry commented Jul 20, 2026 •

Copy link
Copy Markdown
Collaborator

User description

Automated README refresh

Regenerated the org meta-repo README(s) in petry-projects/.github-private from live org state
(repository list, standards docs, agent profiles, and installed frameworks).

Generated by the weekly readme-refresh workflow in petry-projects/.github-private.
Review the diff — curated prose is preserved; only missing/stale facts are corrected.

Action needed: these repos have empty GitHub descriptions — set them on the repo page so future refreshes can enrich the table: TalkTerm, markets


CodeAnt-AI Description

Refresh organization documentation with the latest standards and framework inventory

What Changed

  • Added the gitignore-standard guide to the organization standards indexes
  • Added the bmad-bgreat-suite framework, including its pinned version and repository link
  • Updated the repository structure and framework listings to make the new framework discoverable

Impact

✅ Easier discovery of organization standards
✅ Accurate framework inventory
✅ Clearer repository structure documentation

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Summary by CodeRabbit

  • Documentation
    • Added the bmad-bgreat-suite framework to repository and profile framework listings.
    • Updated the framework description to include Security agents and workflows.
    • Added gitignore-standard to the Standards & Practices tables.
    • Included the framework version reference in the profile documentation.
    • Improved visibility of available frameworks, security capabilities, and repository standards.

Copilot AI review requested due to automatic review settings July 20, 2026 12:09
@don-petry
don-petry requested a review from a team as a code owner July 20, 2026 12:09
@don-petry don-petry added the readme-refresh Automated README refresh label Jul 20, 2026
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@coderabbitai

coderabbitai Bot commented Jul 20, 2026 •

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 1ad8f225-3037-4c75-bd1d-c83d7cda2544

📥 Commits

Reviewing files that changed from the base of the PR and between 0955613 and 5d1174c.

📒 Files selected for processing (2)
  • README.md
  • profile/README.md

📝 Walkthrough

Walkthrough

The repository and profile README files now list the bmad-bgreat-suite framework and the gitignore-standard documentation entry. The profile README pins the framework to version ae8914e84b87 and includes Security agents and workflows.

Changes

Documentation registry updates

Layer / File(s) Summary
Framework registry entries
README.md, profile/README.md
Added bmad-bgreat-suite to the repository structure and installed framework tables. The profile description includes Security agents and workflows.
Standards registry entries
README.md, profile/README.md
Added gitignore-standard documentation entries, including its two-layer model and compliance sections.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies an automated refresh of the organization README files.
Description check ✅ Passed The description explains the automated README refresh, lists the changes, and states their impact; the missing template checklist is non-critical.
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 chore/readme-refresh

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.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the documentation in README.md and profile/README.md to document the addition of the bmad-bgreat-suite framework (SRE and DevOps agents) and the new gitignore-standard engineering standard. The reviewer suggested updating the description of bmad-bgreat-suite in README.md to also mention the Security agent included in the suite, ensuring the documentation is fully accurate.

Comment thread README.md Resolved
@don-petry

Copy link
Copy Markdown
Collaborator Author

Dev-Lead — fix-bot-comment (no-changes)

Agent reasoning
Issues addressed: 0
Skipped (informational): 1
- Codex usage quota notification — not a code issue, informational only
```

@don-petry
don-petry enabled auto-merge (squash) July 20, 2026 12:11
@donpetry-bot

Copy link
Copy Markdown
Contributor

Advisory bots were rate-limited; auto-approval is withheld until they recover. pr-review-sweep will re-review this PR after 2026-07-20T13:11:14Z.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the org meta-repo READMEs in petry-projects/.github-private to reflect current org state by refreshing the documented standards index and installed frameworks list.

Changes:

  • Add bmad-bgreat-suite to the repo structure/framework listings (including its current pinned commit).
  • Add gitignore-standard to the Standards tables in both READMEs.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
README.md Updates the top-level repo structure list and Standards index to include the new framework and gitignore-standard.
profile/README.md Updates the member-hub README’s Standards table and Frameworks table to include gitignore-standard and bmad-bgreat-suite.

@donpetry-bot

donpetry-bot commented Jul 20, 2026 •

Copy link
Copy Markdown
Contributor
Superseded by automated re-review at 1de13af89f71d508828f5a29ca1549a5c6ceb5d0 — click to expand prior review.

Review — fix requested (cycle 1/3)

The automated review identified the following issues. Please address each one:

Findings to fix

Automated review — NEEDS HUMAN REVIEW

Risk: LOW
Reviewed commit: 40771d46d4d229f43c32d718ecb7536bd1acc668
Cascade: triage → deep (triage: haiku 4.5 → deep: opus 4.8 + duck: o4-mini → audit: fable 5)

Summary

Docs-only README refresh (4 added lines) adding bmad-bgreat-suite and gitignore-standard entries. Verified against VENDOR.md and the src/agents tree at the head SHA: the suite ships three ops personas — Morgan (SRE), Riley (DevOps), and Sam (Security) — so the README line 'SRE and DevOps agents' is factually incomplete and omits the Security agent, matching Gemini's unaddressed finding. Low security risk, but this accuracy gate is unresolved, so escalate for a one-line fix rather than approve; no downstream consumers impacted (DOWNSTREAM_IMPACT: none), secret-scanning MCP unavailable and N/A for a docs diff.

Findings

  • minor: README.md line describes 'bmad-bgreat-suite @ ae8914e84b87: SRE and DevOps agents' but VENDOR.md and frameworks/bmad-bgreat-suite/src/agents (bgr-agent-sam-security) confirm the suite also includes Sam, the Security Lead. Should read 'SRE, DevOps, and Security agents'. Matches Gemini advisory finding; currently unaddressed.
  • info: Advisory coverage is partial: Copilot reviewed and found no issues; Gemini flagged the Security-agent omission (low priority); Codex and CodeRabbit were rate-limited at this head SHA. CI is green (CodeQL, CodeRabbit status success); dev-lead/review checks cancelled/skipped as expected for an automated [skip ci] refresh.

Reviewed by the PR-review cascade (triage: haiku 4.5 → deep: opus 4.8 + duck: o4-mini → audit: fable 5). Reply if you need a human review.

Additional tasks

  1. Resolve all unresolved review thread comments from other reviewers
  2. Ensure all CI checks pass after your changes
  3. Rebase on the target branch if behind
  4. Do NOT modify files unrelated to the findings above

The review cascade will automatically re-review after new commits are pushed.

coderabbitai[bot]
coderabbitai Bot previously approved these changes Aug 2, 2026
@don-petry

Copy link
Copy Markdown
Collaborator Author

Dev-Lead — fix-reviews (applied)

Changes committed and pushed.

@codeant-ai

codeant-ai Bot commented Aug 2, 2026 •

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 0955613 Aug 02, 2026 · 16:43 16:43

@codeant-ai codeant-ai Bot added the size:XS This PR changes 0-9 lines, ignoring generated files label Aug 2, 2026
coderabbitai[bot]
coderabbitai Bot previously requested changes Aug 2, 2026

@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

🤖 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 `@profile/README.md`:
- Line 84: Update the bmad-bgreat-suite project description in the profile
README to include the Security agent alongside SRE and DevOps, matching the
capabilities stated in the main README while preserving the existing project
link and registry entry.
🪄 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: ASSERTIVE

Plan: Pro Plus

Run ID: 05a82b43-5431-4f85-a3f8-6e99253116ca

📥 Commits

Reviewing files that changed from the base of the PR and between 298a1d2 and 0955613.

📒 Files selected for processing (2)
  • README.md
  • profile/README.md

Comment thread profile/README.md Resolved
@don-petry
don-petry disabled auto-merge August 2, 2026 16:45
@don-petry

Copy link
Copy Markdown
Collaborator Author

@coderabbitai resolve

coderabbitai[bot]
coderabbitai Bot previously approved these changes Aug 2, 2026
@don-petry

Copy link
Copy Markdown
Collaborator Author

Dev-Lead — fix-bot-comment (applied)

Changes committed and pushed.

@coderabbitai

coderabbitai Bot commented Aug 2, 2026

Copy link
Copy Markdown
✅ Action performed

Comments resolved and changes approved.

@donpetry-bot
donpetry-bot dismissed coderabbitai[bot]’s stale review August 2, 2026 16:50

Auto-dismissed (#617): coderabbitai[bot] CHANGES_REQUESTED on a superseded commit. The bot re-reviews the new head automatically — a valid concern will return as a fresh review.

@don-petry
don-petry disabled auto-merge August 2, 2026 16:50
@don-petry

Copy link
Copy Markdown
Collaborator Author

Dev-Lead — waiting on PR blockers (intent: review-changes)

PR: #1337
No changes were committed, but the PR still has blocking checks or reviews (failing or cancelled checks, or changes-requested reviews). The retry cron will re-attempt automatically. Next attempt after: 2026-08-02T17:22:05Z

@don-petry

Copy link
Copy Markdown
Collaborator Author

Note

@don-petry I reviewed this PR and no code changes were needed, but it still has blocking checks or reviews (failing or cancelled checks, or changes-requested reviews), so I cannot mark it done yet. I'll re-check automatically.
Next attempt after: 2026-08-02T17:22:05Z

@don-petry
don-petry enabled auto-merge (squash) August 2, 2026 16:52

@donpetry-bot donpetry-bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Automated review — APPROVED ✓

Risk: LOW
Reviewed commit: 1de13af89f71d508828f5a29ca1549a5c6ceb5d0
Review mode: triage-approved (single reviewer)

Summary

Docs-only automated README refresh (+5/−1 across README.md and profile/README.md): adds the newly installed bmad-bgreat-suite framework (pinned @ ae8914e84b87) to the structure tree and framework inventory, adds the gitignore-standard entry to both standards indexes, and updates the bmad-bgreat-suite repo description to include Security agents. All three new facts verified against live state: frameworks/bmad-bgreat-suite exists on main, commit ae8914e84b87 exists in petry-projects/bmad-bgreat-suite, and standards/gitignore-standard.md exists in petry-projects/.github. Triage assessment (low-risk) confirmed.

Linked issue analysis

No linked issues. This PR is generated by the weekly readme-refresh workflow; no issue linkage is expected.

Findings

No blocking findings.

  • Prior review cycle (cycle 1 at 40771d4) requested fixes; the two follow-up commits (0955613, 1de13af) addressed them, including the CodeRabbit/Gemini consistency finding (profile/README.md now matches README.md in listing SRE, DevOps, and Security agents). Both review threads are resolved and CodeRabbit has approved.
  • No unanswered human-reviewer questions; all don-petry comments are dev-lead automation markers.
  • Secret scan MCP tool (run_secret_scanning) not available in this run; gitleaks CI check passed (SUCCESS) and the diff contains no secret-like content.
  • Note: mergeStateStatus is BEHIND main — auto-rebase/merge tooling should update the branch before merge; not a review blocker.

CI status

All substantive checks green at head SHA: Lint, ShellCheck, CodeQL (actions + python), Secret scan (gitleaks), Agent Security Scan, agent-shield, SonarCloud (quality gate passed, 0 new issues), unit-tests, holdout-guard, Graphite AI review, CodeRabbit. The CANCELLED entries in the rollup (dev-lead dispatch/ci-relay, review, Dismiss) are superseded duplicate automation runs — each has a later SUCCESS or intentional SKIPPED run, and none is a required test/lint failure. Dependency-audit jobs skipped (no matching ecosystems in a docs-only change).


Reviewed automatically by the PR-review agent (single-reviewer mode: fable 5). Reply if you need a human review.

@don-petry
don-petry disabled auto-merge August 2, 2026 16:57
@don-petry

Copy link
Copy Markdown
Collaborator Author

Dev-Lead — fix-bot-comment (no-changes)

Agent reasoning
Issues addressed: 0
- Quality gate passed; no actionable findings
Files changed: None
Skipped (informational): 0
Status: All checks passing — no action required
```
The PR is in good standing. No fixes needed.

@don-petry
don-petry enabled auto-merge (squash) August 2, 2026 16:57
@sonarqubecloud

sonarqubecloud Bot commented Aug 2, 2026

Copy link
Copy Markdown

@don-petry
don-petry merged commit ea3d062 into main Aug 2, 2026
26 of 29 checks passed
@don-petry
don-petry deleted the chore/readme-refresh branch August 2, 2026 16:59

@donpetry-bot donpetry-bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Automated review — APPROVED ✓

Risk: LOW
Reviewed commit: 5d1174ccaf224c7e1ec838e857282c1cec81566a
Review mode: triage-approved (single reviewer)

Summary

Automated weekly readme-refresh PR updating README.md and profile/README.md (+5/-1, 2 files). Adds the newly installed bmad-bgreat-suite framework (pinned @ ae8914e84b87) to the repo-structure and framework tables, adds the gitignore-standard entry to both standards indexes, and updates the bmad-bgreat-suite repo description to mention Security agents. All facts verified against live state: frameworks/bmad-bgreat-suite exists on main and commit ae8914e84b87 exists in petry-projects/bmad-bgreat-suite. Docs-only, no executable content.

Linked issue analysis

No linked issues (closingIssuesReferences is empty). This is an automated PR from the weekly readme-refresh workflow; no issue linkage is expected.

Findings

  • Triage assessment confirmed: docs-only README changes, LOW risk. Nothing missed by triage.
  • Content accuracy verified: the new frameworks/bmad-bgreat-suite subtree exists on main, the pinned commit ae8914e84b87 resolves in petry-projects/bmad-bgreat-suite, and the gitignore-standard doc link follows the same pattern as sibling entries.
  • No secrets in the diff (docs, doc links, and a commit SHA only). Gitleaks CI check passed. The run_secret_scanning MCP tool was not available in this run; noted per protocol, not blocking.
  • All prior review threads (gemini-code-assist, coderabbitai) are resolved; the CodeRabbit suggestion to mention the Security agent in the profile description was applied. reviewDecision is APPROVED with no pending review requests or unanswered human questions.

CI status

All required checks green: SonarCloud ✓, CodeQL (neutral/pass), agent-shield / AgentShield ✓, dependency-audit / Detect ecosystems ✓. Also passing: Lint, ShellCheck, unit-tests, gitleaks secret scan, Agent Security Scan, SonarCloud Quality Gate, holdout-guard, Compile agentic workflows. Two non-required dev-lead automation jobs (dispatch, ci-relay) show cancelled — these are agent-dispatch jobs superseded at 16:57Z when this review run started, not CI validation failures. The pending review / review check is this review itself.


Reviewed automatically by the PR-review agent (single-reviewer mode: fable 5). Reply if you need a human review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

readme-refresh Automated README refresh size:XS This PR changes 0-9 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants