sync

Synchronize MEMORY.md files, scope statuses, and spec status lines with repository changes.

Updated Sep 19, 2026
One-click install
npx skills add https://github.com/idehen-divine/lumished --skill sync-idehen-divine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/idehen-divine/lumished/tree/main/.ai/skills/sync
Command: npx skills add https://github.com/idehen-divine/lumished --skill sync-idehen-divine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a code change is completed or merged, durable project knowledge (MEMORY.md files, feature scope checklists, and spec status lines) drifts out of sync with what the repository actually shows. This Skill closes that loop by reconciling documentation to repo evidence with surgical, reviewable edits. ## Core Features & Use Cases - MEMORY.md maintenance: Updates existing root and nested MEMORY.md files with surgical line edits, creates nested docs only for net-new areas, and cleans up orphaned docs after deletions. - Scope and spec reconciliation: Ticks completed scope sub tasks from repo evidence, advances feature statuses, and reconciles spec Status lines (Proposed, In Progress, Accepted) to match the feature lifecycle. - Tool discovery with consent: Detects newly added dependencies from manifest diffs and, only after explicit approval, searches for relevant Agent Skills and MCP servers. - Use Case: After merging a feature branch that adds a payments module, run /sync to create a nested payments/MEMORY.md, tick the completed scope sub tasks, flip the linked spec to In Progress, and flag any stale specs for /architect. ## Quick Start Run the sync skill after finishing a change to update MEMORY.md files, the scope, and spec statuses to match what the repo now shows.

Frequently Asked Questions about sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep MEMORY.md files up to date after a code change?▼

Run /sync as the last step after a change completes or merges. It diffs the change set against the base branch, updates existing root and nested MEMORY.md files with surgical line edits, and creates nested docs only for areas that are net new in the change.

How to reconcile spec statuses with feature progress automatically?▼

The skill maps each spec's linked feature to its scope status and edits only the spec's Status line: planned becomes Proposed, in-progress becomes In Progress, and done becomes Accepted. Ambiguous or superseded specs are flagged for /architect instead of edited.

Can /sync create or restructure the root MEMORY.md file?▼

No. Creating or restructuring the root MEMORY.md is owned by /audit, and /sync only flags it as a context gap. /sync edits existing docs, creates nested docs for net-new areas, and never rewrites curated prose.

Does the sync skill install Agent Skills or MCP servers automatically?▼

No. When dependency manifests change, it names the newly added tools and asks for explicit consent before searching. Nothing is searched, fetched, or installed until the engineer picks an option, and declines are recorded in MEMORY.md.

What happens when /sync finds nothing to update?▼

It reports NOTHING_TO_SYNC, which is a valid success outcome. If the change set contains only docs, tests, lock files, or generated output after filtering, it stops early without spawning any maintenance work.

Why does /sync flag a spec as stale instead of fixing it?▼

The skill may only edit a spec's Status line, never its content. When a change contradicts a specific decision in a spec, or a later spec supersedes it, /sync flags the file and recommends running /architect to update or supersede it.