HQ01

The operating system of AAF Holdings. HQ01 is how the CEO and executives build departments and products. It is not a CRM and not an admin panel — it is Headquarters.

Intelligence belongs to the organization, not the worker.

What it is

A Next.js + TypeScript + Tailwind application that renders the AAF Holdings operating system directly from the repository. V1 reads markdown and yaml files only — no database, no API, no authentication, no runtime AI.

Surface	Reads from
Dashboard	live counts + recent activity across the repository
Mission Sessions	**/missions/<id>/mission.md
Work Orders	**/work-orders/<id>/work-order.md
Assignments	**/assignments/<id>/assignment.md
Executives	**/hermes/executives/*.yaml
Reports	**/reports/**/*.md
Artifacts	a read-only explorer of the whole repository
Settings	constitutions, doctrine, roadmaps, and how HQ is wired

Content is discovered by convention, so as Engineering adds new departments and products, HQ01 surfaces their missions, work orders, and reports automatically — no configuration required.

Running

npm install
npm run dev      # http://localhost:4000

Every page is server-rendered on demand and reads the repository fresh, so changes to the underlying files appear on the next request — no rebuild.

Configuration

HQ01 resolves its content root automatically (the AAF workspace that contains both repositories/ and holdings/). Override it explicitly:

HQ01_CONTENT_ROOT=/srv/aaf npm run dev

Architecture

• app/ — the eight HQ01 surfaces (App Router, Server Components).
• components/ui/ — shadcn-style primitives (Card, Badge, Button, …).
• components/layout/ — sidebar, mobile nav, page header, navigation config.
• components/shared/ — status badges, record rows, markdown, field lists.
• lib/content/ — the file-reading layer: one reader per entity type, plus a convention-based document parser that understands both YAML frontmatter and the repository's Label: value / Section: markdown style.

Everything is component-based and additive. To add a new HQ01 surface, add a reader in lib/content/, a route under app/, and an entry in components/layout/nav.ts.

Non-goals (V1)

No Graphiti · No LiteLLM · No Langfuse · No Playwright · No autonomous workers · No AI execution · No Docker orchestration · No backend services · No external APIs.