ai-debt-manager

ai-debt-manager

AI Debt Manager 🧠

Mitigate comprehension and cognitive debt during AI-assisted development. AI Debt Manager is a lightweight developer assistant designed to bridge the gap between rapid AI code generation and human control.

Through incremental coding tasks, developers are coached to build a clear mental model of the codebase, ensuring stronger control over AI-generated code. Full AI-assisted code generation is unlocked only after the required understanding criteria are met.

📚Theoretical Framework: The core scientific and theoretical basis for this project is detailed in the document Coaching for Software Developers.pdf.

🛠️ Methodology: The method used to coach developers and keep human comprehension firmly in the loop is an inductive learning model in which the assistant guides the developer through a path of exploration, guided discovery, and problem solving.

🚀 Key Features

  • Dual LLM Orchestration: Seamlessly switch between local inference (Ollama) and any commercial OpenAI-compatible Cloud API (OpenAI, Anthropic via gateways, Groq, DeepSeek, etc.).
  • Fail-Fast Credential Validation: Real-time pre-flight connection tester against the /models schema endpoint to guarantee configurations are accurate before executing pipelines.
  • Zero-Data Extraction Architecture: The application is 100% client-side. Your source code, telemetry parameters, and API keys never touch our servers—they flow directly from your browser sandbox to your chosen LLM endpoint.
  • Persistent Configuration Caching: Secure on-the-fly synchronization with browser localStorage to keep your environment ready across sessions.

🛠️ Architecture & Core Components

The layout is optimized for an uninterrupted development workflow:

  1. Developer Workspace (Left Column): Direct input for target tasks and raw source code context (supporting functions, classes, or system architecture structures).
  2. LLM Engine Panel (Right Column - Top): The control tower. Handles local model tag verification (including automated background pulls) and custom cloud credential handshakes.
  3. Feedback Console (Right Column - Bottom): The diagnostic stream where the AI Coach outputs structural analysis, interactive reflection steps, and architecture verification questions.

🆓 Get AI Debt Manager

You can use the app for free here