ai-naming-standard-mcp

v6.1.4

Published

2 months ago

AI Governance Era v6.1: loungeservice-grade project initialization. Creates 8-folder structure with complete AI governance (AI_RULES.md, AI_ROLE_MATRIX.yaml, NAMING_EXCEPTIONS.md, DEVELOPMENT.md, project.md) and bridge files (.cursorrules, .windsurfrules)

Downloads

🚀 AI Naming Standard MCP v6.0.8

AI Governance Era: Revolutionary Multi-AI Orchestration with Natural Language Support

AI Naming Standard MCP is a revolutionary file naming and project structure standard designed for multi-AI collaboration. It enables Cursor, Claude, ChatGPT, Windsurf, and other AI tools to work together seamlessly, with natural language support, automatic dependency tracking, and complete governance.

🌐 Language: English | 한국어 | 日本語 | 中文

🌟 v6.0.8 Key Features

🤖 Multi-AI Orchestration

Multiple AIs collaborate with defined roles:

Cursor (Code Writer) - Code implementation
Claude (Reviewer) - Code review and documentation
ChatGPT (Architect) - Structure design and rule management
Windsurf (Assistant) - Refactoring and optimization
Human (Supervisor) - Final approval and quality control

🧠 Naming Wizard (Natural Language Support)

Automatically converts natural language to standard file names:

Input:  "Create login page"
Output: 001_FE_User-Login_C_Page_PROD.jsx

Input:  "Add payment refund API"
Output: 021_BE_Payment-Refund_C_API_PROD.py

Input:  "Create product table"
Output: 005_DB_Product-Schema_C_Migration_PROD.sql

🔗 Dependency Graph (@deps Tracking)

Automatically tracks and manages file dependencies:

/* 
 * @file: 003_BE_Order-Process_X_Service_PROD.py
 * @deps:
 *   - 002_BE_Order-Validate_V_Helper_PROD.py
 *   - 005_DB_Order-Schema_C_Migration_PROD.sql
 * @ai: cursor
 * @reviewed: claude
 * @created: 2025-10-17
 */

📊 Complete Governance Layer

Fully records all AI activities and human interventions:

AI_ROLE_MATRIX.yaml - AI roles and permissions
DEP_GRAPH.yaml - Project-wide dependency graph
CONVERSATION_HISTORY.json - AI conversation logs
HUMAN_OVERRIDES.md - Human intervention audit trail

🏗️ 07_META Folder System

Metadata management for AI collaboration:

07_META/
├── AI_ROLE_MATRIX.yaml           # AI role matrix
├── DEP_GRAPH.yaml                # Dependency graph
├── CONVERSATION_HISTORY.json     # Conversation history
├── HUMAN_OVERRIDES.md            # Human override logs
├── NAMING_WIZARD_RULES.yaml      # Naming rules
└── PROJECT_METADATA.json         # Project metadata

📦 Installation

Global Installation (Recommended)

npm install -g ai-naming-standard-mcp

Local Installation

npm install ai-naming-standard-mcp

From Source

git clone https://github.com/ai-naming-standard/v6.git
cd v6
npm install
npm link

🔧 Configuration

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "ai-naming-standard": {
      "command": "node",
      "args": ["/path/to/ai-naming-standard-mcp/src/index.js"]
    }
  }
}

Config file locations:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

Create .cursorrules file in project root:

# AI Naming Standard v6.0.0
Use AI Naming Convention v6.0.0 for all files
Check 07_META/AI_ROLE_MATRIX.yaml for your role and permissions
Always add @deps tags in file headers
Follow the standard folder structure: 00_DOCS through 07_META

VS Code (MCP Extension)

Add to .vscode/settings.json:

{
  "mcp.servers": {
    "ai-naming-standard": {
      "command": "node",
      "args": ["/path/to/ai-naming-standard-mcp/src/index.js"]
    }
  }
}

🛠️ MCP Tools (24 Total)

🎯 Core Naming Tools (8)

| Tool | Description | |------|-------------| | generateFileName | Generate standard file name | | validateFileName | Validate file name format | | explainFileName | Explain file name components | | getLayerCodes | Get layer code table | | getActionCodes | Get action code table | | getProjectTemplate | Get project template | | batchGenerateFileNames | Batch generate file names | | suggestCorrection | Suggest corrections for invalid names |

🏗️ Project Structure Tools (6)

| Tool | Description | |------|-------------| | createProjectStructure | Create v6 8-folder structure | | checkFolderPermission | Check folder permissions | | migrateFromV4 | Migrate from v4/v5 to v6 | | suggestFolder | Suggest appropriate folder | | handleExternalFile | Handle external files | | generateDependencyManifest | Generate dependency manifest |

🆕 Multi-AI Orchestration Tools (2)

| Tool | Description | |------|-------------| | createAIRoleMatrix | Create AI role matrix | | getAIRole | Get AI role and permissions |

🆕 Naming Wizard Tools (2)

| Tool | Description | |------|-------------| | naturalLanguageToFileName | Convert natural language to file name | | addNamingWizardRule | Add custom naming rule |

🆕 Dependency Graph Tools (3)

| Tool | Description | |------|-------------| | generateDepGraph | Generate dependency graph | | validateDeps | Validate @deps tags | | checkCircularDeps | Check circular dependencies |

🆕 Governance & Audit Tools (3)

| Tool | Description | |------|-------------| | logHumanOverride | Log human intervention | | scanProject | Scan project structure | | exportConfig | Export config for AI tools |

💡 Usage Examples

1. Natural Language to File Name

// Execute in Claude/Cursor
{
  "tool": "naturalLanguageToFileName",
  "args": {
    "naturalLanguage": "Update user profile API",
    "language": "en"
  }
}

// Result
{
  "fileName": "015_BE_User-Profile_U_API_PROD.py",
  "analysis": {
    "domain": "User-Profile",
    "action": "U",
    "layer": "BE",
    "detail": "API",
    "env": "PROD"
  },
  "confidence": "high"
}

2. Check AI Role and Permissions

{
  "tool": "getAIRole",
  "args": { "aiName": "cursor" }
}

// Result
{
  "aiName": "cursor",
  "type": "code_writer",
  "permissions": ["write: 03_ACTIVE", "test: 04_TEST"],
  "canModify": ["03_ACTIVE", "04_TEST"],
  "cannotModify": ["01_CONFIG", "07_META"],
  "responsibilities": ["Code writing", "Test generation", "Bug fixing"]
}

3. Create Project Structure

{
  "tool": "createProjectStructure",
  "args": {
    "projectName": "my-ecommerce-app",
    "version": "v6"
  }
}

// Creates folders:
// 00_DOCS/     - Documentation
// 01_CONFIG/   - Configuration (AI NO-MODIFY)
// 02_STATIC/   - Static assets
// 03_ACTIVE/   - Active code (main workspace)
// 04_TEST/     - Tests
// 05_BUILD/    - Build output
// 06_LOGS/     - Logs
// 07_META/     - AI collaboration metadata

4. Generate Dependency Graph

{
  "tool": "generateDepGraph",
  "args": {
    "sourcePath": ".",
    "outputPath": "07_META/DEP_GRAPH.yaml"
  }
}

// Scans all files in 03_ACTIVE folder,
// extracts @deps tags, and generates DEP_GRAPH.yaml

5. Validate File Name

{
  "tool": "validateFileName",
  "args": {
    "fileName": "001_BE_User-Login_C_Service_PROD.py"
  }
}

// Result
{
  "valid": true,
  "components": {
    "index": "001",
    "layer": "BE",
    "domain": "User-Login",
    "action": "C",
    "detail": "Service",
    "env": "PROD",
    "ext": "py"
  }
}

📂 v6 Folder Structure

my-project/
├── 00_DOCS/                    # 📚 Documentation
│   ├── README.md
│   ├── API_SPEC.md
│   └── ARCHITECTURE.md
│
├── 01_CONFIG/                  # ⚙️ Configuration (AI NO-MODIFY)
│   ├── .env
│   ├── config.yaml
│   └── secrets.json
│
├── 02_STATIC/                  # 📦 Static Assets
│   ├── ASSET_logo.png
│   ├── TEMPLATE_email.html
│   └── EXTERNAL_bootstrap.css
│
├── 03_ACTIVE/                  # 🔥 Active Code (Main Workspace)
│   ├── 001_BE_User-Login_C_Service_PROD.py
│   ├── 002_FE_Dashboard_R_Page_PROD.jsx
│   └── 003_DB_User-Schema_C_Migration_PROD.sql
│
├── 04_TEST/                    # 🧪 Test Code
│   ├── 001_TEST_User-Login_Unit_DEV.test.py
│   └── 002_TEST_Dashboard_E2E_DEV.test.js
│
├── 05_BUILD/                   # 🏗️ Build Output
│   ├── dist/
│   └── bundle.js
│
├── 06_LOGS/                    # 📊 Log Files
│   ├── app.log
│   └── error.log
│
└── 07_META/                    # 🆕 AI Collaboration Metadata
    ├── AI_ROLE_MATRIX.yaml
    ├── DEP_GRAPH.yaml
    ├── CONVERSATION_HISTORY.json
    ├── HUMAN_OVERRIDES.md
    ├── NAMING_WIZARD_RULES.yaml
    └── PROJECT_METADATA.json

🎯 File Naming Pattern

Basic Pattern

[Index]_[Layer]_[Domain]-[Feature]_[Action]_[Detail]_[Env].[ext]

Real Examples

| File Name | Description | |-----------|-------------| | 001_FE_User-Login_C_Page_PROD.jsx | User login page | | 002_BE_Payment-Process_X_Service_PROD.py | Payment processing service | | 003_DB_Order-Schema_C_Migration_PROD.sql | Order table migration | | 004_API_Auth-Token_V_Middleware_PROD.js | Token validation middleware | | 005_ML_Recommend-Product_G_Model_PROD.py | Product recommendation model |

Layer Codes

| Code | Description | Use Case | |------|-------------|----------| | FE | Frontend | React, Vue, Angular | | BE | Backend | Node.js, Python, Java | | DB | Database | MySQL, PostgreSQL, MongoDB | | API | API Gateway | REST, GraphQL, gRPC | | ML | Machine Learning | TensorFlow, PyTorch | | INFRA | Infrastructure | Docker, Kubernetes | | SH | Shared/Common | Utils, Helpers |

Action Codes

| Code | Meaning | Description | |------|---------|-------------| | C | Create | Create new resource | | R | Read | Fetch/read data | | U | Update | Modify/update data | | D | Delete | Delete resource | | V | Validate | Validate data | | X | Execute | Execute/process | | S | Send | Send/transmit | | T | Transform | Transform/convert | | G | Generate | Generate/produce |

Environment Tags

| Tag | Environment | Purpose | |-----|-------------|---------| | DEV | Development | Local development | | STG | Staging | Staging environment | | PROD | Production | Production environment | | COMMON | Common | All environments |

📈 Performance Comparison

| Metric | v5.0.2 | v6.0.0 | Improvement | |--------|--------|--------|-------------| | MCP Tools | 12 | 24 | +100% ⬆️ | | Folders | 7 | 8 | +14% ⬆️ | | AI Support | Single | Multi-AI | +400% ⬆️ | | Natural Language | ❌ | ✅ Naming Wizard | +100% 🆕 | | Dependency Tracking | Manual | Auto (@deps) | +100% ⬆️ | | Governance | Partial | Complete | +80% ⬆️ | | Audit Trail | ❌ | ✅ Full | +100% 🆕 | | Accessibility | 95% | 100% | +5% ⬆️ |

🔄 Migration Guide

v5 → v6 Automatic Migration

{
  "tool": "migrateFromV4",
  "args": {
    "sourcePath": ".",
    "sourceVersion": "v5",
    "dryRun": false
  }
}

Manual Migration Steps

Create 07_META folder
```
mkdir 07_META
```

Create AI_ROLE_MATRIX.yaml

{
  "tool": "createAIRoleMatrix",
  "args": {
    "projectName": "my-project",
    "aiTools": ["cursor", "claude", "chatgpt"]
  }
}

Add @deps tags to files

/* 
 * @file: filename.ext
 * @deps:
 *   - dependency1.ext
 *   - dependency2.ext
 * @ai: cursor
 */

Generate dependency graph

{
  "tool": "generateDepGraph",
  "args": {
    "sourcePath": ".",
    "outputPath": "07_META/DEP_GRAPH.yaml"
  }
}

📜 License

MIT License - Free to use!

MIT License

Copyright (c) 2025 AI Naming Standard Organization

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

📊 Statistics

| Metric | Value | |--------|-------| | MCP Tools | 24 | | Folders | 8 (including 07_META) | | Supported AIs | 4 (Cursor, Claude, ChatGPT, Windsurf) | | Languages | 3 (EN, KO, JA) | | Downloads | | | Stars | | | Contributors | |

Version: 6.0.8 STABLE
Release Date: 2025.10.18
Status: Production Ready ✅
MCP Protocol: v0.6.0
Node: >=16.0.0

Website • Documentation • NPM • GitHub