llamafarm: Command for Claude Code

Codebase Research Playbook

A fast, reliable way for agents to understand this monorepo before implementing an issue. Follow this checklist to map scope, find the right code, and de‑risk changes.

Objectives

• Understand the issue: clarify scope, inputs/outputs, and success criteria.
• Locate the code path: find entry points, flows, configs, and tests.
• De‑risk: identify edge cases, cross‑project impacts, and verification steps.

Quickstart Checklist (15–30 min)

• Read the issue: capture user story, acceptance criteria, affected area(s), and constraints.
• Identify project(s): server, cli, rag, models, docs. If unsure, start with Nx graph.
• Skim module entry points:
  • server/main.py and server/api/**
  • cli/main.go and cli/cmd/**
  • rag/cli.py and rag/**
  • docs/website/**
• Find existing tests near the suspected code.
• Collect commands to run (build/test/dev) so you can validate later.

Workspace-first view (Nx preferred)

If Nx tools are available, prefer them to map dependencies and tasks.

• Graph: visualize projects and edges.
  • Example: run a project graph or open the visualization tool to see producers/consumers.
• Show project details: inspect target configurations (build/test/lint/dev).
• Docs: consult relevant Nx docs for generators/tasks if needed.

If Nx tools are not available, manually inspect:

• nx.json, project.json files at repo and project roots
• package.json scripts (if present in subprojects)
• server/project.json, server/pyproject.toml
• cli/go.mod, cli/project.json
• rag/pyproject.toml, rag/default_strategies.yaml

How to search effectively

• Start semantic, then go exact:
  • Use semantic search for “how/where” questions (endpoints, flows, responsibilities).
  • Use exact search (ripgrep/grep) for symbols, function names, routes, or constants.
• Good semantic queries:
  • “Where is user authentication handled?”
  • “How are CLI commands registered?”
  • “Where is RAG document ingestion triggered?”
• Good exact searches (ripgrep examples):

rg --hidden --glob '!**/dist/**' --glob '!**/node_modules/**' "uvicorn|FastAPI" server | cat
rg --hidden "cobra\.Command" cli | cat
rg --hidden "pytest|conftest\.py" server | cat
rg --hidden "project\.json" -n | cat

• Trace the flow: when you find a hit, read nearby files; follow imports, routes, and callers.
  • Expand outward until you can explain inputs, transformations, side effects, and outputs.