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 nine 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 — Your agent forgets every /clear. Files fix it. The planning pattern Meta paid $2B for.
  • 🪟 plan-it (new) — Stop reading walls of markdown. Start seeing your plan. HTML-first sibling of planning-with-files: single plan.html, survives /clear, SHA-256 attested, 10 templates, 17 IDEs day 1.
  • 🧩 promptfusion (27★) — Three weighted prompt layers. LLMs follow your priorities, not their guesses.
  • 🔭 langsmith-fetch (25★) — Skip tab-switching to LangSmith Studio. LangChain traces land in your terminal.
  • 👥 planning-with-teams (23★) — Run parallel Claude agents on one shared plan. No drift, no duplicated work.
  • 📑 AI-Docs-Copier (17★) — One click turns any doc site into clean Markdown for your AI tool.
  • 🦞 researchclaw (13★) — Turn a topic into a conference-grade paper. 23-stage pipeline, one command.
  • 🎨 MDDesign (8★) — Glue layer between planning, design tokens, memory, and agent teams. No tool replacement.
  • 🖥️ skill-deck (4★) — Browse skills across 15+ AI agents from one keypress desktop overlay.
  • ⏱️ chronos (1★ · new) — Stop agents guessing "just now". Hook ledger, 7 decision rules, 8 platforms.
  • ▶️ YouTube-Clipper (new) — Hear a great moment in YouTube. Alt+drag the seekbar. Verbatim audio + Whisper transcript + AI bullets + a publishable web page land in one folder. Six-stage pipeline, only stage 5 is AI.

🛠️ 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 Markdown as persistent memory. Task plan, findings, progress survive every reset. 21,132
🔭 langsmith-fetch-skill LangChain and LangGraph traces pulled into Claude. Debug without leaving the terminal. 25
👥 planning-with-teams Parallel Claude agents coordinated on shared planning files. No siloed context. 23
🦞 researchclaw-skill Conference-grade research paper from one topic. 23 stages, self-healing pipeline. 13
🎨 MDDesign Wire planning, DESIGN.md, memory routing, agent teams, and session handoff in one contract. 8
🧠 codebase-knowledge-builder Turn any codebase into structured Markdown artifacts your agent reads cold. 8
📋 cowork-workflows Cowork tasks that survive context resets. Markdown checkpoints replay on reconnect. 8
🔀 code-memory-router Cut memory-task token burn 61%. Routes WHY to MemPalace, WHERE to QMD. 3
🎛️ openui-forge Generative UI scaffolds wired to any LLM provider and any backend language. 3
📦 agent-blueprint Stop building agents from zero. Patterns for tool registries, HITL, streaming, serving. 2
🚀 APEX Replatforms in 4 weeks instead of 6-12 months. Six skills, three autonomy tiers. 2
🌉 open-responses-agent-skill OpenAI Responses API, but multi-provider. Switch Groq, Together, Nebius without rewrites. 2
⏱️ chronos Stop agents guessing "just now". Wall-clock, idle detection, retry windows in one ledger. 1
📝 pr-perfect PR descriptions your reviewer-agent verifies. Reads commits, learns your team's format. 1
🌍 humanizer-semitic Turn AI Arabic and Hebrew into text that reads human. 113 patterns, four dialects. 1
🎯 vibe-skills Website from one prompt. Lives on here.now in seconds. No purple gradients. 1
🔗 awesome-here-now Catalog of live sites shipped with here.now. Discover patterns, get yours listed. 1
🗄️ schema-architect SQLite, Redis, Neo4j schemas with typed Rust and Go bindings, ready to ship.

🤖 AI Systems & Apps

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

Repo What it does
📄 AI-Docs-Copier One click turns any doc site into Markdown your AI tool actually reads. 17
🖥️ skill-deck Search skills across 15+ AI coding agents from one desktop overlay keypress. Tauri v2 + Rust. 4
🧭 OpenMark Turn 8K+ bookmarks into a searchable knowledge graph. ChromaDB and Neo4j in one query. 4
▶️ YouTube-Clipper Alt+drag a YouTube seekbar → folder with verbatim audio, Whisper transcript, AI summary + bullets, and a publishable index.html. Chrome MV3 extension + local FastAPI daemon, six-stage pipeline, only stage 5 calls an LLM. new

🕸️ 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 Audit Active Directory compliance via Neo4j Cypher. 24K-line monolith replaced by typed tools. new
🛡️ migraven-max-thclaws Replicate a 25K-line bespoke AD auditor in 2,700 lines of Rust. 90% LOC drop. new
🧠 langgraph-checkpoint-neo4j-js Store LangGraph agent state in Neo4j. Branch checkpoints, time-travel, visual debugging. 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 Route 7000+ AI models by cost, context, and fallback. Decimal math, no pricing drift.

📐 Frameworks & Methodology

Repo What it does
🧩 promptfusion Three weighted prompt layers. LLMs respect your priorities every turn. A methodology, not a tool. 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 Launch a barbershop with bookings, payments, and staff scheduling. React + Firebase + Stripe. 16
🪞 Mystic-Portfolio · othmanadi.com Portfolio site live in four languages with RTL and dark mode ready out of the box. 1
🔁 appwrite-keepalive Never let an Appwrite free-tier project pause again. GitHub Actions heartbeat every 5 days. 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.

planning-with-files ClawHub Download History


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.9k 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 15 4

  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 3