@@ -31,13 +31,14 @@ Codex plugin metadata is maintained beside Claude metadata in each plugin:
3131
3232Follow semantic versioning (semver) for all plugins:
3333
34- | Change Type | Version Bump | Example |
35- | -------------| -------------- | ---------|
36- | Bug fix, docs | Patch | 1.0.0 → 1.0.1 |
37- | New feature, minor change | Minor | 1.0.0 → 1.1.0 |
38- | Breaking change | Major | 1.0.0 → 2.0.0 |
34+ | Change Type | Version Bump | Example |
35+ | ------------------------- | ------------ | ------------- |
36+ | Bug fix, docs | Patch | 1.0.0 → 1.0.1 |
37+ | New feature, minor change | Minor | 1.0.0 → 1.1.0 |
38+ | Breaking change | Major | 1.0.0 → 2.0.0 |
3939
4040** When to bump:**
41+
4142- Adding new commands, skills, or agents → ** Minor**
4243- Modifying existing behavior → ** Minor** (or Major if breaking)
4344- Updating documentation only → ** Patch**
@@ -69,6 +70,7 @@ machine-specific information into any plugin file (manifests, hooks, scripts,
6970skills, commands, configs, docs, examples).
7071
7172** Never hardcode:**
73+
7274- Absolute home paths (` /Users/<you>/… ` ) — use ` $HOME ` , ` ~ ` , ` ${CLAUDE_PLUGIN_ROOT} ` , or ` $PWD ` .
7375- Personal secret-file conventions (e.g. ` ~/.secret ` ) — read secrets from documented env vars; allow an optional, user-set key-file path.
7476- Real project, client, host, or repo names — use neutral placeholders (` demo-project ` , ` /path/to/project ` ).
0 commit comments