Engineering Notes

Patterns from building AI agent systems for daily use — what worked, what failed, and why.

AI Agent Architecture

RDU: Reusable Decision Units for Consistent AI Agents

How to make AI agents give consistent decisions across sessions using versioned, trigger-driven rule files. 140+ rules across iOS, trading, AI agent design, game development.

AI agentsconsistencyClaude Code

Falsifier-Driven AI Decisions: No Claim Without Falsification Conditions

How to prevent LLM agents from hallucinating probabilities and accepting unverifiable multi-agent consensus. Includes real metrics: council_repeat_rate 0.44, empty_consensus_rate 0.354.

AI agentshallucinationmulti-agent

How to Make an AI Research Agent Label Facts vs Inferences

Stop a RAG agent from presenting inferences as facts: let the LLM only extract, and let deterministic code score and label FACT/INFERENCE with a ≥2-independent-source rule and required evidence IDs.

provenanceRAGhallucination

Claude Code Stop Hooks as Behavioral Gates

Using Claude Code hooks to enforce behavioral constraints beyond prompts. AND-gate design, nag-once pattern, decision-ownership and sycophancy-prevention examples.

Claude Codehooksbehavioral gates

Fleet Monitoring & Orchestration

Aggregating cron and macOS launchd into one read-only dashboard — without migrating either

See every cron job and LaunchAgent in one place by globbing on-disk state instead of importing them. Includes a 25-tool fit-gap matrix and the read-only aggregation pattern.

cronlaunchdobservability

Why I Rejected an Event Bus for My Solo Agent Fleet: State Is Truth, Events Are Rumors

Why pull (scan on-disk state) beats push (an event bus) for monitoring a high-churn fleet with components you don't control. The instrumentation-tax argument and self-healing polling.

multi-agentpull vs pushMCP

A File-Based Work-Bus for Orchestrating a Fleet of Agent CLIs

Coordinate independent agent CLIs without LangGraph or a message broker: atomic Task/Result files, capability-based routing, absent-worker skip for graceful degradation, and a typed claim contract on the bus.

orchestrationmulti-agentLangGraph alternative
← hexisteme home · CC-BY 4.0