Code Directory
Structure
/Code
├── CLAUDE.md # This file — cross-cutting conventions
├── agent-alfred/ # Personal assistant — GTD, research, dashboard
├── agent-angel/ # Angel investing — deal flow, pipeline
├── agent-cmo/ # Content/marketing — writings, social
├── agent-worca/ # Worca operations — sales, invoicing, talent
├── hihq-monorepo/ # HIHQ technical implementation
├── worca-repos/ # Worca code repositories
├── lin-family-projects/ # Family coordination
└── misc/ # Uncategorized
Agent Repos
Each agent has its own repo with CLAUDE.md and AGENT.md. Read these first when working in that directory.
| Agent | Purpose |
|---|---|
agent-alfred/ |
Personal assistant — daily actions, research, dashboard UI |
agent-angel/ |
Angel investing — deal tracking, pipeline, thesis |
agent-cmo/ |
Content/marketing — drafts, ideas, social engagement |
agent-worca/ |
Worca operations — clients, invoicing, talent, sales |
Key shared files:
agent-alfred/UI_STYLE_GUIDE.md— Cool Ivory theme (used across all UIs)
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | React 19 + Vite + TypeScript |
| Backend | Express 5 + TypeScript + Prisma 6 |
| Database | PostgreSQL 16 (Docker) |
| Monorepo | pnpm workspaces + Turborepo |
| Dashboard | Astro + Cloudflare Pages |
| Node | >=20.0.0 |
Commands
# HIHQ monorepo
pnpm dev # Start dev servers
pnpm build # Build all packages
pnpm type-check # TypeScript checking
pnpm db:generate # Generate Prisma Client after schema changes
# agent-alfred dashboard
cd agent-alfred/ui/dashboard-astro
pnpm dev # Local dev at localhost:4321
pnpm deploy # Build & deploy to Cloudflare Pages
# agent-worca
cd agent-worca/db
npx tsx scripts/... # Run database operations
Verification
YOU MUST verify work before committing:
- TypeScript:
pnpm type-check - Builds:
pnpm build - Prisma:
pnpm db:generateafter schema changes - Dashboard:
pnpm deployafter system changes (skills, workflows, CLAUDE.md)
Writing Style
Every sentence must carry value. No fluff.
| Do | Don't |
|---|---|
| Start with the point | "Here's what happened:", "Let me explain:" |
| Data and specifics | Adjectives and vague claims |
| Active voice | Passive voice |
Terminology (Worca/HIHQ)
| Use | Avoid |
|---|---|
| Talent | Candidates, users |
| Curate | Source, find |
| Judgment | Algorithm, system |
UI & Theming
For all HTML/CSS work, read agent-alfred/UI_STYLE_GUIDE.md for the Cool Ivory theme.
| Property | Value |
|---|---|
| Background | #fffff8 |
| Text | #2c2c2c |
| Accent | #4a6fa5 |
| Font | Libre Baskerville |
Project-Specific Context
Each project has its own CLAUDE.md. Read it first when working in that directory.
| Project | Context |
|---|---|
agent-alfred/ |
Personal assistant — GTD, research, dashboard |
agent-angel/ |
Angel investing — deals, pipeline, thesis |
agent-cmo/ |
Content/marketing — drafts, ideas, social |
agent-worca/ |
Worca operations — clients, invoicing, talent |
hihq-monorepo/ |
HIHQ technical implementation (code) |
worca-repos/ |
Worca code repositories (API, web, website, extension) |
lin-family-projects/ |
Family coordination |
Proactive Behavior
In work projects:
- Research and pull available info without being asked
- Surface decisions that need human attention
- Be direct when something doesn't fit
When Claude Does Something Wrong
Add it to the relevant CLAUDE.md. Learnings compound.