Skip to content

Latest commit

 

History

History
75 lines (53 loc) · 3.23 KB

File metadata and controls

75 lines (53 loc) · 3.23 KB

TMI Documentation

This directory contains comprehensive documentation for the TMI (Threat Modeling Interface) project, organized by audience and purpose.

Directory Structure

📋 agent/ - AI Agent Context Documentation

Documentation primarily intended to give context to AI agents working on the TMI project.

🛠️ developer/ - Development Documentation

Everything developers need to build, test, and integrate with the TMI server.

🚀 operator/ - Operations Documentation

Deployment, operations, and troubleshooting guidance for running TMI in production.

📖 reference/ - Reference Materials & Architecture

Pure reference materials, specifications, and architectural documentation.

Getting Started by Role

For Developers

Start with developer/setup/development-setup.md for local development environment setup.

For DevOps/SREs

Begin with operator/deployment/deployment-guide.md for production deployment.

For Integration Teams

Review developer/integration/client-integration-guide.md for client integration patterns.

For AI Agents

Context and instructions are available in the agent/ directory.

Documentation Conventions

  • File Naming: All documentation uses kebab-case.md naming convention
  • Cross-References: Links are maintained between related documents
  • Audience-Focused: Each directory serves a specific audience with clear purpose
  • Comprehensive Coverage: Every aspect of TMI development and operations is documented

Quick Reference

Core Setup Documents

Testing & Quality

Client Integration

Operations & Database

Contributing to Documentation

When adding new documentation:

  1. Choose the appropriate directory based on primary audience
  2. Use descriptive, hyphenated filenames
  3. Include comprehensive README updates
  4. Add cross-references to related documents
  5. Follow the established directory structure

For questions about documentation organization or to suggest improvements, please create an issue in the project repository.