-
Notifications
You must be signed in to change notification settings - Fork 603
docs(ai): Add initial AI instruction files #15772
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs(ai): Add initial AI instruction files #15772
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
Adds initial agent-facing documentation and skill placeholders to support AI-assisted workflows in the Azure Linux repo (phase 1 of the AI repo tooling plan), including a root entrypoint guide and directory-specific guidance.
Changes:
- Introduces root and per-directory
AGENTS.mdguides (repo, components, distro config). - Adds initial
.github/copilot-instructions.mdwith repo layout, concepts, and CLI reference. - Adds placeholder skill files for common tasks (
azl-add-component,azl-build-component,azl-fix-overlay).
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
AGENTS.md |
Root agent guide linking to skills and directory-specific guidance. |
base/comps/AGENTS.md |
Component-management rules and links to relevant skills/schema. |
distro/AGENTS.md |
Distro config guidance and build-default pointers. |
.github/copilot-instructions.md |
Main Copilot instruction doc: layout, concepts, CLI reference, hygiene rules. |
.github/skills/azl-add-component/SKILL.md |
Placeholder skill definition for adding components. |
.github/skills/azl-build-component/SKILL.md |
Placeholder skill definition for building/debugging components. |
.github/skills/azl-fix-overlay/SKILL.md |
Placeholder skill definition for diagnosing overlay issues. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
@dmcilvaney What feedback are you looking for? Are these really placeholders? And if so, does that mean corrections / clarifications aren't useful? |
For the placeholders themselves, no, unless you have feedback on the meta structure. This is mostly just a foundational set of instructions which the nitty gritty stuff to follow. I just wanted to ensure there was 'something' in place when adding a reference to it. |
Co-authored-by: Copilot <[email protected]>
christopherco
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
![]()
Implement phase 1 of #15628