# LLM Field Notes > An open, local-first workspace for turning documents into an inspectable, > evolving knowledge graph and projecting it into Obsidian-ready Markdown. ## Start here - [Workbench](./#workbench): ingest documents, inspect concepts and relations, review evidence, improve the representation, and rebuild saved sources through current feedback. - [Learning map](./#map): first-principles notes and runnable experiments about tokens, embeddings, attention, training, transformers, retrieval, agents, knowledge graphs, and production systems. - [Knowledge-graph note](./notes/knowledge-graphs.md): how a document becomes an inspectable representation that can improve through review. - [Try a sample graph](./#sample): launch the complete local workflow without preparing a document. - [Community artifacts](./artifacts.html): runnable experiments and inspectable graph tooling. - [Sample graph export](./examples/sample-graph.json): deterministic starter graph for health, diff, and JSON-LD projection commands. - [Sample Graph.canvas](./examples/sample-graph.canvas): native Obsidian Canvas projection of the same public starter graph. - [Canvas schema](./schema/canvas.schema.json): bounded native Canvas interchange contract for external viewers and importers. - [Canvas verifier](./scripts/verify-canvas.mjs): offline strict verifier for Canvas node, edge, size, and endpoint integrity. - [Service health schema](./schema/service-health.schema.json): versioned liveness and readiness response contract for operators. - [Service health verifier](./scripts/verify-service-health.mjs): offline validation tool for captured health responses. - [Sample graph explainer](./sample-graph.html): crawler-readable concepts, evidence, relations, and fingerprint for the same starter graph. - [Learning loop artifact](./experiments/learning-loop.mjs): a deterministic extract → review → portable guidance → improved extraction walkthrough. - [Diff verifier](./experiments/verify-diff.mjs): independently recompute and verify a graph diff against two bounded graph inputs. - [Graph verifier](./experiments/verify-graph.mjs): verify a graph export or backup fingerprint before consuming it. ## Project contracts - [Architecture](./ARCHITECTURE.md): module boundaries, graph source of truth, learning loop, privacy levels, and extension rules. - [Graph schema](./schema/graph.schema.json): normalized internal representation. - [Feedback schema](./schema/feedback.schema.json): reviewed decisions used as bounded extractor guidance. - [Share schema](./schema/share.schema.json): closed redacted recipient-share projection accepted by the viewer and workbench importer. - [Share verifier](./scripts/verify-share.mjs): offline validation for a downloaded redacted share JSON handoff. - [Sample share fixture](./examples/sample-share.json): safe public input for trying the share verifier. - [Vault manifest schema](./schema/vault-manifest.schema.json): Obsidian projection identity and round-trip metadata. - [Health schema](./schema/health.schema.json): privacy-safe graph quality diagnostics and automation gates. - [JSON-LD schema](./schema/jsonld.schema.json): versioned semantic-web projection contract for external graph tooling. - [Learning-loop schema](./schema/learning-loop.schema.json): versioned baseline-versus-guided artifact output contract. - [Canvas schema](./schema/canvas.schema.json): bounded native Obsidian projection contract with resolvable node and edge identities. - [Rebuild adapter](./rebuild-adapter.js): bounded, cancelable saved-source rebuild orchestration with direct smoke coverage. - [Learning note pages](./notes/README.md): runnable curriculum notes with crawler-readable shared landing pages. ## Principles - Preserve evidence and provenance with every inference. - Make confidence, uncertainty, review freshness, and ambiguity visible. - Let people correct the representation without starting over. - Treat Obsidian and Markdown as projections, not competing databases. - Keep local graph data private; shared URLs never contain the graph. ## Contribute - [Contributing guide](./CONTRIBUTING.md): improve the curriculum, graph behavior, projections, or deployment surface. - [Graph correction workflow](./CONTRIBUTING.md#correct-a-graph-representation): report a missing concept, misleading relation, or unsupported evidence without sharing private source text. - [Artifact submission template](./ARTIFACT_SUBMISSION.md): share a small, reproducible experiment, graph, benchmark, or failed attempt. - [Security guide](./SECURITY.md): data boundaries and vulnerability reporting. - [Changelog](./CHANGELOG.md): production hardening and user-visible changes.