# Project Context

<!-- Replace with your project name and description -->
**Project**: My Project
**Compatible With**: Gemini CLI, Claude Code, and other AI coding assistants

---

## Project Overview

<!-- Replace with your project description -->
<!-- Example: This is a Next.js web application for... -->

---

## Repository Paths

### Primary Repository
<!-- Replace with your repository path -->
**Path**: `/path/to/your/project`
**Framework**: <!-- e.g., Next.js 16, FastAPI, etc. -->
**Status**: Active Development

---

## Tech Stack

<!-- Replace with your actual tech stack -->
- **Framework**: <!-- e.g., Next.js 16 (App Router, TypeScript) -->
- **Styling**: <!-- e.g., Tailwind CSS + shadcn/ui -->
- **State Management**: <!-- e.g., React Query -->
- **Deployment**: <!-- e.g., Railway, Vercel, AWS -->
- **Package Manager**: <!-- e.g., npm, bun, pnpm -->

---

## Architecture

<!-- Replace with your architecture description -->

### Page/Module Structure
```
<!-- Replace with your directory structure -->
app/
  layout.tsx
  page.tsx
```

---

## Services & APIs

### Backend API
<!-- Replace with your API details -->
**Base URL**: `https://your-api.example.com`
**Auth**: <!-- e.g., JWT tokens, API keys -->

---

## Development Workflow

### Local Development
```bash
# Replace with your actual commands
npm run dev          # Start dev server
npm run lint         # Linting
npm run type-check   # Type checking
npm run build        # Build verification
npm test             # Run tests
```

### Pre-Commit Checklist
1. Lint - must pass
2. Type-check - must pass
3. Build - must succeed
4. Tests - all tests pass

---

## Git Workflow

### Branch Strategy
- `main` - production branch
- Feature branches: `feature/[name]`
- Bug fixes: `fix/[name]`

### Commit Rules (ZERO TOLERANCE)
**NEVER include in commits, PRs, or GitHub activity:**
- AI tool attribution of any kind
- "Generated with", "Co-Authored-By" referencing AI tools

See `.ainative/git-rules.md` for complete rules.

---

## AI Agent Configuration

### Claude Code
- Primary agent configuration: `.claude/CLAUDE.md`
- Custom rules: `.claude/rules/`

### Gemini CLI (This File)
- Project context: `.ainative/AINATIVE.md` (this file)
- Settings: `.ainative/settings.json`
- Custom rules: `.ainative/rules/`

---

## MCP Servers (Model Context Protocol)

<!-- Replace with your MCP server configuration -->
See `.claude/mcp.json` for MCP configuration.

---

## Key Files Reference

### Configuration
<!-- Replace with your key config files -->
- `package.json` - Dependencies
- `tsconfig.json` - TypeScript configuration

### Documentation
- `.ainative/AINATIVE.md` - This file
- `.claude/CLAUDE.md` - Claude Code context

---

## Environment Variables

### Required
```bash
# Replace with your required env vars
# EXAMPLE:
# NEXT_PUBLIC_SITE_URL=https://www.example.com
# NEXT_PUBLIC_API_URL=https://api.example.com
```

### Optional
```bash
# Replace with your optional env vars
```

---

## Testing

### Testing Philosophy
- Test-driven development (TDD) preferred
- BDD-style tests (Given/When/Then)
- Minimum 80% coverage for new features

---

## Resources

### Documentation
<!-- Replace with relevant documentation links -->

---

<!-- Replace with your team/project info -->
**Team**: Your Team Name
**Repository**: your-repo-name
