second-brain-publish

1# Prepare to publish
2 
3Once something is crawled, it is out. Every check here is cheap; the failure it
4prevents is permanent.
5 
6## Core rule
7 
8Explicit opt-in only. A page publishes because it says `publish: true`, never
9because nothing excluded it.
10 
11## Workflow
12 
131. **List the opt-in set.** Every page marked for publication.
142. **Follow their links.** A published page linking to a private one either
15   leaks the title or produces a dead link. Report both.
163. **Scan for anything that should never ship:** credentials, other people's
17   private information, confidential work, personal detail in examples.
184. **Check the frontmatter** for fields not meant to be public, such as
19   confidence labels or private source paths.
205. **Report, do not export.** The user runs the build.
21 
22## Output format
23 
24```
25Publishable: <n> pages
26Links to unpublished pages: <n>
27  [[public page]] -> [[private page]]
28Flagged content: <list with reasons>
29Frontmatter to strip: <fields>
30Verdict: <safe to build | fix these first>
31```
32 
33## Calibration
34 
35Err toward flagging. A false positive costs the user ten seconds; a miss is
36permanent.
37 
38If the user asks to publish the whole vault, ask what they intend to do about
39the private material rather than proceeding.