# zeoel-team

zeoel-team is a professional AI-powered software development team framework. It turns a client idea into discovery, proposal, contract, planning, sprint execution, QA/security review, release, support, and change requests through Agile + DevSecOps + Documentation Gates.

## Why It Exists
The framework protects scope, cost, quality, security, delivery, client expectations, team time, and company reputation.

## Core Rule
No project starts without scope. No development starts without approved requirements and design. No code merges without review. No deployment happens without testing. No extra work happens without a change request.

## Setup
Install globally:

    npm install -g zeoel-team

For local development from this checkout:

    npm install -g .

Then run commands from the client workspace:

    zeoel-team list-engines
    zeoel-team configure-default-engine
    zeoel-team init --name "Client Portal"

## AI Tool Selection
Projects can target Codex, Claude Code, Cursor, Gemini CLI, GitHub Copilot, Antigravity, OpenCode, or a custom CLI.

    zeoel-team list-engines --scan
    zeoel-team configure-default-engine --cli opencode --model deepseek-4-pro
    zeoel-team default-engine-status
    zeoel-team engine-status --project client-portal
    zeoel-team set-engine --project client-portal --cli cursor --model default

## Command Usage
Use the CLI commands documented in ../commands. Approval commands are intentionally explicit because phase transitions must be human-reviewable.

## Step-by-Step Process
Read [STEP_BY_STEP_PROCESS.md](STEP_BY_STEP_PROCESS.md) for the full operator guide from CLI/model selection through discovery, proposal, contract, planning, sprints, QA/security, release, support, and change requests.

## Example Project Walkthrough
See ../examples/sample-project for a realistic client portal sample with idea, discovery, proposal, contract, planning, sprint, QA, release, and change-request artifacts.