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

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

Đéšķţöþ

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

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

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

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

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

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

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

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

Ḿàķé ţĥé ŕéţîŕéđ ţéŕḿ à þéŕḿàñéñţ ṽöîçé ṽöçàƃüļàŕý ŕüļé îñ ţĥé šàḿé çĥàñĝé-šéţ, àñđ ţĥé öļđ ñàḿé çàñ ñéṽéŕ ǫüîéţļý ŕéţüŕñ.

ÇĻÎ

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

kapi inspect docs/**/*.md report.docx --jsonl > blocks.jsonl
# rewrite the matching blocks' "text" into edits.jsonl (content entries)
# carrying each block's id + content_hash; keep the <x id="…"/> tags
kapi apply edits.jsonl --diff            # preview the whole sweep as one diff
kapi apply edits.jsonl --in-place=.bak   # land it, keeping backups
kapi check docs/**/*.md --forbid "Acme Sync"   # prove it's done

Ƒöŕ þüŕé ṽöçàƃüļàŕý šüƃšţîţüţîöñ ŵîţĥ žéŕö ĵüđĝḿéñţ îñṽöļṽéđ, kapi voice rewrite đöéš îţ đéţéŕḿîñîšţîçàļļý ƒŕöḿ à þŕöƒîļé: ñö àĝéñţ, ñö ḿöđéļ. Ţĥé çĥàñĝé-šéţ šĥàþé àñđ ţĥé ŕöüñđ-ţŕîþ ĝüàŕđš àŕé îñ Éđîţ çöñţéñţ.

Ñéẋţ

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