Protos-Agent

Meta-repo: memorija, konvencije i skill fileovi za svaki AI agent koji radi na ProtosEschatos projektima (Protos-Web, Bodulica, budući klijenti).

Struktura

| Direktorij | Namjena | | ------------------ | -------------------------------------------------------------- | | AGENTS.md | Golden Rule + tool-agnostic constitution | | rules/stack.md | Preferirani stack za nove greenfield projekte | | memory/ | Git-versioned baza znanja (sessions, learnings, projects, idx) | | memory/scripts/ | Validator + index regenerator + FM backfiller | | memory/schemas/ | Templates + JSON Schema | | .github/workflows/validate-memory.yml | CI za svaki push u memory/** | | agents/, command/, skills/ | Kilo Code specifičan roster (opcionalno) |

Ključne konvencije

• Session file MORA imati YAML front-matter (id, date, project, title, commits[], learnings[], topics[]).
• id format: YYYY-MM-DD-NN (2-digit sequence po danu).
• memory/index.jsonl je DERIVAT iz session FM — generira ga memory/scripts/index-from-fm.mjs.
• Validator (memory/scripts/validate.mjs) blokira drift; CI ga runa.
• Backfill legacy fileova — memory/scripts/backfill-frontmatter.mjs (one-shot, idempotent).
• memory/projects/<slug>.md je autoritativan za stack tog projekta; rules/stack.md je preporuka za nove projekte, ne override.

Admin panel (admin/) — od 2026-08-11

• Next.js 16 app u admin/ poddirektoriju — glavno sučelje za Protos-Agent.
• Vercel projekt: protos-agent, Root Directory = admin/, live na https://admin-jet-xi.vercel.app (prije domain attacha); cilj: protos-design.net.
• Memory hub čita committed memory-data/ snapshot (regenerira ga prepare-memory.mjs prebuild hook kad je source ../memory dostupan). Learning: protos-agent-vercel-root-dir-admin.
• Otvoreno: DNS A record → 76.76.21.21 u Cloudflareu za protos-design.net (DNS-only); obrisati GitHub repo Protos-Eschatos-Control-Centre (treba delete_repo scope).

Aktivni projekti u ovoj bazi

• Protos-Web — Next.js 16 / React 19 / Vercel / Supabase
• Bodulica — vanilla HTML/JS / CF Pages / Supabase Edge (status: stale)
• Protos-Agent admin panel (admin/) — Next.js 16 / Vercel (Root Dir admin/)

Otvoreno / Sljedeći koraci

• [ ] Backfill YAML FM u 6 legacy learnings fileova (validator warna, ne error-a)
• [ ] Odlučiti hoće li se agents/*.md / skills/* refaktorirati za Cursor ili obrisati
• [ ] Wire jedan od 3 opcije iz skills/auto-snapshot-30min/SKILL.md (A/B/C)
• [ ] Redovita provjera bodulica.md — status: stale od 2026-07-10