@cloudteam-dev/ai-toolkit

v2.0.3

Published

8 days ago

Enterprise AI assistance powered by OpenSpec workflow - Build with specifications first, implementation second

Downloads

21,232

0High
0Medium
0Low

rd.cloudteam

ai claude openspec workflow agents compliance iso27001 cmmi spec-driven development

CloudTeam AI-Toolkit — Enterprise AI Development Framework

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

⚡ Quick Install

# Install globally (required)
npm install -g @cloudteam-dev/ai-toolkit

# Then init in your project
cd your-project && cteam-init

⚡ Quick Start

# 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.

Core Philosophy

Specification → Implementation → Validation

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

What You Get

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

Component Breakdown

┌─────────────────────────────────────────────────────────┐
│                  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.)    │  │
│  └──────────────────────────────────────────────────┘  │
│                                                         │
└─────────────────────────────────────────────────────────┘

Technology Stack

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

Prerequisites

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

Step 1: Global Installation

macOS/Linux:

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:

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

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

Step 2: Initialize in Project

Navigate to your project directory:

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

Step 3: Initialize Documentation

CRITICAL: Before starting development:

/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

Step 4: Keep Updated

When new versions are released:

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:

Development Team

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

Business & Analysis

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

Infrastructure & Operations

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

Data Engineering

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

Specialized Agents

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

Additional Agents

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

How to Use Agents

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:

AI & Multimodal (3 skills)

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

Development (8 skills)

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

Infrastructure & DevOps (3 skills)

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

Database & Data (2 skills)

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

Tools & Utilities (12 skills)

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

Content & Design (7 skills)

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

Planning & Process (7 skills)

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

Integrations (4 skills)

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

Other (5 skills)

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

How Skills Work

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:

Agent Shortcuts (7 commands)

/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

Development Workflows

Code Operations:

/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:

/cook              # Quick feature implementation
/cook/auto         # Automated cooking
/cook/auto/fast    # Fast automated cooking
/cook/auto/parallel # Parallel cooking

Bootstrap Operations:

/bootstrap         # Bootstrap project setup
/bootstrap/auto    # Automated bootstrap
/bootstrap/auto/fast    # Fast bootstrap
/bootstrap/auto/parallel # Parallel bootstrap

Git Operations (9 commands)

/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

Testing & Quality

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

Bug Fixing (9 commands)

/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

Documentation (3 commands)

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

Planning (8 commands)

/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

Design Operations (6 commands)

/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

Content Operations (4 commands)

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

Debugging Operations (2 commands)

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

Integration Commands (2 commands)

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

Skills Management (6 commands)

/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

Code Review (2 commands)

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

Scout Operations (2 commands)

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

Utility Commands (10 commands)

/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

Custom Agent Creation

Create specialized agents for your team's needs:

/skill/create

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

MCP Server Configuration

Configure MCP servers in .mcp.json:

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

Workflow Customization

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

Installation Issues

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.

MCP Server Issues

Problem: MCP servers not connecting Solution:

Verify .mcp.json configuration
Check MCP server packages are installed
Restart Claude Code

Agent Not Responding

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: [email protected] / [email protected]
Compliance Standards: See docs/compliances/ for ISO/CMMI documentation
Issues: Report at https://github.com/cloudteam/ai-toolkit/issues

📜 Version History

v2.0.3 (February 2026)

Fix README not showing on npm registry

v2.0.2 (January 2026)

Documentation sync fix for npm registry

v2.0.0 (January 2026)

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

v1.0.0 (November 2025)

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