Cyborgs¶
What's on this page
- What a cyborg is in Inkorporated
- How YAML specs become the visual roster
- Links to schema, operating model, and generated catalog
What this enables
- Role-faithful AI assistants for every major enterprise function
- Fast developer comprehension via cards, chips, and security coloring
Definition¶
A cyborg is an AI agent persona that instantiates a job role (job_id). It is not a free-floating chatbot: it has a system prompt, personalities, tool allowlist, security level, org position, and deployment metadata.
flowchart LR
yaml[cyborgs/*.yaml]
gen[generate_cyborg_docs.py]
roster[Generated roster UI]
detail[Persona detail pages]
yaml --> gen --> roster
gen --> detail
ops[Operators] --> roster
ops --> detail| Artifact | Location |
|---|---|
| Machine source of truth | cyborgs/*.yaml |
| Visual roster | generated/index.md |
| Human role context | docs/job_roles/ |
Browse¶
| Page | Purpose |
|---|---|
| Roster | Card grid with chips + filters |
| By namespace | Deploy topology view |
| By security | Risk-tier review |
| Org graph | Mermaid reporting + stats |
| Schema | Field dictionary |
| Operating model | HITL, audit, kill switches |
| Catalog notes | How to add personas |
Regenerating¶
Do not hand-edit docs/cyborgs/generated/.