Arkitekturo

La mallonga versio

Estas unu sola fonto de vero — 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 edukero, ĉiu kun YAML-frontmaterio (datoj, etikedoj, rol-lensoj, ŝlosilaj rezultoj, kapabloj, ligiloj al pruvoj) kaj longforma teksto. Flanke troviĝas la kerna profilo, kapabloj, atestiloj, prelegoj, mondrigardo, la rol-lensoj kaj la kapabloj de la asistanto. Faktoj estis kunmetitaj el la vivresumoj de Jenks, LinkedIn, Linktree kaj lia prelegista paĝo, kun konfliktoj solvitaj singarde.

Teni la korpuson en git signifas ke ĉiu ŝanĝo estas komito: revidebla, 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 ununuran JSON-korpuson plus la agentajn dosierojn /llms-full.txt kaj /experience.json. Nekonataj etikedoj aŭ lensoj, malbonaj datoj, mankantaj bildoj aŭ mankanta sekcio haltigas la konstruon. La admin API rulas la SAMAN validigon antaŭ ol ĝi faras komiton, do malbona redakto — fare de homo aŭ AI — estas rifuzita antaŭ ol ĝi povas rompi ion ajn.

Aŭdvidaĵoj

Fotoj, videoklipoj kaj PDF-oj ne estas en git. Ili estas alŝutitaj per la administraj interfacoj al Cloudflare R2 sitelo kundividata de programado kaj produktado, kaj servataj de la Worker ĉe /media/<year>/<month>/<name>-<fingerprint>.<ext> kun jarlonga kaŝmemorigo. Enhavo referencas ilin per tiu vojo; la admin API kontrolas ke ĉiu referencita dosiero ekzistas antaŭ ol ĝi faras komiton.

La retejo

La retejo estas Next.js statika eksporto servata de Cloudflare Workers Static Assets. Malgranda Worker antaŭ ĝi pritraktas alidirektojn (gastigantoj jenksguo.com kaj www → jenksguo.xyz), sekurecajn kapliniojn kaj la API-ojn.

La retejo havas du adresojn kiuj ĉiam montras la saman enhavon. https://jenksguo.pages.dev estas la kanonika, sur CV-oj kaj QR-kodoj: firmaaj retoj ofte blokas nove registritajn domajnojn, kaj pages.dev estas malnova kaj vaste permesata. https://jenksguo.xyz estas spegulo. La pages.dev adreso estas Cloudflare Pages-projekto (mirror/) kies sola kodo plusendas ĉiun peton al la reteja Worker, do unu deplojado ĝisdatigas ambaŭ adresojn kaj nenio bezonas sinkronigon. La angla troviĝas ĉe /; la aliaj ses lingvoj ĉe /zh, /zh-hant, /ja, /fr, /es kaj /eo. Ĉiu ero ricevas sian propran paĝon en ĉiu lingvo.

La Ask Jenks asistanto

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

• load_skill — manlibro por la tipo de demando (kongruo kun rolo, skopado de konsultado, AI-transformo, rakontoj laŭ STAR, regado, kariera navigado…),
• get_entries — plenaj priskriboj laŭ slugo,
• list_entries — filtritaj laŭ etikedo, lenso aŭ tipo,
• search_corpus — serĉo laŭ ŝlosilvortoj.

Tiu progresa malkaŝo tenas respondojn surbazitaj en la tuta korpuso sen enorma prompt-teksto. Modeloj estas atingataj per OpenRouter.

Unu specifo, kvar fasadoj

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 referencaj dokumentoj kaj /openapi.json.

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

Publikiga dukto

Admin-eldonoj estas komitoj faritaj per la GitHub API. Ĉiu puŝo rulas CI-on:

1. kompilu kaj validigu la korpuson,
2. re-traduku NUR la erojn kiuj ŝanĝiĝis al la ses aliaj lingvoj (tradukoj estas kaŝmemorigitaj per hakvaloro (hash) de ilia angla fonto; fiksa glosaro fiksas titolojn kaj lens-nomojn),
3. konstrui la retejon kaj la agentajn dosierojn,
4. deplojado — main al https://jenksguo.pages.dev, dev al https://dev.jenksguo.xyz (ne indeksita).

CLI-binaroj por macOS, Linux kaj Windows estas publikigitaj sub /downloads.

Kial ĝi estas tiel formita

Persona retejo estas malgranda, sed ĝin legas homoj, serĉiloj kaj pli kaj pli agentoj, en pluraj lingvoj, kaj ĝin redaktas AI same ofte kiel permane. Unuopa validigita fonto kun generitaj fasadoj estas la plej simpla dezajno kiu tenas ĉion el tio konsekvenca.