skills / conventions
quality
skills/conventions/quality.md
Quality Convention
Cross-cutting quality rules for all brain-writing skills.
Citations (MANDATORY)
Every fact written to a brain page must carry an inline [Source: ...] citation.
- User's statements:
[Source: User, {context}, YYYY-MM-DD] - Meeting data:
[Source: Meeting "{title}", YYYY-MM-DD] - Email/message:
[Source: email from {name} re: {subject}, YYYY-MM-DD] - Web content:
[Source: {publication}, {URL}, YYYY-MM-DD] - Social media:
[Source: X/@handle, YYYY-MM-DD](URL) - Synthesis:
[Source: compiled from {sources}]
Source precedence (highest to lowest)
- User's direct statements (highest authority)
- Compiled truth (brain's synthesized understanding)
- Timeline entries (raw evidence)
- External sources (API enrichment, web search)
Back-Linking (MANDATORY)
Every mention of a person or company WITH a brain page MUST create a back-link FROM that entity's page TO the page mentioning them.
Format: - **YYYY-MM-DD** | Referenced in [page title](path) -- context
An unlinked mention is a broken brain.
Notability Gate
Before creating a new brain page, check notability:
- People: Will you interact again? Relevant to work/interests?
- Companies: Relevant to work/investments/interests?
- Concepts: Reusable mental model? Worth referencing again?
When in doubt, DON'T create. A 400-follower person who tweeted once is not notable.