Developer Guide

For developers modifying Smithers or building packages that integrate with it (custom reviewers, alternate worker SDKs, alternate constraint sources).

• Smithers package layout — directory tree, build outputs, what each module owns.
• Coding agent and inference integration — how CodingAgent resolves credentials, runs the LLM loop, captures evidence, and how SDK workers are dispatched as an alternative path.
• Actor topology — SmithersSupervisor and its children (ConstraintGraph, GitHubAdapter, WorkspaceActor, ContainerManager, IssueActor, ReviewerAgent, RatchetStore, ArchitectureDocWatcher, SprintOrchestrator, EscalationPolicy, ProviderAffinityTracker, ConstraintActor, ConstraintGroupActor, ConstraintVersionStore, ConstraintChecker).
• Testing — the spec suites in src/actors/__tests__/ and the Playwright e2e tree.