# GitHub Copilot Instructions for {{PROJECT_NAME}}

## 📋 Project Overview

**Name:** {{PROJECT_NAME}}

**Description:** {{PROJECT_DESCRIPTION}}

**Stack:** {{FRAMEWORK}} ({{LANGUAGE}}) + {{DATABASE}}
---
## 📚 Documentation Reference

**⭐ CRITICAL:** Always read `AGENT.md` first for complete context.

**Key Documentation:**

- [`AGENT.md`](../../AGENT.md) - Universal AI configuration
- [`ai-instructions.md`](../../ai-instructions.md) - Tech stack and rules
- [`project-brief.md`](../../project-brief.md) - Business context
- [`README.md`](../../README.md) - Developer onboarding & commands
- [`docs/architecture.md`](../../docs/architecture.md) - System architecture
- [`docs/data-model.md`](../../docs/data-model.md) - Entities & relationships
- [`docs/code-standards.md`](../../docs/code-standards.md) - Coding standards
- [`docs/testing.md`](../../docs/testing.md) - Testing strategy
- [`docs/operations.md`](../../docs/operations.md) - Deployment & operations
- [`docs/business-flows.md`](../../docs/business-flows.md) - Business process flows
- [`docs/api.md`](../../docs/api.md) - Endpoint conventions
- [`docs/contributing.md`](../../docs/contributing.md) - Contribution workflow
- [`specs/security.md`](../../specs/security.md) - Security policies
- [`specs/configuration.md`](../../specs/configuration.md) - Environment configuration
---
## 🎯 Quick Rules

### ❌ NEVER

{{NEVER_RULES_SUMMARY}}

### ✅ ALWAYS

{{ALWAYS_RULES_SUMMARY}}
---
## 🏗️ Architecture

**Pattern:** {{ARCHITECTURE_PATTERN}}

**Structure:**

```
{{PROJECT_STRUCTURE_BRIEF}}
```
---
## 🎨 Code Style

| Setting     | Value           |
| ----------- | --------------- |
| Indentation | {{INDENTATION}} |
| Quotes      | {{QUOTE_STYLE}} |
| Line Length | {{LINE_LENGTH}} |
| Formatter   | {{FORMATTER}}   |

**Auto-format:** {{AUTO_FORMAT_COMMAND}}
---
## 🔐 Security

- **Auth:** {{AUTH_METHOD}}
- **Validation:** {{VALIDATION_LIBRARY}}
- **Password:** {{PASSWORD_HASH_ALGORITHM}}
- **NEVER** hardcode secrets
- **ALWAYS** validate user input
---
## 🧪 Testing

- **Framework:** {{TEST_FRAMEWORK}}
- **Coverage:** {{MIN_COVERAGE}}%+ required
- **Command:** `{{TEST_COMMAND}}`

**Test Pattern:**

```{{LANGUAGE}}
{{TEST_PATTERN_EXAMPLE}}
```
---
## 📝 Commit Format

```
{{COMMIT_FORMAT_EXAMPLE}}
```
---
## 💡 Copilot Workflow

1. Read `AGENT.md` for project context
2. Check `docs/` for specific area documentation
3. Follow patterns from `docs/code-standards.md`
4. Write tests alongside code
5. Validate with linter before committing
---
## 🔧 Common Commands

```bash
# Development
{{DEV_COMMAND}}

# Test
{{TEST_COMMAND}}

# Lint
{{LINT_COMMAND}}

# Format
{{FORMAT_COMMAND}}

# Build
{{BUILD_COMMAND}}
```
---
## 🎯 Code Examples

### Controller

```{{LANGUAGE}}
{{CONTROLLER_EXAMPLE_BRIEF}}
```

### Service

```{{LANGUAGE}}
{{SERVICE_EXAMPLE_BRIEF}}
```

### Repository

```{{LANGUAGE}}
{{REPOSITORY_EXAMPLE_BRIEF}}
```
---
**For complete context, always reference `AGENT.md` and project documentation.**

**Generated by:** AI Flow v1.0.0