Getting Started
lesson12 min

@ Mentions: Your Context Superpower

Reference files, folders, and docs to give AI perfect context

@ Mentions: Your Context Superpower

The @ symbol is your key to giving AI perfect context. Instead of explaining what's in your files, you simply reference them.

Types of @ Mentions

Mention TypeSyntaxUse Case
File@filename.mdReference a specific document
Folder@folder/Include all files in a folder
Codebase@codebaseSearch entire project
Docs@docsReference documentation
Web@webSearch the internet

PM Examples

Referencing a PRD:

Look at @prd-mobile-app.md and identify any missing success metrics

Using folder context:

Analyze all files in @user-research/ and summarize the top 5 pain points

Combining references:

Compare @competitor-analysis.md with @our-roadmap.md and identify gaps

Best Practices

  1. Be specific - Reference exact files rather than describing them
  2. Use folders - Group related files for easy bulk reference
  3. Layer context - Combine multiple @ mentions for comprehensive analysis
  4. Name files well - Clear names make @ mentions more intuitive

Pro Tip: Create a context/ folder with company info, personas, and templates. Reference it in any conversation with @context/