Modern Code Guidelines

简体中文

A shared skill package for Codex, Cursor, and Claude Code, containing sixteen independently triggered language skills:

• Codex: .codex-plugin/plugin.json
• Cursor: .cursor-plugin/plugin.json
• Claude Code: .claude-plugin/plugin.json

All three hosts use the same skills/ directory, so language guidance is not duplicated or allowed to drift between integrations.

Marketplace catalogs are provided for direct repository or local installation:

• Codex: .agents/plugins/marketplace.json
• Cursor: .cursor-plugin/marketplace.json
• Claude Code: .claude-plugin/marketplace.json

This project is distributed directly from its repository and is not submitted to the official plugin stores.

Installation

The repository is hosted at zcyc/modern-code-guidelines. The marketplace name is modern-code-guidelines for all three hosts.

Codex

Run these commands in a terminal. The first command adds the repository marketplace; the second installs the plugin:

codex plugin marketplace add zcyc/modern-code-guidelines
codex plugin add modern-code-guidelines@modern-code-guidelines

For a local checkout, replace zcyc/modern-code-guidelines with its absolute path.

Cursor

Add the repository marketplace from a terminal, then install the plugin from Cursor's /plugins interface:

cursor-agent plugin marketplace add https://github.com/zcyc/modern-code-guidelines

Open /plugins, select the modern-code-guidelines marketplace, and install modern-code-guidelines.

Claude Code

Run these commands inside a Claude Code session:

/plugin marketplace add zcyc/modern-code-guidelines
/plugin install modern-code-guidelines@modern-code-guidelines

For a local checkout, use its absolute path with /plugin marketplace add.

Updating

Refresh the marketplace before reinstalling or updating the plugin:

# Codex
codex plugin marketplace upgrade modern-code-guidelines
codex plugin remove modern-code-guidelines@modern-code-guidelines
codex plugin add modern-code-guidelines@modern-code-guidelines

# Claude Code
claude plugin marketplace update modern-code-guidelines
claude plugin update modern-code-guidelines@modern-code-guidelines

For Cursor, run cursor-agent plugin marketplace update modern-code-guidelines, then reopen Cursor and reinstall from /plugins if the cached version does not change.

Skills

• use-modern-java
• use-modern-javascript
• use-modern-typescript
• use-modern-python
• use-modern-csharp
• use-modern-go
• use-modern-rust
• use-modern-scala
• use-modern-cpp
• use-modern-swift
• use-modern-kotlin
• use-modern-dart
• use-modern-php
• use-modern-ruby
• use-modern-c
• use-modern-sql

Each skill reads the project's explicit language/compiler/runtime target and applies only stable rules supported by that target. Version-specific references stay beside their skill.

The JavaScript skill covers core ECMAScript and Node.js. TypeScript has its own skill for compiler/type-system behavior. Browser APIs, CSS, accessibility, and web performance remain the responsibility of modern-web-guidance.

Rule sources

Each skill resolves the project's declared target first, then reads its local rules. The references prioritize official language specifications, release notes, compiler documentation, and runtime/standard-library API documentation:

Language	Version and language source	Runtime/API source
Java	Oracle Java Language Updates, Java Language Specification	Java SE API
JavaScript	ECMAScript 2026	Node.js APIs, Node.js releases
TypeScript	TypeScript release notes, TypeScript 7, TSConfig reference	The selected JavaScript host and its runtime/API documentation
Python	Python What’s New, What’s New in Python 3.14, Language Reference	Python Standard Library
C#	C# version history, C# 15 preview, language versioning	C# language reference, .NET API browser
Go	Go specification, Effective Go, Go Code Review Comments, Go 1.27 release notes; supplementary Modern Go Guidelines	Go standard library, Go release history
Rust	Rust Edition Guide, Rust Style Guide	Rust release notes, Rust standard library, Cargo Book
Scala	Scala 3.8.4 / 3.3.8 LTS / 2.13.18 releases, Scala 3 Reference	Scala/JDK compatibility, sbt, Scalafmt, Scalafix
C++	C++ Core Guidelines, ISO/IEC 14882:2024, C++26 working papers	cppreference C++ language, standard library
Swift	Swift 6.3 release, Swift API Design Guidelines, Swift Evolution	Swift Book, Swift concurrency
Kotlin	What's new in Kotlin 2.0, What's new in Kotlin 2.4, Kotlin coding conventions	Kotlin language documentation, Kotlin coroutines guide
Dart	Dart 3.13 announcement, Effective Dart	Dart language specification, Dart linter rules
PHP	PHP 8.5 release, PHP language manual	PHP standard library, PHP-FIG PSR
Ruby	Ruby 4.0 release, Ruby documentation, RuboCop style cops	Ruby core API
C	ISO/IEC 9899:2024 (C23), C language reference, SEI CERT C	C standard library reference
SQL	ISO/IEC 9075:2023, SQLFluff rules	PostgreSQL release notes, or the selected database vendor's SQL and transaction documentation

The detailed rules and their source links live in each skill's local references/guidelines.md. Secondary guidance can inform examples, but it does not override the project's declared target or the primary sources above.

Relationship to related projects

This project was inspired by modern-go-guidelines and modern-web-guidance. It complements both projects rather than replacing them:

• modern-go-guidelines focuses on modern Go language and standard-library guidance.
• modern-web-guidance focuses on browser and web-platform practices such as Web APIs, CSS, accessibility, and web performance.
• modern-code-guidelines focuses on version-aware language, compiler, runtime, standard-library, database, and secure-coding guidance across the listed languages. Its Go rules use official Go documentation as the authority, with JetBrains go-modern-guidelines as supplementary reference; the official Go toolchain is used only for the most suitable formatting, testing, and correctness checks.

The JavaScript and TypeScript skills intentionally stop at core language, compiler, Node.js, and runtime concerns. Browser UI, CSS, accessibility, and web performance remain in modern-web-guidance, so the projects can be used together with clear boundaries.

Compatibility boundary

Support means that Codex, Cursor, and Claude Code can discover the shared skill package through their host-specific plugin manifest. This project does not add host-specific commands, agents, or duplicated rule files.