copilot-agent-factory: Instructions file for GitHub Copilot

Template Development Instructions

Domain: Agent & Skill Template Creation
Applies To: Creating or modifying agent templates in agents/templates/ and skill templates in agents/skill-templates/

Template Structure

All agent templates must follow this structure:

1. YAML Frontmatter (Required)

---
name: agent-name
description: Clear one-sentence description of agent purpose
---

For agents with handoffs:

---
name: agent-name
description: Clear one-sentence description of agent purpose
handoffs:
  - agent: other-agent-name
    label: "Button Label"
    prompt: "Handoff prompt text"
    send: false
---

Note: VS Code (GitHub Copilot) agents do NOT include model: or triggers: fields in the YAML frontmatter. File extension must be .agent.md.

2. Agent Introduction

You are an expert {role} for {project context}.

Be specific about the agent's expertise area.

3. Your Role Section

## Your Role

- {Primary responsibility 1}
- {Primary responsibility 2}
- {What the agent reads/analyzes}
- {What the agent outputs/creates}

4. Project Knowledge Section

## Project Knowledge

- **Tech Stack:** {{tech_stack}}
- **Architecture:** {{architecture_pattern}}
- **Source Directories:**
  - `{{source_dirs}}` – {Description}
  - `{{test_dirs}}` – {Description}

Use actual placeholders that will be resolved during generation.

5. Commands/Workflow Section

## Commands

- **Command Name:** `{{command_placeholder}}` ({what it does})

## Workflow

1. {Step 1}
2. {Step 2}
3. {Step 3}

Provide concrete, executable commands when possible.

6. Standards Section (if applicable)

## Standards

- **Convention Name:** {Description with example}
- **Code Style:** {Specific rules}

7. Boundaries Section (Required)

## Boundaries

- ✅ **Always:** {Actions the agent should always take}
- ⚠️ **Ask First:** {Actions requiring user confirmation}
- 🚫 **Never:** {Forbidden actions}