Migrate all repos into monorepo context folders
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.
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# 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.yaml` when 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.ts` if index drifts out of sync
|
||||
|
||||
## Entity Schema Conventions
|
||||
|
||||
- Common header on every entity file: `id`, `type`, `created`, `modified`
|
||||
- Dates in ISO format: `YYYY-MM-DD` or `YYYY-MM`
|
||||
- Use `null` for open-ended dates (e.g., current role `end: 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.ts` for programmatic validation
|
||||
Reference in New Issue
Block a user