Handbook
Getting started with Forge LCDL
Browse by intent first, then drill into guides. Canonical narrative overview: WHAT-IS-LCDL.md.
Updated
| I want to… | Start here |
|---|---|
| Understand what LCDL is (and what it is not) | WHAT-IS-LCDL.md |
| Run something in the first hour without live credentials | FIRST-HOUR.md |
| Install LCDL or wire it into a consumer repo | README.md and ADOPTION.md |
| Add or change a governed catalog task | CONTRACT-SPEC.md, SCHEMAS.md, .cursor/rules/lcdl-core.mdc |
Enrich docs with contract.json sidecars |
CONTRACT-SPEC.md, scripts/audit_contract_docs.py |
| Work from Cursor (rules / skills / agents / MCP sidecar) | CURSOR-INTEGRATION.md |
| Expose LCDL operations as MCP tools in Cursor | MCP-SIDECAR.md |
| Call Playwright MCP from Python LCDL helpers | MCP-CLIENT.md |
| Run benchmarks (offline fake transport by default) | BENCHMARKS.md |
| Debug transport / gateway / schema / MCP failures | TROUBLESHOOTING.md |
| Navigate as an agent (paths, verification commands) | FOR-AGENTS.md |
| See the lcdl-snippets demo arena (sibling repo) | README.md |
Publish the handbook site (lcdl.forgesdlc.com) |
WEBSITE-PUBLISHING.md |
Ecosystem pointers
Process, methodology, and ceremony live in Forge Blueprints (blueprints.forgesdlc.com); product framing in Forge SDLC (forgesdlc.com). Forge LCDL owns governed synchronous run_task execution, contracts, generic transport helpers, and composable operators—not Fleet job orchestration, not in-repo Playwright runners.
Verify you are set up
cd forge-lcdl
pip install -e ".[dev]"
python -m compileall -q src tests
pytest -q
See FIRST-HOUR.md for a tighter smoke path (TaskRunner + fake_chat).