Arkitekturo

La mallonga versio

Ekzistas unu vera fonto — korpuso de Markdown-dosieroj en git — kaj ĉio alia estas generata el ĝi aŭ legas el ĝi: la retejo en sep lingvoj, la dosieroj por agentoj, la Ask Jenks asistanto, la REST API, la MCP-serviloj kaj la CLI.

La korpuso

content/corpus/ enhavas unu Markdown-dosieron por ĉiu sperto, projekto, komunuma rolo kaj eduka ero, ĉiu kun YAML frontmatter (datoj, etikedoj, rol-lensoj, ĉefaj rezultoj, kapabloj, pruv-ligiloj) kaj longforma korpo. Kune kun ili troviĝas la kerna profilo, kapabloj, atestiloj, paroladoj, mondrigardo, la rol-lensoj kaj la kapabloj de la asistanto. Faktoj estis kunmetitaj el la vivresumoj de Jenks, LinkedIn, Linktree kaj lia parolista paĝo, kun konfliktoj solvitaj konservative.

Teni la korpuson en git signifas ke ĉiu ŝanĝo estas commit: recenzebla, atribuebla kaj reigebla.

La kompililo

scripts/build-corpus.mjs legas la korpuson, validigas ĉiun dosieron kontraŭ unu skemo (scripts/corpus-schema.mjs) kaj kompilas ĝin en unuopan JSON-korpuson plus la agent-dosierojn /llms-full.txt kaj /experience.json. Nekonataj etikedoj aŭ lensoj, malbonaj datoj, mankantaj bildoj aŭ mankanta sekcio haltigas la konstruon. La administra API rulas la saman validigon antaŭ ol ĝi faras commit, do malbona redakto — de homo aŭ AI — estas rifuzata antaŭ ol ĝi povas rompi ion ajn.

La retejo

La retejo estas Next.js statika elporto servata de Cloudflare Workers Static Assets. Eta Worker antaŭ ĝi traktas alidirektojn (jenksguo.com kaj www gastigantoj → jenksguo.xyz), sekurecajn kapliniojn kaj la API-ojn. La angla loĝas ĉe /; la aliaj ses lingvoj ĉe /zh, /zh-hant, /ja, /fr, /es kaj /eo. Ĉiu enskribo ricevas sian propran paĝon en ĉiu lingvo.

La Ask Jenks asistanto

La asistanto estas ilo-uzanta agento prefere ol longa prompto. Ĝia sistema prompto enhavas nur la kernan profilon kaj unu-linian indekson de ĉiu enskribo, lenso kaj kapablo. Kiam ĝi bezonas detalojn ĝi vokas ilojn:

• load_skill — gvidlibro por la tipo de demando (rola taŭgeco, konsulta ampleksigo, AI-transformo, STAR-rakontoj, mastrumado, kariera navigado…),
• get_entries — plenaj priskriboj laŭ slugo,
• list_entries — filtritaj laŭ etikedo, lenso aŭ tipo,
• search_corpus — ŝlosilvorta serĉo.

Tiu progresa malkaŝado tenas respondojn baziĝantaj sur la tuta korpuso sen enorma prompto. Modeloj estas alirataj per OpenRouter.

Unu specifiko, kvar surfacoj

src/spec.js difinas ĉiun publikan kaj administran ilon unufoje: nomo, priskribo, eniga skemo, REST-vojo kaj CLI-komando. El ĝi devenas:

• la foraj MCP-serviloj (/mcp, /mcp/admin),
• la REST API (/api/v1/*, /api/admin/*),
• la jenks CLI kaj ĝia loka MCP-reĝimo (jenks mcp),
• la referenca dokumentaro kaj /openapi.json.

Ŝanĝu ilon en unu loko kaj ĉiu surfaco sekvas, do la dokumentaro ne povas drivi for de la konduto.

Publikiga dukto

Adminaj redaktoj estas commit-oj faritaj per la GitHub API. Ĉiu push rulas CI:

1. kompili kaj validigi la korpuson,
2. retraduki nur la enskribojn kiuj ŝanĝiĝis en la aliajn ses lingvojn (tradukoj estas kaŝmemorigitaj per hasho de ilia angla fonto; fiksa glosaro difinas titolojn kaj nomojn de lensoj),
3. konstrui la retejon kaj la agent-dosierojn,
4. deploji — main al https://jenksguo.xyz, dev al https://dev.jenksguo.xyz (ne indeksita).

CLI-binaraĵoj por macOS, Linux kaj Windows estas publikigitaj sub /downloads.

Kial ĝi estas formita tiel

Persona retejo estas malgranda, sed ĝin legas homoj, serĉiloj kaj ĉiam pli ankaŭ agentoj, en pluraj lingvoj, kaj ĝi estas redaktata de AI same ofte kiel mane. Unu sola validigita fonto kun generitaj surfacoj estas la plej simpla dezajno kiu tenas ĉiujn tiujn konsekvencaj.