PSI Knowledge Base Training
Slide-Style Presentation
Slide 1: Welcome
PSI Knowledge Base
Your centralized source of truth
- What PSI does
- How we work
- Our data and systems
- Project documentation
For humans AND AI agents
Slide 2: The Problem We’re Solving
Before the Wiki
| Challenge | Impact |
|---|---|
| Knowledge in people’s heads | Lost when they’re busy/leave |
| Docs scattered across projects | Can’t find what you need |
| AI agents lack context | Generic, unhelpful answers |
| New team members lost | Slow onboarding |
| ”What does that term mean?” | Constant interruptions |
Slide 3: The Solution
PSI Wiki
One place for:
├── Business context (what PSI does)
├── Processes (how we work)
├── Data documentation (our information)
├── Project guides (specific projects)
└── Analytics methods (how we calculate)
Accessible by: Humans (Obsidian/web) + AI agents (MCP)
Slide 4: What’s In It?
Content Overview
| Section | Pages | Key Content |
|---|---|---|
| Business | 3 | Company overview, products, 80+ term glossary |
| Processes | 3 | Quality (Redbook), Engineering, Manufacturing |
| Data | 3 | Data catalog, field definitions, systems |
| Projects | 1 | Redbook Analysis documentation |
| Analytics | 2 | Dashboards, calculation methodology |
| Training | 5 | These guides! |
Total: 3,700+ lines of documentation
Slide 5: How to Access
Three Options
1. Obsidian (Recommended)
- Download free: obsidian.md
- Open PSI-Wiki folder as vault
- Full features: graph view, search, backlinks
2. GitHub
- Browse at: progressivesurface.ghe.com/ProgressiveSurface/PSI-Wiki
- Read-only, always current
3. VS Code
- Open folder, use markdown preview
- Good for quick edits
Slide 6: Quick Demo - Obsidian
Key Features
-
Quick Switcher (
Ctrl+O)- Type any part of filename
- Instant navigation
-
Graph View (
Ctrl+G)- Visual map of connections
- Click to navigate
-
Wiki Links (
[[page-name]])- Click to follow
- Backlinks show what links here
-
Search (
Ctrl+Shift+F)- Full-text across all pages
Slide 7: The Terminology Page
Your Most Important Resource
company/terminology.md
80+ PSI-specific terms defined:
- Redbook, ECN, NCN
- PHYS., GTCode, BOM
- Detection Timing, Quality %
- Department codes
- And much more…
Rule: If you see an unfamiliar term, check here first.
Slide 8: How AI Uses This
Claude Code Integration
Without wiki:
“What’s a Redbook?” → Generic answer about actual red books
With wiki:
“What’s a Redbook?” → “A Redbook is PSI’s internal term for a quality issue ticket…”
Setup (one-time)
claude mcp add obsidian-wiki -- npx -y @cyanheads/obsidian-mcp-server \
--vault "C:/path/to/PSI-Wiki"Slide 9: Contributing
It’s Just Markdown
# Page Title
Regular text with **bold** and *italic*.
- Bullet points
- Like this
[[link-to-other-page]]Workflow
git pull(get latest)- Edit files
git commit+git push
Slide 10: Wiki Links
The Special Sauce
# Don't use regular links for internal pages
[Terminology](company/terminology.md) ❌
# Use wiki links instead
[[company/terminology|Terminology]] ✅
[[terminology]] ✅Why?
- Obsidian tracks connections
- Backlinks work automatically
- Easier to type and maintain
Slide 11: When to Update the Wiki
Add/Update Content When:
| Situation | Action |
|---|---|
| New PSI term used | Add to terminology.md |
| New data source | Add to data-brain.md |
| Process changes | Update relevant process page |
| New project | Create project page |
| Found wrong info | Fix it! |
The wiki is only useful if it’s current.
Slide 12: Page Template
Standard Structure
---
tags: [relevant, tags]
---
# Page Title
> One-sentence summary.
---
## Section 1
Content...
---
## Related Pages
- [[other-page]] - Description
---
*Last updated: Month Year*Slide 13: Best Practices
Do This ✅
- Link to related pages
- Define terms on first use
- Use tables for structured info
- Keep pages focused
- Update “Last updated” date
Don’t Do This ❌
- Duplicate content (link instead)
- Use undefined jargon
- Create orphan pages
- Forget to commit changes
Slide 14: Quick Reference
Keyboard Shortcuts (Obsidian)
| Action | Shortcut |
|---|---|
| Find any page | Ctrl+O |
| Global search | Ctrl+Shift+F |
| Graph view | Ctrl+G |
| Toggle edit/preview | Ctrl+E |
| Open link in new pane | Ctrl+Click |
Slide 15: Your First Task
Try This Now (5 minutes)
- Open Obsidian
- Open PSI-Wiki as vault
- Press
Ctrl+O, type “term”, open terminology.md - Find a term you know well
- Press
Ctrl+Gto see the graph - Click around to explore connections
Bonus: Find something to improve and make an edit!
Slide 16: Resources
Where to Learn More
| Resource | Location |
|---|---|
| Getting Started Guide | guides/getting-started.md |
| Editing Guide | guides/edit-wiki.md |
| Obsidian Tips | guides/obsidian-tips.md |
| AI Integration | guides/connect-ai.md |
| Contributing Guide | CONTRIBUTING.md |
Slide 17: Questions?
Common Questions
Q: What if I break something? A: It’s Git! We can always revert.
Q: How often should I update? A: Whenever you learn something others should know.
Q: Who maintains this? A: Everyone. It’s a team resource.
Q: Can I reorganize pages? A: Yes, but update links and llms.txt.
Slide 18: Summary
Key Takeaways
- PSI Wiki = centralized knowledge for humans + AI
- Obsidian = best way to browse and edit
- Terminology page = your first stop for unfamiliar terms
- Wiki links =
[[page-name]]for connections - Everyone contributes = keep it current
Thank You!
Next Steps
- Download Obsidian if you haven’t
- Open the PSI-Wiki vault
- Explore for 15 minutes
- Make one small edit
- Set up MCP server for Claude Code
Questions? Ask in Teams or open a GitHub issue.
PSI Knowledge Base Training - February 2025