Handbook · commands

Commands are questions you ask the system.

Do not memorize commands without knowing what evidence their output should provide. The purpose column is the important part.

Repository & Git

git status

Show working tree/staging state before changing history.

git diff

Inspect unstaged changes.

git diff --staged

Inspect exactly what the next commit will contain.

git log --oneline --decorate -n 20

Read recent history and branch pointers.

git switch -c <branch>

Create a focused branch for a change.

pnpm workspace

pnpm install --frozen-lockfile

Install exactly from the lockfile; fail on manifest drift.

pnpm --filter web dev

Run only the Next.js workspace.

pnpm --filter api start:dev

Run only the NestJS API workspace.

pnpm -r typecheck

Run a script recursively across workspaces that define it.

pnpm why <package>

Explain why a dependency exists in the graph.

Prisma

pnpm exec prisma version

Verify CLI/client/environment version information.

pnpm exec prisma validate

Validate schema/config before migration work.

pnpm exec prisma migrate dev --name <name>

Create/apply a development migration from deliberate schema changes.

pnpm exec prisma generate

Regenerate Prisma Client from schema.

pnpm exec prisma studio

Inspect development data visually; not a migration tool.

Docker

docker build -t taskflow-api:dev .

Build an image from the current Docker context.

docker run --rm -p 4000:4000 --env-file .env taskflow-api:dev

Run API image with explicit port/env injection.

docker ps

List running containers and published ports.

docker logs <container>

Read process output for one container.

docker inspect <container>

Inspect runtime/network/health metadata.

Verification habit

node --version

Prove the active Node executable/version.

corepack --version

Prove Corepack is available.

pnpm --version

Prove the expected package-manager line is active.

git --version

Prove Git command resolution.

pnpm build

Perform a production-style documentation/app build where the repository defines it.