Last updated: Sep 11, 2025, 03:42 PM UTC

File Labeling System Guide

Status: Complete
Purpose: Understanding how Sasha organizes and uses different types of documents in the knowledge management system

Overview

Sasha's intelligence comes from a carefully organized collection of markdown files, each serving a specific purpose in the AI knowledge system. To help users understand and navigate this system, we use a professional file labeling system that categorizes documents by their function and purpose.

This guide explains how the labeling system works, what each category means, and how Sasha uses different document types to provide intelligent assistance.

Document Categories

Specialist Documents

  • Label: Specialist
  • Color: Purple
  • Location: /docs/specialists/
  • Purpose: Configure AI specialists with specific domain expertise
  • Examples:
    • technical-sasha.md - Technical implementation specialist
    • marketing-sasha.md - Marketing strategy specialist
    • compliance-sasha.md - Regulatory compliance specialist
  • How Sasha uses them: These files define specialized AI agents with focused expertise areas, allowing Sasha to provide deep, contextual advice in specific domains

Guide Documents

  • Label: Guide
  • Color: Green
  • Location: /docs/guides/
  • Purpose: Step-by-step implementation instructions and how-to documentation
  • Examples:
    • docker-setup-guide.md - Container deployment instructions
    • api-integration-guide.md - API implementation steps
    • testing-framework-guide.md - Quality assurance procedures
  • How Sasha uses them: Reference materials for providing detailed implementation guidance and troubleshooting assistance

Prompt Documents

  • Label: Prompt
  • Color: Orange
  • Location: /docs/prompts/
  • Purpose: Template instructions and prompt engineering examples
  • Examples:
    • organization-analyzer.md - Company research templates
    • entity-verification-prompt.md - Verification procedures
  • How Sasha uses them: Pre-built instruction templates that ensure consistent, high-quality responses for common tasks

Research Documents

  • Label: Research
  • Color: Sky Blue
  • Location: /docs/organization/, /docs/research/
  • Purpose: Analysis and insights generated by Sasha
  • Examples:
    • company-overview.md - Organizational analysis
    • market-position.md - Competitive landscape research
    • knowledge-synthesis.md - Integrated insights
  • How Sasha uses them: Self-generated research that Sasha references for context-aware responses about specific organizations or topics

Knowledge Documents

  • Label: Knowledge
  • Color: Blue
  • Location: /docs/local/, uploaded files
  • Purpose: Core organizational data and user-uploaded content
  • Examples:
    • Company policies and procedures
    • Employee handbooks
    • Financial reports
    • Marketing materials
  • How Sasha uses them: Primary source material for understanding your organization's specific context, culture, and operational requirements

Policy Documents

  • Label: Policy
  • Color: Red
  • Location: /docs/policies/
  • Purpose: Standards, frameworks, and methodological guidelines
  • Examples:
    • code-quality-standards.md - Development standards
    • security-framework.md - Security protocols
    • compliance-methodology.md - Regulatory compliance
  • How Sasha uses them: Foundational standards that ensure all recommendations and guidance align with established best practices

Tutorial Documents

  • Label: Tutorial
  • Color: Teal
  • Location: /docs/getting-started/
  • Purpose: Learning resources and onboarding materials
  • Examples:
    • welcome.md - Introduction to the system
    • quick-start.md - Basic usage guide
    • first-project.md - Initial project setup
  • How Sasha uses them: Educational content for helping users understand and effectively use the Sasha system

Case Study Documents

  • Label: Case Study
  • Color: Violet
  • Location: /docs/case-studies/
  • Purpose: Real-world examples and practical applications
  • Examples:
    • digital-transformation-analysis.md - Transformation case study
    • procurement-analysis.md - Process improvement example
  • How Sasha uses them: Concrete examples that illustrate successful implementations and lessons learned

Visual Identification in the Files Panel

Label Display

Each markdown file displays a small, professional badge next to the filename indicating its category:

🧠 technical-sasha.md [Specialist]
🧠 docker-setup-guide.md [Guide]
🧠 company-research.md [Research]
🧠 employee-handbook.md [Knowledge]

Color Coding System

Category Color Usage
Specialist Purple AI agent configurations
Guide Green Implementation instructions
Prompt Orange Template instructions
Research Sky Blue Sasha-generated analysis
Knowledge Blue Your organizational data
Policy Red Standards and frameworks
Tutorial Teal Learning resources
Case Study Violet Real-world examples

Knowledge Base Overview

The Files panel includes a collapsible banner that shows:

  • Total count of knowledge files
  • Breakdown by category
  • Brief explanation of how Sasha uses each type

Directory Organization

Standard Structure

docs/
├── specialists/        # AI agent configurations
├── guides/            # Implementation instructions
├── prompts/           # Template instructions
├── organization/      # Sasha-generated research
├── local/            # User-uploaded knowledge
├── policies/         # Standards and frameworks
├── getting-started/  # Learning resources
└── case-studies/     # Examples and analyses

Best Practices

File Naming

  • Use descriptive, meaningful names
  • Include keywords that indicate content
  • Keep names concise but informative
  • Use kebab-case formatting (my-document-name.md)

Organization

  • Place files in the appropriate category directory
  • Group related documents together
  • Maintain consistent structure across categories
  • Update the knowledge base regularly

Content Standards

  • Include clear purpose statements
  • Use consistent formatting and style
  • Add relevant tags and metadata
  • Cross-reference related documents

How Sasha Uses the Knowledge System

Context Awareness

Sasha's responses are informed by the entire knowledge base, with different document types serving specific functions:

  1. Knowledge files provide organizational context
  2. Specialist files enable domain expertise
  3. Guide files support implementation assistance
  4. Policy files ensure compliance and standards
  5. Research files offer analytical insights
  6. Case studies provide practical examples

Dynamic Learning

As new documents are added to the knowledge base, Sasha automatically incorporates them into her understanding, continuously expanding her ability to provide relevant, context-aware assistance.

Quality Assurance

The labeling system helps ensure that:

  • Information is properly categorized
  • Users can quickly find relevant content
  • Sasha can apply the right type of knowledge to each query
  • The knowledge base remains well-organized and maintainable

Benefits of the Labeling System

For Users

  • Quick Navigation: Immediately understand document purposes
  • Better Organization: Find information faster
  • Clear Context: Understand how Sasha uses each document
  • Professional Interface: Clean, uncluttered file browsing

For Sasha

  • Improved Context Selection: Choose the right knowledge for each response
  • Enhanced Accuracy: Apply domain-specific expertise appropriately
  • Better Recommendations: Reference the most relevant documentation
  • Consistent Quality: Follow established standards and frameworks

For Organizations

  • Knowledge Governance: Maintain organized, categorized information
  • Team Collaboration: Clear documentation structure for all team members
  • Scalability: Easy to add new categories and expand the system
  • Audit Trail: Track different types of organizational knowledge

Conclusion

The file labeling system is a key component of Sasha's intelligence infrastructure. By understanding how documents are categorized and used, you can better organize your knowledge base and get more value from Sasha's assistance.

This system evolves with your needs - new categories can be added, and existing ones can be refined to better serve your organization's specific requirements.

For questions about the labeling system or suggestions for improvements, refer to the knowledge management team or update this guide accordingly.