Files
agent-framework/.github/copilot-instructions.md
Eduard van Valkenburg eaad042241 .NET: Python: Add AGENTS.md files and update coding standards (#3644)
* Add AGENTS.md files and update coding standards for Python

- Add root python/AGENTS.md with project structure and package links
- Add AGENTS.md for each package describing purpose and main classes
- Update .github/copilot-instructions.md with improved structure
- Update python/CODING_STANDARD.md with API review guidance:
  - Future annotations convention (#3578)
  - TypeVar naming convention (#3594)
  - Mapping vs MutableMapping (#3577)
  - Avoid shadowing built-ins (#3583)
  - Explicit exports (#3605)
  - Exception documentation guidelines (#3410)
- Simplify python/.github/instructions/python.instructions.md to reference AGENTS.md
- Remove AGENTS.md from .gitignore

* Fix purview import path in AGENTS.md

* Address PR review comments and restructure instructions

- Slim down .github/copilot-instructions.md to reference language-specific docs
- Add ADR section explaining templates and purpose
- Create dotnet/AGENTS.md with .NET-specific build commands, conventions, and sample guidance
- Update Python build/test instructions for core vs isolated changes
- Fix Microsoft.Extensions.AI package references
- Update kwargs guidance per issue #3642
- Fix Python sample helper placement (top, not bottom)
- Document new 'typing' poe task in DEV_SETUP.md

* Add 'typing' poe task to run both pyright and mypy

* Add kwargs guidelines from issue #3642 to CODING_STANDARD.md

* Clarify that connector packages pull in core as dependency
2026-02-05 10:27:46 +00:00

950 B

GitHub Copilot Instructions

Microsoft Agent Framework - a multi-language framework for building, orchestrating, and deploying AI agents.

Repository Structure

  • python/ - Python implementation → see python/AGENTS.md
  • dotnet/ - C#/.NET implementation → see dotnet/AGENTS.md
  • docs/ - Design documents and architectural decision records

Architectural Decision Records (ADRs)

ADRs in docs/decisions/ capture significant design decisions and their rationale. They document considered alternatives, trade-offs, and the reasoning behind choices.

Templates:

  • adr-template.md - Full template with detailed sections
  • adr-short-template.md - Abbreviated template for simpler decisions

When proposing architectural changes, create an ADR to capture options considered and the decision rationale. See docs/decisions/README.md for the full process.