ankn
a5f8fb49ab
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)
Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
1.6 KiB
1.6 KiB
Knowledge Base Conventions
File Naming
- All entity files:
<entity-id>.yaml - Entity IDs: lowercase letters, numbers, hyphens only (kebab-case)
- No leading/trailing hyphens, no double hyphens
- Pattern:
/^[a-z0-9]+(-[a-z0-9]+)*$/
Directory Structure
| Path | Contents |
|---|---|
kb/profiles/ |
Person entities |
kb/experiences/ |
Experience entities |
kb/skills/ |
Skill entities |
kb/organizations/ |
Organization entities |
kb/projects/ |
Project entities |
kb/certifications/ |
Certification entities |
kb/tandems/ |
Tandem entities |
kb/tracking/ |
LinkedIn tracking entities |
kb/graph-index.yaml |
Central graph index |
Graph Index Maintenance
- Always update
kb/graph-index.yamlwhen entities are added or removed - Valid relationship types:
has_skill,worked_at,collaborated_with,applied_for,partners_with - All relationships must reference existing entity IDs
- Rebuild with
src/graph/index-manager.tsif index drifts out of sync
Entity Schema Conventions
- Common header on every entity file:
id,type,created,modified - Dates in ISO format:
YYYY-MM-DDorYYYY-MM - Use
nullfor open-ended dates (e.g., current roleend: null) - YAML files use kebab-case keys (e.g.,
skills-used,shared-vision) - TypeScript uses camelCase (e.g.,
skillsUsed,sharedVision)
Validation Rules
- Always validate entities before writing to disk
- Temporal consistency: start ≤ end (when both are present)
- Tandem entities must have exactly 2 partners
- All referenced entity IDs must exist in the knowledge base
- Use
src/schemas/validate.tsfor programmatic validation