Skip to content
View jordachmakaya's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report jordachmakaya

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
jordachmakaya/README.md

Hi there 👋

Jordach Makaya — I build reliable agentic systems. TypeScript Backend & Agentic Systems Engineer. Harness Engineering · AI Agent Evaluation · Developer Tooling. Open to Backend, Platform & Agentic Engineering roles.

TypeScript · Node.js · NestJS · Python  ·  Casablanca, Morocco — CET, full EU overlap, 4–5h US East

Website LinkedIn npm Email


I came to software from insurance claims operations. That is where the bias in everything below comes from: in claims, an unverified assumption has a financial consequence. So I build systems that are deterministic, traceable and auditable.

One rule runs through all of it:

VERIFIED ≠ DECLARED

A task passes only with reproducible proof.

Moving into software full time after building it in parallel since 2021, alongside a full-time claims role. Open to backend, platform and agentic engineering roles — remote, contractor (B2B / Deel) or EOR.


Published packages

Live badges — the numbers below come from npm, not from me.

Package Version Downloads
@hardmachinelabs/index-ai-validator npm downloads Validates whether a site correctly exposes an AI-readable layer: /.well-known/index-ai.json, /agent-index.json, clean Markdown endpoints, declared content size, exposure risks.
@hardmachinelabs/env-sync npm downloads Syncs .env variables into GitHub Actions secrets and GitLab CI/CD variables. Monorepo-aware. Built from watching local, CI and provider secrets drift apart.
@hardmachinelabs/zod-config npm downloads Runtime config validation for TypeScript and NestJS. Zod schemas as source of truth, fail fast at startup, sensitive values redacted in error output.

All MIT. All built from a problem I actually hit.


What I am building

Status is stated on every line. Some of this is public and inspectable; some is not yet. I would rather tell you which than let you assume.

🔒 Shokunin — delivery harness for AI coding agents

in development · not yet public

Built on one rule: agent output stays untrusted until deterministic gates verify it.

Designed from a catalogued taxonomy of 40 real coding-agent failure modes — context rot, runaway token spend, compaction loops, unverified commits. It keeps specifications, decisions, jobs, evidence and handoffs outside the chat, separates CTO / Coder / Tester / Reviewer roles, loads only the context each task requires, and reports through an HTML cockpit.

Bounded context routing — in a 500-file reference repository, active context narrows to 8 explicitly routed files. Sealed module contracts, mechanical quality gates, SHA-256 artifact sealing, append-only decision ledgers. Traced with Langfuse and OpenTelemetry, evaluated against Harbor / Terminal-Bench.

I use it daily. The human provides intent and judgment; the system carries the process.

🌐 index-ai — an open proposal for AI-readable websites

open proposal · reference implementation · public

Websites are built for humans; agents read differently. Instead of forcing them to scrape noisy HTML, index-ai gives them a clean public layer the publisher controls:

Component What it does
Agent Manifest Discovery and site declarations
Agent Index Structured content inventory
Agent Graph Relationships between resources
Agent Interface Queryable access

The goal is not to promise discovery or citations. It is to make agent-facing content publisher-controlled, testable, measurable and verifiable. index-ai-validator above is the reference implementation.

🔒 Clausis — claims decision engine (French IRSI convention)

in development · private

Backend of a platform turning water-damage claim declarations into step-by-step handling directives. I chose a deterministic rules engine over RAG so every output traces back to a named clause of the Convention d'Indemnisation et de Recours des Sinistres Immeubles. NestJS, Mastra AI, SSE streaming, subscription billing with usage metering, SQL analytics.

Comes straight out of the job I still do by hand.

🔒 Météosure — weather-claim certification for insurers

in development · private

Determines whether a severe weather event occurred at a given address on a given date, and returns an adjuster-ready evidence report in under 60 seconds. A Python filtering layer over raw meteorological telemetry, then a NestJS engine applying contractual thresholds. Weekly batch ingestion from Google Drive into Elasticsearch through a three-stage BullMQ/Redis pipeline with Redlock locking and SHA-256 deduplication.


Stack

Core        TypeScript · JavaScript · Node.js (v20+) · NestJS · Python
            REST · GraphQL · microservices · event-driven architecture

Data        PostgreSQL · TypeORM · Prisma · Redis + Redlock
            Elasticsearch · Kafka · BullMQ · SQLite

AI/Agents   Mastra AI · MCP (tools & servers) · Anthropic, OpenAI, Google AI
            Langfuse · RAG · Harbor / Terminal-Bench

Delivery    Git · GitHub Actions · GitLab CI/CD · Docker · Dokploy
            Nginx · hardened Linux VPS · Cloudflare R2 · OpenTelemetry

Testing     Vitest · integration & E2E · Zod validation · deterministic CI gates

Writing


How I work

Map the workflow end to end. Expose the failure points and the missing capabilities. Then build the software required to close the loop.

I keep decision records, failure analysis, test evidence and release criteria, so every claim I make can be inspected.

The goal is not to present experiments as traction. The goal is to show shipped work, clear engineering judgment, and honest status.

Pinned Loading

  1. index-ai index-ai Public

    An open specification for publishing structured, verifiable, retrieval-efficient content to AI agents.

    TypeScript 1

  2. index-ai-validator index-ai-validator Public

    CLI validator for AI-readable websites: Agent Manifest, Agent Index, clean Markdown endpoints, and content-size checks.

    TypeScript 1

  3. env-sync env-sync Public

    A TypeScript CLI to sync .env files into GitLab and GitHub CI/CD secrets, built for monorepos.

    TypeScript 2

  4. zod-config zod-config Public

    Type-safe Zod v4 configuration utilities for TypeScript, with an optional NestJS adapter.

    TypeScript 1

  5. shokunin-governance-benchmark shokunin-governance-benchmark Public

    TypeScript

  6. index-ai-nextjs index-ai-nextjs Public

    JavaScript