Claude Code Sub-Agents

May 16, 2026 ยท View on GitHub

CI

Minimal Claude Code agent bootstrapper. It installs an agent-architect agent that can create project-specific agents inside .claude/agents/.

Current Status

This repository is a small installer plus a single meta-agent. It does not ship separate frontend, backend, DevOps, or test agent template files. Those agents are generated by agent-architect after it analyzes the target project.

Because generated agents are project-specific, this repo intentionally stays focused on the bootstrapper, prompt, hook, and reusable agent template.

What It Installs

Running init.sh downloads these files into the target project:

  • .claude/agents/agent-architect.md
  • .claude/hooks/auto-agent-setup.sh
  • .claude/templates/agent.template.md
  • .claude/settings.json
  • .claude/VERSION
  • CLAUDE.md

Quick Start

Review the installer before piping it to a shell:

curl -fsSL https://raw.githubusercontent.com/charles-adedotun/claude-code-sub-agents/main/init.sh

Install into the current directory:

curl -fsSL https://raw.githubusercontent.com/charles-adedotun/claude-code-sub-agents/main/init.sh | bash

Install into a specific directory:

curl -fsSL https://raw.githubusercontent.com/charles-adedotun/claude-code-sub-agents/main/init.sh | bash -s -- /path/to/project

Then ask Claude Code:

Use agent-architect to set up agents for this project

Example Workflow

In a React and Node.js project, agent-architect is expected to inspect files such as package.json, framework dependencies, tests, and project docs, then create a small set of focused agents under .claude/agents/.

Example generated agent list:

.claude/agents/react-developer.md
.claude/agents/node-api-developer.md
.claude/agents/test-engineer.md

Each generated agent uses the installed template shape:

---
name: react-developer
description: Frontend with React and TypeScript
---

You are a frontend specialist for this project.

How It Works

  1. The installer creates .claude/ directories in the target project.
  2. It downloads the current agent-architect, hook, template, settings, and version files.
  3. agent-architect checks the target project for language and framework signals.
  4. It creates a small set of project-specific agents only when they add value.

Validation

From this repository checkout:

bash scripts/validate.sh

The validation script checks that the expected .claude files exist and that the hook is executable.

Development

bash scripts/validate.sh

License

MIT