Docs Home

Source mirrored from seocho/docs/README.md

SEOCHO docs are organized around one question: what do you need to do right now?

Start Here

If you need to…	Start here
get a first local success path	QUICKSTART.md
understand local ask() vs runtime semantic/react/debate	QUICKSTART.md#11-execution-modes-matter
follow a runnable notebook walkthrough	../examples/quickstart.ipynb
understand SEOCHO with architecture snippets	BEGINNER_GUIDE.md
use the Python SDK directly	PYTHON_INTERFACE_QUICKSTART.md
declare reusable agent patterns in YAML	AGENT_DESIGN_SPECS.md
declare graph-model-aware indexing in YAML	INDEXING_DESIGN_SPECS.md
bring your own ontology and data	APPLY_YOUR_DATA.md
inspect files, artifacts, and traces	FILES_AND_ARTIFACTS.md
understand the system design	ARCHITECTURE.md
present SEOCHO to a technical audience	presentations/SEOCHO_OVERVIEW_DEEP_DIVE.md
measure behavior with FinDER and benchmark tracks	BENCHMARKS.md

Recommended onboarding order:

1. WHY_SEOCHO.md
2. QUICKSTART.md
3. ../examples/quickstart.ipynb
4. BEGINNER_GUIDE.md
5. PYTHON_INTERFACE_QUICKSTART.md
6. APPLY_YOUR_DATA.md
7. FILES_AND_ARTIFACTS.md
8. ARCHITECTURE.md
9. presentations/SEOCHO_OVERVIEW_DEEP_DIVE.md

Product Entry Points

• WHY_SEOCHO.md: product framing and ontology-aligned value proposition
• QUICKSTART.md: shortest local success path
• ../examples/quickstart.ipynb: runnable notebook covering ontology, indexing design, agent design, indexing, query, .env-backed provider setup, safe Ladybug fallback, optional Neo4j/DozerDB, and provider comparison
• BEGINNER_GUIDE.md: first-run guide that connects SDK snippets to architecture seams
• PYTHON_INTERFACE_QUICKSTART.md: public Python SDK path and API examples
• AGENT_DESIGN_SPECS.md: YAML-backed agent patterns with required ontology bindings
• INDEXING_DESIGN_SPECS.md: YAML-backed indexing variants for LPG, RDF, hybrid, and inquiry-cycle defaults
• APPLY_YOUR_DATA.md: ingest your own records and query them safely
• FILES_AND_ARTIFACTS.md: where ontology files, semantic artifacts, rule profiles, and traces live
• BENCHMARKS.md: FinDER and GraphRAG benchmark tracks
• ARCHITECTURE.md: architecture deep dive and module map

Architecture And Operations

• ARCHITECTURE.md: system architecture and runtime/module map
• INTERNAL_CLASS_DESIGN.md: internal orchestration seam classes (DomainEvent, IngestionFacade, QueryProxy, AgentFactory, AgentStateMachine) used while the modular monolith is still being decomposed
• presentations/SEOCHO_OVERVIEW_DEEP_DIVE.md: 20-30 minute beginner-friendly product and architecture deck
• RUNTIME_PACKAGE_MIGRATION.md: staged extraction/ to runtime/ migration plan
• GRAPH_RAG_AGENT_HANDOFF_SPEC.md: intent-first graph answer contract
• ONTOLOGY_RUN_CONTEXT_STRATEGY.md: ontology context contract across indexing, query, and agents
• PROPERTY_GRAPH_LENS_STRATEGY.md: semantic overlay strategy for property graphs
• INTERNAL_CLASS_DESIGN.md: internal orchestration seams for the modular monolith
• MODULE_OWNERSHIP_MAP.md: canonical module ownership and compatibility boundaries
• WORKFLOW.md: operational workflow

Contributor References

• ISSUE_TASK_SYSTEM.md: sprint and task governance
• BEADS_OPERATING_MODEL.md: .beads execution contract
• OPEN_SOURCE_PLAYBOOK.md: contributor onboarding
• decisions/DECISION_LOG.md: architecture decision history
• ../CONTRIBUTING.md: contribution flow and PR rules

Docs Sync Integration

• GitHub README.md is the fastest product landing page.
• docs/* is the source of truth for long-form product, operator, and system contracts.
• tteon.github.io/ mirrors selected pages for https://seocho.blog.
• If a source doc changes materially, update the mirrored website page and validate drift with the website repo checks.