Aloysius Productions Knowledge Vault

Central repository for documented learnings, decisions, patterns, and references across all Aloysius Productions projects. Built on Obsidian with bidirectional linking and automated validation.

Key Decisions

DecisionRationaleOutcome
Obsidian-based wiki formatBidirectional links enable knowledge discoveryGood
Frontmatter metadata on all filesEnables automation and validationGood
Separate folders for projects/references/patternsClear organizational taxonomyGood
Automated link validationPrevent broken references and orphaned contentGood
Kebab-case filenamesURL-safe, consistent with Obsidian conventionsGood

Patterns Established

PatternDescriptionReusable
Decision log formatTable-based decision tracking with rationale and outcomeYes
Lessons learned formatContext + impact structure for retrospective knowledgeYes
Project page templateStandardized structure for project documentationYes
Bidirectional link validationCI check for broken wiki-style linksYes
Frontmatter schema enforcementRequired fields validated on commitYes

Lessons Learned

LessonContextImpact
Manual curation causes driftProject statuses and links went staleImplement automated validation
Obsidian links need target validationEasy to create links to non-existent pagesAdded link validation workflow
Knowledge capture must be low-frictionHigh-effort documentation gets skippedEstablished quick capture patterns
Consistent naming enables automationInconsistent filenames broke link resolutionEnforced kebab-case convention

Technical Debt

ItemPriorityNotes
No full-text search in CILowObsidian provides this locally
Missing project page templatesLowCreate scaffolding script