# AI_CONTEXT.md - {{PROJECT_NAME}}

This file provides guidance to AI coding assistants when working with code in this repository.

---

## Project Identity

**Platform:** {{PROJECT_DESCRIPTION}}
**Domain:** {{PRODUCTION_URL}}
**Tech Stack:** {{TECH_STACK}}
**Status:** {{PROJECT_STATUS}}

**Quick Reference:**
- **API:** {{API_URL}}
- **Repo:** {{REPO_URL}}
- **Deploy:** {{DEPLOYMENT_PLATFORM}}

---

## Essential Commands

### Development
```bash
{{INSTALL_COMMAND}}
{{DEV_START_COMMAND}}
```

### Testing
```bash
{{TEST_COMMAND}}                    # All tests
{{TEST_E2E_COMMAND}}               # E2E only
{{TEST_COVERAGE_COMMAND}}          # With coverage
```

### Database
```bash
{{MIGRATION_CREATE_COMMAND}}
{{MIGRATION_RUN_COMMAND}}
```

### Deployment
```bash
{{DEPLOY_COMMAND}}
```

---

## Navigation Rules

### High-Level Task (Refactoring a Flow)
**Example:** "{{EXAMPLE_REFACTOR_TASK}}"

**Chain:**
1. Start: [.k0ntext/indexes/workflows/CATEGORY_INDEX.md](./.k0ntext/indexes/workflows/CATEGORY_INDEX.md)
2. Find: Relevant category
3. Load: Domain index
4. Detail: Workflow file
5. Code: [.k0ntext/indexes/code/DOMAIN_LAYER_INDEX.md](./.k0ntext/indexes/code/DOMAIN_LAYER_INDEX.md)
6. Implement: Use appropriate specialized agent

**Context Budget:** ~40k tokens (20% of 200k window)

---

### Low-Level Task (Fix Hardcoded Value)
**Example:** "{{EXAMPLE_LOWLEVEL_TASK}}"

**Chain:**
1. Start: Search Patterns section below
2. Pattern: Use grep/find
3. Verify: [.k0ntext/indexes/code/REVERSE_INDEXES.md](./.k0ntext/indexes/code/REVERSE_INDEXES.md)
4. Fix: Direct file edits
5. Validate: Run tests

**Context Budget:** ~15k tokens (7.5% of 200k window)

---

### Feature Task (Add New Feature)
**Example:** "{{EXAMPLE_FEATURE_TASK}}"

**Chain:**
1. Start: [.k0ntext/indexes/routing/CATEGORY_INDEX.md](./.k0ntext/indexes/routing/CATEGORY_INDEX.md)
2. Route: [.k0ntext/indexes/routing/HIGH_LEVEL_ROUTER.md](./.k0ntext/indexes/routing/HIGH_LEVEL_ROUTER.md)
3. Research: /rpi-research
4. Plan: /rpi-plan
5. Implement: /rpi-implement

**Context Budget:** ~50k tokens (25% of 200k window)

---

## Search Patterns

### Finding Configuration Values

**Environment variables:**
```bash
{{CONFIG_SEARCH_PATTERN}}
```

**Hardcoded URLs/domains:**
```bash
{{URL_SEARCH_PATTERN}}
```

---

### Finding Business Logic

**Core Files:**
{{CORE_FILES_LIST}}

---

### Finding Database Schema

**Models:** {{MODELS_PATH}}
**Migrations:** {{MIGRATIONS_PATH}}

---

### Finding External Integrations

{{EXTERNAL_INTEGRATIONS_LIST}}

---

## System Architecture Mini-Map

{{ARCHITECTURE_DIAGRAM}}

---

## Index Directory

**3-Level Chain:** AI_CONTEXT.md → Category (5) → Domain (15) → Detail (53)

**Level 1 - Categories:** [.k0ntext/indexes/*/CATEGORY_INDEX.md](./.k0ntext/indexes/)
- Workflows, Code, Search, Agents, Routing

**Level 2 - Domains:** [.k0ntext/indexes/workflows/*.md](./.k0ntext/indexes/workflows/)
- {{WORKFLOW_DOMAINS_COUNT}} workflow domains, {{CODE_DOMAINS_COUNT}} code domains

**Level 3 - Details:** [.k0ntext/context/workflows/](./.k0ntext/context/workflows/), [.k0ntext/agents/](./.k0ntext/agents/), [.k0ntext/commands/](./.k0ntext/commands/)
- {{WORKFLOWS_COUNT}} workflows, {{AGENTS_COUNT}} agents, {{COMMANDS_COUNT}} commands

---

## Critical Constants

### Domain & URLs
{{CRITICAL_URLS}}

### Business Constants
{{BUSINESS_CONSTANTS}}

---

## Quick Reference

**Understanding:** [ARCHITECTURE_SNAPSHOT.md](./.k0ntext/context/ARCHITECTURE_SNAPSHOT.md), [workflows/CATEGORY_INDEX.md](./.k0ntext/indexes/workflows/CATEGORY_INDEX.md), [KNOWN_GOTCHAS.md](./.k0ntext/context/KNOWN_GOTCHAS.md)

**Implementing:** [workflows/*.md](./.k0ntext/context/workflows/), [CODE_TO_WORKFLOW_MAP.md](./.k0ntext/context/CODE_TO_WORKFLOW_MAP.md)

**Debugging:** {{DEBUGGING_QUICK_REFS}}

---

## Agent & Command Routing

**Agents:** {{AGENT_ROUTING_TABLE}}
**Full matrix:** [.k0ntext/indexes/agents/router.md](./.k0ntext/indexes/agents/router.md)

**Commands:** /rpi-research, /rpi-plan, /rpi-implement, /verify-docs-current, /validate-all, /help, /collab, /analytics
**All commands:** [.k0ntext/commands/](./.k0ntext/commands/)

---

## Gotcha Quick Reference

### {{GOTCHA_CATEGORY_1}}
{{GOTCHA_1_ITEMS}}

### {{GOTCHA_CATEGORY_2}}
{{GOTCHA_2_ITEMS}}

**Full gotchas:** [.k0ntext/context/KNOWN_GOTCHAS.md](./.k0ntext/context/KNOWN_GOTCHAS.md)

---

## Documentation System

**Navigation:** 3-level chain (AI_CONTEXT.md → Category → Domain → Detail)
**Self-maintaining:** CODE_TO_WORKFLOW_MAP.md guides updates after code changes
**Validation:** Run /verify-docs-current [file_path] after modifications
**RPI Workflow:** /rpi-research → /rpi-plan → /rpi-implement

**See:** [.k0ntext/RPI_WORKFLOW_PLAN.md](./.k0ntext/RPI_WORKFLOW_PLAN.md), [.k0ntext/README.md](./.k0ntext/README.md)

---

## Production

**Platform:** {{PRODUCTION_PLATFORM}}
**Services:** {{PRODUCTION_SERVICES}}
**Monitoring:** {{MONITORING_COMMANDS}}

---

## Key Constraints

**Migrations:** {{MIGRATION_CONSTRAINTS}}
**Testing:** {{TESTING_CONSTRAINTS}}
**Security:** {{SECURITY_CONSTRAINTS}}

---

## Maintenance

**After changes:** Check CODE_TO_WORKFLOW_MAP.md → Update workflows → Run /verify-docs-current
**Docs hub:** [.k0ntext/README.md](./.k0ntext/README.md)
**RPI:** [.k0ntext/RPI_WORKFLOW_PLAN.md](./.k0ntext/RPI_WORKFLOW_PLAN.md)

---

## AI Tools Configuration

This context is optimized for:
- **Claude Code** - Full context reading
- **GitHub Copilot** - See `.github/copilot-instructions.md`
- **Cline** - See `.clinerules`
- **Antigravity** - See `.agent/` directory

---

## Contact

{{CONTACT_INFO}}

---

**Version:** 2.0 | **Last Updated:** {{DATE}} | **Context Target:** 200k
**Architecture:** 3-Level Chain-of-Index | **Index Files:** {{INDEX_FILES_COUNT}}