Skip to content

file conventions

Thomas Naughton edited this page Mar 19, 2026 · 2 revisions

openQSE Meeting File Conventions

Repo conventions observed in this workspace

  • Main meeting pages are stored at repo root as Meeting-YYYY-MM-DD.md.
  • Transcript files are stored at repo root as Meeting-YYYY-MM-DD-transcript.docx.
  • Attendance exports are stored at repo root as Meeting-YYYY-MM-DD-attendance.csv.
  • Canonical attendee normalization data lives at repo root in FOLKS_CANONICAL.md.

Sidecar outputs for this skill

Use date-stamped sidecar files in the working directory:

  • YYYY-MM-DD-attendees.md
  • YYYY-MM-DD-folks-updates.md

These files are intermediate deliverables and should be easy to diff and review.

Meeting page structure cues

Existing meeting pages in this repo commonly include:

  • A meeting title and date
  • Agenda and logistics above the notes
  • ## Attendance
  • ## **Notes**
  • A brief AI-generated notice
  • Inside ## **Notes**, prefer ### Brief Summary followed by ### Detailed Notes
  • Keep Detailed Notes rich and transcript-grounded without repeating attendees or the meeting date

Prefer preserving those sections instead of rewriting the whole page from scratch.

Clone this wiki locally