Skip to content
View OthmanAdi's full-sized avatar
🔴
Serving my mission on earth.
🔴
Serving my mission on earth.

Block or report OthmanAdi

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.

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
OthmanAdi/Readme.md

Hi, I'm Ahmad-Othman 👋

📍 Berlin · 🦀 Senior Applied AI Engineer @migRaven · 🚀 planning-with-files

Senior Applied AI Engineer at migRaven Berlin, building Rust runtimes and agent infrastructure. Open-source: 16K+ developers install my skills (planning-with-files, MDDesign, chronos, OpenMark). Eight thousand teaching hours taught me complexity isn't a property of problems; it's a measure of how badly we've drawn the system. So I draw them: in markdown, in skills, in 21k-star repos.

Currently: shipping Rust agent infrastructure at migRaven · maintaining planning-with-files, MDDesign, chronos · publishing skills weekly under npx skills add OthmanAdi/<skill>.


⭐ Start Here

The eight projects that explain the rest of this page. Each one ships, each one solves a system, each one is one npx away.

  • 📋 planning-with-files 21,132★ · 1,877 forks — Manus-style file-based planning that survives /clear across Claude Code, Codex, Cursor, OpenCode. The skill behind a $2B acquisition pattern.
  • 🧩 promptfusion (27★) — Three-layer prompt composition for AI agents. Semantic weighted priorities.
  • 🔭 langsmith-fetch (25★) — First AI observability skill. Debug LangChain / LangGraph agents from your terminal.
  • 👥 planning-with-teams (23★) — Context engineering for Claude Code agent teams. Coordinate multiple Claude instances on shared planning files.
  • 📑 AI-Docs-Copier (17★) — Transform any documentation into AI-friendly formats. One command.
  • 🦞 researchclaw (13★) — Topic to conference-grade paper. Autonomous 23-stage research pipeline.
  • 🎨 MDDesign (8★) — Orchestrator skill: composes planning, DESIGN.md, memory routing, agent teams, and session handoff into one contract.
  • ⏱️ chronos (1★ · new) — Temporal awareness for AI coding agents. Hook-backed ledger, 7 decision rules, 8 platforms. Fixes the temporal-blindness pattern from arxiv 2510.23853.

🛠️ Agent Skills & Tools

The skill catalog. Built for coding agents (Claude Code, Codex, Cursor, OpenCode, Hermes, ADAL, OpenClaw, Warp, +). Install one-line: npx skills add OthmanAdi/<name> -g.

Repo What it does
🗂️ planning-with-files Manus-style persistent markdown planning. The workflow pattern behind the $2B acquisition. 21,132
🔭 langsmith-fetch-skill AI observability. Pull LangSmith traces, debug LangChain / LangGraph agents from terminal. 25
👥 planning-with-teams Multi-Claude coordination on shared planning files. Context engineering for agent teams. 23
🦞 researchclaw-skill Topic to conference-grade paper. 23-stage autonomous research pipeline. 13
🎨 MDDesign Orchestrator: planning + DESIGN.md + memory routing + agent teams + handoff. Cross-IDE. 8
🧠 codebase-knowledge-builder Produces structured knowledge artifacts from any codebase. Turns any agent into a 10x dev. 8
📋 cowork-workflows File-based planning workflows tuned for Cowork. 8
🔀 code-memory-router Routes memory/retrieval tasks between MemPalace and QMD. 13/13 benchmark vs 4/13 without. 3
🎛️ openui-forge Generative UI with OpenUI. Any LLM, any backend. Scaffold + integrate + validate. 3
📦 agent-blueprint Production-grade AI agent scaffold. Workflow builders + app embedders. Apache-2.0. 2
🚀 APEX 6-12 months to 4 weeks. AI-driven replatforming workflows: decompose → replatform → tier1-3 → learn. 2
🌉 open-responses-agent-skill Multi-provider agent development via HuggingFace Inference Providers. 2
⏱️ chronos Temporal awareness for AI coding agents. Hook ledger, 7 rules, 8 platforms. 1
📝 pr-perfect One command to engineer PR descriptions a reviewer-agent can verify. 1
🌍 humanizer-semitic AI text humanizer for Arabic + Hebrew. MSA, Egyptian, Levantine, Hebrew. Zero AI tells. 1
🎯 vibe-skills Production websites from natural language. Deploy via here.now. No AI slop. 1
🔗 awesome-here-now Curated catalog for the here.now publishing ecosystem. 1
🗄️ schema-architect Production DB schemas for SQLite + Redis + Neo4j. Typed Rust + Go bindings. Multi-DB architectures.

🤖 AI Systems & Apps

Larger software, not skills. Production-grade systems built around agentic stacks.

Repo What it does
📄 AI-Docs-Copier Transform any documentation into AI-friendly formats. One CLI. 17
🖥️ skill-deck Universal coding agent skill browser. Desktop overlay for 15+ AI agents. Tauri v2 + Rust + Svelte 5. 4
🧭 OpenMark Personal knowledge graph. 8K+ bookmarks + LinkedIn + YouTube indexed with pplx-embed, ChromaDB, Neo4j. LangGraph agent + Gradio UI. 4

🕸️ Neo4j × AI Agents

Production-grade work where Neo4j is the spine — graph-as-memory, graph-as-permission-model, graph-as-checkpoint. Built for the Neo4j + agentic-AI intersection.

Repo What it does
🔓 migraven-openfang-mvp OpenFang-style Active Directory + permission + security audit agent. Rust runtime, Node + Zod skill, Neo4j graph DB, Azure AI Foundry (gpt-5.5 + claude-opus-4-5). new
🛡️ migraven-max-thclaws Framework-built AD + Berechtigung audit agent. Neo4j + thClaws + MCP. Replicates a 25K-line bespoke monolith in ~2,700 lines of Rust. new
🧠 langgraph-checkpoint-neo4j-js Neo4j checkpoint saver for LangGraph.js. Persistent memory with time-travel. 1

Neo4j also powers OpenMark (knowledge graph) and schema-architect (multi-DB schema generator) — see sections above.


🦀 Rust & Systems

Production Rust. Tauri. Native runtimes. The MAX-stack credibility tier.

Repo What it does
🦀 ai-model-directory-router-rs Routing, cost calculation, fallback chains, and context window management for 7000+ AI models. Rust library.
📚 ai-model-directory The most comprehensive, automatically updated directory of 7000+ AI models and their metadata.
🛠️ migRaven-AD-CleanUP Active Directory cleanup tooling in Rust. Production at migRaven.

skill-deck (Tauri v2 + Rust) is listed under AI Systems above for product-tier framing.


📐 Frameworks & Methodology

Repo What it does
🧩 promptfusion Three-layer prompt composition for AI agents. Semantic weighted priorities. A methodology, not just a tool. 12 forks. 27

🏢 Built at migRaven (Berlin)

Commercial enterprise products I've led or contributed to at migRaven GmbH — Identity, Data & Access Management for the DACH market. All four shipped within the last 18 months.

  • 🛡️ migRaven.MAX · flagship, building now — Identity, Data & Access Management platform. Neo4j knowledge graph with 90+ connectors (AD, Entra ID, SharePoint, Teams, Exchange, file servers). LLM natural-language query layer (Azure OpenAI / AWS Bedrock, EU servers only). Reporting against BSI, ISO 27001, NIS2, DORA, TISAX, DSGVO. Public since Sep 2025 · Launch coverage
  • 📨 migRaven.Archiver for Teams (internally: TeamsArchiver) — Microsoft Teams archiving + compliance. Returns channel data to file servers, detects external permissions, selective channel archiving. Launched Jan 2025 · Press release
  • 🧠 aikux.Brain (sister company aikux Service GmbH) — Enterprise Knowledge Graph platform. Neo4j + GraphRAG + semantic / LLM layer. Multi-tenant, on-prem or EU cloud, LLM-agnostic. Powers migRaven.MAX. Public since Nov 2025 · Launch coverage

Also leading Nexus internally — the workflow and script-orchestration engine inside migRaven.MAX (not publicly branded).


🌐 Web & Apps

Repo What it does
✂️ BarbersBuddies · barbersbuddies.com Complete open-source booking platform for barbershops. React + Firebase + Stripe. 16
🪞 Mystic-Portfolio · othmanadi.com Multilingual developer portfolio. React 19 + TypeScript + Tailwind + RTL. 1
🔁 appwrite-keepalive Keeps Appwrite free-tier projects alive. Zero infrastructure. 1

📰 Press & Articles About My Work


✍️ Where I Publish


💬 What People Say

"Adi has an exceptional talent for breaking down complex coding concepts into easy-to-understand lessons that were both engaging and interactive. His passion for web development is infectious, and it was clear that he genuinely cared about the success of his students."Ivan Curmi · Finance Professional, MBA · ex-student

"Adi possesses full technical proficiency in the subjects he teaches. What most impressed me was how well Adi managed the different levels of technical experience that coexisted in the same class. Adi is mindful of the needs of his students and often brings the best out of them."João Teixeira · Software Engineer, Backend & Distributed Systems (Java/Kotlin/TypeScript)

"The greatest instructors do more than show, or even demonstrate; they inspire. Should I ever go into teaching, the impact his lectures have made on my development journey have the energy I would hope to be able to channel into my future students."Vernell Clark · Full Stack Software Engineer + Cloud Engineer

"Bis jetzt einer der besten Coding Lehrer die ich je hatte. Jeder der bei ihm lernen kann lernt von einem der Besten." (One of the best coding teachers I've ever had. Anyone who learns from him is learning from one of the best.)Romano Mantek · Junior Full Stack Developer

More references on LinkedIn.


🌍 planning-with-files — In the Wild

Repos other developers built on top of the skill.

Repo What it is
lincolnwan/Planning-with-files-copilot-agent Entire Copilot agent built around the skill.
cooragent/ClarityFinance AI finance agent framework. Planning-with-Files approach directly credited.
oeftimie/vv-claude-harness Claude Code harness built on Manus-style persistent markdown planning.
jessepwj/CCteam-creator Multi-agent team orchestration skill using file-based planning.

🧩 Merged Contributions to Other Repos

Code I wrote that lives in known and helpful repos.

Upstream Contribution
davila7/claude-code-templates planning-with-files included in the largest Claude Code template library. Listed on LobeHub.
ComposioHQ/awesome-claude-skills #21 → first AI observability skill (LangSmith Fetch).
santifer/career-ops #21 DACH job scanner · #22 engineer-instructor example · #23 German language modes.
MemPalace/mempalace #558 → fix: skip unreachable reparse points on Windows (WinError 448).
op7418/guizang-ppt-skill #5 → fix: grid-4 stat overflow + frame overflow:hidden.
obra/superpowers #255 → fork rebuilt around planning-with-files. PR credits OthmanAdi.
uberskillsdev/uberSKILLS #65 Windows compatibility · #67 Claude Code skill format support.
buzhangsan/skill-manager #1 → add planning-with-files and langsmith-fetch skills.
tobi/qmd #561 → fix(windows): qmd.cmd launcher for MCP stdio spawn.
rlnorthcutt/analyzeRepo #1 → multi-provider LLM support (Azure OpenAI, OpenAI, Ollama).
divar-ir/ai-doc-gen #21 → Azure OpenAI Service support.

🔧 Open PRs in Other Repos

Upstream PR
mattpocock/sandcastle #519 → feat: ports option for docker() sandbox provider. Expose agent web servers to host.
warpdotdev/warp #9306 → fix(windows): resolve ERROR_UNTRUSTED_MOUNT_POINT (448) for junction + symlink.
warpdotdev/warp #9307 → fix(windows): convert WSL paths to host-native format in /open-file.
warpdotdev/warp #9308 → fix(mcp): size-based log rotation to prevent unbounded MCP log growth.

Behind the Work · 8,000+ teaching hours · 100+ careers launched · 97K+ LOC in production
  • Teaching: 8,000+ hours since 2023 across Morphos, Aikux.Brain, MAX. KI Python module, AI Engineering 12-Factor curriculum.
  • Outcomes: 100+ students transitioned into developer roles. References on LinkedIn.
  • Production code: 97K+ LOC across migRaven products (Rust + Node + .NET, Neo4j + Redis + Pinecone + Anthropic).
  • Open source reach: 21K+ stars · 16K+ developers installing skills · 11 merged PRs into other public repos.
  • Currently learning: Rust async runtimes, Tauri v2 internals, formal methods for agent reliability.
  • Personal stack: Claude Code + planning-with-files + chronos + MDDesign, locally. Rust on Windows. Berlin-based since 2021, German citizen since 2026.

Draw the system. Ship the markdown. Repeat until obvious.

LinkedIn · X · dev.to · othmanadi.com · Email

Pinned Loading

  1. planning-with-files planning-with-files Public

    Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.

    Python 21.2k 1.9k

  2. promptfusion promptfusion Public

    🎯 Three-layer prompt composition system for AI agents. Translates numerical weights into semantic priorities that LLMs actually follow. ⚡ Framework-agnostic, open source, built for production multi…

    JavaScript 27 12

  3. langsmith-fetch-skill langsmith-fetch-skill Public

    🔍 AI observability skill for Claude Code. Debug LangChain/LangGraph agents by fetching execution traces from LangSmith Studio directly in your terminal.

    25 2

  4. AI-Docs-Copier AI-Docs-Copier Public

    Transform any documentation into AI-friendly formats with one click

    TypeScript 17 2

  5. BarbersBuddies_Onlineshop_maker BarbersBuddies_Onlineshop_maker Public

    ✂️ The complete open-source booking platform for barbershops. React + Firebase + Stripe. Multi-language, dark mode, analytics, messaging & more.

    JavaScript 16 3

  6. planning-with-teams planning-with-teams Public

    Manus-style context engineering for Claude Code Agent Teams. Coordinate multiple Claude instances with shared planning files.

    Python 23 4