🕌 IMH-Code — Imam Hussain Coding Harness Platform

A fast-first multi-agent AI coding harness with intelligent model routing, configurable testing, and token-saving optimizations for rapid SaaS MVP development.

📚 Documentation

For detailed information on how to configure and execute IMH-Code, see:

• User Manual — Comprehensive guide on pipeline phases, stack configurations, and custom agent systems.
• CLI Execution Guide — Command reference, usage options, aliases, and agent execution architectures.

⚡ Quick Start

1. Install Globally

npm install -g imhcode

2. Initialize a Workspace

Navigate to your project directory and run the initialization wizard:

cd your-project
imhcode

This scans your system for local engines (Claude, OpenCode, Codex, Antigravity, QwenCode, MimoCode) and sets up the Intelligent Model Routing configurations inside imhcode.config.json.

🔄 The 6-Phase Pipeline

IMH-Code enforces a fast-first software delivery pipeline:

1. Write: Describe your product requirements in docs/start.md.
2. Plan: Run imhcode plan to generate docs/brainstorming.md.
3. Brainstorm: Review recommended answers in docs/brainstorming.md and run imhcode plan again.
4. Sprint Plan: Sprints, tasks, and shell execution scripts are generated.
5. Execute: Run imhcode execute 1 (or specify sprint). Respects your selected testing mode.
6. Test: Run imhcode test to execute E2E browser tests, security audit, and SEO scans.

🛠️ Usability Upgrades (v2.0)

Version 2.0 introduces powerful new commands for codebase scanning, project imports, in-place changes, and interactive control:

• Scan & Import: Run imhcode scan or imhcode import to bring existing projects (Next.js, Laravel, React, etc.) under orchestration. Maps project folders to .imhcode/import-map.json automatically.
• In-place Modifications: Run imhcode modify "task" to auto-detect the target agent and run in-place code adjustments.
• Feature Sprint Planning: Run imhcode feature "desc" to plan a targeted 1-3 task mini-sprint for adding a new feature.
• Interactive Terminal TUI: Run imhcode (or imhcode gui) to launch a beautiful, interactive terminal user interface (TUI) to manage your projects, sprints, and code modifications via a simple console-based dashboard.

🔒 Configurable Testing Strategy

Unlike other frameworks that mandate slow TDD at every step, IMH-Code lets you choose:

• Fast Mode (Default): No tests written during development sprints. A dedicated testing sprint is appended at the end to cover unit, integration, security, and browser tests. 3-5x faster development.
• Balanced Mode: Basic smoke tests per task, full test suites at the end.
• Strict TDD: Write failing tests first before coding on every task.

🤖 19 Generic Role-Based Agents

IMH-Code replaces individual persona names with generic agents routed to the best models:

• planner: Sprint coordination and architecture.
• designer: UI/UX design (prefer Mimo v2.5 Pro).
• nextjs-executor: Next.js full-stack (prefer Mimo v2.5 Pro).
• laravel-executor: Laravel backend (prefer DeepSeek V4 Pro).
• tester: Unit/Integration/E2E tests (prefer GPT-5.5).
• security-auditor: OWASP security scans (prefer GPT-5.5).
• seo-optimizer: SEO & sitemaps (prefer GPT-5.5).
• (Run imhcode agent list to see all 19 agents)