원클릭으로
magic-dev-sync
Project Sync & Hygiene — synchronizes versions, documentation, and engine metadata
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
Project Sync & Hygiene — synchronizes versions, documentation, and engine metadata
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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"