Agentic Ventures Wiki

05-final-report

4 Min. Lesezeit

05 — Final-Report: QA-Sweep Vault-Vollstaendigkeit

Zusammenfassung in 5 Saetzen

Das Vault ist nach dem Sweep + Marvins Folge-Entscheidungen strukturell konsistent und produktiv-bereit. Von 54 broken Wikilinks bleiben 5 als Schema-konforme PII-Referenzen uebrig. Cross-Refs zwischen Kunden/Personen/Projekten/MCPs sind komplett sauber, IDs konsistent durchnummeriert. Alle 10 SKILL.md-Files haben jetzt Vault-Schema 5.17 Frontmatter und referenzieren neue Pfade — Vault ist Source of Truth, Plugin-Repo wird ggf. spaeter angelegt. .gitignore neu, edi-certificates.md geloescht, ZIP-Pattern entfernt. 44 Wissen-Files ohne type: bleiben als bewusster Migrations-Stand offen.

Top-3-Probleme — alle erledigt

1. SKILL.md Source of Truth — ✅ erledigt (Marvin: Vault ist Source)

Plugin-Repo marvinkuehlmann/agentic-ventures-plugin existiert nicht (gh 404). Marvin hat entschieden: Vault als Source of Truth.

Was gemacht wurde:

  • Alle 10 SKILL.md (+ wochen-planung/plan.md) haben jetzt Schema-5.17-Frontmatter: id, type: skill, name, description, purpose, required_mcps, inputs, outputs, runs_log_in, status, last_used.
  • Alle alten Pfad-Verweise gefixt: wiki/kunden/ → intern/kunden/, operations/finanzen/ → intern/finanzen/ oder extern/inbound/rechnungen/, operations/action-items.md → Plugin-TODO-Liste, mcp-setups/ → intern/capabilities/mcps/, company/brand.md → intern/firma/brand.md, company/partner-materials/ → assets/firma/partner-materials/, runs/ → intern/runs/, raw/belege/ → assets/finanzen/, ideas-backlog.md → intern/ideen/ideas-backlog.md.
  • Pfad-Tiefe korrigiert: ../../../_meta/... (3 levels) → ../../../../_meta/... (4 levels — Skills liegen 1 level tiefer als andere Files).
  • Skill-↔-MCP-Cross-Refs jetzt symmetrisch: gsuite MCP referenziert 5 Skills via [[../skills/<name>/SKILL]], jeder dieser 5 Skills hat required_mcps: ["[[../../mcps/gsuite]]"].

2. edi-certificates.md — ✅ erledigt (Marvin: brauchen wir nicht)

Datei geloescht. Keine offenen Referenzen.

3. agentic-brand-assets.zip Pattern — ✅ erledigt (Marvin: entfernen)

.gitignore Pattern assets/firma/brand-assets/*.zip entfernt. ZIP wird beim naechsten git add committed.

Was ich automatisch behoben habe

Strukturelle Vollstaendigkeit

  • ✅ intern/kunden/_context.md neu angelegt (war einzig fehlender Folder-Context unter intern/)
  • ✅ .gitignore neu angelegt (war komplett nicht vorhanden — Sicherheits-Luecke!) mit allen Patterns aus _meta/security.md plus Defaults
  • ✅ 12x .md-Suffix-Drift in _meta/-Files
  • ✅ 12x Skill-Wikilinks auf <skill>/SKILL korrigiert (in MCP-/Repo-Files)
  • ✅ 14x bas-twin / becker-projekt von Slug- auf relative Pfade
  • ✅ 5x Pfad-/File-Korrekturen (recht → recht/_context, eu-ai-act → eu-ai-act-pflichten, etc.)
  • ✅ 5x Trailing-Slash-Folder-Wikilinks → _context/_index
  • ✅ 3x [[../_context]] (Vault-Root, existiert nicht) → [[../CLAUDE]]

Frontmatter

  • ✅ intern/lieferanten/ypsum.md: category: service_provider ergaenzt (Schema 5.3 Pflicht)
  • ✅ CLAUDE.md, CONTEXT.md, ONBOARDING.md: type: meta_doc ergaenzt

Migrations-Drift

  • ✅ 4 Wissen-Files (entscheidungen, glossar, prozesse): alte Pfade wiki/, company/, mcp-setups/ korrigiert
  • ✅ 3 Firma-Files: alte Pfade in brand.md, leistung-claude-dsgvo-hosting.md, fahrplan.md korrigiert
  • ✅ 4 _meta-Files: .md-Suffixe in Wikilinks entfernt, „sobald migriert”-Anhaenge entfernt wo Files existieren

Was offen blieb und warum

Brauchen Marvin-Entscheidung

  • SKILL.md Source-of-Truth + Schema (siehe Top-3 #1) — Plugin-Repo gibt’s nicht
  • edi-certificates.md (siehe Top-3 #2) — 0-byte-Mystery
  • agentic-brand-assets.zip (siehe Top-3 #3) — Build-Artefakt-Frage

Bewusster Migrations-Stand (laut Migration-Log)

  • 44 Files ohne type:-Feld — Wissen-Files mit altem Frontmatter, „beim naechsten Editieren auf neues Schema”. Akzeptiert als gradueller Migrationsweg.
  • Detail-Vertraege, Rechnungen, YouTube, Branchen-Wissen, Recherche-Berichte, Team, Meetings — unter Migration-Log §“Was noch offen ist” als „bei aktiver Arbeit nachholen” markiert. Nichts blockiert akut.

Niedrige Prioritaet

  • 53 von 136 Files ohne ## Related-Section — Convention sagt „IMMER”, Praxis hat 17 Personen-Files (oft sehr kurz) und 18 _context.md (haben „Verwandte Bereiche”-Section stattdessen) ohne Related. Empfehlung: Convention §4.4 explizit lockern fuer Files <30 Zeilen, oder einen Stichproben-Lauf bei Personen-Files mit ergaenzendem Related-Block.
  • 15 Orphan-Files — alle gepruefte legitim (Top-Level-Routing, Reference-Material). Nichts loeschen.

Empfehlung

Produktiv-bereit: ja, ohne Vorbehalte.

Was als Naechstes graduell anfallen kann (nicht akut blockierend):

  • Bei naechstem Editieren (graduell): Wissen-Files Frontmatter auf neues Schema ziehen (type: process / type: glossary_entry / type: decision_record). Schema in _meta/schemas.md 5.21+ ergaenzen.
  • Optional spaeter: Plugin-Repo marvinkuehlmann/agentic-ventures-plugin anlegen + von Vault sourcen wenn Multi-User / mehrere Maschinen relevant werden.
  • Optional spaeter: Personen-Files mit ## Related-Section nachziehen (17 Files betroffen).

Das Vault-Operating-System ist konsistent: Behavior-Rules, Routing, MCP-Index, Customer/Person/Projekt-Cross-Refs, Skills mit Vault-Schema, Sicherheits-Hygiene — alles gruen.

Statistik

  • Files editiert: ~45 (incl. SKILL.md-Sweep)
  • Files neu angelegt: 2 (intern/kunden/_context.md, .gitignore)
  • Files geloescht: 1 (edi-certificates.md)
  • Wikilinks im Vault gefixt: 49 (54 → 5 Schema-konforme PII-Refs)
  • Migrations-Drift-Treffer gefixt: 14 (in wissen + firma + _meta) + ~40 (in skills/)
  • Offene Drift-Treffer: 0 (alle gefixt)
  • SKILL.md mit Vault-Schema-Frontmatter: 11/11 (10 SKILL.md + wochen-planung/plan.md)
  • Frontmatter-Pflicht-Issues behoben: 4 (CLAUDE/CONTEXT/ONBOARDING + ypsum)
  • Frontmatter-Pflicht-Issues offen: 32 (Wissen-Files — bewusster Migrations-Stand)
  • Doppelte IDs: 0

Graphansicht

Backlinks