SPECIMEN_ID: LOCAL-SYNTAX-LLM

local-syntax-llm

Context-aware LLM for architecture audits and restart ramps

Designation
local-syntax-llm
Caste
Sovereign Librarian / Local Inference Engine
Primary Mission
Context-aware LLM for architecture audits and restart ramps
Status
Active - Mac Mini M4 Only
Visibility
PRIVATE
Port
n/a (Ollama default: 11434 on M4)
Primary Surface
Python CLI (orchestrator.py)
Engine
Python 3.12+ / Ollama (Llama 3)

Description

local-syntax-llm is a lightweight Python orchestration layer for a locally-hosted Ollama LLM, deployed on the Mac Mini M4. It feeds architecture documentation, schema files, and synced vault logs as a knowledge base to the model, then accepts director queries via an interactive prompt. Its primary purpose is generating 'restart ramps' — structured context summaries that allow the director to re-enter complex work after a gap — and auditing junior agent progress against the known system architecture.

Key Features

  • ›
    Architecture knowledge base

    Loads all .md and .sql files from data/architecture/ into the model's system context at startup.

  • ›
    Deterministic startup workflow

    Launch sequence is cd local-syntax-llm, source venv/bin/activate, then python orchestrator.py on the Mac Mini M4.

  • ›
    Vault sync

    scripts/sync_vaults.py pulls live JSON logs from synt-mx human (:3000) and agent (:3001) vaults into data/raw/ for ingestion.

  • ›
    System identity

    system.md defines the Sovereign Orchestrator role, guiding principles, and reasoning constraints injected into every session.

  • ›
    Interactive query loop

    orchestrator.py runs a single-turn prompt/response loop against the Ollama API — no server setup required beyond ollama run.

  • ›
    Transcript storage

    Raw session transcripts stored in data/raw/transcripts/ for audit and replay.

Changelog

Version 2026.04.06

  • ›
    Data

    Added transcript dataset data/raw/transcripts/pnm-agent-feature-video.txt for restart-ramp context.

Version 2026.04.05

  • ›
    Init

    Initialized the M4 orchestrator stack and initial repository scaffolding (orchestrator.py, system.md, README.md, LICENSE, .gitignore).

  • ›
    Architecture

    Expanded knowledge-base coverage with agent-synt-mx-schema.md, synt-mx-build-system.md, diagram.md, and updated system-overview.md.

  • ›
    Sync

    Added and then promoted vault sync utility to scripts/sync_vaults.py.

  • ›
    Data

    Captured initial synced telemetry snapshots in data/raw/agent_logs.json and data/raw/human_logs.json.

Open GitHub Back to Registry