{
  "schema": "fable.external_project.review.v1",
  "id": "kunchen-dotfiles-advisory-map-20260705",
  "title": "Kun Chen Dotfiles + Agentic Setup \u2014 Advisory Map (Windows Adaptation)",
  "source": {
    "type": "video + repo",
    "video_url": "https://www.youtube.com/watch?v=5N-okeDdIuI",
    "repo_url": "https://github.com/kunchenguid/dotfiles-mac-nix",
    "description": "L8 Meta/Microsoft engineer builds reproducible Mac dev setup from scratch using Nix, nix-darwin, Home Manager, declarative Homebrew. Agentic engineering config: Westerm terminal, Neovim, Herder multiplexer, Claude Code, global agent memory file.",
    "fetchedAt": "2026-07-06T23:28:35.477379+00:00"
  },
  "externalProjectReviews": [
    {
      "repo": "kunchenguid/dotfiles-mac-nix",
      "stars": null,
      "license": "not specified",
      "description": "Public reusable core of Kun Chen Mac setup. Built with Nix, nix-darwin, Home Manager, declarative Homebrew. Fresh Mac: run bash setup/mac.sh. Later changes: darwin-rebuild switch --flake",
      "keyPattern": "Reproducible declarative config from scratch. One script to bootstrap an entire dev environment. Agent-aware setup: Herder multiplexer, global memory file for all agents.",
      "relevance": "Validates fable-agent TRUTH.md approach: single source of truth for environment state. Kun uses Nix flakes + rebuild.sh; fable-agent uses TRUTH.md + quarantine. Same reproducibility goal, different mechanism.",
      "decision": "advisory",
      "safeToVendor": false,
      "vendorReason": "Mac-specific Nix setup. Not applicable to Windows without WSL. Learn the reproducibility pattern, not the tooling."
    }
  ],
  "windowsAdaptation": {
    "summary": "Nix/nix-darwin/Home Manager do NOT run natively on Windows. Nix does run in WSL but the Mac-native toolchain (nix-darwin, Homebrew) has no Windows equivalent.",
    "mappings": [
      {
        "mac_tool": "Nix + nix-darwin",
        "windows_replacement": "WSL2 + Nix inside WSL, or Windows Package Manager (winget) + Chocolatey for package management"
      },
      {
        "mac_tool": "Homebrew (declarative)",
        "windows_replacement": "winget + configuration as code (Dev Home / DSC)"
      },
      {
        "mac_tool": "Home Manager",
        "windows_replacement": "PowerShell profile + PSReadLine + Oh My Posh"
      },
      {
        "mac_tool": "Westerm terminal",
        "windows_replacement": "Windows Terminal + settings.json in dotfiles"
      },
      {
        "mac_tool": "Neovim + Lazy",
        "windows_replacement": "Same \u2014 Neovim runs on Windows natively"
      },
      {
        "mac_tool": "Herder multiplexer",
        "windows_replacement": "Windows Terminal panes or WSL tmux"
      },
      {
        "mac_tool": "Zsh + Starship",
        "windows_replacement": "PowerShell + Oh My Posh"
      },
      {
        "mac_tool": "rebuild.sh (Nix flake)",
        "windows_replacement": "Bootstrap PowerShell script in dotfiles repo"
      },
      {
        "mac_tool": "Global agent memory file",
        "windows_replacement": "Same pattern \u2014 flat file read by all agents"
      },
      {
        "mac_tool": "Dotfiles repo + symlinks",
        "windows_replacement": "Same pattern \u2014 dotfiles repo + junctions/symlinks via mklink"
      }
    ],
    "keyInsight": "The PATTERN is platform-agnostic: one script to bootstrap, one repo for config, one source of truth. The tools differ but the reproducibility goal is identical."
  },
  "keyTakeaways": [
    "Kun Chen dotfiles are Mac/Nix-specific. For Windows, use winget + Windows Terminal + PowerShell + dotfiles repo.",
    "The reproducibility pattern is the value: one script to go from fresh OS to full dev setup. fable-agent TRUTH.md serves the same role.",
    "Global agent memory file (agents.md) is the same pattern as fable-agent flat-ledger.ts: state outside LLM context.",
    "Herder multiplexer validates worktree-isolation.ts: agents need isolation, and seeing agent status at a glance is critical.",
    "Declarative config (Nix flakes) is overkill for Windows. A simple PowerShell bootstrap script + dotfiles repo is MVI.",
    "Advisory only. No vendoring. Pattern validation is the value."
  ],
  "contentVerified": true,
  "liveVerification": "GitHub API confirmed repo exists under kunchenguid/dotfiles-mac-nix. Video at youtube.com/watch?v=5N-okeDdIuI accessible. Kun Chen is former L8 at Meta/Microsoft.",
  "advisoryOnly": true,
  "noActionRequired": true,
  "fableAgentStatus": {
    "containers": 19,
    "phase": 4,
    "autoPatchProven": false,
    "tests": "295 passing, 69 files",
    "commit": "95ddbf7"
  }
}