Skip to content

docs: publish Wave 5 Phase 1 audit deliverables#790

Merged
ashleyshaw merged 2 commits into
developfrom
claude/wave-5-phase1-audit-deliverables-docs
Jun 3, 2026
Merged

docs: publish Wave 5 Phase 1 audit deliverables#790
ashleyshaw merged 2 commits into
developfrom
claude/wave-5-phase1-audit-deliverables-docs

Conversation

@ashleyshaw
Copy link
Copy Markdown
Member

Summary\nPublish the Phase 1 audit/report deliverables that were linked in closed Wave 5 issues so they are present on .\n\n## Included files\n- \n- \n- \n- \n- \n- \n- \n\n## Related issues\n- #660\n- #661\n- #664\n- #665\n- #671\n- #672\n- #673\n\n## Notes\n- This PR is docs-only and intentionally excludes config/code changes from PR #788.\n- Existing local modification to was left untouched and uncommitted per request.

Add #660 #661 #664 #665 #671 #672 #673 deliverable documents under .github/reports/audits and docs/ for publication to develop.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 3, 2026

Warning

Review limit reached

@ashleyshaw, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 55 minutes and 53 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

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.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: f0970e08-8478-4fb4-80d1-4d02df786804

📥 Commits

Reviewing files that changed from the base of the PR and between f62305a and 523d1a1.

📒 Files selected for processing (7)
  • .github/reports/audits/2026-06-03-agent-script-migration-status-audit-672.md
  • .github/reports/audits/2026-06-03-docs-folder-structure-vs-claude-boundaries-audit-665.md
  • .github/reports/audits/2026-06-03-file-organisation-migration-plan-673.md
  • .github/reports/audits/2026-06-03-file-organisation-vs-claude-boundaries-audit-671.md
  • .github/reports/audits/2026-06-03-issue-fields-config-vs-github-api-audit-660.md
  • .github/reports/audits/2026-06-03-labeling-docs-consolidation-audit-664.md
  • docs/CANONICAL_CONFIGS_GUIDE.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/wave-5-phase1-audit-deliverables-docs

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 and usage tips.

@github-actions github-actions Bot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:documentation Documentation meta:needs-changelog Requires a changelog entry before merge labels Jun 3, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

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 introduces several new audit reports and a migration plan addressing repository file organization, documentation consolidation, and canonical configuration interdependencies (such as CLAUDE.md boundaries, labeling strategy, and issue fields configuration). It also adds a new CANONICAL_CONFIGS_GUIDE.md to document the relationships between key configuration files. The reviewer feedback suggests documenting migration maps and notes in a central /docs/MIGRATION.md file and adding a corresponding validation checklist item to the migration plan.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment on lines +127 to +128
- Execute approved move or retention strategy.
- Update dependent paths if file moves occur.
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.

medium

When executing file moves or residual migrations, please ensure that any migration maps and notes are documented in the central /docs/MIGRATION.md file. This helps contributors easily track and follow migration rules across the repository.

Suggested change
- Execute approved move or retention strategy.
- Update dependent paths if file moves occur.
- Execute approved move or retention strategy.
- Update dependent paths if file moves occur, and document migration maps and notes in a central /docs/MIGRATION.md file.
References
  1. Document migration maps and notes in a central /docs/MIGRATION.md file to ensure contributors can follow migration rules mentioned in README files across the repository.

Comment on lines +158 to +159
- [ ] CI guardrails active and tested
- [ ] migration report updated with final status
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.

medium

Please add a validation checklist item to verify that any migration maps and notes have been documented in the central /docs/MIGRATION.md file.

Suggested change
- [ ] CI guardrails active and tested
- [ ] migration report updated with final status
- [ ] CI guardrails active and tested
- [ ] migration report updated with final status
- [ ] migration maps and notes documented in /docs/MIGRATION.md
References
  1. Document migration maps and notes in a central /docs/MIGRATION.md file to ensure contributors can follow migration rules mentioned in README files across the repository.

Copy link
Copy Markdown

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

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: 523d1a175b

ℹ️ 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".


## Recommended Validation Hooks

- `scripts/validation/validate-issue-fields.cjs` now includes strict cross-file parity checks for `Status`, `Priority`, and `Type` mappings.
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 Correct the validator enforcement claim

This says validate-issue-fields.cjs already performs strict cross-file parity checks, but the current validator only reads .github/issue-fields.yml and docs/ISSUE_FIELDS.md and never loads .github/labels.yml or .github/issue-types.yml, so status/priority/type drift against those canonical files would still pass. Because this guide and the #660 audit can be used to close the parity work or decide CI coverage, the inaccurate claim can leave the promised guardrail absent for canonical-config changes.

Useful? React with 👍 / 👎.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🔍 Reviewer Summary for PR #790

CI Status:success
Files changed: 0
Risk Distribution: 0 critical, 0 high, 0 medium, 0 low

Recommendations

  • Ready to proceed pending human review

@ashleyshaw ashleyshaw merged commit 420ef92 into develop Jun 3, 2026
7 of 14 checks passed
@ashleyshaw ashleyshaw deleted the claude/wave-5-phase1-audit-deliverables-docs branch June 3, 2026 20:25
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🚫 This PR description is missing required template sections.

Missing required section(s): Linked issues, Changelog, Global DoD checklist

Please update the PR body using one of the repository PR templates:

This check must pass before merge.

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

Labels

area:documentation Docs & guides lang:md Markdown content/docs meta:needs-changelog Requires a changelog entry before merge priority:normal Default priority status:needs-review Awaiting code review type:chore Chore / small hygiene change type:documentation Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant