Production-ready specialized AI subagents for Nephio and O-RAN telecommunications automation. Properly configured for Claude Code's subagent system with correct tool assignments and YAML frontmatter format.
Visit our comprehensive documentation: https://thc1006.github.io/nephio-oran-claude-agents/
The documentation website includes:
- 📖 Detailed agent documentation
- 🎯 Interactive compatibility matrices
- 🌐 Multi-language support (English & Traditional Chinese)
- 🔍 Full-text search
- 🌙 Dark/Light theme
# Navigate to website directory
cd website
# Install dependencies
npm install
# Start development server
npm start
# Website available at http://localhost:3000/nephio-oran-claude-agents/
# Build for production
npm run build# 1. Clone the repository
git clone https://github.com/thc1006/nephio-oran-claude-agents.git
cd nephio-oran-claude-agents
# 2. Install agents globally (recommended)
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/
# 3. Verify installation
claude code
# Type: /agents
# You should see all 10 agents listed
# 4. Start using agents
claude code "Deploy O-Cloud infrastructure with Nephio"- Claude Code v1.0.60+ required for subagent support
- Agents use Claude Code's built-in tools only (Read, Write, Bash, Search, Git)
- No external tool dependencies needed
All agents enforce consistent versioning:
- O-RAN SC: L Release (released 2025-06-30)
- Nephio: R5 (v5.x)
- Go: 1.24.6
- kpt: v1.0.0-beta.55
- Kubernetes: Latest three minor releases policy
10 Production-Ready Subagents with proper YAML frontmatter and Claude Code tool configuration:
| Agent | Purpose | Model |
|---|---|---|
| nephio-infrastructure-agent | Deploy and manage Nephio infrastructure with ArgoCD GitOps | haiku |
| configuration-management-agent | YANG models, Kpt packages, Helm charts, ArgoCD ApplicationSets | haiku |
| oran-nephio-dep-doctor-agent | Diagnose and fix dependency issues in deployments | haiku |
| Agent | Purpose | Model |
|---|---|---|
| nephio-oran-orchestrator-agent | End-to-end O-RAN deployment on Nephio infrastructure | opus |
| oran-network-functions-agent | Deploy RAN network functions (CU/DU/RU) with vendor abstraction | haiku |
| performance-optimization-agent | Optimize RAN performance with AI/ML integration | haiku |
| Agent | Purpose | Model |
|---|---|---|
| monitoring-analytics-agent | Real-time monitoring with Prometheus, Grafana, and SMO integration | haiku |
| data-analytics-agent | Advanced analytics with Jupyter Notebooks and TensorFlow | haiku |
| Agent | Purpose | Model |
|---|---|---|
| security-compliance-agent | Kubernetes security and O-RAN compliance validation | haiku |
| testing-validation-agent | Comprehensive testing with ONAP OTIC framework | haiku |
The agents follow a directed acyclic graph (DAG) workflow that prevents circular dependencies:
graph TD
Start([Deploy O-RAN])
%% Stage 1: Infrastructure
Start --> infra[nephio-infrastructure-agent]
%% Stage 2: Dependencies
infra --> doctor[oran-nephio-dep-doctor-agent]
%% Stage 3: Configuration
doctor --> config[configuration-management-agent]
%% Stage 4: Network Functions
config --> nf[oran-network-functions-agent]
%% Stage 5: Operations - Multiple parallel paths
nf --> orchestrator[nephio-oran-orchestrator-agent]
nf --> monitor[monitoring-analytics-agent]
nf --> security[security-compliance-agent]
%% Stage 6: Analytics
monitor --> analytics[data-analytics-agent]
%% Stage 7: Optimization
analytics --> perf[performance-optimization-agent]
orchestrator --> perf
%% Stage 8: Testing
perf --> test[testing-validation-agent]
security --> test
%% End state
test --> End([Deployment Complete])
claude code "Deploy a complete O-RAN infrastructure with Nephio R5"claude code "Deploy Nokia CU/DU on the existing Nephio cluster"claude code "Optimize RAN performance for edge deployment"claude code "Run security compliance check for O-RAN deployment"- Vendor Abstraction: Support for Nokia, Ericsson, Samsung, ZTE
- GitOps Automation: ArgoCD ApplicationSets for declarative deployments
- AI/ML Integration: Kubeflow pipelines for RAN optimization
- Multi-Cloud: AWS, Azure, GCP, and on-premise support
- FIPS 140-3: Security compliance capability (requires validated builds)
nephio-oran-claude-agents/
├── agents/ # Agent markdown files with YAML frontmatter
├── website/ # Documentation website (Docusaurus v3)
│ ├── docs/ # Documentation content
│ ├── src/ # React components
│ └── package.json # Website dependencies
├── .github/workflows/ # CI/CD pipelines
├── tests/ # Agent tests and validation
├── tools/ # Helper scripts
└── README.md # This file
We welcome contributions! Please see our Contributing Guide for details.
# Clone repository
git clone https://github.com/thc1006/nephio-oran-claude-agents.git
cd nephio-oran-claude-agents
# Run tests
./tools/test_dag_cycles.sh
# Validate agents
./tools/validate_agents.sh
# Run documentation website
cd website && npm startThe repository includes comprehensive testing:
- DAG cycle detection
- Agent dependency validation
- Version consistency checks
- YAML frontmatter validation
Run all tests:
./tools/run_all_tests.shApache License 2.0 - See LICENSE file for details.
- Nephio Project - Cloud-native automation platform
- O-RAN Alliance - Open RAN specifications
- Claude by Anthropic - AI assistant platform
- Community Contributors - Thank you for your support!
- Documentation: https://thc1006.github.io/nephio-oran-claude-agents/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Note: This project enforces strict version normalization:
- O-RAN L (released 2025-06-30)
- Nephio R5 (v5.x)
- Go 1.24.6
- kpt v1.0.0-beta.55
- Kubernetes (latest three minor releases)
All agents and documentation maintain these version standards automatically.