ForgeLoopSign in with GitHub

Field notes

Better systems around coding agents.

Practical engineering notes for teams moving from generated code to verifiable software delivery. No invented benchmarks. No shortcut around review.

Runner operations

Recover a Self-Hosted AI Coding Runner

Use a practical restart recovery checklist for self-hosted AI coding runners: verify durable state, credentials, heartbeats, leases, and safe task resumption.

Read field note

GitHub workflows

From GitHub issues to AI pull requests

Build an issue-to-PR workflow with explicit intake rules, bounded tasks, verification evidence, and a deliberate approval point.

Read field note

Architecture

Coding agents vs. delivery harnesses

Understand the difference between an AI coding agent and the orchestration, policy, evidence, and recovery system around it.

Read field note

Verification

Acceptance criteria coding agents can verify

Write observable acceptance criteria for AI coding tasks, including failure paths, permissions, test evidence, and explicit scope boundaries.

Read field note

Runner operations

Self-hosted AI runners: what stays local?

Understand what a self-hosted coding runner controls, what data can reach a model provider, and why local execution still needs security boundaries.

Read field note

GitHub workflows

Auto-merge for AI PRs: checks before trust

Design guarded auto-merge around required checks, exact commits, repository policy, and human escalation rather than model confidence.

Read field note

Cost control

Budgeting AI coding agents without guesswork

Track model usage, distinguish unknown costs from zero, and bound retries and task scope before starting autonomous coding work.

Read field note

Reliability

Designing repair loops that know when to stop

Make AI repair loops bounded and useful with structured failure context, retry classifications, durable attempts, and human escalation.

Read field note

Architecture

Git worktrees for parallel coding agents

Use separate worktrees and explicit path ownership to reduce parallel agent conflicts, while keeping integration and host security separate.

Read field note

Testing

Test AI workflows without spending API credits

Separate free deterministic tests from paid model validation using fake providers, local servers, persistence checks, and explicit evidence boundaries.

Read field note

Integrations

Reliable GitHub webhook intake for AI agents

Design webhook intake with signature verification, idempotency, authorization, and clear issue eligibility before dispatching agent work.

Read field note