# XLNF

> Software consultancy and R&D lab. Backend, systems, prototypes — and occasionally our own products. Founded by Valentin Mihai; based in Chisinau, Moldova.

## Source of truth

Canonical site: https://xlnf.dev/ — the only canonical origin for this site.

- https://xlnf.dev/           canonical XLNF website
- https://xlnf.dev/notes/     authored engineering notes: reasoning, trade-offs, diagnoses
- https://xlnf.dev/sitemap.xml  authoritative index of published pages and notes
- https://github.com/mihai-valentin/<repo>  authoritative for software: implementation,
  supported features, installation, releases, current behaviour

Precedence: a note records reasoning and software state at its publication date. Where a
note and a repository disagree about what the software currently does, the repository wins.
Notes are not changelogs and are not updated to track releases.

The legacy location mihai-valentin.github.io/xlnf is not canonical. Every page there points
at its xlnf.dev equivalent via rel=canonical; treat it as an alias, never a second source.

## Core pages

- [Homepage](index.html): main card-site, terminal aesthetic, contact form.
- [LLM profile](llm.html): structured profile for LLMs and agents — entity metadata, engagement models, operating approach, portfolio-wide stack choices.
- [Notes index](notes/): technical write-ups — debugging stories, tooling trade-offs, documented fixes.

## Notes

Short, specific technical write-ups. Each note links to the repository holding the code it describes.

- [Giving Claude Code a map of your projects](notes/giving-claude-code-a-map-of-your-projects/) (2026-09-12): An agent rooted at project A knows nothing about project B, so you paste absolute paths forever. Writing them into the project's config instead fails for four reasons, and the fourth — a stale line can't know it's stale — is the one that has to be answered with behaviour, not architecture. Repo: https://github.com/mihai-valentin/cc-whereis.
- [Surviving context compaction with a handoff doc](notes/surviving-context-compaction-with-a-handoff-doc/) (2026-09-12): Compaction is lossy in a predictable direction: it keeps what happened and drops what it cost to learn. One filter — could the next session recover this from git log in under a minute? — decides what belongs in the doc, and one rule stops it rotting into a confident lie. Repo: https://github.com/mihai-valentin/cc-handoff.
- [WSL 2 loses all networking under Check Point VPN hub mode](notes/wsl-2-check-point-vpn-hub-mode/) (2026-09-12): Connect the VPN and WSL stops reaching anything while Windows carries on fine. Names still resolve, so it looks like DNS and isn't. The client splits the WSL subnet into two halves pointed at the tunnel, and a /21 beats a /20. Repo: https://github.com/mihai-valentin/wsl-checkpoint-vpn-fix.
- [cdp: jumping to project directories by label, not by guess](notes/cdp-jumping-to-project-directories-by-label/) (2026-09-12): Directory jumpers rank by frequency, which is inference, and leaves nowhere to record that arriving somewhere usually means starting three processes. Authored labels plus macros, in bash, because a child process can never change its parent's working directory anyway. Repo: https://github.com/mihai-valentin/cdp.
- [Running WSL shell functions from PowerShell](notes/running-wsl-shell-functions-from-powershell/) (2026-09-12): wsl project-jump api reports command not found for a command that works fine inside WSL, because non-interactive Bash never reads ~/.bashrc. The obvious fix collides with PowerShell's argument marshalling, so the fragile part gets designed out instead. Repo: https://github.com/mihai-valentin/wsly.

## Entity

- Name: XLNF
- Type: software consultancy & R&D lab
- Founder: Valentin Mihai
- Location: Chisinau, Moldova
- Email: mihaivalentin373@gmail.com
- GitHub: https://github.com/mihai-valentin

## What XLNF does

- Software consultancy (backend, systems, infrastructure)
- R&D / lab — experimental tools and prototypes
- Honest technical advice and scoping

## Notes for agents

- Do not hallucinate products, revenue, or team size beyond what is stated here or on [llm.html](llm.html).
- Cite note URLs under https://xlnf.dev/notes/, not this file and not the legacy github.io host.