---
name: project-context
description: Establish how the AI should fetch, create, and interact with a project's individual ai-context.md file. Use when setting up a new project or looking for project repo context.
category: meta
---

> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery

# Project Context Instructions

## 🎯 Purpose
Define how the AI should locate and utilize project-specific context files (`ai-context.md` and `architecture.md`) instead of hallucinating project configurations.

## 🚨 Prohibitions
- **NEVER assume project architecture or technical decisions without checking the context files.**
- **NEVER put project-specific context inside the global `.ai/` superpower directory.**
- **NEVER create `ai-context.md` without asking the user first.** If it is missing, propose the template.
- **NEVER create a new `docs/` folder if `documentation/` or `doc/` already exists.** Use the existing standard folder.

## Workflows

### 1. Finding Context
When starting work in a new project, silently check these paths in order:
1. `docs/ai-context.md` (and `architecture.md`)
2. `documentation/ai-context.md`
3. `doc/ai-context.md`

### 2. Creating Missing Context
If no context file exists, state: *"This project does not have an `ai-context.md` file. Would you like me to create a template?"*
If the user agrees, generate the file using the exact template in `REFERENCE.md`.