Monorepo Health Checklist

Run this review periodically (recommended: every 2 weeks or at the start of a focused sprint).

Quick Health Check (5 min)

$env:PATH = "C:\Users\AndreKnie\AppData\Local\GitHubDesktop\app-3.5.8\resources\app\git\cmd;" + $env:PATH
cd "c:\Users\AndreKnie\OneDrive - Deutsche Bahn\Coden\Orchestrator"

# 1. Git status overview
git status --short | Measure-Object -Line

# 2. Untracked files by category
git status --short | Where-Object { $_ -match '^\?\?' } | ForEach-Object { ($_ -replace '^\?\?\s+"?([^/"]+).*', '$1') } | Sort-Object -Unique

# 3. Branches
git branch -v

# 4. Ahead/behind origin
git log --oneline origin/master..master | Measure-Object -Line

Component Inventory (10 min)

Check	Command	Expected
All components have COMPONENT.md	`Get-ChildItem -Recurse -Filter COMPONENT.md`	18 files
No stray .git folders (except root)	`Get-ChildItem -Recurse -Filter .git -Directory`	Only root `.git/`
README presence	Check each component	All have README.md
Package files valid	`npm ls` / `pip check` per component	No broken deps

Context Folders

Context	Expected Contents	Check
bahn/	aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp, Confluence_Bot, db-planet-mcp-server, knowledge/, O2C-Harness, project-audit, teamlandkarte-mcp, wissensdatenbank	`Get-ChildItem bahn -Name`
dhive/	Jury-Voting, knowledge/, Projekt-KIQ-HP	`Get-ChildItem dhive -Name`
privat/	CV, knowledge/, NoteGraph	`Get-ChildItem privat -Name`
shared/	AI-Orchestrator, config/, OrgMyLife, power_skills_and_more, references/, tools/	`Get-ChildItem shared -Name`

Upstream Sync Status

Components with external upstreams need periodic sync:

Component	Upstream	Sync Method
bahn/wissensdatenbank	git.tech.rz.db.de/einfachbahn-lab/tools/wissensdatenbank	`git subtree pull --prefix=bahn/wissensdatenbank wissensdatenbank main --squash`
privat/CV	github.com/DoctoDre/CV	Add remote, fetch, `git read-tree --prefix=privat/CV/ -u cv/main`
dhive/Jury-Voting	github.com/DoctoDre/Jury-Voting	Manual copy or subtree
bahn/project-audit	git.tech.rz.db.de/AndreKnie/project-audit	Manual copy (DB GitLab)

Steering Files

Expected set in .kiro/steering/:

bahn-context.md (fileMatch: bahn/**)
brevity.md (manual)
component-docs.md (fileMatch: /)
git-path.md (always)
mcp-servers.md (auto)
session-context.md (auto)
workspace-context.md (auto)
workspace-notes.md (always)

Secrets & Security

.secrets exists and is gitignored
remarkable_token.json is gitignored
No plaintext secrets in tracked files: git grep -l "password\|token\|secret\|api_key" -- ':!.secrets' ':!*.md'
No Token extern.md or similar files in Coden/ root

Knowledge Store Health

Each context has knowledge/ with _index.yaml
Inbox items are being processed (not piling up indefinitely)
bahn/knowledge/inbox/ count is reasonable (check with (Get-ChildItem bahn\knowledge\inbox -File).Count)

Workspace Consistency

Coden/.kiro/steering/workspace-context.md exists for Coden workspace
Orchestrator/.kiro/steering/ has all 8 files
privat/CV/.kiro/steering/ exists for CV workspace
No stale folders in Coden/ (only .kiro/ and Orchestrator/)

Monorepo CLI

cd shared\tools\monorepo-cli
python -m pytest tests/test_artifact.py tests/test_capture.py tests/test_bridge.py -x --tb=short -q

Expected: All pass (72+ tests).

Actions After Review

Commit any untracked COMPONENT.md or generated files that should be tracked
Push to origin if ahead
Merge or close stale feature branches
Update session-context.md with current priorities
Run ctx-guard components scan to regenerate architecture overview

3.9 KiB Raw Permalink Blame History