# Copilot Instructions for PromptGenius

## Project Stack
- Next.js 14 with App Router
- TypeScript strict mode
- Tailwind CSS v4 with OKLCH color system
- Content via MDX with gray-matter frontmatter

## Conventions
- Use server components by default
- `'use client'` only for interactivity
- Path alias: `@/` → project root
- Named exports over default exports
- Co-locate tests: `*.test.ts` next to source

## Code Style
- No `any` types — use `unknown` and type guards
- Prefer early returns over nested conditionals
- Extract business logic from components into lib/ functions
- Error boundaries wrap every route segment

## Commands
- `npm run dev` — Start dev server
- `npm run build` — Production build
- `npm run lint` — ESLint + TypeScript check

## Constraints
- NEVER modify next.config.ts without asking
- NEVER install packages without confirmation
- ALWAYS run `npm run lint` after code changes

{
  "github.copilot.chat.codeGeneration.instructions": [
    {
      "text": "Use interfaces over type aliases for object shapes"
    },
    {
      "text": "Always add JSDoc comments to exported functions"
    },
    {
      "text": "Never use console.log — use the logger from src/lib/logger.ts"
    }
  ],
  "github.copilot.chat.localeOverride": "en",
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": true
  }
}

.github/
├── copilot-instructions.md    # Project-wide system prompt
├── prompts/                   # Shared prompt templates
│   └── pr-review.prompt.md
└── actions/                   # GitHub Actions workflows (Copilot can reference)

{
  "github.copilot.nextEditSuggestions.enabled": true,
  "github.copilot.chat.agent.enabled": true,
  "github.copilot.agent.codeGeneration.instructions": [
    {
      "text": "Run npm run typecheck after every code change"
    }
  ]
}