Add AGENTS.md for LLM coding agents and update Python requirement to 3.8+#4
Merged
tcardosoMSFT merged 3 commits intomasterfrom Mar 3, 2026
Merged
Add AGENTS.md for LLM coding agents and update Python requirement to 3.8+#4tcardosoMSFT merged 3 commits intomasterfrom
tcardosoMSFT merged 3 commits intomasterfrom
Conversation
Co-authored-by: tcardosoMSFT <17726346+tcardosoMSFT@users.noreply.github.com>
…eholder Co-authored-by: tcardosoMSFT <17726346+tcardosoMSFT@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Add documentation for the specified item
Add AGENTS.md for LLM coding agents and update Python requirement to 3.8+
Dec 11, 2025
There was a problem hiding this comment.
Pull request overview
This PR adds comprehensive technical documentation for LLM coding agents and updates Python requirements. The changes separate documentation concerns between human developers (README.md) and AI agents (AGENTS.md), while addressing outdated Python version requirements.
Key Changes:
- Created AGENTS.md with 576 lines of detailed technical documentation covering architecture patterns, function-level documentation, API endpoints, and development guidelines
- Updated Python requirement from 3.7+ to 3.8+ to reflect that Python 3.7 reached EOL in June 2023
- Enhanced README.md with Quick Links section, fixed repository URL placeholder, and added AI/LLM developers section
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| README.md | Added Quick Links section, updated Python version to 3.8+, fixed repository URL, added AI/LLM developer contributing section, updated project structure to reference AGENTS.md |
| AGENTS.md | New comprehensive technical documentation for LLM coding agents including architecture patterns, function documentation, CSV schemas, API endpoints, development guidelines, and troubleshooting |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Development Guidelines | ||
|
|
||
| ### Prerequisites | ||
| - Python 3.8 or higher (Python 3.7 reached EOL in June 2023) |
There was a problem hiding this comment.
The documentation states "Python 3.7 reached EOL June 2023" but should specify "in June 2023" for grammatical correctness.
Copilot stopped work on behalf of
tcardosoMSFT due to an error
March 3, 2026 22:15
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Added comprehensive technical documentation for LLM coding agents to complement existing human-focused README.
Changes
Created AGENTS.md (576 lines)
Updated Python requirement: 3.7+ → 3.8+ (3.7 reached EOL June 2023)
Enhanced README.md
Documentation Coverage
All 6 Python scripts documented with architecture details:
security_assessment.py(695 lines): Code scanning, secret scanning, Dependabot, branch protectionidp_assessment.py(609 lines): SSO, 2FA, permissions, environment segregation, token securityassess_copilot_repos.py(412 lines):.github/directory structure validationlist_repos_gh_cli.py,list_repos_gh_cli_optimized.py,list_and_check_repos.pyAudience Separation
Original prompt
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.