ai-superpower/.ai/instructions/behavior/project-context.instructions.md

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, find and read:

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

Use whichever documentation folder the project already has.

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:

# 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]