Skip to content

Comments

docs: add hierarchical AGENTS and Copilot instruction scaffolding#2775

Open
napetrov wants to merge 4 commits intoIntelPython:masterfrom
napetrov:docs/agents-copilot-layout
Open

docs: add hierarchical AGENTS and Copilot instruction scaffolding#2775
napetrov wants to merge 4 commits intoIntelPython:masterfrom
napetrov:docs/agents-copilot-layout

Conversation

@napetrov
Copy link

@napetrov napetrov commented Feb 18, 2026

Summary

  • add root and directory-scoped AGENTS.md files for AGENTS-aware tooling context
  • add .github/copilot-instructions.md as canonical Copilot policy
  • add focused Copilot instruction files for build and testing scopes

Design goals

  • keep instructions long-lived and token-efficient
  • avoid duplicating mutable details (versions/flags/CI matrix) in instruction docs
  • keep policy split clear:
    • AGENTS.md files: directory scope/guardrails
    • .github/instructions/*.instructions.md: Copilot-specific editing hints

Added files

  • AGENTS.md
  • .github/AGENTS.md
  • .github/copilot-instructions.md
  • .github/instructions/build.instructions.md
  • .github/instructions/testing.instructions.md
  • dpnp/AGENTS.md
  • doc/AGENTS.md
  • examples/AGENTS.md
  • benchmarks/AGENTS.md
  • scripts/AGENTS.md
  • tests_external/AGENTS.md

@coveralls
Copy link
Collaborator

coveralls commented Feb 18, 2026

Coverage Status

coverage: 81.124%. remained the same
when pulling e6fc825 on napetrov:docs/agents-copilot-layout
into 30f5fd1 on IntelPython:master.

- Add precedence hierarchy for conflict resolution
- Clarify multi-directory change handling
- Add README/docs links for new contributors
- Add explicit test coverage and regression requirements
- Define user-visible changes with examples
- Add validation workflow guidance
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants