docs-v2/.context/README.md

1.3 KiB

Context Files for LLMs and AI Tools

This directory contains plans, reports, and other context files that are:

  • Used to provide context to LLMs during development
  • Not committed to the repository
  • May be transient or belong in other repositories

Directory Structure

  • plans/ - Documentation plans and roadmaps
  • reports/ - Generated reports and analyses
  • research/ - Research notes and findings
  • templates/ - Reusable templates for Claude interactions

Usage

Place files here that you want to reference--for example, using @ mentions in Claude--such as:

  • Documentation planning documents
  • API migration guides
  • Performance reports
  • Architecture decisions

Example Structure

.context/
├── plans/
│   ├── v3.2-release-plan.md
│   └── api-migration-guide.md
├── reports/
│   ├── weekly-progress-2025-07.md
│   └── pr-summary-2025-06.md
├── research/
│   └── competitor-analysis.md
└── templates/
    └── release-notes-template.md

Best Practices

  1. Use descriptive filenames that indicate the content and date
  2. Keep files organized in appropriate subdirectories
  3. Consider using date prefixes for time-sensitive content (e.g., 2025-07-01-meeting-notes.md)
  4. Remove outdated files periodically to keep the context relevant