Skip to content
flowlayer

Onboarding a New Developer

Use this checklist to get a new teammate productive on day one without tribal knowledge.

Baseline checklist

Section titled “Baseline checklist”
  1. Install binaries:
  • flowlayer-server
  • flowlayer-client-tui
  1. Clone repository and fetch the canonical flowlayer.jsonc.
  2. Run local server once:
Terminal window
flowlayer-server -c ./flowlayer.jsonc
  1. If session mode is enabled, validate health endpoint:
Terminal window
curl -H "Authorization: Bearer <token>" http://127.0.0.1:6999/health
  1. Connect TUI:
Terminal window
flowlayer-client-tui -addr 127.0.0.1:6999 -token <token>

What to teach explicitly

Section titled “What to teach explicitly”
  • server/client role split
  • session.bind vs session.addr
  • readiness and dependency basics
  • where runtime logs come from

Common onboarding failures

Section titled “Common onboarding failures”
  • using wrong binary name
  • trying to use server config as TUI config without session.addr
  • expecting FlowLayer to behave like a production orchestrator

Direct references: