AI Workflow Guide

Overview

This guide describes the recommended workflow for using Cortex AI in your development process.

Getting Started

1. Connect Your IDE

• Install the Cortex VS Code extension
• Configure your API endpoint in settings
• Authenticate via Zitadel SSO

2. Index Your Codebase

# Trigger initial indexing
cortex index --repo /path/to/your/repo

3. Start Asking Questions

Use natural language queries to search your codebase: - "Where is user authentication implemented?" - "Show me all database migrations" - "How does the payment processing work?"

Best Practices

Context-Aware Queries

Be specific about what you're looking for: - ❌ "Fix the bug" - ✅ "Find where the null pointer exception occurs in UserService"

Using MCP with Claude Desktop

1. Configure Claude Desktop with Cortex MCP endpoint
2. Use search_codebase tool for context retrieval
3. Use edit_file for AI-assisted code changes

Commit Workflow

1. Make changes with AI assistance
2. Review all changes before committing
3. Use conventional commit messages

Troubleshooting

See Known Issues for common problems and solutions.