Feature request: Slim down notio note types and add structural primitives
Problem¶
Notio currently ships 8 note types (idea, issue, task, commit, daily, weekly, meeting, personal). In practice, many are redundant — daily/weekly are covered by worklog session tracking, commit is often redundant with git log, and personal is underused. Meanwhile, the real structural gaps are about relationships between notes, not more types.
Observations, hypotheses, findings, decisions, audits, and reviews are all just "ideas" with different tags — they don't need separate types with separate templates.
Proposal¶
1. Slim default types to four core types¶
| Type | Purpose |
|---|---|
| idea | Core workhorse — ideas, hypotheses, observations, decisions, findings, audit items. Tags differentiate. |
| issue | Distinct open/closed lifecycle, auto-dispatch support |
| task | Agent-executable — structurally different (prompt, acceptance criteria) |
| meeting | Participants, action items — genuinely different mode |
Deprecate or make optional: daily, weekly, commit, personal. Users who need them can add them as project-local types.
2. Add series frontmatter field (all types)¶
Group related notes into a named series. E.g. series: plan-audit lets you query "all notes in the plan-audit series" regardless of type. Supports multi-part investigations, audits, and review sets. Should be queryable via note_list/note_search.
3. Add refs frontmatter field (all types)¶
Structured cross-references to other notes, plan sections, pipeline mods, or any project artifact:
refs:
- note: idea-arash-20260211-175919
- plan: 03-Questions-and-Hypotheses
- mod: brainstate
Gives traceability without dedicated types for every relationship.
4. Tags carry the semantics¶
Instead of type proliferation, encourage tagging: [hypothesis], [observation], [finding], [decision], [audit], [review], [literature]. The template stays the same; filtering and discovery work through tags.
Context¶
Originated from a plan-audit discussion in pixecog. The M1 audit series (docs/log/dev/m1-audit/) was done as ad-hoc files precisely because no audit type existed — but adding a type is the wrong fix. Tags + series + refs solve it more flexibly.
Source context: pixecog¶
PixEcog (pixecog): Neuropixels and ECoG dataset and analysis
Recent commits:
6429574 untrack
614785c remove CI builds/ from tracking, add to gitignore
63f0884 pipeio notebook test
README:
type: readme
Quick Start for Collaborators¶
Follow this checklist to get started with Pixecog documentation and workflows.
🐀 Pixecog Project — Compact Overview¶
Core principles
- One immutable BIDS raw dataset (
raw/) as the canonical baseline - Each analysis pipeline ha