Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (zeoel-framework) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Zeoel — AI Agency Multi-Agent Framework

A production-grade multi-agent orchestration framework for building enterprise-grade products. Powered by 22 highly specialized AI agents, strict frontend/ and backend/ codebase containment, rigorous multi-stage verification, and .worktrees/ sprint snapshots.

Links & Contact

NPM Package: zeoel-framework
GitHub Repository: goharabbas321/zeoel-framework
Creator: Gohar Abbas (@goharabbas321)
Telegram: @goharabbas786

What is Zeoel?

Zeoel is an AI-powered software development agency that replaces monolithic prompts with a 22-agent pipeline. Each agent has a distinct persona, curated skill pack, and specific responsibility. When you say "I want to build a SaaS product", Zeoel doesn't just start coding — it brainstorms, plans sprints, delegates to specialists, and verifies quality before shipping.

With integrated Superpowers methodologies, Zeoel protects your codebase by running all tasks directly on your main feature branches in designated frontend/ and backend/ directories, backing up every sprint into a permanent .worktrees/ snapshot, and enforcing strict verification loops.

The 4-Phase Pipeline

Phase 1: BRAINSTORM → Phase 2: PLAN → Phase 3: EXECUTE → Phase 4: VERIFY

Brainstorm — Gohar (CEO) leads a debate between all agents to define scope, architecture, and constraints.
Sprint Planning — Decomposes the brief into sprints. Gohar creates a branch (feature/sprint-N) in the root codebase so the main branch is not touched directly.
Execution — Each agent is dispatched with its curated skills to complete its task using Strict Red-Green-Refactor TDD inside frontend/ and backend/.
Verification & Snapshot — QA tests, security audits, SEO audits, and a final code review. Once passed, the branch is merged to main, and the sprint is archived into a .worktrees/sprint-N/ snapshot for permanent tracking.

The 22 Specialized Agents

Zeoel boasts a massive roster of specialized engineers, designers, and domain experts:

Role	Name	Specialty & Tech Stack
👑 CEO	Gohar	Orchestration, Sprint Planning, Worktree Snapshots
🎨 Product Designer	Mahdi	UX Flows, Accessibility, SEO-First Design
🖌️ Visual Director	Mustafa	Three.js, GSAP, Premium Styling, Framer Motion
⚛️ Sr. Frontend Eng	Karar	Next.js App Router, shadcn/ui, 3D, GSAP, SEO
🔧 Backend Engineer	Tariq	Laravel, PostgreSQL, SaaS Billing, APIs
📝 Content & SEO	Zara	Technical SEO, Keyword Strategy, Content
📱 Mobile Developer	Hassan	Flutter, Material 3, Riverpod, Kotlin/Swift
📊 Data & ML	Fatima	Postgres Analytics, ML Pipelines, ClickHouse
🐍 Python & ML Eng	Abbas	Python, Django, FastAPI, Scikit, Celery
🔍 Debugger & Perf	Sajjad	Systematic Debugging (4-phase root cause), Perf Profiling
📚 Docs & API	Baqir	Technical Writing, OpenAPI, DX
🧪 QA Engineer	Muhammad	Playwright, Cypress, Strict TDD Enforcement
🛡️ DevOps & Sec	Ali	Docker, GitHub Actions, OWASP ASI
🧠 AI Architect	Ibrahim	Multi-agent setups, MCP servers, LLM Evals
☕ Enterprise Java	Yusuf	Spring Boot, Quarkus, Enterprise Patterns
⚙️ Systems Engineer	Bilal	Go, Rust, C++, High-performance Networking
🍏 iOS Developer	Layla	SwiftUI, Swift Concurrency, CoreData
🤖 Android Dev	Hamza	Kotlin, Jetpack Compose, Clean Architecture
🏥 Healthcare	Khadija	HIPAA Compliance, EMR Integration, FHIR
⛓️ Web3 Engineer	Salman	Smart Contracts, DeFi, AMM Security
💼 Business Ops	Maryam	SaaS Billing ops, Logistics, Startup metrics

All agent names are inspired by Ahle Bait (a.s.) and the Zeoel team.

Quick Start (NPM / NPX)

You can easily initialize Zeoel into any project directory using npx.

# 1. Initialize Zeoel in your project
npx zeoel-framework init

# 2. Open your AI coding tool (Claude Code, Cursor, Copilot, Antigravity)
# 3. Tell it what you want to build

See USER_MANUAL.md for a comprehensive guide on how to interact with the agency and SETUP.md for detailed platform integrations.

How to Interact

Start the conversation: "I want to build a [your idea]"
Follow the flow: Zeoel will automatically run Phase 1 (Brainstorm) and ask clarifying questions.
Approve the Plan: After generating docs/sprint-N/plan.md, Zeoel will wait for your approval.
Watch it Work: Zeoel will write tests, execute the code directly in frontend/ and backend/, and run audits autonomously.
Ship: Review the final results in the .worktrees/sprint-N/ snapshot and merge to main!

Architecture & Codebase Containment

Zeoel heavily relies on the file system for shared memory and strict directory containment:

frontend/ — All frontend code.
backend/ — All backend code.
.worktrees/ — Runnable Git Worktree snapshots of completed sprints.
PROJECT_BRIEF.md: The master requirements document.
docs/sprint-N/plan.md: The current sprint plan.
docs/sprint-N/progress.md: Real-time task tracker updated after every task.
docs/sprint-N/deferred.md: Items pushed to the backlog.

zeoel-framework