Skip to content

Conversation

@camilamacedo86
Copy link
Member

@camilamacedo86 camilamacedo86 commented Aug 23, 2025

This PR introduces Copilot-style instructions directly into the repository. While inspired by GitHub Copilot, these instructions are designed to be tool-agnostic, making them usable by a wide range of AI-assisted development tools and IDE integrations.

Benefits

  • Broader Compatibility: The instructions can be recognized not only by GitHub Copilot but also by other IDEs and AI tooling that support similar patterns.
  • Consistency Across Environments: Developers receive the same guidance regardless of which AI assistant they choose.
  • Future-Proofing: As new AI-powered tools emerge, they can immediately benefit from the same instruction set without requiring additional configuration.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Aug 23, 2025
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: camilamacedo86

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added approved Indicates a PR has been approved by an approver from all required OWNERS files. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 23, 2025
@camilamacedo86 camilamacedo86 changed the title ✨ (chore): Add copilot instructions for AI toolings ✨ (chore): Introduced project instructions file to guide AI tooling and IDEs. Aug 23, 2025
@camilamacedo86 camilamacedo86 force-pushed the add-copilot-instructions branch 3 times, most recently from a815cd3 to 04fdca0 Compare August 23, 2025 07:13
@camilamacedo86
Copy link
Member Author

c/c @vitorfloriano

@camilamacedo86 camilamacedo86 force-pushed the add-copilot-instructions branch from 04fdca0 to 655fb21 Compare August 23, 2025 16:48
Copy link
Contributor

@vitorfloriano vitorfloriano left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@camilamacedo86 I'm not sure if copilot-instructions.md will be considered by other AI tools.

For example, Gemini uses a file named GEMINI.md placed in root. Claude uses a CLAUDE.md file also placed in root.

It seems that there is no standard way of passing project instructions to AI. Some use .instructions.md or INSTRUCTIONS.md in root for that, but it's not a recognized practice.

// SetTemplateDefaults implements machinery.Template
func (f *CopilotInstructions) SetTemplateDefaults() error {
if f.Path == "" {
f.Path = filepath.Join(".github", "copilot_instructions.md")
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
f.Path = filepath.Join(".github", "copilot_instructions.md")
f.Path = filepath.Join(".github", "copilot-instructions.md")

See: https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions#creating-a-repository-custom-instructions-file

@camilamacedo86
Copy link
Member Author

Yep, I think might not be a good idea
let wait a little more to see if some convetion / guideline came accross

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants