zzaia-workspace

ZZAIA Agentic Workspace

Multi-agent orchestration system for software engineering workflows across analytics, development, documentation, and management.

🚀 Quick Start

For full onboarding instructions see QUICKSTART.md.

Use as Remote Plugin

/plugin marketplace add zzaia/zzaia-agentic-workspace
/plugin install zzaia-workspace@zzaia

🏗️ Command Hierarchy

Commands are organized in a five-layer hierarchy. Each layer calls into the next, enabling complex automation through composition:

sequenceDiagram
    participant O as /orchestrator:*
    participant W as /workflow:*
    participant B as /behavior:*
    participant S as /capability:*
    participant T as templates/

    O->>W: dispatch workflows (parallel or sequential)
    W->>B: sequence domain operations
    B->>S: invoke reusable capabilities
    S->>T: populate markdown blueprints
    T-->>S: structured content
    S-->>B: capability result
    B-->>W: operation complete
    W-->>O: workflow result

Layer	Prefix	Responsibility
Orchestrator	/orchestrator:*	Multi-item coordination — dispatches workflows in parallel or sequentially based on dependency analysis
Workflow	/workflow:*	Sequence of behaviors for a complete task (e.g. implement a work item end-to-end)
Behavior	/behavior:*	Single domain operation with agent delegation (e.g. run a pipeline, create a PR)
Capability	/capability:*	Self-contained capability with SKILL.md, template.md, examples/, scripts/
Template	templates/	Markdown blueprints filled in by capabilities with real conversation context

⚡ End-to-End Automation

From a product specification document to production-ready - human super-visioned automated flow.

sequenceDiagram
    actor U as Product Spec
    participant A as workflow:remote:architect
    actor T as Tech Team
    participant I as orchestrator:implement
    participant D as dev/stg
    participant H as workflow:remote:homologate

    U->>A: PDF / Word / MD / POC
    A-->>T: BDD + Epic + Work Items + SDDs
    T-->>A: Review and update SDDs
    A->>I: Approved work items
    I-->>T: All PRs created
    T-->>I: Review and complete PRs
    I->>D: Deploy
    loop Until no bugs
        D->>H: E2E BDD
        H-->>I: Bug work items
        I-->>T: Bug fix PRs
        T-->>I: Review and complete PRs
        I->>D: Deploy fix
    end
    D-->>U: Ready for Production

Example Commands

# 1. Generate BDD, Epic, Work Items and SDDs from a product spec document
/workflow:remote:architect --selected-work-item 2001 --project MyProject --description "Feature description" --doc ./spec.pdf

# 2. Implement all approved work items in parallel — all PRs created via agent teams
/orchestrator:implement --work-items 2002,2003,2004 --portal azure --project MyProject --target-branch develop --description "Feature description"

# 3. Run E2E BDD against staging — creates test case, runs scenarios, files bugs
/workflow:remote:homologate --work-item 2001 --project MyProject --url https://staging.myapp.com --application MyApp --type e2e

# 4. If bugs found — implement all bug fix work items and create PRs
/orchestrator:implement --work-items 2010,2011 --portal azure --project MyProject --target-branch develop --description "Bug fixes"

# 5. Re-run until no bugs found
/workflow:remote:homologate --work-item 2001 --project MyProject --url https://staging.myapp.com --application MyApp --type e2e

This layering keeps each command focused on one responsibility and makes the system extensible without coupling between layers.

📋 Available Commands

All individual commands can be called by users for standalone operations; workflows combine multiple commands.

Analytics

Machine learning dataset discovery and analysis workflows.

• /workflow:analytics:explorate - Domain and dataset exploration
• /workflow:analytics:analyze - Dataset analysis and visualization

Development

Software development lifecycle operations.