mp-board-setup
One-time setup that creates this project's Obsidian board and links it into the repo, so mp-board-to-issues and mp-batch-execute can read requirements and pasted images. Resolve MPX_SKILLS_DIR and read <resolved MPX_SKILLS_DIR>/mp/skills/shared/BOARD_CONVENTION.md now — board format and link layout. $ARGUMENTS
Step 1: Resolve paths
- Repo root —
git rev-parse --show-toplevel. - Project name — the repo directory's base name (becomes the board filename
<project>.md). - Vault root — the
[vault-root]argument if given; else$env:MPX_OBSIDIAN_VAULT; else ask the user for the absolute Obsidian vault path (and suggest they setMPX_OBSIDIAN_VAULTso future projects skip this prompt).
Step 2: Create board + links
Run the setup script with the resolved paths (PowerShell tool):
& "$HOME\.claude\skills\mp-board-setup\scripts\link-board.ps1" -Repo "<repo>" -Vault "<vault>" -Project "<project>"
The script is idempotent and:
- enables
git core.symlinksglobally so Windows preserves real symlinks; - creates
<vault>\Boards\<project>.mdwith the four-lane skeleton (# To Process,# Ready to implement,# Manual testing,# Archive) only if it does not already exist (never clobbers existing notes); - creates the
.mpx/board-filesjunction →<vault>\Files(no admin) and the.mpx/BOARD.mdfile symlink → the board; - appends
.mpx/BOARD.mdand.mpx/board-files/to.gitignore.
Without Windows Developer Mode the direct symlink call fails; the script then retries that single op in an elevated child process (Start-Process -Verb RunAs), which raises a UAC prompt. Tell the user to accept it.
Step 3: Verify + report
Confirm the script printed both links. If it still warned that the .mpx/BOARD.md symlink could not be created (elevation declined, or the UAC prompt wasn't accepted), the junction and board file are already in place — only the file symlink needs the extra privilege. Re-run the script and accept the UAC prompt, or enable Windows Developer Mode (Settings › Privacy & security › For developers) and re-run.
Report the board path, both link paths, and the next step: open the board in Obsidian, paste any bug/task/feature notes with screenshots under # To Process (no need to sort by type), then run /mp-board-to-issues or /mp-batch-execute. If symlink privilege remains unresolved, report partial success rather than full completion.