peerasak-u/pi-sec-brain/sb-setup

raw/
  articles/
  papers/
  podcasts/
  books/
  notes/
  assets/
wiki/
  entities/
  concepts/
  sources/
  synthesis/
scripts/

mkdir -p raw/{articles,papers,podcasts,books,notes,assets}
mkdir -p wiki/{entities,concepts,sources,synthesis}
mkdir -p scripts

# AGENTS.md — [Wiki Name]
 
## Wiki Overview
-**Domain**: [user-provided]
-**Purpose**: [user-provided]
-**Scope**: [what belongs here vs. outside]
 
## Directory Structure
-`raw/` — immutable source documents (articles, papers, podcasts, books, notes, assets)
-`wiki/` — LLM-generated pages
  -`entities/` — people, places, organizations
  -`concepts/` — ideas, topics, methods
  -`sources/` — summary pages for each ingested source
  -`synthesis/` — ideas/explorations derived from wiki
  -`index.md` — catalog of all pages
  -`log.md` — chronological append-only log
 
## Naming Conventions
-**Slugs**: kebab-case only (e.g., `neural-networks`, `attention-is-all-you-need`)
-**Page names**: globally unique across entire wiki
-**Categories**: use folder prefix (entities/, concepts/, etc.)
-**Never**: Title Case, snake_case, or spaces in slugs
 
## Link Syntax
-Wikilinks: `[[slug]]` (e.g., `[[neural-networks]]`)
-Link to heading: `[[slug#heading]]`
-Link to alias: `[[slug|Display Text]]`
-**Always use kebab-case** inside wikilinks
 
## Page Format
 
### Frontmatter (YAML)
\`\`\`yaml
---
title: Page Title
tags: [tag1, tag2]
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: [source-slug-1, source-slug-2]
---
\`\`\`
 
### Section Structure
\`\`\`markdown
# Page Title
 
## Summary
 
[2-3 sentence overview]
 
## Key Points
 
-[bullet 1]
-[bullet 2]
 
## Related
 
-[[related-slug]]
\`\`\`
 
## Workflow: Ingest
 
1.User drops source in `raw/[category]/`
2.Call `sb:ingest` skill
3.LLM interviews user (see ingest skill for details)
4.LLM creates pages breadth-first
5.Run post-edit script: `uv run scripts/ingest_post.py`
6.Script validates links, creates stubs, logs to `log.md`
 
## Workflow: Query
 
1.User asks question
2.Call `sb:query` skill
3.LLM searches wiki via `index.md` and page content
4.LLM synthesizes answer
5.Ask: "Save this to wiki?" if answer is valuable
6.If yes → save to `synthesis/`
 
## Workflow: Lint
 
1.User triggers lint: "lint the wiki"
2.Call `sb:lint` skill
3.Run lint script: `uv run scripts/lint.py`
4.Report findings to user
5.If user approves fixes → run with `--fix` flag
 
## Logging
 
-All operations logged to `wiki/log.md` by scripts only
-LLM never edits `log.md` directly
-Format: `## [YYYY-MM-DD] action | type | details`
-Log rotation: 1000 rows
 
## Index
 
-`wiki/index.md` catalog of all pages
-Updated automatically after every ingest
-Format: link + one-line summary per page

# macOS
.DS_Store
 
# Editor
.obsidian/
 
# Logs (keep log.md but archive old ones)
wiki/log-archive/
 
# OS
Thumbs.db

echo '{}' > wiki/manifest.json