Posts tagged “engineering”
All CommitBrief blog posts tagged “engineering”.
3 posts ·all posts
Reviewing against your architecture: teaching the model where the boundaries are.
An LLM reads your diff but not your layering rules. CommitBrief reads a sibling linter's architecture.json — one-way, read-only — and hands the model your declared import boundaries so it can flag a diff that crosses one.
When the model won't return valid JSON: a recovery ladder, not a blind retry.
Prompt-only models break the JSON contract in three predictable ways — fenced JSON, prose, and truncation. How CommitBrief v1.13.0 recovers each one with fence salvage, a failure-mode-specific repair prompt, and a graceful degrade.
How a single JSON schema survives four very different LLM providers.
Anthropic tools mode, OpenAI strict response_format, Gemini ResponseSchema, Ollama format:json — four mechanisms, one contract. How CommitBrief's findings schema v1 stays stable across them, and the retry-once-then-degrade fallback for when it doesn't.