Skip to content

mult-agentes

A multi-agent framework with 684 curated skills across 39 domains, governed by 21 absolute + 12 contextual constitutional rules and validated by 5 audit gates + 46 tests on every commit.

┌─────────────────────────────────────────────────────────────────┐
│  19 layers · 168 artifacts · 127 curated skills (4 tiers)       │
│  25 agents · 12 orchestrators · 64 sub-areas                    │
│  13 runtime modules · 7-phase pipeline · HMAC-chained audit     │
└─────────────────────────────────────────────────────────────────┘

Documentation is organized by Diátaxis

Section Purpose
📘 Tutorials Learn by doing — step-by-step lessons
🛠️ How-to guides Goal-oriented recipes ("how do I X?")
📖 Reference Specs, templates, contracts, registries, policies, runtime API
💡 Explanation Architecture, constitution, ADRs — the "why"

Why this exists

Building reliable LLM-powered systems needs more than a clever prompt:

  • Constitutional governance — 21 hard rules + 12 contextual ones, enforced at every pipeline run.
  • Spec-Driven Development (Rule 35) — every change ships with an approved spec.
  • Privacy by design — PII auto-classified, RBAC + purpose binding, HMAC-chained audit log.
  • Resource discipline — token budgets, circuit breakers, resource locks, backpressure controllers.
  • HomoSapiens lifecycle — same framework scales from MICRO (5 capsules) to SENIOR (>2000).

Quickstart

pip install -e ".[dev,test,docs]"
python scripts/setup_hooks.py
make audit       # 5 audits + drift detection
make test        # pytest unit + smoke
make docs-serve  # this site at http://localhost:8000

What's inside

Path What it is
src/ 13 runtime modules (pipeline, privacy, ai, skills, cognitive, scalability, …)
docs/reference/ 122 specs + 44 templates + 5 schemas + registries + policies
docs/explanation/ Architecture, constitution, ADRs
_framework/ Instance docs (PRD, ROADMAP, …) + runtime data (memory, locks)
scripts/ 5 audits, registry sync, marketplace fetch
tests/ 46 tests (pytest, unit + smoke)
<area>/ 39 area folders containing the 684 SKILL.md files