메뉴
Use when developing the Team Edition server (packages/team-server) — local run, tests against the guarded fleetlens_test database, authoring hand-written DB migrations, demo data, and the fixture-privacy rule.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when adding support for a new coding agent/CLI as a Fleetlens session source (e.g. OpenCode) — the parser adapter, source registry, display metadata, tests, and optional usage poller. This is the canonical community extension task.
Use after changing parser, web, or CLI code to see the change actually running, and before claiming any change works — covers the standalone rebuild flow, smoke verification, and the port/cache/worktree traps that repeatedly bite agents in this repo.
Use when the user asks to file, log, track, open, or backlog a GitHub issue for a Fleetlens enhancement, bug, or chore. Applies when capturing work for future handoff to an implementation agent rather than doing it inline in the current session.
Use when shipping a fleetlens CLI release — squash-merging the PR, writing the CHANGELOG entry, bumping the version, pushing the tag, and verifying the npm + GitHub Release land. Covers the CLI track only; team-server (server-v*) has its own path in CLAUDE.md.
| name | team-server-dev |
| description | Use when developing the Team Edition server (packages/team-server) — local run, tests against the guarded fleetlens_test database, authoring hand-written DB migrations, demo data, and the fixture-privacy rule. |
packages/team-server/README.md is the reference (local development,
architecture orientation, env vars). This skill is the working checklist an
agent needs in-loop.
createdb fleetlens_local
DATABASE_URL=postgres://localhost:5432/fleetlens_local \
FLEETLENS_ENCRYPTION_KEY=$(openssl rand -hex 32) \
BASE_URL=http://localhost:3322 \
pnpm -F @claude-lens/team-server dev
Migrations apply automatically on boot; the first signup becomes the
staff/admin account. Root pnpm dev also boots team-server and crashes the
whole turbo run without DATABASE_URL — export first or run per-package.
createdb fleetlens_test # once
pnpm -F @claude-lens/team-server test
The suite defaults to postgres://localhost:5432/fleetlens_test, migrates it,
and truncates every table between tests. It refuses any database whose
name doesn't contain test — do not weaken that guard, and never point
DATABASE_URL at a database you care about.
Read packages/team-server/src/db/MIGRATIONS.md first. Non-negotiables:
src/db/migrations/NNNN_<desc>.sql, next free
number). Do NOT run drizzle-kit generate — the journal is frozen at 0008
and it emits a corrupt migration re-creating existing tables.-- description: ... (release pipeline hard-fails
without it).src/db/schema.ts in the same commit; run the test suite — it
applies every migration including orphans.migration-reviewer agent (.claude/agents/migration-reviewer.md)
on the diff before opening the PR.All demo/mock/test data in this package is fictional by construction:
project orbit-shop, tickets ORB-<n>, members Erin/Alice/Bob/Dana, emails
@example.com. Never introduce real employer/customer names, real ticket
prefixes, or real people into insights-mock-data.ts, seed scripts, or test
fixtures — the ?mock=1 demo view renders this content to real customers,
and scrubbing leaked data once cost a dedicated audit round.
Own track: entry in packages/team-server/CHANGELOG.md, then version bump +
server-v<X.Y.Z> tag (exact commands in root CLAUDE.md → Release process —
the npm-from-subdirectory gotcha is real). Ships to GHCR; customers pin
:X.Y.Z tags, :latest tracks master.