# Project Context

## How to Load Project Context

**This file does not contain project-specific information.**

Each project maintains its own context document. When working in a project, search for `ai-context.md` in the following folders (in order):

```
docs/ai-context.md
documentation/ai-context.md
doc/ai-context.md
```

These are the standard alternatives defined in `ai-superpower/config.yaml`. Use whichever folder exists in the project. If multiple exist (unlikely), prefer the first in the list above.

Also look for `architecture.md` in the same folder:

```
docs/architecture.md
documentation/architecture.md
doc/architecture.md
```

This file contains everything you need to understand the project:
- Architecture overview
- Repository structure
- Key technical decisions
- Infrastructure and platforms
- Common debugging patterns

---

## If ai-context.md Does Not Exist

Tell the user:

> "This project does not have an `ai-context.md` file. Would you like me to create a template?"

Place it in the project's existing documentation folder (`docs/`, `documentation/`, `doc/`, etc.). If no documentation folder exists, use `docs/`.

---

## Template Structure for ai-context.md

When creating a new context file, use this structure:

```markdown
# AI Context: [Project Name]

**Updated**: YYYY-MM-DD

## Project Overview

[Short description — what does this project do?]

## Architecture

[Key components and how they connect]

## Repository Structure

[Most important directories and files]

## Key Technical Decisions

[Things the AI must know to avoid bad suggestions]

## Common Commands

[Build, run, test, deploy]

## Debugging Patterns

[How to diagnose common issues]

## What NOT to Do

[Project-specific pitfalls]
```