CloudTeam AI-Toolkit — Enterprise AI Development Framework

> Spec-driven development powered by AI — Build with specifications first, implementation second

![Setup Time]()
![Compliance]()

⚡ Quick Install

``bash

Install globally (required)

npm install -g @cloudteam-dev/ai-toolkit

Then init in your project

cd your-project && cteam-init
`

---

⚡ Quick Start

`bash

Install globally (required)

npm install -g @cloudteam-dev/ai-toolkit

Initialize in your project

cd your-project && cteam-init

Initialize documentation structure

/docs:init
`

Setup time: < 5 minutes from install to productive use.

---

📖 What Is CloudTeam AI-Toolkit?

CloudTeam AI-Toolkit is an enterprise-grade AI development framework that standardizes how development teams work with AI assistance. Instead of ad-hoc prompts and inconsistent workflows, every task follows proven patterns backed by compliance standards.

$3

Specification → Implementation → Validation

Every change starts with clear requirements. Every implementation follows established patterns. Every deployment is validated against standards.

$3

- 24 Specialist AI Agents — Expert agents for every development role
- 51 Reusable Skills — Pre-built capabilities for common tasks
- 88 Slash Commands — Quick shortcuts for workflows
- Compliance Built-In — Automatic ISO/IEC 27001/27701/27002 + CMMI Level 3 validation
- MCP Integration — Database adapters, Figma, Playwright, MongoDB, Context7

---

🏗️ Architecture Overview

$3

`
┌─────────────────────────────────────────────────────────┐
│ CloudTeam AI-Toolkit │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 24 AI Agents │ │ 51 Skills │ │ 88 Commands │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Compliance Validation Engine │ │
│ │ (ISO 27001/27701/27002 + CMMI Level 3) │ │
│ └──────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ MCP Server Integration │ │
│ │ (Context7, MongoDB, Playwright, Figma, etc.) │ │
│ └──────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
`

$3

Core:
- Node.js 18+ (runtime)
- TypeScript (compliance validation)
- Markdown (specifications & documentation)
- Git (version control)

Optional:
- Python 3.8+ (document parser utilities)
- Database drivers (PostgreSQL, MySQL, SQLite)
- Docker (for MCP servers)

---

🚀 Installation

$3

- Claude Code (for AI agents and MCP integration)
- Node.js 18+ (for package management)
- Git (for version control)

$3

macOS/Linux:
`bash
npm install -g @cloudteam-dev/ai-toolkit
`

The installer automatically:
- Creates ~/.npm-global directory if needed
- Configures npm user-prefix
- Adds to shell PATH (.zshrc or .bashrc)

Note: After install, restart terminal or run source ~/.zshrc (or source ~/.bashrc)

Windows:
`bash
npm install -g @cloudteam-dev/ai-toolkit
`

No additional setup needed — npm uses user folder by default.

$3

Navigate to your project directory:

`bash
cd my-project

Initialize the toolkit

cteam-init

or

cloudteam-ai-init
`

This copies framework files to your project:

`
your-project/
├── .claude/ # AI agents, commands, and skills
├── docs/ # Documentation templates
├── .mcp.json # MCP server configuration
├── CLAUDE.md # Project instructions for Claude
└── LICENSE # License information
`

$3

CRITICAL: Before starting development:

`bash
/docs:init
`

This creates essential documentation structure:
- code-standards.md - Coding standards and best practices
- codebase-summary.md - High-level codebase overview
- project-overview-pdr.md - Product Development Requirements
- system-architecture.md - System architecture documentation

$3

When new versions are released:

`bash
cteam-update

or

cloudteam-ai-update
`

This command:
- Checks npm registry for latest version
- Updates global package if newer version exists
- Re-syncs project files with latest toolkit

---

🤖 AI Agents Reference

CTEAM AI Toolkit includes 24 specialist agents organized by expertise:

$3

Backend Developer Agent (.claude/agents/agent-backend-developer.md)
- API design, microservices, security, AI integration
- Expertise: Node.js, Python, Go, databases, authentication
- Shortcut: /dev/as-dev-backend

Frontend Developer Agent (.claude/agents/agent-frontend-developer.md)
- UI/UX implementation, React components, accessibility
- Expertise: React, TypeScript, MUI, TanStack Router
- Shortcut: /dev/as-dev-frontend

Quality Engineer Agent (.claude/agents/dev/agent-quality-engineer.md)
- Test automation, compliance validation, security testing
- Expertise: Unit/integration/E2E tests, coverage analysis
- Shortcut: /dev/as-dev-quality

$3

Business Analyst Agent (.claude/agents/agent-business-analyst.md)
- Requirements engineering, stakeholder analysis, user stories
- Creates specifications and acceptance criteria
- Shortcut: /ba/as-business-analyst

$3

Architecture Expert Agent (.claude/agents/agent-architecture-expert.md)
- System design, technical leadership, distributed systems
- Designs technical architecture and infrastructure
- Shortcut: /infras/as-infra-architect

Platform Engineer Agent (.claude/agents/agent-platform-engineer.md)
- Infrastructure as code, CI/CD, Kubernetes, cloud deployment
- Expertise: Docker, Cloudflare, GCP, automation
- Shortcut: /infras/as-infra-platform

$3

Data Engineer Agent (.claude/agents/agent-data-engineer.md)
- Data pipelines, ETL, data warehouse, analytics
- Implements data processing and storage solutions
- Shortcut: /data/as-data-engineer

$3

Code Reviewer Agent (.claude/agents/code-reviewer.md)
- Code quality validation, security review, best practices
- Reviews code against specifications and standards

Debugger Agent (.claude/agents/debugger.md)
- Issue investigation, error analysis, diagnostics
- Investigates and resolves production issues

Docs Manager Agent (.claude/agents/docs-manager.md)
- Documentation generation, maintenance, updates
- Maintains documentation throughout project lifecycle

Planner Agent (.claude/agents/planner.md)
- Implementation planning, task breakdown, research coordination
- Creates detailed implementation plans

Tester Agent (.claude/agents/tester.md)
- Test execution, coverage analysis, test report generation
- Validates implementations against requirements

Project Manager Agent (.claude/agents/project-manager.md)
- Project oversight, progress tracking, documentation updates
- Coordinates implementation across teams

$3

- Brainstormer — Solution ideation and technical debates
- Code Simplifier — Code refinement and clarity
- Copywriter — Marketing and content creation
- Database Admin — Database design and optimization
- Fullstack Developer — Full-stack implementation
- Git Manager — Git operations and conventional commits
- Journal Writer — Critical issue documentation
- MCP Manager — MCP server management
- Researcher — Technical research and documentation
- Scout/Scout-External — File location and codebase exploration
- UI/UX Designer — Interface design and user experience

$3

Option 1: Slash command shortcuts
`
/dev/as-dev-backend Implement payment gateway API
`

Option 2: Direct invocation
`
I need backend development help for [task description]
`

The framework automatically routes to appropriate specialist agents.

---

🎯 Claude Skills Catalog

CTEAM AI Toolkit includes 51 reusable skills providing specialized capabilities:

$3

- ai-artist — Craft prompts for AI models (Midjourney, DALL-E, Stable Diffusion)
- ai-multimodal — Analyze images/audio/video with Gemini API, generate images/videos
- sequential-thinking — Structured problem-solving for complex tasks

$3

- backend-development — Node.js, Python, Go, APIs, databases, security
- frontend-development — React, TypeScript, MUI, TanStack Router
- frontend-design — UI/UX design, Figma integration, animations
- frontend-design-pro — Production-ready interfaces with real photos
- aesthetic — Beautiful interface design with proven principles
- mobile-development — React Native, Flutter, Swift, Kotlin
- web-frameworks — Next.js, Turborepo, SSR, ISR
- react-best-practices — React/Next.js performance optimization

$3

- devops — Cloudflare, Docker, GCP deployment, CI/CD
- better-auth — Authentication framework, OAuth, 2FA, sessions
- platform-engineer — Infrastructure as code, Kubernetes, cloud

$3

- databases — MongoDB, PostgreSQL schema design and queries
- data-engineer — Data pipelines, ETL, analytics

$3

- chrome-devtools — Browser automation with Puppeteer
- media-processing — FFmpeg, ImageMagick for media manipulation
- code-review — Quality assessment and security review
- debugging — Systematic debugging and root cause analysis
- docs-seeker — Documentation search via llms.txt
- mcp-builder — Build MCP servers for LLM integration
- mcp-management — Manage MCP servers and capabilities
- repomix — Pack repositories into AI-friendly files
- shopify — Build Shopify apps and extensions
- skill-creator — Create or update Claude skills
- markdown-novel-viewer — View markdown with book-like experience
- web-testing — Playwright, Vitest, k6 for testing

$3

- copywriting — Conversion copywriting formulas and templates
- ui-styling — shadcn/ui components with Tailwind CSS
- ui-ux-pro-max — Complete UI/UX design intelligence
- ui-ux-responsive — Responsive design patterns
- web-design-guidelines — Web Interface Guidelines compliance
- threejs — 3D web apps with Three.js
- mermaidjs-v11 — Diagrams with Mermaid.js v11

$3

- brainstorming — Solution brainstorming with trade-off analysis
- planning — Implementation planning and architecture design
- plans-kanban — Plan progress tracking and visualization
- problem-solving — Systematic problem-solving techniques
- research — Technical research and solution analysis
- fixing — Bug fixes with intelligent routing
- context-engineering — Context usage optimization

$3

- payment-integration — SePay and Polar payment integration
- google-adk-python — Build AI agents with Google ADK
- atlassian — Atlassian tools integration
- ccs-delegation — CCS CLI delegation for tasks

$3

- claude-code — Claude Code feature documentation
- database-schema — Database schema analysis
- docs-parser — Multi-format document parsing
- document-skills — Document processing skills
- template-skill — Template for creating new skills

$3

Skills activate automatically when relevant to tasks. Explicit invocation:

`
Use the ai-multimodal skill to analyze this video
`

---

💬 Slash Commands Reference

CTEAM AI Toolkit provides 88 slash commands for quick workflows:

$3

`bash
/dev/as-dev-backend # Backend Developer
/dev/as-dev-frontend # Frontend Developer
/dev/as-dev-quality # Quality Engineer
/ba/as-business-analyst # Business Analyst
/infras/as-infra-architect # Architecture Expert
/infras/as-infra-platform # Platform Engineer
/data/as-data-engineer # Data Engineer
`

$3

Code Operations:
`bash
/code # Standard implementation workflow
/code/auto # Automated code generation
/code/no-test # Implementation without tests
/code/parallel # Parallel implementation
/code/code-modified # Work on modified code
`

Cook Operations:
`bash
/cook # Quick feature implementation
/cook/auto # Automated cooking
/cook/auto/fast # Fast automated cooking
/cook/auto/parallel # Parallel cooking
`

Bootstrap Operations:
`bash
/bootstrap # Bootstrap project setup
/bootstrap/auto # Automated bootstrap
/bootstrap/auto/fast # Fast bootstrap
/bootstrap/auto/parallel # Parallel bootstrap
`

$3

`bash
/git/push # Auto-review, commit, and push
/git/undo # Interactive undo
/git/discard # Discard uncommitted changes
/git/revert-last # Revert last commit
/git/cm # Commit changes
/git/cp # Cherry-pick commits
/git/merge # Merge branches
/git/pr # Create pull request
`

$3

`bash
/test # Run test suite
/test/ui # UI/UX testing
`

$3

`bash
/fix # General bug fixing
/fix/fast # Quick fixes
/fix/hard # Complex bug fixes
/fix/parallel # Parallel bug fixing
/fix/ci # CI/CD issues
/fix/logs # Log-based debugging
/fix/test # Test failures
/fix/types # Type errors
/fix/ui # UI issues
`

$3

`bash
/docs/init # Initialize project documentation
/docs/update # Update existing documentation
/docs/summarize # Summarize documentation
`

$3

`bash
/plan # Create implementation plan
/plan/fast # Quick planning
/plan/hard # Complex planning
/plan/parallel # Parallel planning
/plan/two # Two-phase planning
/plan/archive # Archive plan
/plan/validate # Validate plan
/plan/ci # CI/CD planning
/plan/cro # Conversion rate optimization planning
`

$3

`bash
/design/fast # Quick design
/design/good # High-quality design
/design/screenshot # Design from screenshot
/design/describe # Describe design
/design/3d # 3D design
/design/video # Video design
`

$3

`bash
/content/fast # Quick content
/content/good # High-quality content
/content/enhance # Enhance content
/content/cro # Conversion-optimized content
`

$3

`bash
/debug # Debug issues
/debugger/debug # Launch debugging session
`

$3

`bash
/integrate/polar # Polar payment integration
/integrate/sepay # SePay payment integration
`

$3

`bash
/skill/add # Add new skill
/skill/create # Create skill from scratch
/skill/update # Update existing skill
/skill/optimize # Optimize skill
/skill/optimize/auto # Auto-optimize skill
/skill/fix-logs # Fix skill logs
/skill/plan # Plan skill development
`

$3

`bash
/review/codebase # Review entire codebase
/review/codebase/parallel # Parallel codebase review
`

$3

`bash
/scout # Scout files and structure
/scout/ext # External scouting
`

$3

`bash
/ask # Ask questions
/brainstorm # Brainstorm solutions
/ccs # CCS CLI delegation
/ccs/continue # Continue CCS session
/ck-help # Get help
/coding-level # Set coding level
/journal # Write journal entry
/kanban # View kanban board
/preview # Preview changes
/use-mcp # Use MCP servers
/watzup # Project status
/worktree # Git worktree management
`

---

📁 Project Structure

`
.claude/
├── agents/ # 24 AI Agents
│ ├── agent-backend-developer.md
│ ├── agent-frontend-developer.md
│ ├── agent-business-analyst.md
│ ├── agent-architecture-expert.md
│ ├── agent-platform-engineer.md
│ ├── agent-data-engineer.md
│ ├── code-reviewer.md
│ ├── debugger.md
│ ├── docs-manager.md
│ ├── planner.md
│ ├── tester.md
│ ├── project-manager.md
│ └── ... (12 more)
├── commands/ # 88 Slash Commands
│ ├── dev/ # Dev agent shortcuts
│ ├── ba/ # Business analyst shortcut
│ ├── infras/ # Infrastructure shortcuts
│ ├── data/ # Data engineer shortcut
│ ├── git/ # Git operations
│ ├── docs/ # Documentation
│ ├── debugger/ # Debugging
│ ├── code/ # Code operations
│ ├── cook/ # Cook operations
│ ├── bootstrap/ # Bootstrap operations
│ ├── fix/ # Bug fixing
│ ├── plan/ # Planning
│ ├── design/ # Design operations
│ ├── content/ # Content operations
│ ├── skill/ # Skills management
│ └── ... (more)
├── skills/ # 51 Reusable Skills
│ ├── ai-artist/
│ ├── ai-multimodal/
│ ├── backend-development/
│ ├── frontend-development/
│ ├── frontend-design/
│ ├── aesthetic/
│ ├── devops/
│ ├── better-auth/
│ ├── databases/
│ ├── media-processing/
│ ├── code-review/
│ ├── debugging/
│ ├── docs-seeker/
│ └── ... (38 more)
└── rules/ # Development rules
├── primary-workflow.md
├── development-rules.md
├── orchestration-protocol.md
└── documentation-management.md

docs/
├── compliances/ # ISO/CMMI/PCI-DSS standards
├── brd/ # Business requirements
├── prd/ # Product requirements
├── epics/ # Epic-level documentation
├── tasks/ # Technical tasks
└── user-stories/ # User stories

plans/ # (created during usage)
└── reports/ # Agent reports

.mcp.json # MCP server configuration
CLAUDE.md # Project instructions for Claude
LICENSE # License information
`

---

🔒 Compliance & Standards

CTEAM AI Toolkit automatically validates implementations against:

- ✅ ISO/IEC 27001:2022 — Information Security Management
- ✅ ISO/IEC 27701:2019 — Privacy Information Management
- ✅ ISO/IEC 27002:2022 — Security Controls
- ✅ CMMI Level 3 — Defined Process Maturity
- ✅ PCI-DSS v4.0 — Payment Card Industry Data Security (when applicable)

Compliance validation runs automatically during implementation workflows.

---

🔧 Advanced Topics

$3

Create specialized agents for your team's needs:

`bash
/skill/create
`

Follow prompts to define agent expertise, capabilities, and invocation patterns.

$3

Configure MCP servers in .mcp.json:

`json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@context7/mcp-server"]
},
"MongoDB": {
"command": "npx",
"args": ["-y", "@cloudteam-dev/mcp-server-mongodb"]
}
}
}
`

$3

Customize workflows in .claude/rules/:
- primary-workflow.md — Main development workflow
- development-rules.md — Coding standards and practices
- orchestration-protocol.md — Agent coordination rules
- documentation-management.md — Documentation processes

---

❓ FAQs

Q: Can I use this without Claude Code?
A: No, Claude Code is required for AI agent functionality and MCP integration.

Q: Does this work with other IDEs?
A: The framework is optimized for Claude Code but documentation and compliance tools work anywhere.

Q: How do I update to latest version?
A: Run cteam-update to check for updates and sync project files.

Q: Can I customize the agents?
A: Yes, edit agent files in .claude/agents/ or create new ones with /skill/create.

Q: What's the difference between agents and skills?
A: Agents are specialized AI assistants for roles (Backend Dev, QA, etc.). Skills are reusable capabilities that agents can use.

Q: Do I need all 51 skills?
A: No, skills activate automatically when needed. No manual management required.

Q: How does compliance validation work?
A: Framework includes ISO/CMMI standards that agents reference during implementation to ensure compliance.

Q: Can I use this for non-software projects?
A: The framework is optimized for software development but documentation and planning workflows work for any project type.

---

🛠️ Troubleshooting

$3

Problem: command not found: cteam-init
Solution:
- Restart terminal after installation
- Run source ~/.zshrc (or source ~/.bashrc)
- Verify npm global bin is in PATH: npm config get prefix

Problem: Permission errors on macOS/Linux
Solution: Never use sudo. Framework automatically configures user-prefix.

$3

Problem: MCP servers not connecting
Solution:
- Verify .mcp.json configuration
- Check MCP server packages are installed
- Restart Claude Code

$3

Problem: Agent slash command not working
Solution:
- Verify command syntax (case-sensitive)
- Check agent file exists in .claude/agents/
- Restart Claude Code to reload configuration

---

📞 Support

- Documentation: Check docs/ directory and .claude/README.md
- Contact: phuc.phan@cloudteam.vn / ty.pham@cloudteam.vn
- Compliance Standards: See docs/compliances/` for ISO/CMMI documentation
- Issues: Report at https://github.com/cloudteam/ai-toolkit/issues

---

📜 Version History

$3

- Fix README not showing on npm registry

$3

- Documentation sync fix for npm registry

$3

- Enhanced agent system: 24 specialized agents
- Expanded skills catalog: 51 reusable skills
- Comprehensive commands: 88 slash commands
- Improved MCP integration
- Enhanced compliance validation

$3

- Initial release
- Claude Code framework with department-based agent organization
- MCP integration
- 10 agents, 16 commands, 12 skills
- ISO/CMMI compliance foundation

---

📝 License

ISC License - See LICENSE file for details

---

🔗 Quick Links

- AI Agents Reference — 24 specialist agents
- Claude Skills Catalog — 51 reusable skills
- Slash Commands — 88 commands
- Compliance Standards — ISO/IEC 27001/27701/27002, CMMI, PCI-DSS
- Development Rules — Coding standards
- Primary Workflow — Main development workflow

---

Framework Version: 2.0.3
Last Updated: February 2, 2026
Platform: Claude Code
Package: @cloudteam-dev/ai-toolkit
Repository: github.com/cloudteam/ai-toolkit

---

Made with ❤️ by CloudTeam