feat: consolidate GitHub Actions workflows by purpose

[jeremyeder]

Summary

Consolidated 16 GitHub Actions workflows down to 13 by grouping related functionality by purpose, improving organization and maintainability while maintaining all existing functionality.

• Net reduction: 16 → 13 workflows (-3 workflows)
• Actionlint compliance: 100% for all modified workflows
• Updated actions: All actions now use latest versions (v6)
• Documentation: Added GitHub Actions guidelines to CLAUDE.md, reorganized README.md with TOC and research citations

Changes

Workflows Consolidated

• ✅ Merged coverage-report.yml into ci.yml (testing in one place)
• ✅ Created docs.yml from link-check.yml (documentation validation)
• ✅ Deleted update-docs-manual.yml (redundant with automated version)
• ✅ Renamed and improved agentready-dev.yml with explicit agent invocation
• ✅ Fixed shell quoting issues (proper "$GITHUB_OUTPUT" usage, combined redirects)

Documentation Updated

• ✅ README.md: Complete reorganization with TOC, research citations with URLs, expanded CLI reference
• ✅ CLAUDE.md: Added GitHub Actions guidelines section
• ✅ All workflows: Updated to latest action versions (checkout@v6, setup-python@v6, etc.)

Final Workflow Organization (13 Total)

Purpose	Workflows
Testing & Quality	ci.yml, security.yml
Documentation	docs.yml, update-docs.yml
Release & Publishing	release.yml
Agent Automation	agentready-dev.yml, pr-review-auto-fix.yml
AgentReady Features	agentready-assessment.yml, leaderboard.yml, continuous-learning.yml, research-update.yml
Maintenance	stale-issues.yml, dependabot-auto-merge.yml

Test Plan

• All modified workflows pass actionlint validation
• Branch rebased on latest main
• README.md reorganization verified (TOC, research citations, CLI reference)
• CI runs successfully on PR
• No workflow functionality broken

Benefits

• Clearer organization: Purpose-driven structure makes workflows easier to find and understand
• Improved maintainability: Fewer files to manage, related functionality grouped together
• Better documentation: Comprehensive README with research citations, GitHub Actions guidelines in CLAUDE.md
• Modern tooling: All actions updated to latest versions

🤖 Generated with Claude Code