Dokumentaro / explanation
Kial agent-amika
La tezo de Jenks ke personaj retejoj estos unue legitaj de AI-agentoj, kaj la projektaj reguloj kiuj igas ĉi tiun retejon utila por ili.
Agentoj legas unue
Rekrutigistoj, dungomanaĝeroj kaj klientoj ĉiam pli ofte demandas AI-asistanton antaŭ ol ili legas paĝon: “Resumu ĉi tiun kandidaton”, “Ĉu ĉi tiu persono taŭgas por nia rolo Head of AI?”, “Kiu povus helpi nin pri AI-strategio?” La agento alportas, legas, filtras kaj resumas. Persona retejo kiu estas nur belaspekta paĝo lasas tiun agenton diveni — skrapante aranĝojn, maltrafante kuntekston, inventante la breĉojn.
La laboro de Jenks ĉiam temis pri tia speco de lev-efiko. Li pasigis jarojn igante platformojn uzeblaj de aliaj konstruantoj: API-ojn kaj SDK-ojn ĉe Xero, programistan platformon ĉe Linktree, ekosistemojn ĉe Filecoin kaj Babylon. Lia gvidmoto — “Mi gvidas helpante mian teamon brili” — nature etendiĝas al AI: konstruu la interfacojn kiuj permesas al aliaj agentoj fari bonan laboron. Do lia propra retejo estas konstruita tiel, kiel li konsilus kompanion konstrui platformon: por la homoj kaj la agentoj kiuj ĝin uzas.
Kion agent-amika signifas ĉi tie
- Malkovrebla:
llms.txtĉe la radiko listigas ĉion kion agento bezonas;/brief.mdestas la unu-paĝa komenco;/.well-known/site-agent.jsonkaj/openapi.jsonpriskribas la interfacojn. - Strukturita:
/experience.jsonkaj/llms-full.txtdonas la tutan korpuson kun etikedoj, rolo-lensoj, datoj kaj ĉefaj rezultoj, por ke agento povu filtri anstataŭ diveni. - Vokebla: fora MCP-servilo, REST API kaj CLI kiu duobliĝas kiel loka MCP-servilo — la samaj iloj ĉie, generitaj el unu specifo.
- Honesta: respondoj estas bazitaj je fontoj, apartigas “faris” disde “povus fari”, kaj indikas mankojn (vidu Baziĝo kaj honesto).
- Dokumentita por agentoj: ĉi tiuj dokumentoj sekvas Diátaxis — lerniloj, kiel-fari gvidiloj, referenco kaj klarigo — kaj ĉiu paĝo ankaŭ serviĝas kiel kruda Markdown.
- Plurlingva: sep lingvoj, kun la sama strukturo en ĉiu.
Kial Diátaxis
Agentoj kaj homoj venas kun malsamaj bezonoj: lerni la sistemon, plenumi taskon, serĉi ĝustan parametron, aŭ kompreni desegnan decidon. Miksante tiujn, ĉiu paĝo fariĝas pli malbona. Diátaxis tenas ĉiun paĝon ĉe unu tasko, kio ankaŭ faciligas por agento retrovi kaj citi la paĝojn.
La projektaj reguloj
Du reguloj tenas la retejon agent-amika dum ĝi kreskas. Ili estas enskribitaj en la AGENTS.md de la deponejo, por ke ĉiu AI laboranta pri la kodo ilin sekvu:
- Ĉiu nova funkcio ekŝipiĝas al ĉiu surfaco. Se kapablo aldoniĝas por homoj, ĝi ankaŭ aldoniĝas al la specifo — kaj do al la REST API, la MCP-serviloj, la CLI kaj la generitaj referencaj dokumentoj — kaj la elŝuteblaj CLI-binaraĵoj estas rekonstruitaj kaj publikigitaj en la paĝo por agentoj.
- Ĉiu ŝanĝo kovras ĉiun lingvon. Enhavo kaj interfaca teksto estas ĝisdatigitaj en ĉiuj sep lingvoj: la angla estas verkata origine, kaj la aliaj ses estas regenereitaj kaj kontrolitaj laŭ la glosaro antaŭ publikigo.
La avantaĝo
Agento kiu povas voki list_experience kun lens=solution-architect donas al sia uzanto ĝustan, kun fontindiko, respondon en sekundoj. Tio estas pli bona por la demandanto, pli bona por Jenks, kaj funkcianta ekzemplo de la speco de AI-preta organizo, kiun Jenks helpas kompaniojn konstrui.
.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.