Skip to content

feat: ADR Agent Phase 1B — Additional Fixes & Improvements - #2014

Closed
ashleyshaw wants to merge 6 commits into
developfrom
feat/adr-agent-phase-1b-improvements
Closed

feat: ADR Agent Phase 1B — Additional Fixes & Improvements#2014
ashleyshaw wants to merge 6 commits into
developfrom
feat/adr-agent-phase-1b-improvements

Conversation

@ashleyshaw

Copy link
Copy Markdown
Member

Summary

ADR Agent Phase 1B & 1C implementation with additional quality fixes and improvements:

  • ✅ Template loader (4 variants: standard, lightweight, security, infrastructure)
  • ✅ 6 modular validation rules (unique titles, references, status, format, filename, metadata)
  • ✅ Discovery skill (find next ADR number)
  • ✅ 88 tests passing (100% pass rate)

Additional Fixes in This Branch

Test Coverage

All 88 tests passing with >85% coverage

Related Issues

Test Userand others added 6 commits August 18, 2026 15:14
Phase 1B: Templates & Validation System
- 4 ADR templates (standard, lightweight, security, infrastructure)
- Template loader with schema validation
- 6 validators (enforcing naming, date formats, frontmatter, structure, etc.)
- Validation orchestrator for multi-step checks
Phase 1C: ADR Discovery Skill
- Discovery skill for finding ADRs in repositories
- Filters by file patterns and frontmatter criteria
- Integration with Phase 1A configuration system
All 88 tests passing. Copilot code quality fixes applied.
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
The documentation pattern check was coming after the feature pattern check,
causing titles like 'docs: Add README' to match the feature pattern first
(due to 'add') instead of the documentation pattern.
Changed: Move documentation check before feature check and remove 'add'
from feature pattern to avoid false positives.
Fixes failing test: should detect type:documentation from issue titles
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- Remove backup file (adr-template-loader.js.bak) to reduce noise
- Fix enforceValidReferences() to handle both numeric and date-based ADR IDs
- Add fallback for empty slugs in generateFilename() to prevent invalid filenames
- Add complete frontmatter to adr-discovery.md with standard metadata fields
Addresses comments:
- Line 85 (enforceValidReferences pattern ordering)
- Line 133 (generateFilename empty slug fallback)
- adr-discovery.md frontmatter completion
- .bak file removal
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Fixed 40+ markdown linting violations:
- Removed trailing punctuation from headings
- Added missing blank lines around headings, lists, and code blocks
- Ensured consistent formatting with markdownlint-cli2 standards
Files fixed:
- .github/operations/MILESTONE_ALLOCATION_ANNOUNCEMENT.md
- .github/operations/MILESTONE_ALLOCATION_MONITORING.md
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- Fixed unresolved merge conflict in CHANGELOG.md from PR #1989
- Restored 5 recent entries that were inadvertently removed:
* PR #2001: PR Creation Agent Phase 3 — Skills 5 & 6
* PR #1999: CI Validators Infrastructure — validate:frontmatter:changed script
* PR #1994: Project Maintenance Agent — Phase 1 & 2 Documentation
* PR #1993: Project documentation scripts security/logic/testing fixes
* PR #1995: Phase 5A agentic release team training guide
- Restored ADR Agent Phase 1B & 1C implementation entry
- Restored Reports & Projects Restructuring Phase 4 entry
- Removed duplicate GitHub Actions v7 upgrade entry
- All recent PRs (Aug 12-18) now accurately reflected
**#1928 - Gitleaks false positive in OPENSPEC_TEMPLATE.md**
- Added gitleaks ignore comments around example curl command
- Prevents security scanner from flagging valid example bearer tokens
**#1930 - PR template validator false negatives**
- Fixed regex in sectionBody() to match any heading level (#, ##, ###)
- Changed pattern from /^##\s+.+$/m to /^#+\s+.+$/m
- Now correctly detects 'Changelog' and 'Global DoD Checklist' sections
**#1938 - Branch name validator false negative**
- Enforced strict kebab-case (lowercase, hyphens only)
- Changed regex from [a-zA-Z0-9._-]+ to [a-z0-9-]+
- Updated tests to reject uppercase letters, dots, and underscores
- Complies with CLAUDE.md requirement for lowercase, kebab-case branch names
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@coderabbitai

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

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

Next review available in:19 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

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: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 37f10f4f-e5e9-4a93-bf5f-d1026ac57007

📥 Commits

Reviewing files that changed from the base of the PR and between ccc8577 and cd19879.

📒 Files selected for processing (19)
  • .github/operations/MILESTONE_ALLOCATION_ANNOUNCEMENT.md
  • .github/operations/MILESTONE_ALLOCATION_MONITORING.md
  • .github/projects/_templates/OPENSPEC_TEMPLATE.md
  • CHANGELOG.md
  • agents/adr-generator/SKILL.md
  • agents/adr-generator/skills/adr-discovery.js
  • agents/adr-generator/skills/adr-discovery.md
  • agents/adr-generator/skills/adr-validation-orchestrator.js
  • agents/adr-generator/templates/infrastructure.md
  • agents/adr-generator/templates/lightweight.md
  • agents/adr-generator/templates/security.md
  • agents/adr-generator/templates/standard.md
  • agents/adr-generator/tests/discovery.test.js
  • agents/adr-generator/tests/template-loader.test.js
  • scripts/automation/__tests__/auto-update-all.test.js
  • scripts/automation/auto-update-all.js
  • scripts/validation/__tests__/validate-branch-name.test.js
  • scripts/validation/template-helpers.cjs
  • scripts/validation/validate-branch-name.js

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.

@github-actions

Copy link
Copy Markdown
Contributor

🚫 This PR description is missing required template content.

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

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

Empty placeholders, unchecked checklist boxes, and stub issue references do not count.

@github-actionsgithub-actionsBot added status:needs-review Awaiting code review type:feature Feature or enhancement labels Aug 18, 2026
@github-actions

Copy link
Copy Markdown
Contributor

⏱️ Aging and SLA annotation

  • Age: 0 day(s)
  • SLA state: Within SLA
  • Thresholds: warn at 7 days, breach at 14 days
  • Last updated: 2026-08-18T13:56:31.973Z

Maintained by project-meta-sync workflow.

@github-actionsgithub-actionsBot added priority:normal Default priority area:theme Theme & styles area:documentation Docs & guides area:tests Test suites & harnesses area:scripts Scripts & tooling lang:js JavaScript/TypeScript lang:md Markdown content/docs type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge labels Aug 18, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📄 README Validation

✅ All README checks passed.

CheckResult
✅ FrontmatterPassed
✅ StructurePassed

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #2014

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

Recommendations

  • ⚠️ Security-sensitive files modified (review carefully)

auto-merge was automatically disabled August 18, 2026 14:01

Pull request was closed

@ashleyshaw
ashleyshaw deleted the feat/adr-agent-phase-1b-improvements branch August 18, 2026 14:04
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guidesarea:scriptsScripts & toolingarea:testsTest suites & harnessesarea:themeTheme & styleslang:jsJavaScript/TypeScriptlang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defecttype:choreChore / small hygiene changetype:featureFeature or enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ashleyshaw