Content Relationships

Overview

Collections in my-buddy connect to each other in two ways:

1. Frontmatter references — Slug fields that point to entries in other collections
2. Wiki links — [[slug]] syntax in markdown body text

Relationship Map

accounts → contacts     (contact.account)
accounts → deals        (deal.account)
accounts → projects     (project.account)
accounts → meetings     (meeting.account)
contacts → deals        (deal.contact)
projects → tasks        (task.project)
projects → meetings     (meeting.project)
projects → journals     (journal.projects)
any      → kb           (wiki links in markdown body)

Frontmatter References

These are typed slug fields in frontmatter that create direct relationships:

From	Field	To	Cardinality
Contact	account	Account	Many-to-one
Deal	account	Account	Many-to-one
Deal	contact	Contact	Many-to-one
Project	account	Account	Many-to-one
Task	project	Project	Many-to-one
Meeting	account	Account	Many-to-one
Meeting	project	Project	Many-to-one
Journal	projects	Project	Many-to-many

Wiki Link References

Any entry can reference any other entry in its markdown body using [[slug]] syntax. These are resolved at build time and tracked in the backlink index.

Common patterns:

• Meeting notes referencing attendees: Met with [[sarah-chen]]
• Tasks referencing context: Part of [[acme-crm-integration]]
• KB articles cross-referencing: See also [[meeting-best-practices]]

Deal Pipeline Workflow

The relationship between accounts and deals follows a specific workflow:

Lead account → Deal (discovery → proposal → negotiation → closed-won)
→ Account type changes from lead to client

This conversion is manual — edit the account frontmatter from type: lead to type: client when a deal closes.

Backlinks

Every entry automatically displays a “Referenced by” section showing all other entries that link to it, whether through frontmatter references or wiki links. This is generated at build time from src/data/backlink-index.json.