Menu
Project Sync & Hygiene — synchronizes versions, documentation, and engine metadata
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Workflow for simulating and validating Magic SDD engine logic.
Session resume briefing — current position, progress, blockers, and the one next command
Workflow for executing tasks from the project plan.
Workflow for orchestrating tasks and generating the implementation plan.
Initialize Magic Spec development environment with junctions and symlinks.
Specification Knowledge Graph — builds, analyzes, and visualizes the SDD artifact graph
| name | magic-dev-sync |
| description | Project Sync & Hygiene — synchronizes versions, documentation, and engine metadata |
Maintain project hygiene by synchronizing all metadata, documentation, and versioning across the repository. The pipeline is idempotent — re-running it without source changes produces no diff.
Pipeline (orchestrated by dev/scripts/sync.js):
.magic/, workflows/, skills/. Bumps .magic/.version, regenerates checksums, projects Skill wrappers, appends per-workflow history.**Active Development** (vX.Y.Z) line in README.md. Other version mentions are not touched.CLAUDE.md, GEMINI.md, QWEN.md, CODEX.md share the same inode as AGENTS.md. Drift is reported (non-fatal by default; pass --strict-links to fail). Repair: /magic-dev-init..design/INDEX.md (with version/date/history fields stripped). Bumps the index version and appends a history row only when the digest actually changed — no more "Automated metadata update" floods.CONTRIBUTING.md from .magic/templates/contributing.md using current sources (RULES.md, INDEX.md, workflows/). Footer date reflects the latest source mtime, not "today".docs/{name}.md with a matching workflows/magic.{name}.md, propagates the **Triggers:** and **Slash command:** lines verbatim and refreshes the ## Sync Note only when the workflow source hash changed or the engine version bumped.Flags (forwarded to sync.js):
--dry-run — no physical writes, log intended mutations.--skip-meta / --skip-docs / --skip-links — skip individual stages.--strict-links — fail when any agent rule sibling is missing.State files (do not edit by hand):
.magic/.checksums — engine drift baseline (Step 1)..design/.cache/project-meta-state.json — last structural digest of .design/INDEX.md (Step 4).dev/.cache/.docs-state.json — last hash + version per workflow (Step 5, dev-only).// turbo
6. Final Meta-Sync: Wait for file system stability (≈1s) then run node .magic/scripts/executor.js update-engine-meta --workflow sync.
Trigger: /magic-dev-sync, "Sync project", "Hygiene check"