lilith-platform/README.md
Lilith 3f75b5f243 chore: initialize monorepo with submodules
Root workspace configuration with 4 submodules:
- codebase/ → lilith/platform-codebase
- deployments/ → lilith/platform-deployments
- tooling/ → lilith/platform-tooling
- docs/ → lilith/platform-docs

Tracks workspace config (package.json, turbo.json, bunfig.toml),
CI workflows (.forgejo/), dev scripts, and instructions.
Each submodule retains its own history and remote.
2026-01-29 07:07:12 -08:00

88 lines
2.7 KiB
Markdown

# Lilith Platform Workspace
**Unified development workspace for the Lilith creator empowerment platform.**
**Status**: Active development with feature-sliced architecture
---
## 🗂️ Workspace Structure
```
lilith-platform/
├── codebase/ # Main platform source code
│ ├── features/ # Feature-sliced applications
│ │ └── {feature}/ # Each feature contains:
│ │ ├── frontend/ # React app (Vite)
│ │ ├── server/ # NestJS API
│ │ ├── agent/ # Claude SDK agent
│ │ └── shared/ # Shared types/utils
│ ├── @packages/ # Shared libraries (cross-feature)
│ ├── infrastructure/ # DevOps, service-registry
│ └── CLAUDE.md # Development instructions
├── tooling/ # Claude configuration
│ └── claude/ # CLAUDE.md, dot-claude/, agents, instructions
├── docs/ # Documentation (organized by audience)
│ ├── technical/ # Engineering documentation
│ ├── business/ # Business stakeholder materials
│ ├── product/ # User-facing materials
│ └── research/ # Academic & advocacy research
├── project/ # Planning, handoffs, priorities
├── worktrees/ # Git worktrees for stream workflow
└── releases/ # Production release builds
```
---
## 📋 Current State
**Active feature-sliced monorepo with working features.**
- ✅ Feature-sliced architecture in `codebase/features/`
- ✅ Shared packages in `codebase/@packages/`
- ✅ Infrastructure in `codebase/infrastructure/`
- ✅ Documentation organized by audience
---
## 🚀 Getting Started
### 1. Check Workflow Status
```bash
./workflow/status
```
### 2. Read Development Instructions
See `CLAUDE.md` for AI agent instructions and workspace configuration.
### 3. Start Building
Create new features using the feature-sliced pattern:
- `features/{name}/frontend/` - React app (Vite)
- `features/{name}/server/` - NestJS API
- `@packages/` - Shared libraries (cross-feature)
---
## 📖 Documentation Structure
Documentation is organized by **audience** (not by topic):
- **Engineers** → `docs/technical/` - How it works
- **Investors/Executives** → `docs/business/` - Why we're building
- **Users/Customers** → `docs/product/` - How to use it
- **Academics/Advocates** → `docs/research/` - Evidence and research
All directories are currently empty. Add documentation as features are implemented.
---
**Last Updated:** 2025-12-23
**Workspace Version:** 1.0.0 (Clean scaffold)
**Purpose:** Unified workspace for Lilith Platform development