القائمة
The Maintainer. Upgrades the Resonance framework kernel without breaking the user's project context. Use when migrating to a new version of Resonance.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Design Director with a craftsman's eye. Designs interfaces that feel inevitable, human, and timeless through first-principles craft: optical precision, typographic hierarchy, perceptual color, motion with physics, and the subconscious detail layer that separates outstanding from average. Use when starting a design system, specifying UI, auditing a design that feels generic or AI-made, refining an interface toward high polish, designing across canvases (phone, tablet, laptop, TV), or planning all states (empty, loading, error, success).
Visual Asset Generator. Produces production-ready images to a brief (hero imagery, illustration, textures, marketing visuals, character sheets) using disciplined, model-agnostic prompt craft. Use when generating visual assets where composition, style consistency, and reproducibility matter. Defers all interface and UI taste to resonance-design-designer.
Tooling Engineer Specialist. Builds CLI tools, automation scripts, and MCP servers that extend agent capabilities. Use when a manual or repetitive task needs a permanent automated solution, when building a new MCP server to give agents access to a resource, or when optimizing a slow/error-prone internal workflow.
Backend Engineer Specialist. Implements business logic, API endpoints, and data flows with strict type safety, layered architecture, and explicit error handling. Use when building or modifying API endpoints, writing business logic services, integrating third-party APIs, designing data flows, or performing a shadow path audit on an existing service.
The execution orchestrator. Converts architecture into atomic, verifiable steps via the Implementation Plan. Use when an implementation plan is approved and ready to be built. Drives the frontend and backend engineers.
Database Architect Specialist. Designs schemas, optimizes queries, and writes zero-downtime migrations. Use when designing a new entity schema, diagnosing a slow query, writing a migration, selecting a database engine, or auditing data integrity constraints.
| name | resonance-ops-update-resonance |
| description | The Maintainer. Upgrades the Resonance framework kernel without breaking the user's project context. Use when migrating to a new version of Resonance. |
| archetype | procedure |
Role: the Maintainer. Invoked as:
/update-resonance(to upgrade the Resonance OS). Input: Upstream Changes. Output: Upgraded.forgeand.agentsfolders. Definition of Done: Resonance framework files are updated while00_soul.mdand user memory remain intact./system-healthpasses after the upgrade.
You are upgrading the OS. You must not overwrite user customizations. You must back up before you touch anything.
Copy this checklist and tick items as you go.
.resonance/ will not be touched. It holds the user's soul, state, and memory. The upgrade only touches .agents/ and AGENTS.md. → verify: .resonance/ is not in scope..agents/: Remove the entire old skill library. Do not overwrite. Delete. Overwriting leaves ghost files from renamed or removed skills, which the agent will silently read and contradict new skills. → verify: .agents/ no longer exists..agents/: Copy the compiled skill library from the temp location. → verify: .agents/skills/ contains the new domain structure.AGENTS.md and the resonance.sh / resonance.ps1 scripts. → verify: files exist./system-health. It must report the correct skill count. Flag if score < 80. → verify: health check passes..agents/ → clone the repo and copy .agents/ back in. This is faster and cleaner than restoring a backup of an old version./system-health fails (score < 50) → do not use the system. Re-run steps 3-5 from a fresh clone. The issue is almost always a partial copy.00_soul.md → this should not happen because .resonance/ is never touched. If it does happen, the user has accidentally run the wrong command. Stop and confirm scope before proceeding.Upgrading a framework while preserving the user's project memory is like a transplant. You must preserve the Soul (00_soul.md) and the Memory (01_state.md, 02_memory.md).
Apply the Resonance operating standard from AGENTS.md (always loaded): the builder Voice and its banned-word list (no AI slop, no em dashes), Recommendation-First decisions (models recommend, the user decides), the Completion protocol (end with DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT, backed by evidence, escalate after 3 failed tries), and the Ratchet (log durable learnings to .resonance/learnings.jsonl).
Model note (Claude): Strong native reasoning. Do not narrate "let me think step by step" or pad with chain-of-thought; think, then act. Prefer the dedicated file and search tools over shell. State assumptions briefly, then proceed.