Topic archive

Coding Agents

Repository Handoff Notes for Coding Agent Runs

A practical guide to writing repository handoff notes that help coding agents preserve context, evidence, and review readiness across branches, worktrees, and pull requests.

coding agentsrepository handoffpull requestsgit worktrees
Open guide

Agent Run Evidence Ledgers for Human Review

A practical guide to what evidence a coding agent should capture during a run, how to structure that evidence into a ledger a human reviewer can act on, and how to hand it off through a pull request or CI workflow.

coding agentsevidence ledgershuman reviewpull requests
Open guide

Instruction File Scope Checks for Coding Agent Repos

A practical guide to auditing the scope, placement, and content of instruction files — AGENTS.md, .github/copilot-instructions.md, CLAUDE.md, and similar — so coding agents in your repo stay within intended boundaries.

coding-agentsinstruction-filesagents-mdrepo-setup
Open guide

How Agent Guides Fail Without Source Backing: A Field-Level Breakdown

Agent guides that lack source backing produce instructions agents cannot verify, leading to silent drift, broken CI, and unsafe automation decisions. This article maps the concrete failure modes, explains where guidance gaps originate in real instruction files and memory systems, and gives operators a practical workflow for diagnosing and hardening their own agent guides.

coding-agentsagent-guidesfailure-modesinstruction-files
Open guide

How to Gate Model Candidates Before Your Coding Agent Publishes

A practical guide for engineering teams that want a structured approval workflow before a coding agent uses a new model in production publishing pipelines. Covers the rationale, a smoke-test workflow, CI gate integration, and a safe log-record template.

coding-agentsmodel-approvalci-cdgateway
Open guide

How to Produce Reviewable Diffs From Coding Agent Sessions

A practical guide to structuring coding agent sessions so every change lands as a clean, reviewable diff — covering branch strategy, git worktree isolation, pull request conventions, and CI checks that keep human reviewers in control.

coding-agentsgitpull-requestscode-review
Open guide

Cost Guardrails for Agent Model Gateway Retries

When a coding agent retries model gateway calls without guardrails, each attempt carries a token cost that compounds quickly. This guide explains the categories of retry risk, the guardrail controls available at the gateway layer, and a smoke-test workflow for verifying that your setup caps runaway spend before it reaches production.

coding-agentsmodel-gatewaycost-controlretries
Open guide

Gateway Fallback Checks for Coding Agent Writers

A practical guide for coding agent writers who need to verify that their model gateway handles fallback conditions safely — covering endpoint-family checks, auth signal tests, error-path logging, and a repeatable smoke-test workflow.

coding-agentsmodel-gatewayfallback-routinggateway-checks
Open guide

Cost Controls for Coding Agent Model Gateways

Practical cost-control patterns for teams running coding agents through a model gateway, covering spend guards, per-agent token budgets, CI-integrated spend checks, and verification steps to confirm your gateway enforces the limits you configure.

coding-agentsmodel-gatewaycost-controltoken-budget
Open guide

Model Routing Decisions for Coding Agent Workflows

A practical guide to choosing and configuring model routes for coding agent workflows, covering task-type mapping, instruction-file conventions, CI integration, and gateway setup.

coding-agentsmodel-routingAI-workflowsgateway-setup
Open guide

Keep Coding Agent Prompt Registries Consistent With Drift Checks

Coding agents read instruction files — AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, and memory files — to understand what tools, workflows, and conventions are available. When those files drift from the actual runtime environment, agents make confidently wrong decisions. This guide explains what prompt registry drift is, how it appears across popular agent runtimes, and how to detect and prevent it with CI-backed drift checks.

coding-agentsprompt-registrydrift-checksinstruction-files
Open guide

Route Coding Agent Model Calls Without Endpoint Drift

A source-backed operating guide for routing coding agent writer, reviewer, critic, and fallback calls through a model gateway without confusing Responses, Chat Completions, Claude messages, secrets, or publish gates.

coding agentsmodel gatewayagent operationsCometAPI
Open guide

Verify Coding Agent Outputs Before They Ship

A practical workflow for checking coding agent outputs against repository instructions, official documentation, diffs, and a short evidence log.

coding agentssource verificationrepository instructionsagent operations
Open guide