Main index for AI-assisted development. Use this document as the entry point for project documentation.
- Type: Web monolith (Next.js 15 App Router)
- Primary language: TypeScript
- Architecture: Layered BFF (Backend For Frontend)
- UI: React 19, styles in
app/globals.css(custom properties, VT323 font) — no Tailwind - Office view: 2D only (pixel-art rooms); no 3D scene or Three.js dependencies
- Persistence: file system (JSON, YAML, Markdown)
- Observability: JSONL event log (
.aiteam/), REST snapshot + localhost ingest, in-app dashboard linked from Help
- Stack: Next.js 15, React 19, TypeScript 5, next-intl, MiniSearch, Vitest
- Entry point:
app/[locale]/page.tsx— health check and localized dashboard (/en,/pt) - Pattern: BFF monolith + on-disk persistence
- API routes: 32
route.tsmodules underapp/api/**(REST + SSE), including observability and arena endpoints - Components: ~47
.tsxfiles undercomponents/ distDir:.next-devin development,.nextin production (seenext.config.ts)
- Project overview — executive summary, stack, and features
- Architecture — patterns, decisions, diagrams, and layers
- Source tree — annotated structure
- API contracts — routes with request/response schemas (includes
/api/observabilityand commandX-Correlation-Id) - Component inventory — components, hierarchy, and state
- Development guide — setup, commands, and conventions
- Main README — project introduction (English)
- README (Portuguese) — Portuguese version
- User guide — using the dashboard
- Installation guide — installation and setup
- architecture.md — points to the canonical architecture document
- api-reference.md — points to API contracts
- developer-guide.md — points to the development guide
- Memory system — technical overview
- Memory system guide — using the vault
- System comparison — comparative analysis
- Sprint status — sprint progress (YAML)
Designs and plans for future features (context profiles, portability, web setup):
- Context profiles — design
- Portability — design
- Setup wizard web — design
- Context profiles — plan
- Portability — plan
- Setup wizard web — plan
Specs for the old 3D scene were removed from docs/; history remains in Git if needed.
- Screenshots — UI captures
git clone https://github.com/INOSX/AITeam.git
cd AITeam
npm install
npm run setup
npm run devOpen http://localhost:3000 (redirects to the default locale).
If you see missing chunks or CSS after switching between dev and build, run npm run clean:next and restart.
| Field | Value |
|---|---|
| Last revised | 2026-04-03 |
| Mode | full_rescan (manual) |
| Reference workflow | document-project v1.2.0 |