Github Copilot Starter

Main repository instructions that apply to all Copilot interactions. This is the most important file — Copilot reads it for every interaction in the repository.

Use this structure:

# {Project Name} — Copilot Instructions

## Project Overview
Brief description of what this project does and its primary purpose.

## Tech Stack
List the primary language, frameworks, and key dependencies.

## Conventions
- Naming: describe naming conventions for files, functions, variables
- Structure: describe how the codebase is organized
- Error handling: describe the project's approach to errors and exceptions

## Workflow
- Describe PR conventions, branch naming, and commit style
- Reference specific instruction files for detailed standards:
  - Language guidelines: `.github/instructions/{language}.instructions.md`
  - Testing: `.github/instructions/testing.instructions.md`
  - Security: `.github/instructions/security.instructions.md`
  - Documentation: `.github/instructions/documentation.instructions.md`
  - Performance: `.github/instructions/performance.instructions.md`
  - Code review: `.github/instructions/code-review.instructions.md`

2. .github/instructions/ Directory

Create specific instruction files:

• {primaryLanguage}.instructions.md - Language-specific guidelines
• testing.instructions.md - Testing standards and practices
• documentation.instructions.md - Documentation requirements
• security.instructions.md - Security best practices
• performance.instructions.md - Performance optimization guidelines
• code-review.instructions.md - Code review standards and GitHub review guidelines

3. .github/skills/ Directory

Create reusable skills as self-contained folders:

• setup-component/SKILL.md - Component/module creation
• write-tests/SKILL.md - Test generation
• code-review/SKILL.md - Code review assistance
• refactor-code/SKILL.md - Code refactoring
• generate-docs/SKILL.md - Documentation generation
• debug-issue/SKILL.md - Debugging assistance

4. .github/agents/ Directory

Always create these 4 agents:

• software-engineer.agent.md
• architect.agent.md
• reviewer.agent.md
• debugger.agent.md

For each, fetch the most specific match from awesome-copilot agents. If none exists, use the generic template.

Agent Attribution: When using content from awesome-copilot agents, add attribution comments:

<!-- Based on/Inspired by: https://github.com/github/awesome-copilot/blob/main/agents/[filename].agent.md -->

5. .github/workflows/ Directory (only if user uses GitHub Actions)

Skip this section entirely if the user answered "no" to GitHub Actions.

Create Coding Agent workflow file:

• copilot-setup-steps.yml - GitHub Actions workflow for Coding Agent environment setup

CRITICAL: The workflow MUST follow this exact structure:

• Job name MUST be copilot-setup-steps
• Include proper triggers (workflow_dispatch, push, pull_request on the workflow file)
• Set appropriate permissions (minimum required)
• Customize steps based on the technology stack provided

Content Guidelines

For each file, follow these principles:

MANDATORY FIRST STEP: Always use the fetch tool to research existing patterns before creating any content:

1. Fetch specific instruction from awesome-copilot docs: https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md
2. Fetch specific agents from awesome-copilot docs: https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md
3. Fetch specific skills from awesome-copilot docs: https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md
4. Check for existing patterns that match the technology stack

Primary Approach: Reference and adapt existing instructions from awesome-copilot repository:

• Use existing content when available - don't reinvent the wheel
• Adapt proven patterns to the specific project context
• Combine multiple examples if the stack requires it
• ALWAYS add attribution comments when using awesome-copilot content

Attribution Format: When using content from awesome-copilot, add this comment at the top of the file:

<!-- Based on/Inspired by: https://github.com/github/awesome-copilot/blob/main/instructions/[filename].instructions.md -->

Examples:

<!-- Based on: https://github.com/github/awesome-copilot/blob/main/instructions/react.instructions.md -->
---
applyTo: "**/*.jsx,**/*.tsx"