Verwendung von loam
Dies ist der Router für den loam-Skill-Namensraum. Er führt selbst keine Arbeit aus. Er teilt Ihnen mit, welchen loam-Skill Sie für eine bestimmte Absicht aufrufen sollen, und die Regeln, die für alle gelten.
Dies ist ein Routing-/Meta-Skill. Wenn Sie den passenden Skill erkennen, rufen Sie ihn über den Skill-Loader des Host-Harness auf. Führen Sie die Arbeit nicht hier aus.
Unverhandelbar
Drei Regeln halten die loam-Arbeit mit dem Gedächtnismodell konsistent.
- Rufen Sie den relevanten Skill vor jeder loam-Aktion auf. Nicht nur Tool-Aufrufe. Bevor Sie planen, recherchieren, starten, fortsetzen, checkpointen, debattieren oder einen Konsens erzielen, einen Plan ändern, zum Gedächtnis hinzufügen, das Gedächtnis abfragen, das Gedächtnis ändern, das Gedächtnis linten, das Gedächtnis normalisieren, das Gedächtnis überprüfen, Erkenntnisse festhalten, Anleitungen auditieren, das Wiki aufsetzen oder ein Vault initialisieren: Rufen Sie den passenden Skill auf. Dieses Dokument ist ein Router. Der Skill-Text enthält die eigentlichen Regeln. Die Verantwortung liegt bei Ihnen für alles andere. Gehen Sie lieber auf Nummer sicher und rufen Sie auf.
- Gedächtnis zuerst, Substrat zweitens. Sprechen Sie zuerst über „Gedächtnis“. Verwenden Sie „Wiki“ nur, wenn Sie das Markdown-Substrat vom Guidance- oder Checkpoint-Substrat unterscheiden müssen. Sagen Sie niemals „das Wiki“, wenn Sie „Gedächtnis“ meinen – das Wiki ist ein Substrat des Gedächtnisses, nicht das Ganze.
- Vom Agenten eigenverantwortete Gedächtnisschreibvorgänge. Der Agent schreibt, korrigiert, routet und archiviert Gedächtnis ohne vorherige Genehmigung. Der Mensch kann veraltete oder falsche Inhalte melden, was denselben Korrekturfluss auslöst wie ein vom Agenten entdeckter Widerspruch.
Das Gedächtnismodell
Gedächtnis ist der Oberbegriff für alles, was loam erfasst. Es gibt drei Substrate:
| Substrat | Was es ist | Wer pflegt es |
|---|---|---|
| wiki | Dauerhafte, Obsidian-kompatible Markdown-Notizen unter wiki/. Seiten zu Themen, Entitäten, Konzepten, Analysen. | loam-memory-Gruppe (die meisten Skills) |
| guidance | AGENTS.md ist die kanonische Anleitungsdatei. CLAUDE.md ist ein dünner Import-Shim (nur @AGENTS.md). .claude.local.md für persönliche Überschreibungen. | loam-memory-Gruppe (auditing-guidance, learning-from-session-Anleitungspfad) |
| checkpoints | Flüchtiger Arbeitsstand unter wiki/checkpoints/. Notizen zum Neustart, kein dauerhaftes Wissen. | loam-work-Gruppe (checkpointing schreibt, resuming liest) |
Das Wiki-Substrat ist das, was qmd indiziert. Das Guidance-Substrat ist das, was Harnesses als Prompt-Kontext laden. Checkpoints sind Arbeitsstand, kein Wissen – sie weigern sich, index.md oder log.md zu berühren, und sollten nicht zu dauerhaften Behauptungen werden.
Sprechen Sie zuerst über „Gedächtnis“. Verwenden Sie „Wiki“ nur, wenn die Substratunterscheidung wichtig ist. Ein Skill, der auf den Markdown-Notizen arbeitet, arbeitet am Wiki-Substrat des Gedächtnisses. Ein Skill, der AGENTS.md bearbeitet, arbeitet am Guidance-Substrat des Gedächtnisses. Beide sind Gedächtnis.
Aufnahmekriterien für dauerhaftes Gedächtnis
Verwenden Sie diese Kriterien, bevor Sie eine Wiki-Seite erstellen. Seitenerstellende Skills referenzieren diesen Abschnitt, anstatt ihn zu kopieren.
Eine Behauptung verdient eine Wiki-Seite nur, wenn sie alle drei Kriterien erfüllt:
- R1 Wiederverwendbar – eine zukünftige Sitzung zu einer anderen Aufgabe würde sie plausibel benötigen.
- R2 Über das Projekt/Die Domäne – Codebasis, Architektur, Entscheidungen, Konventionen, externe Abhängigkeiten oder dauerhafte externe Fakten; nicht das Gespräch, den Agenten oder den flüchtigen Benutzerzustand.
- R3 Kostspielig zu rekonstruieren & erneut prüfbar – die erneute Ableitung der Behauptung aus einer Live-Quelle (Code, Konfiguration, Kalender, Aufgabenliste) würde mehr kosten, als die Seite zu pflegen. Wenn ein Befehl oder ein Dateilesen sie zurückbringt, verdient sie keine Seite. Wo eine externe Quelle existiert, nennt die Seite sie, damit die Aktualität erneut validiert werden kann. Reine Entscheidungen und Begründungen sind selbstquellend und erfüllen dies, indem sie ihre Argumentation angeben.
Ausschlusskriterien überschreiben die Kriterien:
- D1 Ephemer – Build-Status, aktueller Branch, „heute habe ich X ausgeführt“ -> Betriebsbericht.
- D2 Duplikat – Eine vorhandene Seite deckt es ab -> die vorhandene Seite ergänzen, anstatt eine neue zu erstellen.
Entscheidungsregel: Aufnehmen, wenn nicht aus einer Live-Quelle rekonstruierbar; verwerfen, wenn rekonstruierbar. wiki/.archive/ ist nur für Inhalte, die früher dauerhaft waren, jetzt aber ersetzt sind. Niemals dauerhaftes Material wird nicht in das Wiki geschrieben und niemals archiviert.
Routing-Matrix
| Material | Ziel | Skill-Pfad |
|---|---|---|
| Wiederverwendbarer Projekt-/Domänenfakt, besteht die Kriterien | dauerhafte Wiki-Seite | loam::adding-to-memory, Selbstkorrektur |
| Agentenverhaltenskonvention/Befehl/Knackpunkt | AGENTS.md / CLAUDE.md | loam::learning-from-session-Anleitungspfad |
| Sitzungszustand für Fortsetzung/Übergabe | wiki/checkpoints/<slug>.md | loam::checkpointing |
| Aufgabenkontext pro Arbeitseinheit | Aufgabenannotation / Plan-Datei | loam::planning, loam::starting |
| Build-Ausgabe, Branch-Status, Einzelfall, nicht überprüfbar oder Kriterien nicht erfüllt | verwerfen, optional mit einem log.md-Auditeintrag | keiner |
Selbstkorrektur und durch Menschen ausgelöste Auslöser
- Selbstkorrektur: Wenn der Agent Gedächtnis liest und einen Widerspruch zu aktuellen Beweisen findet, verschieben Sie die ersetzte dauerhafte Seite nach
wiki/.archive/mit einem Archivkopf, schreiben Sie die Korrektur in den aktiven Speicherort, fügen Sie einenself-correct-Eintrag zulog.mdhinzu und setzen Sie die ursprüngliche Aufgabe fort. - Durch Menschen ausgelöst: Wenn der Mensch sagt, eine Gedächtnisseite sei falsch oder veraltet, behandeln Sie es als Korrekturtrigger, nicht als Genehmigungsanfrage. Lesen Sie die markierte Seite und die aktuellen Beweise, archivieren Sie die ersetzte dauerhafte Seite, schreiben Sie die Korrektur, protokollieren Sie sie und berichten Sie, was sich geändert hat.
- Archivumfang:
.archive/ist nur für Seiten, die dauerhaft waren und später falsch, veraltet oder ersetzt wurden. Niemals dauerhaftes Material wird woanders hingeleitet oder verworfen.
Aktualitätsvalidierungsauslöser
Verwenden Sie vorhandenes updated_at plus Lint-Zeitbeweise; fügen Sie kein Aktualitäts-Frontmatter hinzu.
- F1 Ein zitierter Dateipfad hat sich seit dem
updated_atder Seite geändert. - F2 Ein Refactoring, eine Umbenennung, Löschung oder Migration hat einen referenzierten Pfad berührt (
loam::syncing-code-graph --touched). - F3 Eine gepinnte Version, API oder ein externes Dokument, das die Seite nennt, hat eine neuere Erwähnung.
- F4
updated_atist älter als 90 Tage und die Seite zitiert volatile Oberflächen wie APIs, Konfigurationen, Versionen oder Codepfade. Lint flaggt dies zur erneuten Validierung und archiviert es nicht automatisch. - F5 Widerspruch beim Lesen, behandelt durch Selbstkorrektur.
Validierungsergebnis ist eines von: bestätigt (updated_at erhöhen), korrigiert (archivieren + neu schreiben + protokollieren) oder herabgestuft (archivieren mit Grund „gilt nicht mehr“).
Rote Flaggen: Gedanken, die STOP und Aufruf bedeuten
Diese Rationalisierungen führen dazu, dass Skills übersprungen werden. Wenn Sie sich dabei ertappen, einen dieser Gedanken zu denken, rufen Sie den relevanten Skill auf, auch wenn Sie ihn „bereits früher in der Sitzung gelesen haben“.
| Gedanke | Aktion |
|---|---|
| „Ich schreibe das einfach ins Wiki“ | Rufen Sie loam-adding-to-memory auf. Wenden Sie die Aufnahmekriterien an, dann schreiben oder routen. |
| „Ich plane das einfach, das ist einfach“ | Rufen Sie loam-writing-spec auf. Spezifikationen sind vor loam-planning erforderlich. |
| „Ich mache einfach eine schnelle Debatte zwischen Agenten“ | Rufen Sie loam-configuring-agents auf. Debatten sind genehmigungspflichtig; keine Sendungen vor dem Tor. |
| „Ich bearbeite diesen Plan einfach direkt“ | Rufen Sie loam-amending-plan auf. Planänderungen kaskadieren; der Skill geht die Auswirkungen durch. |
| „Ich schreibe diese Gedächtnisseite, weil sie später helfen könnte“ | Wenden Sie zuerst die Aufnahmekriterien an. Wenn sie fehlschlagen, routen oder verwerfen Sie sie. |
| „Das Wiki ist veraltet, ich korrigiere es inline“ | Archivieren Sie die ersetzte dauerhafte Seite, schreiben Sie die Korrektur, protokollieren Sie sie und fahren Sie fort. |
| „Ich halte diese Erkenntnis einfach als Notiz fest“ | Rufen Sie loam-learning-from-session auf. Es leitet an Wiki oder Guidance weiter, nicht an Sie. |
| „Ich überprüfe einfach kurz das Wiki“ | Rufen Sie loam-querying-memory auf. Bleiben Sie im Gedächtnis verankert, nicht in veraltetem Kontext. |
| „Ich füge diesen Befehl einfach zu AGENTS.md hinzu“ | Rufen Sie loam-learning-from-session (Anleitungspfad) oder loam-auditing-guidance für ein vollständiges Audit auf. |
| „Ich mache einfach eine Pause und mache später weiter“ | Rufen Sie loam-checkpointing auf. Ein Checkpoint ist ein fortsetzbares Artefakt, kein mentaler Notiz. |
| „Ich setze dort fort, wo ich aufgehört habe“ | Rufen Sie loam-resuming auf. Überprüfen Sie den Live-Status, bevor Sie handeln. |
| „Ich richte das Wiki ein“ | Rufen Sie zuerst loam-scaffolding-wiki auf, dann loam-initializing-vault für die Obsidian-Konfiguration. |
Der loam-Lebenszyklus
Für jede loam-Aufgabe:
- Orientieren. Erkennen Sie den passenden Skill aus dem Entscheidungsgraphen unten. Wenn zwei Skills relevant erscheinen, wenden Sie die Vorrangregeln an.
- Skill auswählen. Rufen Sie ihn über den Skill-Loader des Host-Harness auf.
- Substratgrenzen einhalten. Schreiben Sie keine Checkpoints in dauerhafte Seiten. Schreiben Sie keine Anleitungen in Wiki-Seiten. Schreiben Sie keine Wiki-Inhalte in
AGENTS.md. Jedes Substrat hat seinen Skill. - Aufnahme und Routing vor Gedächtnisschreibvorgängen anwenden. Dauerhafte Wiki-Seiten müssen die Kriterien bestehen; alles andere geht an Guidance, Checkpoints, Aufgabenannotationen oder wird verworfen.
- Pläne / Checkpoints / Anleitungen nur über den passenden Skill aktualisieren. Bearbeiten Sie keinen Plan inline – verwenden Sie
loam-amending-plan. Schreiben Sie keinen Checkpoint inline – verwenden Sieloam-checkpointing. Bearbeiten SieAGENTS.mdnicht inline – verwenden Sieloam-learning-from-sessionoderloam-auditing-guidance.
Konfliktregeln (wenn zwei Skills relevant erscheinen)
- Prozess-/aktuelle-Arbeit-Skills gewinnen vor Gedächtnispflege-Skills. Wenn Sie mitten in der Ausführung sind und ein Gedächtnisproblem entdecken, schließen Sie zuerst den aktuellen Arbeitsschritt ab (oder checkpointen Sie ihn), dann rufen Sie den Gedächtnis-Skill auf.
- Gedächtnisschreibvorgänge sind agenteneigen. Wenn die aktuelle Arbeit eine Erkenntnis hervorbringt, leiten Sie sie durch die Matrix; wenn sie veraltetes Gedächtnis aufdeckt, korrigieren Sie es inline mit Archiv + Protokoll.
- Checkpoints sind flüchtig. Sie leben unter
wiki/checkpoints/, sind aber keine dauerhaften Behauptungen. Sie weigern sich,index.mdoderlog.mdzu aktualisieren. Erkennen Sie keinen Checkpoint in eine dauerhafte Notiz hoch, ohneloam-adding-to-memoryzu durchlaufen. - Ändern vs. Linten.
loam-amending-memorykorrigiert bestimmte falsche Behauptungen.loam-linting-memoryüberprüft den gesamten Graphen auf Gesundheit. Wenn Sie einen spezifischen Fehler gefunden haben, ändern Sie ihn. Wenn Sie eine allgemeine Überprüfung wünschen, linten Sie. - Abfragen vs. Überprüfen.
loam-querying-memorybeantwortet eine Frage.loam-reviewing-memorydeckt Lücken auf. Wenn Sie eine Antwort möchten, fragen Sie ab. Wenn Sie wissen möchten, was ungelöst ist, überprüfen Sie es. - Hinzufügen vs. Lernen.
loam-adding-to-memorynimmt eine Quelle auf (Datei, Artikel, Gespräch als Notiz).loam-learning-from-sessionerfasst sitzungsabgeleitete Erkenntnisse und leitet sie an Wiki oder Guidance weiter. Wenn Sie eine Quelle haben, fügen Sie hinzu. Wenn die Sitzung eine Erkenntnis hervorgebracht hat, lernen Sie.
Entscheidungsgraph
„Ich möchte...“
├─ etwas Neues beginnen
│ ├─ eine Frage recherchieren ──────────── /loam::writing-spec
│ ├─ genehmigte Arbeit planen ──────────── /loam::planning
│ └─ debattieren / Konsens erzielen ────── /loam::configuring-agents
├─ Arbeit ausführen
│ ├─ einen Plan beginnen ────────────────── /loam::starting
│ ├─ pausieren / übergeben ────────────── /loam::checkpointing
│ ├─ nach Pause fortsetzen ─────────────── /loam::resuming
│ └─ einen laufenden Plan ändern ───────── /loam::amending-plan
├─ mit Gedächtnis arbeiten
│ ├─ eine Quelle hinzufügen ─────────────── /loam::adding-to-memory
│ ├─ eine Codebasis aufnehmen ───────────── /loam::ingesting-codebase
│ ├─ Code-Graph-Drift synchronisieren ───── /loam::syncing-code-graph
│ ├─ eine Frage stellen ─────────────────── /loam::querying-memory
│ ├─ beheben, was falsch ist ────────────── /loam::amending-memory
│ ├─ Gesundheitscheck ───────────────────── /loam::linting-memory
│ ├─ unordentliches Korpus normalisieren ─ /loam::normalizing-memory
│ ├─ sehen, was ungelöst ist ────────────── /loam::reviewing-memory
│ ├─ Sitzungserkenntnisse erfassen ─────── /loam::learning-from-session
│ └─ Agentenanleitung auditieren ────────── /loam::auditing-guidance
└─ das Substrat einrichten
├─ das Wiki aufsetzen ─────────────────── /loam::scaffolding-wiki
└─ Obsidian-Vault initialisieren ──────── /loam::initializing-vault
Vorrangregel für mehrdeutige Fälle
Wenn eine Absicht auf zwei Skills abgebildet wird, ist der Baum oben der primäre Router. Wenn der Baum nicht eindeutig ist, wenden Sie die Konfliktregeln im Lebenszyklusabschnitt an. Wenn immer noch unsicher: Fragen Sie den Benutzer, welche Absicht näher liegt.
Kompakte Skill-Referenz
Eine Zeile pro Skill. Der Entscheidungsgraph ist der primäre Router; dies dient zum schnellen Nachschlagen.
loam-writing-spec— eine Frage recherchieren,specs/<slug>.mderstellenloam-planning— genehmigte Spezifikation in ausführungsreifen Plan kompilierenloam-starting— Ausführung eines Plans beginnen oder fortsetzenloam-resuming— von Checkpoint-Notizen fortsetzenloam-checkpointing— einen fortsetzbaren Checkpoint schreiben, bevor pausiert wirdloam-configuring-agents— eine genehmigungspflichtige, strukturierte Debatte oder Konferenz zwischen Agenten mit unterschiedlichen Positionen und einem Konvergenzergebnis durchführenloam-amending-plan— einen laufenden Plan nach Umfangsänderung aktualisierenloam-adding-to-memory— eine Quelle in das Gedächtnis (Wiki-Substrat) aufnehmenloam-ingesting-codebase— Codebasis als Entitätsseiten mit Wikilink-Kanten aufnehmenloam-syncing-code-graph— Codegraph mit dem Repository an Plangates oder auf Abruf abgleichenloam-querying-memory— eine Frage aus dem Gedächtnis beantwortenloam-amending-memory— bestimmte falsche oder veraltete Gedächtnisbehauptungen korrigierenloam-linting-memory— Gesundheitscheck des Gedächtnisgraphenloam-normalizing-memory— Struktur in ein unordentliches Gedächtniskorpus nachrüstenloam-reviewing-memory— ungelöste Lücken im Gedächtnis aufdeckenloam-learning-from-session— Sitzungserkenntnisse erfassen, an Wiki oder Guidance weiterleitenloam-auditing-guidance—AGENTS.md/CLAUDE.md/.claude.local.mdauditieren und verbessernloam-scaffolding-wiki— ein neues Wiki-Substrat-Scaffold instanziierenloam-initializing-vault— ein Obsidian-Vault mit Konfiguration einrichten
Schrägstrich-Befehle installieren
Wenn der Benutzer /checkpoint und /resume als Kurzbefehle wünscht (anstatt /loam::checkpointing und /loam::resuming zu tippen), können Sie sie installieren. Die Befehlsdateien befinden sich im loam-Repository unter commands/.
Lesen Sie references/commands-install.md für das vollständige Protokoll. Es behandelt:
- In welchem Harness Sie laufen (Erkennungssignale)
- Welches Befehlsformat Ihr Harness erwartet (Markdown vs. TOML)
- Wo installiert werden soll (global vs. projektspezifisch)
- Das Ask-Permission-Before-Copying-Protokoll
Die Befehlsdateien sind als Assets unter assets/commands/ gebündelt
…
[abgeschnitten für Übersetzung]
Beispiele
loam writing-spec "Wie konfiguriere ich die Datenbankverbindung?"— recherchiert die Frage und erstellt eine Spezifikation.loam planning— erstellt einen Plan aus der aktuellen Spezifikation.loam starting— beginnt mit der Ausführung des aktuellen Plans.loam querying-memory "Was ist die Architektur des Projekts?"— durchsucht das Gedächtnis nach relevanten Informationen.loam check pointing— erstellt einen Checkpoint des aktuellen Arbeitsstands.loam resuming— setzt die Arbeit von einem Checkpoint fort.
Fehlerbehandlung
- Skill nicht gefunden: Wenn der angeforderte Skill (z. B.
loam::adding-to-memory) nicht geladen werden kann, geben Sie eine klare Fehlermeldung aus und schlagen Sie die Verwendung des Entscheidungsgraphen vor. - Substratverletzung: Wenn ein Skill versucht, auf das falsche Substrat zuzugreifen (z. B. ein Checkpoint, der in eine dauerhafte Seite schreibt), lehnen Sie die Aktion mit einer Erklärung ab.
- Nicht bestandene Aufnahmekriterien: Wenn eine Seite die Kriterien nicht besteht, schlagen Sie vor, den Inhalt zu verwerfen oder in ein anderes Substrat umzuleiten, anstatt ihn in das Wiki aufzunehmen.
Sicherheit und Berechtigungen
- Keine automatischen Schreibvorgänge ohne Aufruf des passenden Skills. Der Router erzwingt, dass alle Schreibvorgänge durch den entsprechenden Skill autorisiert werden.
- Genehmigungen für Debatten:
loam-configuring-agentserfordert eine explizite Benutzerfreigabe, bevor Agenten Nachrichten senden können. - Dateisystemzugriff: Skills können das Dateisystem lesen und schreiben, aber nur innerhalb der durch das Substrat definierten Grenzen (z. B.
wiki/,AGENTS.md).
Wartung und Updates
- Aktualität: Das Gedächtnis sollte regelmäßig auf Aktualität überprüft werden (siehe Aktualitätsvalidierungsauslöser).
- Selbstkorrektur: Der Agent korrigiert sich selbst, wenn er Widersprüche findet.
- Menschliches Feedback: Der Benutzer kann jederzeit veraltete oder falsche Inhalte melden.
Integration mit anderen Tools
- Obsidian: Das Wiki-Substrat ist Obsidian-kompatibel und kann mit einem Obsidian-Vault verknüpft werden.
qmd: Das Wiki-Substrat wird vonqmdindiziert, um Suchvorgänge zu ermöglichen.- Versionierung:
AGENTS.mdundCLAUDE.mdkönnen versioniert und mit dem Projekt-Repository geteilt werden.
Leistung
- Effizienz: Die Routing-Matrix und der Entscheidungsgraph sind optimiert, um die Anzahl der benötigten Aufrufe zu minimieren.
- Skalierbarkeit: Das Gedächtnismodell kann mit einer großen Anzahl von Seiten umgehen, wobei die Aufnahmekriterien die Qualität sicherstellen.
Einschränkungen
- Nicht für Chat-Protokolle: Das Gedächtnis ist nicht für die Aufzeichnung von Gesprächen oder transienten Benutzerzuständen gedacht.
- Kein Ersatz für Versionskontrolle:
wiki/.archive/ist kein Versionskontrollsystem; es ist nur für Seiten, die ersetzt wurden. - Abhängigkeit vom Harness: Die Ausführung der Skills hängt vom Host-Harness ab (Claude Code, Cursor, Codex usw.).