ai-superpower/.ai/skills/project-context/SKILL.md

32 lines
1.4 KiB
Markdown

---
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
impact: low
---
> **🏷️ 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`.