1Gherkin that tests [philosophy.md](philosophy.md). Each Rule maps to a principle. Simulate a structural decision against these scenarios when an edge case is unclear.
2
3```gherkin
4Feature: Note-taking philosophy
5
6 How knowledge is shaped, tagged, linked, and accreted in a personal
7 knowledge base. These scenarios are what good practice looks like; the
8 prose rationale lives in philosophy.md.
9
10 Rule: A note is about one concept
11
12 Scenario: Authoring a new evergreen note
13 Given a finding worth keeping durably
14 When the note is created
15 Then its title names a single concept
16 And another page could link to that concept by name without ambiguity
17
18 Scenario: An existing page covers several distinct concepts
19 Given a page whose sections each describe a distinct concept
20 And each section could plausibly be a link target from another page
21 When the page is next edited
22 Then it is split into one page per concept
23 And a hub note may remain in its place linking to the new pages
24
25 Scenario: A page covers several aspects of one concept
26 Given a page with multiple sections
27 And the sections are facets of the same underlying concept
28 When the page is reviewed
29 Then the page is left as one page
30
31 Rule: Working knowledge stays in todos; durable knowledge is extracted
32
33 Scenario: A reusable lesson emerges during a todo
34 Given a todo's work log uncovers a fact useful beyond this todo
35 When the work log entry is written
36 Then a separate concept-oriented page is created or updated for the lesson
37 And the work log links to that page from where the discovery happened
38 And the work log does not duplicate the lesson's content
39
40 Scenario: A finding is specific to this todo only
41 Given a finding emerges that has no value outside this todo
42 When the work log entry is written
43 Then the finding is recorded in the work log
44 And no separate page is created
45
46 Scenario: A todo's work is still in progress
47 Given durable insights are accumulating during active work
48 When a stopping point has not yet been reached
49 Then extraction may be deferred until the work concludes
50 But extraction is not skipped permanently
51
52 Rule: Density lives in the link graph
53
54 Scenario: A page mentions a concept that has its own page
55 Given a page being written or edited
56 When it mentions a concept that has a page in the space
57 Then the mention is wikilinked inline
58 Even if the link feels obvious
59
60 Scenario: A page mentions a concept that does not yet have a page
61 Given a page being written
62 When it mentions a concept that lacks a page
63 And the concept seems likely to recur
64 Then a stub page may be created and linked to
65 Or the absent page is noted as a follow-up
66
67 Scenario: A section needs to enumerate items in the space
68 Given items that can be queried by tag, path, or front-matter attribute
69 When the enumeration is added to the page
70 Then a structured query is written instead of a static list
71
72 Rule: A tag must fit one of the four axes
73
74 Scenario: A candidate tag is being considered
75 Given a candidate tag for a page
76 When the tag does not fit any of: type, topic-as-object, sensitivity, or faceted sub-aspect
77 Then the tag is not added
78
79 Scenario: A page mentions a subject without being about it
80 Given a page that mentions a topic in passing
81 And the page would remain substantially intact with the topic removed
82 When tags are being chosen
83 Then the topic is not used as a tag
84 And the mention is wikilinked instead
85
86 Scenario: A page is centrally about a topic
87 Given a page whose primary subject is a topic
88 And removing the topic would gut the page
89 When tags are being chosen
90 Then the topic is used as a tag
91
92 Scenario: A faceted sub-tag is being considered
93 Given a candidate slash-tag refining a topic
94 When at most one page in the space would share that facet
95 Then the facet tag is not introduced
96 And the topic tag is used alone
97
98 Rule: Tags converge over time
99
100 Scenario: An existing tag would convey the same meaning
101 Given a candidate tag for a page
102 When an existing tag fits the meaning, even imperfectly
103 Then the existing tag is used
104
105 Scenario: A new tag would only apply to one page
106 Given a candidate tag
107 When no existing tag fits
108 And only this page would carry the tag
109 Then no new tag is created
110 And a wikilink is added in body text instead
111
112 Scenario: Near-duplicate tags exist
113 Given two tags that mean the same thing under slightly different spellings
114 When the situation is noticed
115 Then one is chosen and the others are updated to match
116
117 Rule: Tags don't echo the hierarchy
118
119 Scenario: A page lives at a path that names its topic
120 Given a page at `<area>/<topic>/<title>`
121 When tags are being chosen
122 Then the topic is not added as a tag
123 Unless the topic-as-object test would still apply with the page moved elsewhere
124
125 Rule: Look before writing
126
127 Scenario: A new page is about to be created
128 Given an intent to add a new page
129 When the page is created
130 Then full-text search has been consulted for related existing pages first
131 And structured queries have been consulted for structurally similar pages where applicable
132 And the new page either does not duplicate an existing one
133 Or it explicitly subsumes and supersedes the existing one
134
135 Scenario: An existing page is the right home
136 Given a search returns a page whose concept matches the new content
137 When the new content is added
138 Then it is added to the existing page rather than to a new page
139
140 Rule: Hubs link, but don't substitute for atomicity
141
142 Scenario: A hub note is healthy
143 Given a page that links to constituent pages with prose around them
144 When the prose is short and serves to orient
145 Then the page is a structure note and stays as one
146
147 Scenario: A hub note has accumulated content
148 Given a hub note whose prose has grown to dominate the page
149 When the prose covers concepts that could each be their own page
150 Then the prose is extracted into concept pages
151 And the hub retains only orienting prose and links
152```