Architecture Decision Records
Indexed ADRs from docs/adr/, docs/adrs/, and the Build 025.5 governance layer. Reference these before modifying any platform system.
Formal audit of Build 025 before Build 026 feature work. Identified RISK-4 (ingestion_runs not persisted) and RISK-6 (hydration mismatch). Both resolved in Build 025.5.
docs/BUILD_026_CHANGE_AUDIT.mdIntroduces the architecture governance layer: domain registry, protected systems list, migration registry, build registry, ADR index, dependency map, and governance dashboard. Establishes release-state model and protected-system policy.
Skills extraction (80+ taxonomy), vertical classifier (11 verticals), freshness decay, dedup engine, trend snapshots, company hiring profiles, and admin source panel.
docs/adr/ADR-025-workforce-intelligence.mdLive ATS ingestion from Greenhouse, Lever, and Ashby via typed provider adapters. Ingestion orchestrator, source health tracking, and manual trigger API.
docs/adr/ADR-024-real-ingestion-pipeline.mdEstablishes the /jobs route as a dedicated robotics jobs board. Initial 60-record seed. WorkforceScout brand.
docs/adr/ADR-022-robotics-jobs-board.mdEstablishes Supabase as the sole production database for EAR, providing PostgreSQL, real-time, and auth in one hosted platform.
docs/adr/ADR-001-supabase.mdAdopts n8n for scheduling and orchestrating ingestion workflows, allowing no-code workflow authoring over the API layer.
docs/adr/ADR-002-n8n-orchestration.mdDefines the signal approval workflow: all AI-generated content passes through human operator review before publication.
docs/adr/ADR-003-review-workflow.mdKeyword-based forum signal classification taxonomy for robotics topics.
docs/adr/ADR-004-forum-keyword-classification.mdEstablishes the EAR ontology as a protected layer. Defines the process for adding, modifying, or deprecating canonical terms.
docs/adr/ADR-005-ontology-governance.mdAll AI-generated content on EAR surfaces must carry a disclosure label. Defines disclosure UI patterns.
docs/adr/ADR-006-ai-disclosure.mdNumeric credibility scoring model for news and data sources. Score decays on failures and resets on successful ingestion.
docs/adr/ADR-007-source-credibility.mdRBAC model: visitor / member / operator / admin tiers with gated admin routes.
docs/adr/ADR-008-role-model.mdAppend-only entity_timeline_events table for all company and market events. Events are never deleted.
docs/adr/ADR-009-event-history.mdDefines the operator session mode: elevated admin capabilities with audit logging for all destructive actions.
docs/adr/ADR-010-operator-mode.mdFoundational ADR for the robotics jobs intelligence pillar. Establishes the WorkforceScout brand and data model.
docs/adr/ADR-011-jobs-intelligence.mdIngestion can operate in demo (seed data) or live (API) modes. Mode is controlled by environment flag.
docs/adr/ADR-012-hybrid-model-ingestion.mdMultiple AI providers contribute independent confidence scores to program ratings. Final rating is an ensemble.
docs/adr/ADR-013-multi-ai-program-ratings.mdPer-vertical specialist intelligence agents provide deeper analysis within each robotics category.
docs/adr/ADR-014-category-specialist-intelligence.mdEAR is the OS layer. Multiple brand skins (EAR, TDB, etc.) run on top of shared intelligence infrastructure.
docs/adr/ADR-015-multi-brand-intelligence-operating-system.mdCanonical entity model for companies, people, and products. Entity resolution and dedup strategy.
docs/adr/ADR-016-entity-intelligence-layer.mdRevised entity intelligence model with expanded relationship graph and signal-to-entity attribution.
docs/adrs/adr-019-entity-intelligence.mdSelf-scheduling ingestion pipeline with adaptive frequency based on source activity levels.
docs/adrs/adr-020-autonomous-pipeline-scheduler.mdConsolidates multiple ingestion pipelines into a single orchestrator. Introduces the operator review queue.
docs/adr/ADR-021-pipeline-consolidation-operator-review.md