.socraticodecontextartifacts.json

{
  "artifacts": [
    {
      "name": "database-schema",
      "path": "docs/SCHEMA.md",
      "description": "Table and column reference with FK relationships and full Alembic migration history. Check before writing any migration, DB query, or schema-dependent feature."
    },
    {
      "name": "deployment",
      "path": "docs/DEPLOYMENT.md",
      "description": "Server lifecycle, systemd service management, address validation workflow, backfill commands, and full ops reference. Check before touching infra, services, or env config."
    },
    {
      "name": "source-page",
      "path": "docs/SOURCE_PAGE.md",
      "description": "WSLCB source page HTML structure and field label quirks. Must consult when touching parser.py or any scraping/parsing logic."
    },
    {
      "name": "style",
      "path": "docs/STYLE.md",
      "description": "Brand colors, CSS conventions, and Tailwind usage patterns. Check before modifying templates or adding new UI components."
    },
    {
      "name": "infra",
      "path": "infra/",
      "description": "Host configuration: systemd units and timers for all services (web, scraper, address validation, healthcheck), plus the memory-pressure configs that keep the web service alive under exhaustion on this swapless VM (service + parent-slice MemoryLow, OOMScoreAdjust, vm.min_free_kbytes, earlyoom). Consult when modifying service configuration, adding scheduled tasks, or touching OOM/memory behaviour."
    },
    {
      "name": "research",
      "path": "docs/research/",
      "description": "Architectural review findings and design decisions (architecture-review.md — consult before proposing structural changes), plus domain research: entity classification, template analysis, data audits, and record linking analysis. Relevant for work on entities, record linking, and data quality."
    },
    {
      "name": "plans",
      "path": "docs/plans/",
      "description": "Dated implementation plans and design docs (2026-03 onward), including the superseded SQLite-to-PostgreSQL phase plans. Design history, not current behaviour: may describe values or schemas a later migration changed. Search with artifactName set when asking why something was built a certain way."
    },
    {
      "name": "specs",
      "path": "docs/specs/",
      "description": "Dated design specs (the docs/superpowers/specs override, #176): the design intent behind a feature at the time it was written. Design history, not current behaviour; confirm against source."
    },
    {
      "name": "socraticode",
      "path": "docs/SOCRATICODE.md",
      "description": "Code exploration reference: the full SocratiCode tool table, a pointer to the prefetch hook, per-tool notes, graph-health and index-scope guidance. The on-demand half of the Code Exploration Policy block in AGENTS.md."
    }
  ]
}