Enterprise AI assistance powered by OpenSpec workflow - Build with specifications first, implementation second
npm install @cloudteam-dev/ai-toolkitbash
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