Projects — System Portal

One place to read the whole system and jump straight to the code. Here's the shape of it — a first static cut of the system map (the interactive version is architecture/ADR-001, Phase 2). For where everything actually stands right now — versions, what's shipping next — see the Roadmap (architecture/ADR-002):

graph TD
  KB["kb-agent<br/>RAG + tool-use"] -->|"classify_snippet → /classify"| DNC["defense-news-classifier"]
  KB -->|"search_notes → GET /notes"| API["notes-api<br/>FastAPI"]
  API -->|"BackgroundTask → /classify"| DNC
  API -->|"writes labels back as tags"| API
  ARCH["architecture<br/>ADRs + this portal"] -.->|"governs"| KB
  ARCH -.->|"governs"| API
  ARCH -.->|"governs"| DNC

How this stays honest

Everything below is generated from the source repos — read it here, but edit it in its home repo. See architecture/ADR-001.

Jump in

• Roadmap

  The whole system's status at a glance — live versions plus what's now, next, and later.

  Open the roadmap →

• Decisions

  The whole log in one wall — system (SYS-*) and per-app (ADR-*).

  Open the decision wall →

• System

  Product one-pager, program view, engineering substrate, case study.

  Open the system view →

• Apps

  Each service's README, docs, and decisions — one click from its source.

  Open the apps →

• Telemetry

  Quality & telemetry. Placeholder until a service is deployed (Phase 3).

  Open telemetry →

Repos at a glance

Repo	Read	Code
architecture (this hub)	Decisions · System	GitHub ↗
kb-agent	In portal	GitHub ↗
notes-api	In portal	GitHub ↗
defense-news-classifier	In portal	GitHub ↗
learning-notes	plain-language concept notes	GitHub ↗
agent-ops	the agent operating layer, all vendors — incidents, security posture, skills (SYS-015)	GitHub ↗