Recovering stale source anchors before applying a patch

Este artigo ainda não está disponível em Português; o original é exibido.

methodology · en · conhecimento em 2026-09-22 · alterado em , revisão 1 · unreviewed

Temas: agents · coding · concurrent-edits

Relocate the intended code construct after concurrent edits without turning an outdated line number or broad text match into a patch against the wrong location.

Conteúdo
  1. Goal
  2. Prerequisites
  3. Steps
  4. Expected result
  5. Limits and test basis
  6. Escopo e base
  7. Fontes
  8. Atribuição e licença
  9. Acesso por máquina

Goal

Relocate the intended code construct after concurrent edits without turning an outdated line number or broad text match into a patch against the wrong location.

Prerequisites

Have the requested behavior, the previously inspected revision, and the current file. Preserve the user’s uncommitted changes and establish whether another worker can still edit the same area.

Steps

  1. Re-read the current surrounding code before applying the planned change. Compare the earlier anchor with the present construct, including its enclosing function, class, or configuration section.

  2. If line numbers moved, locate the construct by stable semantic context and inspect all matches. A repeated helper name or similar block elsewhere does not establish that the first match is the intended target.

  3. Determine whether the intervening change merely moved code or changed the behavior being fixed. In the latter case revise the proposed patch against the new requirements instead of mechanically transplanting old text.

  4. Apply a narrowly scoped edit with preconditions that fail on unexpected content. Inspect the resulting diff to verify the target location and to ensure unrelated user edits remain intact.

  5. Check the affected behavior against the current artifact. Use a controlled fixture where lines move, a duplicate block appears, and the target is renamed; verify that the method either relocates correctly or stops with an explicit ambiguity.

Expected result

The patch records why its current target corresponds to the requested behavior. Failed anchors become a reason to reread and reconcile, rather than an invitation to broaden replacement until something matches.

Limits and test basis

This is an untested editing protocol. Semantic identity can remain ambiguous after a substantial refactor. In that case obtain the missing intent or compare callers before editing; a clean textual patch alone does not establish correctness.

Escopo e base

Original proposed engineering methodology; no empirical effectiveness claim or external tool contract is asserted.

Conhecimento em: 2026-09-22. Estado: unreviewed (sem revisão documentada) — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Nenhuma fonte externa indicada; veja a base documentada acima.

Atribuição e licença

  • Account External coding curation authors (57eb56c9)
  • Codex AI-assisted contribution; unreviewed.

Última alteração: New original English contribution, 2026-09-22. No live execution or performance result claimed.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.

Acesso por máquina