agentleFS
cykedevcykedev/vereinsheim/.claude/skills/sync-graph/SKILL.md

sync-graph

Skill1 starsChanged 13 days agoApache-2.0View on GitHub

Den Memory-Graph-Vault nach Note-/ADR-Änderungen validieren und aufräumen — vault-lint laufen lassen, jedes Schema-Problem in der Note fixen, Cross-Reference-Lücken schließen, vault/index.md pflegen. Nach Änderungen an vault/ oder wenn der Graph veraltet wirkt.

The file

Files
SKILL.md

/sync-graph

Der Memory-Graph ist der Vault (ADR-025) — es gibt keinen Build-Schritt und kein Manifest abzugleichen. Dieser Skill hält den Vault nach Edits kohärent; er baut nichts.

  1. git diff --stat -- vault/ — welche Notes sich geändert haben.
  2. node .claude/vault-lint.mjs — jedes gemeldete Problem in der Note fixen (nicht in einem Store — es gibt keinen): type, eindeutige id (== Dateiname), dangling [[edge]], fehlender title, ein documented_in-Anker ohne passende Überschrift im Ziel-Guide, eine atomare Note (subsystem/operation/concept/incident) ohne kuratierte keywords:-Zeile. Der Graph ist live, sobald die Note gespeichert ist.
  3. Cross-Reference-Lücken schließen — ein neues Konzept muss erreichbar sein (sonst nur per Suche findbar, nicht per Graph-Walk):
    • Membership: subsystem_of/operation_of/feature_of bzw. part_of zum Topic-MOC (architecture/operations/monorepo/domain/incidents/meyton/spiegel bzw. ringwerk; treffsicher nur noch als Archiv).
    • governed_by zur ADR, falls eine die Entscheidung trägt (informed_by, wenn nur beeinflusst).
    • documented_in zum Guide-Abschnitt, der es ausführt ("[[guide#Überschrift TEXT]]" — Anker = Überschriften-Text, kein Slug) → die dünne Note erbt die Such-Keywords dieses Abschnitts.
    • Bei konzeptionell symmetrischen Relationen die Gegen-Kante ergänzen (relates_to/contrasts_with/ see_also). Volles Vokabular: vault/SCHEMA.md §4.
  4. vault/index.md aktuell halten (Katalog nach Typ + Lese-Reihenfolge) und die geänderten Notes zusammen committen. Am Turn-Ende erzwingt der graph-sync-Stop-Hook ohnehin vault-lint (blockt bei invalidem Vault) — dieser Skill ist die kuratierende Ergänzung (Cross-Refs + Index), die ein Hook nicht leisten kann.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.