Dockerized the project

.dockerignore

@@ -0,0 +1,37 @@
+# Git
+.git
+.gitignore
+
+# Node
+node_modules
+npm-debug.log
+dist
+coverage
+
+# Python
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+env
+venv
+pip-log.txt
+pip-delete-this-directory.txt
+.tox
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.log
+.pytest_cache
+
+# Docker
+docker-compose.yml
+Dockerfile
+.dockerignore
+
+# Environment
+.env

README.md

@@ -352,7 +352,17 @@ This section explains how to run Coderrr locally from source for development or
 git clone https://github.com/Akash-nath29/Coderrr.git
 cd Coderrr
 ```
-### 2. Backend Setup (FastAPI)
+### 2. Backend Setup
+You can run the backend using Docker (recommended) or set it up manually.
+
+#### Option A: Docker (Recommended)
+
+```bash
+docker compose up --build
+```
+The backend will be started at `http://localhost:5000` with hot-reloading enabled.
+
+#### Option B: Manual Setup (FastAPI)
 
 ```bash
 cd backend

backend/Dockerfile

@@ -0,0 +1,27 @@
+# Use official Python 3.11 slim image
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+# Install system dependencies (if any needed, e.g. for build tools)
+# RUN apt-get update && apt-get install -y --no-install-recommends gcc && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first to leverage cache
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Expose the API port
+EXPOSE 5000
+
+# Run the application
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "5000"]

docker-compose.yml

@@ -0,0 +1,21 @@
+
+
+services:
+  backend:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    container_name: coderrr-backend
+    ports:
+      - "5000:5000"
+    volumes:
+      - ./backend:/app
+    environment:
+      - HOST=0.0.0.0
+      - PORT=5000
+    # Load environment variables from .env file if it exists
+    env_file:
+      - .env
+    # Override command to enable hot reloading for development
+    command: uvicorn main:app --host 0.0.0.0 --port 5000 --reload
+    restart: unless-stopped

src/agent.js

@@ -46,7 +46,8 @@ class Agent {
     this.scanOnFirstRequest = options.scanOnFirstRequest !== false; // Default to true
     this.gitEnabled = options.gitEnabled || false; // Git auto-commit feature (opt-in)
     this.maxHistoryLength = options.maxHistoryLength || 10; // Max conversation turns to keep
-    this.customPrompt = null; // Custom system prompt from Coderrr.md
+    this.skillsPrompt = null; // Skills prompt from Skills.md (persistent skills)
+    this.customPrompt = null; // Custom system prompt from Coderrr.md (task-specific)
 
     // Initialize project-local storage and load cross-session memory
     configManager.initializeProjectStorage(this.workingDir);
@@ -84,15 +85,32 @@ class Agent {
     ui.info('Conversation history cleared');
   }
 
+  /**
+   * Load skills prompt from Skills.md in project directory
+   * Skills are persistent guidance that applies to all tasks (e.g., design guidelines)
+   */
+  loadSkillsPrompt() {
+    try {
+      const skillsPath = path.join(this.workingDir, 'Skills.md');
+      if (fs.existsSync(skillsPath)) {
+        this.skillsPrompt = fs.readFileSync(skillsPath, 'utf8').trim();
+        ui.info('Loaded skills from Skills.md');
+      }
+    } catch (error) {
+      ui.warning(`Could not load Skills.md: ${error.message}`);
+    }
+  }
+
   /**
    * Load custom system prompt from Coderrr.md in project directory
+   * This is task-specific guidance that may change per task
    */
   loadCustomPrompt() {
     try {
       const customPromptPath = path.join(this.workingDir, 'Coderrr.md');
       if (fs.existsSync(customPromptPath)) {
         this.customPrompt = fs.readFileSync(customPromptPath, 'utf8').trim();
-        ui.info('Loaded custom system prompt from Coderrr.md');
+        ui.info('Loaded task prompt from Coderrr.md');
       }
     } catch (error) {
       ui.warning(`Could not load Coderrr.md: ${error.message}`);
@@ -124,6 +142,11 @@ class Agent {
    */
   async chat(prompt, options = {}) {
     try {
+      // Load skills prompt on first request if not already loaded
+      if (this.skillsPrompt === null) {
+        this.loadSkillsPrompt();
+      }
+
       // Load custom prompt on first request if not already loaded
       if (this.customPrompt === null) {
         this.loadCustomPrompt();
@@ -144,14 +167,21 @@ class Agent {
         }
       }
 
-      // Enhance prompt with custom prompt and codebase context
+      // Build enhanced prompt with priority:
+      // 1. System Prompt (embedded in backend)
+      // 2. Skills.md (persistent skills)
+      // 3. Coderrr.md (task-specific guidance)
+      // 4. User prompt
       let enhancedPrompt = prompt;
 
-      // Prepend custom prompt if available
+      // Prepend task-specific prompt (Coderrr.md) if available
       if (this.customPrompt) {
-        enhancedPrompt = `${this.customPrompt}
+        enhancedPrompt = `[TASK GUIDANCE]\n${this.customPrompt}\n\n[USER REQUEST]\n${enhancedPrompt}`;
+      }
 
-${prompt}`;
+      // Prepend skills prompt (Skills.md) if available - comes before task prompt
+      if (this.skillsPrompt) {
+        enhancedPrompt = `[SKILLS]\n${this.skillsPrompt}\n\n${enhancedPrompt}`;
       }
 
       if (this.codebaseContext) {

src/fileOps.js

@@ -13,6 +13,7 @@ const ui = require('./ui');
 // Protected paths that should never be deleted by Coderrr
 const PROTECTED_PATHS = [
   'Coderrr.md',
+  'Skills.md',
   '.coderrr'
 ];
 

tests/unit/skills.test.js

@@ -0,0 +1,194 @@
+const fs = require('fs');
+const path = require('path');
+const Agent = require('../../src/agent');
+
+// Mock dependencies
+jest.mock('../../src/ui', () => ({
+    info: jest.fn(),
+    warning: jest.fn(),
+    success: jest.fn(),
+    error: jest.fn(),
+    spinner: jest.fn(() => ({ start: jest.fn(), stop: jest.fn() })),
+    section: jest.fn(),
+    space: jest.fn(),
+    confirm: jest.fn(),
+    displayFileOp: jest.fn(),
+    displayDiff: jest.fn()
+}));
+
+jest.mock('../../src/configManager', () => ({
+    initializeProjectStorage: jest.fn(),
+    loadProjectMemory: jest.fn(() => []),
+    saveProjectMemory: jest.fn(),
+    clearProjectMemory: jest.fn(),
+    getConfig: jest.fn()
+}));
+
+jest.mock('axios');
+
+describe('Skills.md Loading', () => {
+    let tempDir;
+    const originalCwd = process.cwd();
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Create a temporary directory for testing
+        tempDir = path.join(originalCwd, 'test-temp-skills');
+        if (!fs.existsSync(tempDir)) {
+            fs.mkdirSync(tempDir, { recursive: true });
+        }
+    });
+
+    afterEach(() => {
+        // Clean up temporary directory
+        if (fs.existsSync(tempDir)) {
+            const files = fs.readdirSync(tempDir);
+            for (const file of files) {
+                fs.unlinkSync(path.join(tempDir, file));
+            }
+            fs.rmdirSync(tempDir);
+        }
+    });
+
+    describe('loadSkillsPrompt', () => {
+        it('should load Skills.md when it exists', () => {
+            const skillsContent = '# Frontend Skills\n- Use modern design patterns';
+            fs.writeFileSync(path.join(tempDir, 'Skills.md'), skillsContent);
+
+            const agent = new Agent({ workingDir: tempDir });
+            agent.loadSkillsPrompt();
+
+            expect(agent.skillsPrompt).toBe(skillsContent);
+        });
+
+        it('should not set skillsPrompt when Skills.md does not exist', () => {
+            const agent = new Agent({ workingDir: tempDir });
+            agent.loadSkillsPrompt();
+
+            expect(agent.skillsPrompt).toBeNull();
+        });
+
+        it('should handle empty Skills.md gracefully', () => {
+            fs.writeFileSync(path.join(tempDir, 'Skills.md'), '   ');
+
+            const agent = new Agent({ workingDir: tempDir });
+            agent.loadSkillsPrompt();
+
+            expect(agent.skillsPrompt).toBe('');
+        });
+    });
+
+    describe('loadCustomPrompt', () => {
+        it('should load Coderrr.md when it exists', () => {
+            const taskContent = '# Task: Build landing page';
+            fs.writeFileSync(path.join(tempDir, 'Coderrr.md'), taskContent);
+
+            const agent = new Agent({ workingDir: tempDir });
+            agent.loadCustomPrompt();
+
+            expect(agent.customPrompt).toBe(taskContent);
+        });
+
+        it('should not set customPrompt when Coderrr.md does not exist', () => {
+            const agent = new Agent({ workingDir: tempDir });
+            agent.loadCustomPrompt();
+
+            expect(agent.customPrompt).toBeNull();
+        });
+    });
+
+    describe('Prompt Priority Order', () => {
+        it('should construct prompt with Skills.md before Coderrr.md', () => {
+            const skillsContent = '# Skills\n- Be modern';
+            const taskContent = '# Task\n- Build a form';
+            fs.writeFileSync(path.join(tempDir, 'Skills.md'), skillsContent);
+            fs.writeFileSync(path.join(tempDir, 'Coderrr.md'), taskContent);
+
+            const agent = new Agent({ workingDir: tempDir, scanOnFirstRequest: false });
+            agent.loadSkillsPrompt();
+            agent.loadCustomPrompt();
+
+            // Simulate prompt construction (from chat method logic)
+            let enhancedPrompt = 'User request';
+
+            // Task guidance first (will be wrapped by skills)
+            if (agent.customPrompt) {
+                enhancedPrompt = `[TASK GUIDANCE]\n${agent.customPrompt}\n\n[USER REQUEST]\n${enhancedPrompt}`;
+            }
+
+            // Skills prepended (comes before everything else)
+            if (agent.skillsPrompt) {
+                enhancedPrompt = `[SKILLS]\n${agent.skillsPrompt}\n\n${enhancedPrompt}`;
+            }
+
+            // Verify priority order: Skills comes first
+            expect(enhancedPrompt.startsWith('[SKILLS]')).toBe(true);
+            expect(enhancedPrompt.indexOf('[SKILLS]')).toBeLessThan(enhancedPrompt.indexOf('[TASK GUIDANCE]'));
+            expect(enhancedPrompt.indexOf('[TASK GUIDANCE]')).toBeLessThan(enhancedPrompt.indexOf('[USER REQUEST]'));
+        });
+
+        it('should work with only Skills.md (no Coderrr.md)', () => {
+            const skillsContent = '# Skills\n- Be creative';
+            fs.writeFileSync(path.join(tempDir, 'Skills.md'), skillsContent);
+
+            const agent = new Agent({ workingDir: tempDir, scanOnFirstRequest: false });
+            agent.loadSkillsPrompt();
+            agent.loadCustomPrompt();
+
+            let enhancedPrompt = 'User request';
+
+            if (agent.customPrompt) {
+                enhancedPrompt = `[TASK GUIDANCE]\n${agent.customPrompt}\n\n[USER REQUEST]\n${enhancedPrompt}`;
+            }
+
+            if (agent.skillsPrompt) {
+                enhancedPrompt = `[SKILLS]\n${agent.skillsPrompt}\n\n${enhancedPrompt}`;
+            }
+
+            expect(enhancedPrompt).toContain('[SKILLS]');
+            expect(enhancedPrompt).not.toContain('[TASK GUIDANCE]');
+            expect(enhancedPrompt).toContain('User request');
+        });
+
+        it('should work with only Coderrr.md (no Skills.md)', () => {
+            const taskContent = '# Task\n- Do something';
+            fs.writeFileSync(path.join(tempDir, 'Coderrr.md'), taskContent);
+
+            const agent = new Agent({ workingDir: tempDir, scanOnFirstRequest: false });
+            agent.loadSkillsPrompt();
+            agent.loadCustomPrompt();
+
+            let enhancedPrompt = 'User request';
+
+            if (agent.customPrompt) {
+                enhancedPrompt = `[TASK GUIDANCE]\n${agent.customPrompt}\n\n[USER REQUEST]\n${enhancedPrompt}`;
+            }
+
+            if (agent.skillsPrompt) {
+                enhancedPrompt = `[SKILLS]\n${agent.skillsPrompt}\n\n${enhancedPrompt}`;
+            }
+
+            expect(enhancedPrompt).not.toContain('[SKILLS]');
+            expect(enhancedPrompt).toContain('[TASK GUIDANCE]');
+            expect(enhancedPrompt).toContain('User request');
+        });
+
+        it('should work with neither Skills.md nor Coderrr.md', () => {
+            const agent = new Agent({ workingDir: tempDir, scanOnFirstRequest: false });
+            agent.loadSkillsPrompt();
+            agent.loadCustomPrompt();
+
+            let enhancedPrompt = 'User request';
+
+            if (agent.customPrompt) {
+                enhancedPrompt = `[TASK GUIDANCE]\n${agent.customPrompt}\n\n[USER REQUEST]\n${enhancedPrompt}`;
+            }
+
+            if (agent.skillsPrompt) {
+                enhancedPrompt = `[SKILLS]\n${agent.skillsPrompt}\n\n${enhancedPrompt}`;
+            }
+
+            expect(enhancedPrompt).toBe('User request');
+        });
+    });
+});