Ƃüļķ ŕéŵŕîţé ŵîţĥ àñ àĝéñţ

Ĝöàļ: àþþļý öñé éđîţöŕîàļ çĥàñĝé éṽéŕýŵĥéŕé (ŕéñàḿé à þŕöđüçţ, ŕéţîŕé à þĥŕàšé, šöƒţéñ à ţéñšé) àçŕöšš ƒîļéš ýöüŕ éđîţöŕ çàñ'ţ éṽéñ öþéñ (.docx, çàţàļöĝš, ĤŢḾĻ, Ḿàŕķđöŵñ), ŵîţĥöüţ ŕîšķîñĝ šţŕüçţüŕé. Ţĥé àĝéñţ đéçîđéš ŵĥàţ ţĥé ñéŵ ţéẋţ šàýš. ķàþî ĥàñđļéš ţĥé ŕéšţ: îţ ķééþš ţĥé îñļîñé çöđéš, ŕéƒüšéš à ŵŕîţé ţö à ƃļöçķ ţĥàţ çĥàñĝéđ šîñçé îţ ŵàš ŕéàđ, àñđ ŕüñš ţĥé çĥéçķ ţĥàţ çöñƒîŕḿš ţĥé šŵééþ îš çöḿþļéţé. Ñö šéçöñđ ḿöđéļ îš îñṽöļṽéđ îñ ţĥé ŵŕîţé.

Đéšķţöþ

Ţĥé šŵééþ îţšéļƒ îš àĝéñţ- öŕ ÇĻÎ-đŕîṽéñ; Đéšķţöþ îš ŵĥéŕé ýöü ṽéŕîƒý îţ:

1. Ƃéƒöŕé: ƃîñđ ţĥé ŕüļé ţĥàţ ḿöţîṽàţéš ţĥé šŵééþ (à ƒöŕƃîđđéñ ţéŕḿ, à ŕéǫüîŕéđ þĥŕàšîñĝ) îñ ţĥé þŕöĵéçţ'š ṽöîçé þŕöƒîļé, šö ţĥé ƒîñđîñĝš çöüñţ öñ ţĥé þŕöĵéçţ'š Öṽéŕṽîéŵ šĥöŵš éẋàçţļý ŵĥîçĥ ƃļöçķš àŕé àƒƒéçţéđ àñđ ĥöŵ ḿàñý.
2. Àƒţéŕ: çļîçķ Ŕüñ öñ éṽéŕýţĥîñĝ öñ ţĥé Ḿàþ ţö çöñƒîŕḿ ţĥé çöüñţ îš žéŕö, àñđ šþöţ-çĥéçķ ţĥé éđîţéđ ƒîļéš îñ ţĥé þŕéṽîéŵ: šţŕüçţüŕé, šţýļéš, àñđ þļàçéĥöļđéŕš îñţàçţ.

Ƒöŕ ţŕàñšļàţéđ çöñţéñţ, àñ éđîţéđ šöüŕçé đŕöþš àƒƒéçţéđ ƃļöçķš ƃàçķ ţö þéñđîñĝ; Ƃŕîñĝ üþ ţö đàţé ŕé-ţŕàñšļàţéš ĵüšţ ţĥöšé, àñđ ţĥé Ŕéṽîéŵ ǫüéüé þîçķš üþ àñýţĥîñĝ ţĥàţ ŵàîţš ƒöŕ ŕéṽîéŵ.

Àĝéñţ (Çļàüđé)

Šţàţé ţĥé çĥàñĝé öñçé, öṽéŕ ţĥé ŵĥöļé šéţ:

Ŵé ŕéñàḿéđ "Àçḿé Šýñç" ţö "Àçḿé Ƒļöŵ". Üþđàţé éṽéŕý ḿéñţîöñ àçŕöšš docs/ àñđ src/locales/en/ (îñçļüđîñĝ ţĥé .docx öñé-þàĝéŕš) àñđ ķééþ ţĥé ƒöŕḿàţţîñĝ.

Ţĥé àššîšţàñţ ŕüñš ţĥé ļööþ àţ šçàļé:

1. kapi inspect --jsonl öṽéŕ ţĥé šéţ: öñé ŕéçöŕđ þéŕ ƃļöçķ, ŵîţĥ îţš ŕéƒéŕéñçé (ref), îţš ŕéṽîšîöñ (rev), àñđ ţĥé ţéẋţ (îñļîñé çöđéš àš <x id="…"/> þļàçéĥöļđéŕš).
2. Îţ ŕéŵŕîţéš öñļý ţĥé ƃļöçķš ţĥàţ ḿéñţîöñ ţĥé ţéŕḿ, ĵüđĝḿéñţ çàļļš îñçļüđéđ ("Àçḿé Šýñç'š éñĝîñé" → "ţĥé Àçḿé Ƒļöŵ éñĝîñé"). Ţĥöšé çàļļš ñééđ ĵüđĝḿéñţ, šö àñ àĝéñţ đöéš ţĥéḿ àñđ sed çàññöţ.
3. kapi apply ļàñđš ţĥé çĥàñĝé šéţ. Éàçĥ öþéŕàţîöñ çàŕŕîéš ţĥé ŕéṽîšîöñ îţ ŕéàđ, šö à ƃļöçķ šöḿéöñé çĥàñĝéđ šîñçé ţĥé ŕéàđ ŕéƒüšéš ţĥé çĥàñĝé šéţ ŵîţĥ îţš çüŕŕéñţ ţéẋţ, àñđ à çöñçüŕŕéñţ éđîţ çàñ'ţ ƃé çļöƃƃéŕéđ.
4. kapi check --forbid "Acme Sync" þŕöṽéš çöḿþļéţîöñ: éẋîţ 0 ḿéàñš ţĥé šŵééþ îš đöñé.

Ḿàķé ţĥé ŕéţîŕéđ ñàḿé à þéŕḿàñéñţ ţéŕḿ, šö à ļàţéŕ üšé öƒ îţ ƒàîļš à çĥéçķ. Ŕéçöŕđîñĝ à ţéŕḿ îš ýöüŕ đéçîšîöñ, šö ţĥé àššîšţàñţ šüĝĝéšţš îţ àñđ ýöü ķééþ îţ, öŕ ýöü àđđ ţĥé term öþéŕàţîöñ ţö ţĥé çĥàñĝé šéţ ýöü àþþļý.

ÇĻÎ

Ţĥé šàḿé ļööþ ŵîţĥ ýöü (öŕ à šçŕîþţ) àš ţĥé ŵŕîţéŕ:

kapi inspect docs/**/*.md report.docx --jsonl > blocks.jsonl
# write a replace_text or set_content operation per matching block to
# edits.json, with the block's ref and rev; keep the <x id="…"/> tags
kapi apply edits.json --dry-run          # preview the whole sweep, one diff per document
kapi apply edits.json --in-place=.bak    # land it, keeping backups
kapi check docs/**/*.md --forbid "Acme Sync"   # prove it's done

Ƒöŕ à þļàîñ šüƃšţîţüţîöñ ţĥàţ ñééđš ñö ĵüđĝḿéñţ, ksed -i 's/Acme Sync/Acme Flow/g' öŕ kapi voice rewrite đöéš îţ đéţéŕḿîñîšţîçàļļý: ñö àĝéñţ, ñö ḿöđéļ. Ţĥé çĥàñĝé šéţ'š šĥàþé àñđ ŵĥàţ ŕéƒüšéš àñ éđîţ àŕé îñ Éđîţ çöñţéñţ.

Ñéẋţ

• Éđîţ çöñţéñţ: ţĥé îñšþéçţ → éđîţ → àþþļý ļööþ àñđ îţš ĝüàŕđš, îñ đéþţĥ.
• Çöñţéñţ ĝöṽéŕñàñçé ƒöŕ ÀÎ: ţĥé šţàñđîñĝ ŕüļéš ţĥàţ ķééþ ƒüţüŕé öüţþüţ çļéàñ.
• Üšé ŵîţĥ Çļàüđé: ŵîŕîñĝ ţĥé àššîšţàñţ ţĥàţ ŕüñš ţĥîš ļööþ.