← Roteiro home

Documentation

• Roteiro — Build Plan
• Roteiro — Technical Implementation Plan

Architecture Decision Records

• ADR-0001: Build Roteiro — a unified, provenance-tagged codebase knowledge graph (spec-store v2)
• ADR-0002: Adopt the official rmcp SDK for networked MCP serving
• ADR-0003: Pluggable embedding models — tiny static default, opt-in local models
• ADR-0004: Spec/Blueprint authoring pillar — tiered, graph-grounded, check-gated
• ADR-0005: Image ingestion — tiered OCR (pure-Rust) + optional vision understanding
• ADR-0006: Local model serving — a llama.cpp-backed, code-aware OpenAI-compatible endpoint
• ADR-0007: Configuration file — a single project-level TOML with layered precedence
• ADR-0008: Multi-repo workspace serve — one instance, many project graphs, one model
• ADR-0009: Cross-repo workspace links — interlink a hub app with its deployment repos
• ADR-0010: Explorer web app — vendored client-side JS (cytoscape.js) for the served UI
• ADR-0011: Structured file logging — OpenTelemetry-shaped JSON, rotated, groundwork for OTLP
• ADR-0012: Analyzer findings — a separate artifact model, never a provenance class
• ADR-0013: Agent memory — a two-tier artifact store, decaying by evidence not by clock
• ADR-0014: Sandboxed analyzer execution — an owned seam, ingest by default, boxlite opt-in
• ADR-0015: Generated media content — its own artifact store, rebuildable on demand
• ADR-0016: Audio metadata as derived facts — symphonia for format reads, and MPL-2.0 in the licence allowlist
• ADR-0017: Dependency security — current by default, monitored, and held for a minimum release age of at least 48 hours
• ADR-0018: Analyzer coverage — which analyzers deliver which languages, and on which axis
• ADR-0019: Remote model tier — an explicitly consented egress path, and the promises it changes
• ADR-0020: Build-capable sandboxed execution — running the repository's own build, and the non-goal it narrows
• ADR-0021: The graph's shareable form is an OKF bundle — replacing the Obsidian vault
• ADR-0022: A dynamic OKF viewer — the bundle is the source, and it is somebody else's
• ADR-0023: Authoring commands act on the sources, and only where a rule is decidable
• ADR-0024: Widening the content screen — what a peer's bundle can carry, and what we never say about it
• ADR-0025: Documents are decoded, screened, and extracted only where somebody said yes
• ADR-0026: A research knowledge layer — raw sources in, an authored wiki out

← Back to roteiro.dev