CorpAI v2.0 (The Soul Upgrade)

CorpAI Hero

The open standard for AI agent organizations — a corporate hierarchy for your AI workforce, now with Operational Soul Protocols.

CorpAI Compatible Website Version

🧬 What are “Soul Protocols”?

Inspired by the industry-leading PaperclipAI standard, CorpAI v2.0 integrates Prime Directives, Tool Mandates, and Forbidden States directly into the corporate structural spec. This transforms agents from mere role-holders into Autonomous Action Units.

Imagine you have an AI company.

Not a chatbot. Not a single agent. A full organization — with a CEO that sets direction, a CTO that owns architecture, a CFO watching the budget, and dozens of specialized agents executing below them.

Who tells who what to do? How does a failure at L1 reach the OWNER? What does a cross-department request actually look like? When does a task become an escalation? What happens when two AI orgs need to work together?

CorpAI answers all of that.

It’s not a framework. It’s not a library. It’s an open standard — written in markdown, designed to be implemented in any language, on any platform, with any LLM.

The Hierarchy

graph TD
    OWNER["👤 OWNER — Human Principal"]
    CEO["[L5] CEO"]
    CFO["[L5] CFO"]
    CTO["[L5] CTO"]
    COO["[L5] COO"]
    CMO["[L5] CMO"]

    OWNER --> CEO
    CEO --> CFO & CTO & COO & CMO

    CFO --> Finance["Finance\nDirector → Analyst → Auditor → Tracker"]
    CTO --> Engineering["Engineering\nDirector → Lead → Engineer → QA"]
    CTO --> Security["Security\nDirector → Manager → Analyst → Monitor"]
    CTO --> DataAI["Data/AI\nDirector → ML Lead → Scientist → Engineer"]
    COO --> Operations["Operations\nDirector → PM → Analyst → Coordinator"]
    COO --> HR["HR\nDirector → Manager → Specialist → Onboarding"]
    COO --> CS["Customer Success\nDirector → Manager → Specialist → Support"]
    CMO --> Marketing["Marketing\nDirector → Content → Writer → Growth"]
    CEO --> Legal["Legal\nDirector → Compliance → Contract → Policy"]

Full department charts → spec/diagrams/org-chart.md

Quick Start

# Install the CLI
pip install corpai

# Validate any CorpAI org
git clone https://github.com/Arigitshub/CorpAI
cd CorpAI

corpai lint                                              # validate all roles
corpai graph                                             # ASCII org tree
corpai simulate --from CEO --to "QA Tester" --priority P2   # trace a message
corpai info                                              # org summary

What’s Inside

Core Spec

| File | What it defines | |—|—| | CODEX.md | The founding philosophy | | spec/ranks.md | L1–L5 rank system with custom tier support | | spec/communication.md | Message types, format, priority levels | | spec/escalation.md | Escalation triggers and OWNER notifications | | spec/lifecycle.md | Agent lifecycle: Proposed → Active → Decommissioned | | spec/cross-department.md | How departments interact and coordinate | | spec/multi-org.md | Federation protocol for inter-org communication | | spec/message-examples.md | Real message examples for every type | | spec/glossary.md | Every term, defined | | spec/faq.md | Common questions answered |

Roles (46 defined)

| Department | Roles | |—|—| | Executive | OWNER, CEO, CFO, CTO, COO, CMO | | Engineering | Director, Team Lead, Senior Engineer, Engineer, QA Lead, QA Tester | | Finance | Director, Financial Analyst, Auditor, Budget Tracker | | Marketing | Director, Content Lead, Growth Specialist, Brand Strategist, Content Writer | | Operations | Director, Project Manager, Process Analyst, Coordinator | | Legal | Director, Compliance Specialist, Contract Reviewer, Policy Checker | | HR | Director, HR Manager, Talent Specialist, Onboarding Agent | | Security | Director, Security Manager, Threat Analyst, Monitor Agent | | Data/AI | Director, ML Lead, Data Scientist, Data Engineer, Data Processor | | Customer Success | Director, CS Manager, Account Specialist, Support Agent |

Templates & Resources

| File | What it’s for | |—|—| | templates/role-template.md | Create a new role | | templates/config-example.md | Configure your org | | examples/real-world-mapping.md | Map real jobs to CorpAI roles | | CERTIFIED.md | CorpAI Certified program | | CHANGELOG.md | Version history |

CorpAI CLI

The official validator and tooling for this spec:

pip install corpai
Command What it does
corpai lint Validates all role files — 11 checks + cross-role chain verification
corpai graph ASCII tree or Mermaid org chart, filter by dept
corpai simulate Traces every hop a TASK or ESCALATION makes
corpai info Org summary — roles, departments, rank distribution

→ Arigitshub/corpai-cli

CorpAI Compatible

Implementing this spec? Add the badge to your repo → BADGE.md

Want CorpAI Certified status? → CERTIFIED.md

Roadmap

Full roadmap → ROADMAP.md

Community