Skip to content

AI-driven development naming convention. Standard file naming rules and patterns for automated code generation by AI systems.

License

ai-naming-standard/mcp

Repository files navigation

πŸš€ AI File Naming Assistant

Teach AI how to name your files!
Then AI will understand your project better and help you more effectively.

npm version npm downloads License: MIT

🌐 Language: English | ν•œκ΅­μ–΄ | ζ—₯本θͺž | δΈ­ζ–‡


πŸ’‘ Who is this for?

βœ… Anyone using AI tools like Claude, ChatGPT, Cursor
βœ… People struggling with too many files
βœ… Teams wanting consistent file naming rules
βœ… Anyone wanting AI to understand their project better


🎯 The Problem We Solve

❌ Before: Confusing File Names

login.js user_page_final_v2.jsx payment_fixed.py test123.sql 

Result: AI gets confused and makes mistakes 😡

βœ… After: Clear File Names

001_FE_User-Login_C_Page_PROD.jsx 002_BE_Payment-Process_X_API_PROD.py 003_DB_User-Schema_C_Migration_PROD.sql 004_TEST_Login_Unit_DEV.test.js 

Result: AI understands perfectly and helps better! ✨


🎁 What You Get

1. πŸ€– AI Understands Your Intent

Just say in plain language:

  • "Create a login page" β†’ AI makes: 001_FE_User-Login_C_Page_PROD.jsx
  • "Add payment refund API" β†’ AI makes: 021_BE_Payment-Refund_C_API_PROD.py
  • "Create product table" β†’ AI makes: 005_DB_Product-Schema_C_Migration_PROD.sql

2. πŸ“ 8 Simple Folders

Your project stays organized automatically:

my-project/ β”œβ”€β”€ 00_DOCS/ πŸ“š Documentation β”œβ”€β”€ 01_CONFIG/ βš™οΈ Settings β”œβ”€β”€ 02_STATIC/ πŸ“¦ Images, fonts β”œβ”€β”€ 03_ACTIVE/ πŸ”₯ Your main code β”œβ”€β”€ 04_TEST/ πŸ§ͺ Tests β”œβ”€β”€ 05_BUILD/ πŸ—οΈ Build files β”œβ”€β”€ 06_LOGS/ πŸ“Š Logs └── 07_META/ 🎯 AI collaboration files 

3. 🀝 Multiple AIs Work Together

  • Claude writes code
  • Cursor reviews it
  • ChatGPT designs structure
  • All understand the same rules!

4. πŸ“ Automatic Record Keeping

Everything is tracked automatically:

  • Who did what
  • When it was done
  • Which files depend on each other

⚑ Quick Start (3 Minutes)

Step 1: Install

npm install -g ai-naming-standard-mcp

Step 2: Tell Your AI

Just copy this into your Claude or Cursor settings:

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

Step 3: Start Using!

Tell your AI in plain language:

  • "Create a user dashboard page"
  • "Add email verification API"
  • "Make a product database table"

That's it! πŸŽ‰


πŸ“– Real Examples

Example 1: Building a Shopping Site

You say: "I need a shopping cart page"

AI creates:

015_FE_Cart-Shopping_R_Page_PROD.jsx 

You can tell it means:

  • 015 - File number (easy to find)
  • FE - Frontend (it's a webpage)
  • Cart-Shopping - Shopping cart feature
  • R - Read/Display (shows information)
  • Page - It's a page
  • PROD - For production (real site)

Example 2: Team Collaboration

Before:

  • John makes: login_page.jsx
  • Sarah makes: LoginPage.jsx
  • Mike makes: user-login-component.jsx
  • 😡 Everyone confused!

After:

  • Everyone makes: 001_FE_User-Login_C_Page_PROD.jsx
  • ✨ Perfect consistency!

🌍 Supports 4 Languages

All features work in your language:

Language Status Documentation
English βœ… Full Docs
ν•œκ΅­μ–΄ (Korean) βœ… Full λ¬Έμ„œ
ζ—₯本θͺž (Japanese) βœ… Full ドキγƒ₯γƒ‘γƒ³γƒˆ
δΈ­ζ–‡ (Chinese) βœ… Full ζ–‡ζ‘£

πŸŽ“ How File Names Work

Don't worry - you don't need to memorize this!
Just tell AI what you want, and it creates the correct name.

But if you're curious, here's how it works:

[Number]_[Where]_[What]-[Detail]_[Action]_[Type]_[Environment] 

Examples:

File Name Meaning
001_FE_User-Login_C_Page_PROD.jsx Frontend login page (creating)
002_BE_Payment-Process_X_Service_PROD.py Backend payment service (executing)
003_DB_Order-Schema_C_Migration_PROD.sql Database order table (creating)

Where (Layer):

  • FE = Frontend (what users see)
  • BE = Backend (server logic)
  • DB = Database (data storage)
  • API = API (connects things)

Action:

  • C = Create (making new)
  • R = Read (showing)
  • U = Update (changing)
  • D = Delete (removing)
  • X = Execute (processing)

πŸ’¬ Need Help?

πŸ“§ Email: omskykhal@gmail.com


🀝 Want to Contribute?

We welcome:

  • Bug reports
  • Feature suggestions
  • Translations
  • Documentation improvements

How to contribute:

  1. Visit our GitHub: https://github.com/ai-naming-standard/mcp
  2. Open an Issue or Pull Request
  3. We'll review and respond quickly!

πŸ“œ License

MIT License - Free to use for everyone!

Copyright (c) 2025 AI Naming Standard 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. 

🎯 Key Benefits

✨ Save Time: No more thinking about file names
✨ Less Confusion: Everyone uses the same system
✨ Better AI Help: AI understands your project structure
✨ Easy Teamwork: Clear rules for everyone
✨ Professional: Your project looks organized and clean


πŸ“¦ Technical Details (For Developers)

Click to see technical information

MCP Protocol

  • Compatible with MCP v0.6.0
  • 24 built-in tools for file management
  • Supports multi-AI orchestration
  • Automatic dependency tracking

System Requirements

  • Node.js >= 16.0.0
  • npm or yarn
  • Compatible with Claude Desktop, Cursor, VS Code

Advanced Features

  • Custom naming rules
  • Migration from v4/v5
  • Dependency graph generation
  • AI role matrix management
  • Conversation history tracking

For detailed technical documentation, visit: Technical Docs


Version: 6.0.13
Status: Production Ready βœ…

Made with care for the AI community πŸ’™

NPM Package β€’ GitHub β€’ Documentation

About

AI-driven development naming convention. Standard file naming rules and patterns for automated code generation by AI systems.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published