Write convention.md template #4

New Issue

Closed

opened 2026-06-30 15:24:19 +00:00 by jared · 1 comment

jared commented

2026-06-30 15:24:19 +00:00

Owner

What to build

Apply the template-design process (from the memory-template skill) to produce ~/Documents/SecondBrain/_templates/convention.md.

Template sections per the plan:

Purpose (1–2 sentences) — what recurring decision does this govern?
Core Principles (3–7) — each with rationale ("do X because Y")
Patterns — how principles manifest in practice; concrete examples
Anti-Patterns — what this convention forbids and why
Exceptions — known cases where the convention doesn't apply

Dogfood exemplar: convention/sandi-metz-code-philosophy.md. Fill the completed template with this note; cut any empty or padded sections; tighten ambiguous instructions.

Acceptance criteria

Template file exists at ~/Documents/SecondBrain/_templates/convention.md
Template uses the authoritative frontmatter schema from vault-conventions.md
Each section header includes a one-line inline instruction
Template dogfooded with convention/sandi-metz-code-philosophy.md — no empty sections, no padding
Sections that didn't survive the injection-economics filter are removed

Blocked by

Issue #3 (howto.md template must be complete first — it validates the design process itself)

## What to build Apply the template-design process (from the memory-template skill) to produce `~/Documents/SecondBrain/_templates/convention.md`. Template sections per the plan: 1. Purpose (1–2 sentences) — what recurring decision does this govern? 2. Core Principles (3–7) — each with rationale ("do X because Y") 3. Patterns — how principles manifest in practice; concrete examples 4. Anti-Patterns — what this convention forbids and why 5. Exceptions — known cases where the convention doesn't apply Dogfood exemplar: `convention/sandi-metz-code-philosophy.md`. Fill the completed template with this note; cut any empty or padded sections; tighten ambiguous instructions. ## Acceptance criteria - [ ] Template file exists at `~/Documents/SecondBrain/_templates/convention.md` - [ ] Template uses the authoritative frontmatter schema from `vault-conventions.md` - [ ] Each section header includes a one-line inline instruction - [ ] Template dogfooded with `convention/sandi-metz-code-philosophy.md` — no empty sections, no padding - [ ] Sections that didn't survive the injection-economics filter are removed ## Blocked by - Issue #3 (howto.md template must be complete first — it validates the design process itself)