MuseMVP Docs
Development

IDE Setup

Recommended editors, extensions, and AI configuration files for MuseMVP development.

MuseMVP is an AI-native project — its directory layout and module boundaries are deliberately structured to help AI coding assistants like Cursor and GitHub Copilot produce accurate, on-spec suggestions.

AI IDE Live Usage Manual

This IDE setup page focuses on stable reference content, while the AI IDE Live Usage Summary continuously tracks the latest AI tool usage and best practices — bookmark both.


Required Extensions

Install the following extensions before you start coding. They enforce the project's code style and provide accurate IntelliSense across the stack.


AI Configuration Files

MuseMVP does not rely on any editor-specific proprietary rule files. Instead, it uses universal AI context files compatible with all major tools — Cursor, GitHub Copilot, Claude Code, CodeX, and more.

AGENTS.md
claude.md
  • AGENTS.md — The primary project context file describing the tech stack, directory structure, development principles, and naming conventions. Readable by any AI tool that supports agent mode.
  • claude.md — Claude-specific entry point that declares AGENTS.md as the single source of truth, keeping the two in sync.
  • .agents/skills/ — A built-in skill library providing structured prompts for common development scenarios (frontend design, Next.js best practices, UI/UX, etc.) that AI tools can reference on demand.
  • .agents/workflows/ — Predefined workflows describing repeatable operations like deployments and code reviews, with // turbo annotation support for one-click automatic execution.

Switch AI Tools Seamlessly

Because the configuration is based on universal files rather than editor-proprietary formats, you can freely switch between Cursor, VS Code + Copilot, Claude Code, and CodeX — your AI context stays consistent throughout.


Workspace Settings

The repository includes VS Code workspace settings in .vscode/settings.json. Format-on-save and auto-fix are configured out of the box — no manual setup required.

{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true,
  "editor.formatOnPaste": true,
  "emmet.showExpandedAbbreviation": "never",
  "tailwindCSS.experimental.classRegex": [
    ["cn\\(([^)]*)\\)", "[\"'`]([^\"'`]*).*?[\"'`]"]
  ],
  "editor.codeActionsOnSave": {
    "source.fixAll.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  },
  "typescript.preferences.importModuleSpecifier": "non-relative",
  "typescript.tsdk": "node_modules/typescript/lib",
  "i18n-ally.localesPaths": ["./src/i18n/translations"],
  "i18n-ally.keystyle": "nested",
  "i18n-ally.namespace": false,
  "i18n-ally.enabledParsers": ["json"],
  "i18n-ally.sourceLanguage": "zh",
  "i18n-ally.displayLanguage": "zh",
  "i18n-ally.enabledFrameworks": ["next-intl"],
  "i18n-ally.extract.autoDetect": true,
  "i18n-ally.annotations": true,
  "i18n-ally.pathMatcher": "{locale}/{namespace}.json",
  "i18n-ally.sortKeys": true,
  "i18n-ally.keepFulfilled": true,
  "i18n-ally.usage.scanningIgnore": [
    "node_modules/**",
    "dist/**",
    ".next/**",
    "**/*.test.ts",
    "**/*.spec.ts"
  ],
  "i18n-ally.extract.keygenStyle": "camelCase",
  "i18n-ally.dirStructure": "dir",
  "i18n-ally.tabStyle": "space",
  "[typescript]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[typescriptreact]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[json]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[css]": {
    "editor.defaultFormatter": "biomejs.biome"
  }
}

When you open the project for the first time, VS Code will prompt you to install the recommended extensions. Click Install All to set everything up in one go.