@aaaaqwq/frontend-backend-integration

<p align="right"><a href="./README_CN.md">中文</a></p>

<p align="center">
  <img src="assets/banner-v2.png" alt="AGI Super Team: an organized cross-harness team of agents and skills" width="760">
</p>

<h1 align="center">AGI Super Team</h1>

<p align="center"><strong>An organized, installable team of Agents + Skills for local AI agent frameworks.</strong></p>

<p align="center">
  Start with an outcome. Let the CEO route executives, executives dispatch specialists, Skills supply methods, and the Governor verify the result.
</p>

AGI Super Team is not a Codex-only plugin. It is a versioned, organized Agents + Skills team system for Claude Code, Codex, OpenClaw, Hermes, and other mainstream local AI agent frameworks through 18 explicit adapters.

The same organizational contract travels across frameworks: 14 top-level roles, 92 opt-in specialists, reusable Skills, eight outcome Teams, independent review, and explicit human approval.

Each adapter maps that contract to the capabilities its target actually supports.

Install into your agent framework

List all 18 adapter targets, preview one target, then apply the same selection:

npx -y github:aAAaqwq/AGI-Super-Team --list-tools
npx -y github:aAAaqwq/AGI-Super-Team --tool claude-code
npx -y github:aAAaqwq/AGI-Super-Team --tool claude-code --install --connect
npx -y github:aAAaqwq/AGI-Super-Team --tool claude-code --doctor

Replace claude-code with an ID from --list-tools. Use --all-tools only when you intentionally want every global and project adapter. A no-argument run remains the legacy Codex preview; new automation should always name --tool or --all-tools.

Four primary frameworks

Platform	Preview command	Installed capability
Claude Code	npx -y github:aAAaqwq/AGI-Super-Team --tool claude-code	Native Markdown Agents + canonical Skills + Claude orchestrator
Codex	npx -y github:aAAaqwq/AGI-Super-Team --tool codex	Main-session CEO + native TOML Agents + canonical Skills
OpenClaw	npx -y github:aAAaqwq/AGI-Super-Team --tool openclaw	Namespaced Agent workspaces + canonical Skills + safe config merge
Hermes Agent	npx -y github:aAAaqwq/AGI-Super-Team --tool hermes	Role Skills + canonical Skills + Profiles/Kanban blueprints

--install materializes files; --install --connect also writes a connection receipt. OpenClaw dry-runs and then upserts managed agents.list entries while preserving unmanaged Agents and creating no channel bindings. Claude and Codex use filesystem discovery. Hermes emits blueprints but does not create Profiles, Cron jobs, or a Gateway. See the primary harness Adapter guide for paths, permissions, and receipt requirements.

Claude Code, Codex, OpenClaw, and Hermes are first-class entry points to the same team system, not separate editions with different organizations.

Delivery format varies because each framework exposes different native Agent and Skill primitives.

Install executive subagent groups

The default remains the 14 top-level roles. Add one executive pyramid, or all 92 optional specialists:

npx -y github:aAAaqwq/AGI-Super-Team --tool codex --with-subagents cto
npx -y github:aAAaqwq/AGI-Super-Team --tool codex --with-subagents cfo --with-subagents clo
npx -y github:aAAaqwq/AGI-Super-Team --tool codex --all-subagents --install

The hierarchy is CEO → eleven manager executives → leaf specialists. CTO also references the existing canonical PE as delivery lead; it does not create a second PE identity. All 92 source files under agents/*/subagents/*/AGENTS.md are byte-for-byte copies from pinned jnMetaCode/agency-agents-zh; local routing and safety envelopes remain separate. CEO retains coordination authority, Governor remains an independent reviewer, and PE remains CTO's canonical delivery leaf rather than another manager. See config/agent-sources.lock.json for source URLs and SHA-256 digests. Nested Codex routing requires max_depth = 2; with four threads, run one manager plus at most two children per wave.

These are 18 AI client/runtime adapter targets, not 18 interchangeable CLIs. An adapter can install native Agents, native Skills, project rules/context, or role packs degraded to Agent-as-Skill. File placement does not by itself prove that a current client loaded or executed the content.

All 18 adapter targets

Paths for global adapters are relative to the selected home; project adapters are relative to the selected project directory.

ID	Client/runtime	Scope	Agent delivery	Skill delivery	Status
claude-code	Claude Code	Global	Native Markdown Agent: .claude/agents	Canonical: .claude/skills	Structurally connected; runtime pending
codex	Codex	Global	Main-session CEO + TOML: .codex/agents	Canonical: .agents/skills	Structurally connected; runtime pending
openclaw	OpenClaw	Global	Native workspace: .openclaw/agency-agents/agi-super-team	Canonical: .openclaw/skills/agi-super-team	Structurally connected; runtime pending
hermes	Hermes Agent	Global	Role Skills: .hermes/skills/agi-super-team-agents	Canonical: .hermes/skills/agi-super-team	Blueprint connected; runtime pending
copilot	GitHub Copilot	Global	Markdown Agent: .github/agents, .copilot/agents	Native: .copilot/skills	Adapter
antigravity	Antigravity	Global	Agent: .gemini/config/agents	Native: .gemini/config/skills	Experimental
gemini-cli	Gemini CLI	Global	Markdown Agent: .gemini/agents	Native: .gemini/skills	Adapter
opencode	OpenCode	Global	Markdown Agent: .config/opencode/agents	Native: .config/opencode/skills	Adapter
cursor	Cursor	Global	Markdown Agent: .cursor/agents	Native: .cursor/skills	Experimental
trae	Trae	Project	Project rule: .trae/rules	Native: .trae/skills	Project adapter
aider	Aider	Project	Combined project rules: CONVENTIONS.md	Combined into the same project context	Project adapter
windsurf	Windsurf	Project	Combined project rules: .windsurfrules	Combined into the same project context	Project adapter
qwen	Qwen Code	Global	Markdown Agent: .qwen/agents	Native: .qwen/skills	Adapter
deerflow	DeerFlow	Project	Agent-as-Skill: skills/custom/agi-super-team-agents	Native: skills/custom/agi-super-team	Project adapter
workbuddy	WorkBuddy	Global	Agent-as-Skill: .workbuddy/skills/agi-super-team-agents	Native: .workbuddy/skills/agi-super-team	Adapter
codewhale	CodeWhale	Global	Agent-as-Skill: .codewhale/skills/agi-super-team-agents	Native: .codewhale/skills/agi-super-team	Adapter
kiro	Kiro	Global	Markdown Agent: .kiro/agents	Native: .kiro/skills	Adapter
qoder	Qoder	Global	Markdown Agent: .qoder/agents	Native: .qoder/skills	Adapter

The matrix describes the adapter contract in config/cli-adapters.json, not a claim that all 18 clients have been runtime-verified. Cursor and Antigravity are explicitly experimental.

Use the canonical orchestrate-agi-super-team Skill when a task needs the complete Team → C-suite → Skills/Subagents → Governor → CEO → human-approval flow. It detects the current framework's real delegation limits and records any flat or sequential fallback instead of pretending native nesting occurred.

Select destinations, refresh, and verify

Use --home to redirect global targets and --project-dir for project-scoped targets (the project directory defaults to the current directory). This makes a disposable audit easy:

AGI_AUDIT_HOME="$(mktemp -d "${TMPDIR:-/tmp}/agi-super-team-home.XXXXXX")"
AGI_AUDIT_PROJECT="$(mktemp -d "${TMPDIR:-/tmp}/agi-super-team-project.XXXXXX")"

npx -y github:aAAaqwq/AGI-Super-Team --tool openclaw \
  --home "$AGI_AUDIT_HOME" --project-dir "$AGI_AUDIT_PROJECT"
npx -y github:aAAaqwq/AGI-Super-Team --tool openclaw \
  --home "$AGI_AUDIT_HOME" --project-dir "$AGI_AUDIT_PROJECT" --install
npx -y github:aAAaqwq/AGI-Super-Team --tool openclaw \
  --home "$AGI_AUDIT_HOME" --project-dir "$AGI_AUDIT_PROJECT" --doctor

Run the same --install command again to refresh managed content; use --install --connect when the connection and pending receipt should also be refreshed, then repeat --doctor. Restart or open a new task in the target client and verify that it discovers the expected Agent/Skill surface. --doctor verifies installed adapter artifacts, not model behavior or task quality.

Safety and update limits

• Preview is the default and performs no writes; --install is the explicit write boundary.
• Reapplying the same selection is designed to be idempotent. Differing managed destinations are backed up before replacement; unrelated client files are outside the managed selection.
• Backups are local recovery aids, not a complete snapshot or uninstall system. Review the preview and keep your own version-control or filesystem backup for important configuration.
• Symlinked or unsafe destinations are refused. --no-agents and --no-skills can narrow the payload when needed.
• This project does not use a remote-script pipe installer; the commands above use npm's package runner and still deserve normal dependency review.
• Installation proves file materialization only. Runtime evidence for all four primary Adapters remains pending until a clean-client canary is bound to a clean source revision.

The adapter design was inspired in part by jnMetaCode/agency-agents-zh at fixed commit 2ecfabf8. AGI Super Team's manifest, payload mapping, safety behavior, and evidence boundaries are maintained here.

<p align="center">
  <a href="#install-into-your-agent-framework"><strong>Install the team</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
  <a href="./.codex/INDEX.md">Inspect the Codex package</a>
</p>

🧠 The system in one minute

Layer	What you get	Why it matters
🧩 Skills	Canonical physical SKILL.md files grouped into 14 outcome categories	Reuse focused playbooks instead of rebuilding instructions for every task
🤖 Agents	14 top-level role packs plus 92 optional direct specialists with exact routing and source locks	Give planning, engineering, product, content, research, and review clear ownership
🔁 Team packs	8 manifest-driven outcome Teams, from Solo Founder to Full Team	Start with the smallest team that can own the outcome instead of loading everything

<p>
  <a href="https://github.com/aAAaqwq/AGI-Super-Team/actions/workflows/validate-repository.yml"><img src="https://github.com/aAAaqwq/AGI-Super-Team/actions/workflows/validate-repository.yml/badge.svg" alt="Repository contracts"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-2563eb" alt="MIT license"></a>
  <img src="https://img.shields.io/badge/outcome%20fixture-validation%20pending-64748b" alt="Outcome fixture validation pending">
</p>

Team, C-suite, Subagents, and Skills form an outcome-driven graph rather than a directory inheritance chain. A Team selects the smallest sufficient C-suite; each executive receives assigned Skills on one branch and an allowlisted specialist roster on another; all evidence flows through an independent Governor gate.

flowchart TD
  O["Outcome / Brief"] --> C["Coordinator scopes"]
  C --> T["Team Kit<br/>roster, outputs, checks"]
  T --> CEO["CEO coordinator"]
  CEO --> M["Smallest sufficient C-suite"]
  CEO --> G["Independent Governor"]
  M -->|"role assignment"| SK["Canonical Skills<br/>reusable methods"]
  M -->|"bounded delegation"| L["Direct Subagents<br/>domain specialists"]
  L --> RI["Specialist role contract<br/>trigger, inputs, outputs, boundary"]
  SK --> W["Evidence-backed work"]
  RI --> W
  W --> G
  G --> CEO
  CEO --> H["Human approval<br/>release, money, credentials, irreversible actions"]

Skills and Subagents are parallel capability branches beneath a C-suite role, not an automatic Subagent → Skill inheritance chain. See How Teams, C-suite Agents, Subagents, and Skills connect for the contract compiler, runtime sequence, framework mappings, and invariants.

AGI Super Team owns the versioned content, selection rules, safe copying, and repository checks. Your configured coding-agent harness owns the model, credentials, tools, execution, and final task output.

🎯 Start with an outcome

Choose the army that matches the outcome. Each Team has a CEO coordinator, a bounded executive core, an independent Governor gate, and access to additional executives or specialists when a named evidence gap requires them.

Team army	Give it	Intended evaluation outputs	Core team
🚀 Solo Founder	A bounded product idea or launch brief	Product decision, test-first plan, launch evidence, Governor decision	CEO, CPO, PE, Governor
✍️ Content Creator	Approved sources, audience, and channel	Evidence brief, channel-ready drafts, measurement plan, claims review	CEO, CRO, CCO, CMO, Governor
📊 Quant Research	A hypothesis and historical data	Reproducible backtest specification, risk memo, independent gate	CEO, CQO, CDO, CFO, Governor
🧱 Product Delivery	A validated user problem and delivery constraints	Product brief, architecture decision, tested change, release handoff	CEO, CPO, CTO, PE, Governor
🔬 Research Decision	A consequential question and decision criteria	Research plan, evidence map, cited synthesis, decision memo	CEO, CRO, CDO, Governor
📣 Go To Market	Validated positioning and a launch/revenue objective	Positioning brief, launch assets, revenue experiment, risk gate	CEO, CPO, CMO, CCO, CSO, Governor
🚨 Operations Response	A bounded incident or delivery failure	Incident scope, containment, verified recovery, post-incident review	CEO, COO, CTO, PE, Governor
🏛️ Executive Team	A cross-functional company brief	Executive routing plan, specialist artifacts, independent review, verified handoff	All 14 top-level roles available; CEO coordinates, Governor reviews

Start with the smallest complete army that can own the outcome. full-team makes all 14 top-level roles eligible, but the CEO still dispatches only the roles and specialists justified by the brief.

⚡ Legacy generic workspace materializer

The multi-client npm installer above is the primary entry point. The older install.sh path remains useful when you want harness-neutral, inspectable role workspaces instead of a client adapter. Clone main and preview Solo Founder; preview is the default and writes nothing:

git clone --depth 1 --branch main https://github.com/aAAaqwq/AGI-Super-Team.git
cd AGI-Super-Team
git rev-parse HEAD
./install.sh --source "$PWD" --destination /path/to/review-workspace solo-founder

Inspect the selected Agents and destinations. Apply only when they match your intent:

./install.sh --source "$PWD" --destination /path/to/review-workspace --apply solo-founder

The generic installer validates every required file before publishing staged workspaces. It preserves existing persona and skill files and rejects dangerous source or destination symlinks. See setup.md for prerequisites, updates, and recovery.

The manifest separates portable required/optional Skills from harnessSpecific catalog entries and unbundled external recommendations. Generic installs copy only classes that pass the current portability contract; the complete copied payload is scanned for known host paths and runtime-only commands.

Success: the preview writes nothing; apply creates three inspectable role workspaces without overwriting existing files.

🧭 Browse skills by outcome

The root README stays curated. Use the generated catalog when you need the complete, searchable inventory.

Build and operate	Reach and create	Decide and automate
🤖 AI Agents & Orchestration	📈 Marketing, SEO & Growth	📊 Data, Analytics & Research
💻 Software Engineering	✍️ Content, Media & Publishing	🧭 Business Operations & Strategy
☁️ Cloud, DevOps & Reliability	🤝 Sales, CRM & Customer Success	⚙️ Apps & Workflow Automation
🛡️ Security, Privacy & Legal	🎨 Product, Design & UX	💹 Finance, Trading & Markets
🧰 Specialized Domains & Utilities	🇨🇳 Chinese Platform Workflows

Explore the repository by depth:

Path	Best for
Skills overview	Support levels, bounded starting points, and discovery guidance
Generated skill catalog	Every canonical physical skill grouped by task outcome
Agents	Persona, identity, workflow, and tool guidance
Practical guides	Codex, Claude Code, compatibility, team choice, and workflow boundaries
Cookbooks	Longer material for content, prompts, research, and quantitative workflows
Architecture map	Sources of truth, generated outputs, public entry points, and change ownership
Team / Agent / Skill linking model	Team selection, Manager routing, Skill assignment, Adapter compilation, and runtime delegation
Shared language	Module, Interface, Adapter, evidence, and product terminology

🔎 Find high-quality skill sources

agent-skill-repository-index turns Daniel's reviewed source list into a safe selection workflow. Compare one candidate, inspect its permissions and provenance, then install or remove it without globally activating entire repositories.

Need	Maintained reference
Compare reviewed sources	Source matrix
Inspect the dated popularity signal	Star snapshot
Install one candidate safely	Installation workflow

Stars help with discovery, not trust. The matrix records DAILY, LIBRARY, and QUARANTINE boundaries; catalogs and runtimes are never bulk-installed.

✅ What is useful today

You can already browse a deterministic skill catalog, inspect every Agent instruction, preview a manifest-selected team, and assemble local role workspaces without overwriting existing files.

Claim	Evidence	Status
Repository inventory, counts, and references	npm run validate -- --warnings-as-errors	Verified in this checkout
Generic installer preview, preflight, no-clobber, and staging	npm test	Verified in this checkout
Generated catalog covers the canonical inventory	npm run check:skills	Verified in this checkout
Primary-outcome classification agrees with the fixed reviewed set	Gold Set method + generated report	Reviewed-set gate passed in this checkout
Client loading for an adapter without a matching receipt	Revision-matched harness receipt	Validation pending
Task quality or business outcome	Public fixture, baseline, rubric, and artifacts	Validation pending

🧾 Reproducible installation receipt

Create a disposable destination, prove preview wrote nothing, apply, and verify the three expected Solo Founder workspaces:

AGI_SOLO_DEST="$(mktemp -d "${TMPDIR:-/tmp}/agi-solo-founder.XXXXXX")"

./install.sh --source "$PWD" --destination "$AGI_SOLO_DEST" solo-founder
test -z "$(find "$AGI_SOLO_DEST" -mindepth 1 -print -quit)"

./install.sh --source "$PWD" --destination "$AGI_SOLO_DEST" --apply solo-founder
test -f "$AGI_SOLO_DEST/workspace-ceo/SOUL.md"
test -f "$AGI_SOLO_DEST/workspace-pe/SOUL.md"
test -f "$AGI_SOLO_DEST/workspace-cco/SOUL.md"

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --requirement requirements-dev.txt
npm test
npm run validate -- --warnings-as-errors
npm run check:skills
npm run check:taxonomy-evaluation
npm run check:architecture

This receipt proves manifest-driven selection, preview safety, staged copying, and repository integrity for the inspected checkout and destination state. It does not prove harness loading, task quality, or business outcomes.

<details>
<summary><strong>👀 See the preview → apply → verify storyboard</strong></summary>

<p align="center">
  <img src="assets/demo-install.gif" alt="Terminal storyboard showing a read-only preview, explicit apply, and repository checks" width="760">
</p>

The animation uses sanitized paths and is illustrative, not runtime evidence. Read the storyboard transcript.

</details>

🔌 Choose a distribution

Use the 18-target npm installer for a named Agent framework, the curated Codex package for Codex-specific details, or the legacy generic workspace materializer above for harness-neutral files. The Claude Code guide and Harness compatibility guide provide additional background, but the current adapter manifest and commit-matched receipts govern support claims.

The generic path requires Bash and Node.js; repository verification also requires npm and Python 3. Exact operating-system and client-version support remains bounded by CI and published receipts. Adapter presence never establishes feature parity.

🗂️ Repository architecture

flowchart LR
  subgraph R["AGI Super Team repository: versioned content, not a runtime"]
    S["skills/<br/>reusable playbooks"]
    A["agents/<br/>14 top-level roles + 92 optional specialists"]
    M["team-manifest.json<br/>8 kits + skill mappings"]
    C["plugins/agi-super-team-codex/<br/>curated Codex package"]
  end

  S --> I["install.sh<br/>preview → preflight → staged copy"]
  A --> I
  M --> I
  I --> W["workspace-agent<br/>inspectable local files"]
  W --> H["External harness<br/>model + tools + execution"]
  C --> H
  H --> O["Task artifacts<br/>behavioral evidence pending"]

  S --> G["Catalog generator"]
  M --> G
  G --> K["catalog/<br/>generated discovery index"]

  S --> V["Validator + tests"]
  A --> V
  M --> V
  I --> V
  V --> E["Repository receipt<br/>structure + install safety"]

File or directory	Responsibility
config/team-manifest.json	Source of truth for Agents, kits, and portable, harness-specific, or external Skill assignments
config/repository-architecture.json	Machine-readable Modules, path owners, generated lineage, and Adapter status
agents/ and skills/	Authored, versioned inputs; only manifest-classified portable payloads enter generic workspaces
docs/guides/team-agent-skill-architecture.md	Team, C-suite, Subagent, Skill, Governor, and human-approval linking principles
.codex/INDEX.md	Installation guide and Codex package index
plugins/agi-super-team-codex/	Actual curated Codex plugin, skills, and bundled agent roles
install.sh	Preview-first selection, preflight, staging, and no-clobber publishing
scripts/repository_model.py	Shared inventory and manifest model used by validation and generation
catalog/	Generated discovery output; never an inventory source
tests/	Repository, installer, site-data, and SEO contracts
docs/	Project site, verification data, and editorial guides

For the authored-input, generated-output, distribution, and evidence boundaries, read the full repository architecture map, shared language, and decision records.

config/external-skill-sources.json records tombstones for removed machine-local links, including unresolved provenance fields. README text and generated catalog files are not inventory sources.

🧠 Team topology

Founder / operator
└── CEO: coordination and quality gates
    ├── CTO / PE: architecture and implementation
    ├── CPO / CCO / CMO: product, content, and growth
    ├── CQO / CFO / CDO: quantitative research, finance, and data
    ├── CLO / CRO / CSO / COO: legal, research, sales, and operations
    └── Governor: independent review and escalation

Mentor names are creative framing. They do not imply affiliation, endorsement, or guaranteed imitation.

🛡️ Boundaries and human approval

AGI Super Team is not a model, autonomous orchestrator, or agent runtime. Installing files does not make a harness load or execute them automatically.

• Inspect third-party commands and dependencies before execution.
• Never place credentials, private data, browser sessions, or production configuration in a skill or issue.
• Keep financial workflows in research or paper-trading environments until independently validated.
• Require explicit human approval for posts, messages, transactions, deployments, and destructive operations.
• Report vulnerabilities privately through GitHub Security Advisories.

🤝 Contribute and get help

• Report a reproducible issue
• Contributing and provenance
• Setup and recovery
• Security policy
• MIT License

⭐ GitHub Stars

Track AGI Super Team's public star trend over time. The live visualization is provided by Star History; click the chart to inspect the interactive timeline.

<p align="center">
  <a href="https://www.star-history.com/?type=date&amp;legend=top-left&amp;repos=aAAaqwq%2FAGI-Super-Team">
    <img src="https://api.star-history.com/svg?repos=aAAaqwq/AGI-Super-Team&amp;type=Date&amp;legend=top-left" alt="AGI Super Team Star History chart">
  </a>
  <br>
  <sub>Live chart by Star History · <a href="https://github.com/aAAaqwq/AGI-Super-Team/stargazers">View Stargazers on GitHub</a></sub>
</p>

If AGI Super Team has genuinely saved you time, feel free to Star the repository so you can find it again.