Ambient Completeness Checklist

25 verifiche post-setup MacBook per garantire ambient PERFETTO. Lanci después Step 12 SETUP-MACBOOK, cada check ti dice qué fare se fail.

Atelier Noelia · Day 1 post-setup verify · Wave 4.5 audit deep · 2026-05-24

Progreso verifica ambient: 0 / 25 0%

🎉 ¡Ambient PERFETTO!

Todas 25 verifiche pasadas. MacBook setup completo end-to-end. Listo para Welcome Tutorial T1-T5 → WELCOME-APP-TUTORIAL.html

1. Tools base installati (5 check)

Verifica Homebrew + Git + Node + Bun + pnpm via terminal commands.

1.1 Homebrew installato

brew --version

Atteso: Homebrew 4.x.x

Si fail: Re-run Step 1 SETUP-MACBOOK (Xcode CLT primer + brew install script)

1.2 Git installato

git --version

Atteso: git version 2.40+

Si fail: brew install git

1.3 Node + Bun installati

node --version && bun --version

Atteso: v20.x.x (Node) + 1.x.x (Bun)

Si fail: brew install node + curl -fsSL https://bun.sh/install | bash

1.4 pnpm installato (Wedding-Templates)

pnpm --version

Atteso: 9.x.x o superiore

Si fail: npm install -g pnpm

1.5 VSCode + comando code in PATH

code --version

Atteso: 1.90+ + commit hash + arch arm64

Si fail: Apri VSCode → Cmd+Shift+P → "Shell command: Install 'code' command in PATH"

2. Repos clonati + deps install (3 check)

2.1 Sharkcode repo clonato

ls ~/Code/sharkcode/CLAUDE.md

Atteso: file path (no errore "No such file")

Si fail: cd ~/Code && git clone git@github.com:Michel9329/sharkcode.git

2.2 Wedding-Templates clonato (branch master)

cd ~/Code/Wedding-Templates && git branch --show-current

Atteso: master (NO main)

Si fail: cd ~/Code && git clone git@github.com:Michel9329/Wedding-Templates.git

2.3 Bun install Sharkcode deps OK (picomatch + js-yaml per hooks)

ls ~/Code/sharkcode/node_modules/picomatch ~/Code/sharkcode/node_modules/js-yaml

Atteso: 2 path esistenti

Si fail: cd ~/Code/sharkcode && bun install

3. Dotfiles + VSCode workspace (3 check)

3.1 zshrc-noelia attivo (brand prompt + alias)

alias | grep -E "cdsc|cdwt|dev|gnoelia"

Atteso: 4+ alias listati

Si fail:

cp ~/Code/sharkcode/.planning/business/atelier-noelia/dotfiles/zshrc-noelia ~/.zshrc-noelia && echo 'source ~/.zshrc-noelia' >> ~/.zshrc && source ~/.zshrc

3.2 noelia.code-workspace copiato ~/Code/

ls ~/Code/noelia.code-workspace

Atteso: path esistente

Si fail: cp ~/Code/sharkcode/.planning/business/atelier-noelia/dotfiles/noelia.code-workspace ~/Code/

3.3 VSCode settings.json applicato (claudeCode ES + lightweight)

cat "$HOME/Library/Application Support/Code/User/settings.json" | grep claudeCode

Atteso: "claudeCode.defaultLanguage": "es"

Si fail:

cp ~/Code/sharkcode/.planning/business/atelier-noelia/dotfiles/vscode-settings.json "$HOME/Library/Application Support/Code/User/settings.json"

+ restart VSCode

4. Hooks + settings.json Claude Code (4 check)

4.1 Hook auto-retrieval-preload installato

ls ~/.claude/hooks/auto-retrieval-preload.mjs

Atteso: path esistente

Si fail: Re-run bash ~/Code/sharkcode/tools/atelier-noelia/setup-mac-user-scope.sh

4.2 Hook protected-paths-block installato

ls ~/.claude/hooks/protected-paths-block.mjs

Atteso: path esistente

Si fail: Re-run setup-mac-user-scope.sh

4.3 settings.json registra 4 hook events

Atteso: numero >= 4

Si fail: Re-run setup-mac-user-scope.sh (genera settings.json template se mancante)

4.4 SHARKCODE_AUTO_RETRIEVAL env attiva

echo $SHARKCODE_AUTO_RETRIEVAL

Atteso: 1

Si fail: source ~/.zshrc-noelia + check zshrc-noelia ha export SHARKCODE_AUTO_RETRIEVAL="1"

5. MCP servers + Tavily API (3 check)

5.1 .mcp.json eredito clone repo (20 MCP servers)

cat ~/Code/sharkcode/.mcp.json | grep -c '"type"\|"command"'

Atteso: numero ~20

Si fail: Re-clone sharkcode repo (file .mcp.json tracked git)

5.2 TAVILY_API_KEY env settata (Welcome Tutorial T2 Etsy research)

echo $TAVILY_API_KEY | head -c 8

Atteso: tvly-... (prefix prime 8 char)

Si fail: Signup free https://tavily.com → API Keys → Create → uncomment riga zshrc export TAVILY_API_KEY="tvly-YOUR-KEY"

5.3 markitdown-mcp Win override Mac (opzionale, .mcp.json.local)

ls ~/Code/sharkcode/.mcp.json.local 2>/dev/null && echo "OK override" || echo "skip (tollerabile, log noisy ma Claude continua)"

Atteso: "OK override" OR "skip" (entrambi accettabili)

Si fail (optional): Re-run setup-mac-user-scope.sh + brew install jq se mancante

6. Project scope ereditato (agenti + skill + commands + memory) (4 check)

6.1 47 agenti OS Sharkcode disponibili

ls ~/Code/sharkcode/.claude/agents/*.md | grep -v "abstract\|overview" | wc -l

Atteso: numero ~47

Si fail: Re-clone sharkcode repo (.claude/agents/ tracked git)

6.2 83 project skill (mandatory cluster Phase 106.7 inclusi)

ls ~/Code/sharkcode/.claude/skills/ | wc -l

Atteso: numero ~83 (include impeccable + ui-ux-pro-max + design-taste-frontend + motion-design-skill + copywriting + brandkit + ecc)

Si fail: Re-clone sharkcode repo

6.3 24 slash commands OS disponibili

ls ~/Code/sharkcode/.claude/commands/*.md | grep -v "abstract\|overview" | wc -l

Atteso: numero ~24

Si fail: Re-clone sharkcode repo

6.4 memory-shared/ ~90 file + SHARKCODE_MEMORY_DIR puntato

echo $SHARKCODE_MEMORY_DIR && ls $SHARKCODE_MEMORY_DIR | wc -l

Atteso: ~/Code/sharkcode/memory-shared + numero ~90

Si fail: source ~/.zshrc-noelia OR re-clone sharkcode repo

7. Test end-to-end Claude main session (3 check)

Verifica funzionale finale: Claude risponde ES + accede memorie + skill + agenti + hook auto-retrieval triggera.

7.1 Claude risponde ES (settings claudeCode.defaultLanguage attivo)

claude "Hola, decime en una frase qué es Sharkcode."

Atteso: risposta in español Latam (NO inglese)

Si fail: Restart Claude Code (Cmd+Q + riapri) OR verify VSCode settings.json check 3.3

7.2 Hook auto-retrieval inietta Topic Matches

claude "Cuáles son las decisiones cementadas sobre el setup de Noelia."

Atteso: risposta include sezione "Topic Matches" con memoria reference_noelia_setup_choices.md

Si fail: Restart Claude Code (Cmd+Q + riapri) + verify check 4.1+4.3+4.4

7.3 Agent + skill spawn funziona (test sub-agent design)

claude "Spawn sub-agent sharkcode-frontend per fare audit veloce di un componente Card test"

Atteso: Claude lancia sub-agent sharkcode-frontend con skill mandatory cluster Phase 106.7 (impeccable + ui-ux-pro-max + design-taste-frontend + motion-design-skill)

Si fail: Verify check 6.1 + 6.2. Restart Claude Code.