Menu
Apply plugin methodology updates to an existing vault. Preserves user content while upgrading templates, config, and context files.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | upgrade |
| description | Apply plugin methodology updates to an existing vault. Preserves user content while upgrading templates, config, and context files. |
| tags | ["architecture","maintenance","upgrade"] |
Delegates to: @ars-contexta:vault-architect
Invoke this skill when the user wants to bring their vault up to date with a newer version of the Ars Contexta plugin, after a plugin update, or when prompted by the health checker that the vault version is behind.
Version Comparison Phase
Read ops/derivation-manifest.md to determine the vault's current plugin version. Compare against the plugin's current version.
If the vault is already at the current version, report this and exit: "Your vault is already running plugin version {version}. No upgrade needed."
Change Summary Phase Show the user exactly what will change, organized by impact:
reviewed frontmatter field")copilot-instructions.md and CLAUDE.md: describe what sections will be refreshedops/methodology/ops/config.yaml (always additive, never removes existing fields)notes/, self/, and any user-created files will not be touchedWait for user confirmation before proceeding.
Backup Phase
Before modifying any file, create timestamped backups in ops/archive/:
ops/archive/templates/{name}-{YYYY-MM-DD}.mdcopilot-instructions.md → ops/archive/copilot-instructions-{YYYY-MM-DD}.mdCLAUDE.md → ops/archive/CLAUDE-{YYYY-MM-DD}.mdops/config.yaml → ops/archive/config-{YYYY-MM-DD}.yamlUpgrade Phase Apply updates in order:
copilot-instructions.md and CLAUDE.md (re-derive from current config + new plugin defaults)ops/methodology/ if introduced in this versionops/config.yaml with default valuesops/derivation-manifest.mdValidation Phase Run the 15 kernel primitive checks. Report any that regressed during the upgrade. If regressions are found, offer to restore from backup.
Add a new knowledge domain to an existing vault. Creates domain-specific MOCs, templates, and vocabulary mappings.
Research-backed vault evolution guidance. Toggle features (self-space, semantic search), rebalance MOCs, adjust dimensions with full rationale.
Query the Ars Contexta research methodology. Answers 'why does my system do X?' with research-backed explanations from 249 interconnected claims.
Analyze the vault's knowledge graph. Subcommands: orphans, density, bridges, synthesis, traverse, clusters, stats.
Run vault health diagnostics. 3 modes: quick (schema+orphans+links), full (all 8 categories), three-space (boundary violations).
Contextual guidance and command discovery. Shows available skills, agents, and intelligent suggestions based on vault state.