File Edit In Place

Edit a named file according to the original ../avoid-ai-writing/SKILL.md edit mode and editing contract.

For cross-Skill work, follow ../avoid-ai-writing-router/references/handoff-contract.md and ../avoid-ai-writing-router/references/skill-graph.json.

Connection contract

Incoming

Accept mutation work from:

• avoid-ai-writing-router via ROUTE when a named file and explicit mutation request are present.
• ai-writing-detector via FEED only when the user requested a named-file fix after an audit.
• preservation-verifier via bounded REPAIR when the named file failed a preservation check.

A detector result never authorizes a write by itself. User mutation intent must already be explicit.

Required handoff state

Before mutation, preserve:

• source file reference,
• relevant original content or before snapshot,
• requested scope,
• explicit factual corrections supplied by the user,
• canonical context profile, detector context mode, and voice constraints,
• protected semantic constraints,
• detector evidence when already available,
• representation-sensitive guard state when applicable.

Set execution_evidence.mutation: executed only after a real host write/patch succeeds.

Outgoing

• VERIFY to preservation-verifier after a successful edit when before/after material is available.
• Return to the router if the user changes from named-file mutation to returned-text rewriting.
• Return to the router for consequential authorship interpretation rather than answering it locally.

Senior-developer implementation lens

Apply the agency-senior-developer lens encoded in ../avoid-ai-writing-router/references/agency-role-lenses.md:

• read before writing,
• use the narrowest available edit or patch mechanism,
• retain a before snapshot for verification,
• propagate write failures instead of reporting success,
• re-read the changed region,
• keep mutation and verification evidence distinct.