Skip to content

Add tutorial: OCaml for LLM Coding Agents#3584

Open
cuihtlauac wants to merge 1 commit into
mainfrom
tutorial-llm-agents
Open

Add tutorial: OCaml for LLM Coding Agents#3584
cuihtlauac wants to merge 1 commit into
mainfrom
tutorial-llm-agents

Conversation

@cuihtlauac
Copy link
Copy Markdown
Collaborator

Summary

  • New guide data/tutorials/guides/1wf_06_llm_coding_agents.md (~200 lines)
  • Standalone tutorial on making LLM coding agents productive with OCaml
  • Covers writing effective agent configuration files (CLAUDE.md, .cursorrules, copilot-instructions.md) with a complete worked example
  • MCP server integration for extending agent knowledge (ocaml-docs, LSP, odoc Markdown)
  • What agents are good/bad at in OCaml
  • Project structure practices that help agents: .mli files, focused modules, explicit types, dune fmt in CI

Context

The existing LLM sections in the opam-path and dune-pkg tutorials cover environment setup. This guide goes further: how to configure a project so agents can actually be productive, what tools extend their knowledge, and how to work around their limitations. It's a distinct audience (developers setting up projects for agent use) with distinct content.

Test plan

  • make build succeeds
  • Review rendered page at /docs/llm-coding-agents
  • Links to /docs/opam-path, /docs/dune-pkg, /docs/reading-errors work

🤖 Generated with Claude Code

New guide covering how to make LLM coding agents productive with
OCaml projects:

- Environment setup: opam exec vs dune pkg for agents
- Writing effective configuration files (CLAUDE.md, .cursorrules,
  copilot-instructions.md) with a complete worked example
- Extending agent knowledge with MCP servers (ocaml-docs, LSP,
  odoc Markdown output)
- What agents are good at: pattern-following, refactoring, tests
- What agents struggle with: type errors, dune syntax, package
  selection, advanced type features, PPX
- Structuring projects for agent success: .mli files, focused
  modules, explicit types, formatting in CI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant