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

name	description	category	impact
project-context	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.	meta	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.