naming
MANDATORY for all naming decisions - variables, functions, files, folders, classes, database tables, routes, CSS classes. Must be followed when creating or renaming any identifier. Non-negotiable baseline for consistent, readable names across all languages and contexts.
SKILL.md
| Name | naming |
| Description | MANDATORY for all naming decisions - variables, functions, files, folders, classes, database tables, routes, CSS classes. Must be followed when creating or renaming any identifier. Non-negotiable baseline for consistent, readable names across all languages and contexts. |
Talent Tree
Overpowered Claude Code talents to power level your software architecture.
Install Talents
Requires Claude Code.
/plugin marketplace add heyJordanParker/dotfiles
/plugin install talents@talent-tree
Talents
Invoked as /talents:<name>:
- agent-browser — Automate browser interactions, web testing, screenshots, data extraction (requires agent-browser)
- architecture — Present architectural options with tradeoffs
- breadboarding — Map workflows into affordance tables
- breadboard-review — Find design smells in breadboards
- cc — Work with Claude Code skills, hooks, settings
- codebase-exploration — Explore codebase structure and dependencies
- commit-message — Structured commits with type prefix and file tree
- debug — Systematic debugging with root cause tracing
- design — UI components, styling, and interaction decisions
- diagram — Generate Excalidraw diagrams on a live canvas (requires drawbridge)
- naming — Consistent naming for variables, files, classes, everything
- debate — N independent architects debate architectural options through structured rounds with cross-pollination
- execute-plan — Orchestrate implementation plans with persistent team, validation gates per slice
- independent-review — N identical parallel agents for consensus through redundancy
- ledger — Review and update Claude.md files for template compliance
- modeling — Transform shaped parts into concrete models (DB schema, UX flows, architecture)
- pcc — Add pros/cons/confidence to any prompt
- personas — 5 parallel persona agents for diverse perspectives
- plan — Plan features using structured format
- pragmatic-engineering — KISS-driven planning and review
- review-plan — Review planning artifacts with 5 parallel specialized agents
- review — Parallel code reviewers on uncommitted changes
- shaping — Collaborate on problem definition and solution options
- show-architecture — Annotated file trees inline
- slicing — Break modeled features into vertical implementation slices with acceptance criteria
- subagents — Framework for dispatching and managing subagents
- trace — Code intelligence CLI: search, callers, definitions, complexity, file/method reads with rich architectural context (requires the bundled
tracebinary; see Tracer Setup below) - user-testing — Trace real user flows through code changes, find gaps
- using-git-worktrees — Isolated git worktrees for feature work
- verification-before-completion — Evidence before assertions
- working-with-markdown-files — Rules for markdown editing
- writing-tests — Behavior-driven tests, not implementation tests
Commands
Also invoked as /talents:<name>:
- ask — Break complex scenarios into decision questions with 4+ options
- brainstorm — Interactive design refinement using Socratic method
- bug-hunt — Review code for bugs, logic errors, security vulnerabilities
- commit — Validated commit with tests and comprehensive review
- docs-review — Review Claude documentation with parallel subagents
- pcc — Add pros/cons/confidence to any prompt
- plan — Plan a feature using structured format
- q — Answer questions only, no actions
- retro — Analyze conversation history for patterns and improvements
- wtf — Hard reset, redo the last task correctly
Hooks
The plugin includes hooks that run automatically to keep Claude disciplined:
- session-start — Injects ground rules (no sycophancy, literal execution, read before acting)
- retro-reminder — Nudges to run
/retroif 3+ days since last one - block-git-revert — Blocks
git reset,git restore,git checkout -- <file>. Forces manual execution. - block-unsafe-delete — Whitelists
rmto specific directories only. Everything else blocked. - enrich-on-read — Auto-enriches every native Read/Glob with tracer's per-file lifecycle, complexity rank, and architecture-graph counts. Silent fallback if
traceisn't installed; the native tool always runs. - pre-edit — "Did you read this file?" checklist before any edit
- ask-user-question — Enforces research-first, 4+ options, self-contained questions
- sync-shaping — Ripple-check reminders when editing shaping documents
- user-prompt-submit — Pre-response checklist (read the code, question vs instruction, test your changes)
Tracer Setup
The enrich-on-read hook and the /trace skill both need the trace binary. The plugin ships a POSIX launcher that lands on PATH automatically when the plugin is enabled. tracer is a native Rust binary, so the launcher resolves a host-appropriate one: a committed prebuilt (macOS arm64 / Linux x86_64), a previously locally-built cached binary, or — on any other platform — cargo build from the crate source shipped in the plugin. If no Rust toolchain is present for that last path, trace prints an actionable "install Rust" error; the SessionStart primer degrades silently so sessions never break.
All 23 commands work from whichever binary the launcher resolves — there is no reduced-feature tier. If you want trace outside the plugin too, build it from tools/tracer and put it on PATH (the dotfiles setup.sh does this into ~/.local/bin):
cd tools/tracer
cargo build --release
install -m 755 target/release/trace ~/.local/bin/trace
Tracer wraps five external binaries: ast-grep, scc, universal-ctags, ripgrep, git. Install whichever your platform needs:
macOS (Homebrew):
brew install ast-grep scc universal-ctags ripgrep
xcode-select --install # git
Linux (Debian/Ubuntu):
apt install universal-ctags ripgrep git
# ast-grep: https://ast-grep.github.io/guide/quick-start.html
# scc: https://github.com/boyter/scc#installation
Windows (Scoop):
scoop install ast-grep scc ripgrep
# universal-ctags: https://github.com/universal-ctags/ctags
# git: https://git-scm.com/download/win
Verify with trace doctor — it lists missing binaries with the same install command for your platform. The enrich-on-read hook degrades gracefully: if trace isn't installed at all, the hook exits 0 with no output and native Read/Glob run normally — nothing breaks, you just don't get the enrichment.
Agents
Per Claude Code plugin schema, agents (.md files in packages/claude/agents/) are NOT distributed by the marketplace install — only skills, commands, and hooks. To use the bundled agents (explorer, researcher, architect, debugger, etc.), copy the files you want into your own ~/.claude/agents/ or <repo>/.claude/agents/:
git clone https://github.com/heyJordanParker/dotfiles.git /tmp/dotfiles
cp /tmp/dotfiles/packages/claude/agents/explorer.md ~/.claude/agents/
cp /tmp/dotfiles/packages/claude/agents/researcher.md ~/.claude/agents/
# ... and any others you want
The split worth knowing:
- explorer — in-codebase architectural mapping ("where is X used", "how does Y work end-to-end"). Uses the trace skill heavily.
- researcher — external research (library docs, APIs, framework references, web lookups). Uses agent-browser, cc, claude-api, plus trace for incidental in-repo grounding.
- architect / backend-engineer / code-reviewer / debugger / frontend-engineer / regression-reviewer / tester — also have the trace skill for navigating the codebase during their work.
Safe Delete
Claude loves running rm -rf. Protect yourself by replacing rm with trash so deleted files go to macOS Trash instead of being permanently destroyed:
brew install trash
Then alias rm to trash in your shell profile:
cat >> ~/.zshenv << 'EOF'
# Safe delete - moves to Trash instead of permanent deletion
rm() {
local args=()
for arg in "$@"; do
[[ "$arg" =~ ^-[rRfidv]+$ ]] && continue
args+=("$arg")
done
trash "${args[@]}"
}
EOF
This silently strips rm flags (-rf, -i, etc.) and sends files to Trash. Claude thinks it's deleting; you can undo from Trash.
Dotfiles
macOS dotfiles managed with GNU Stow.
New Machine Setup
One-line bootstrap (clones to ~/dotfiles, then runs setup):
curl -fsSL https://raw.githubusercontent.com/heyJordanParker/dotfiles/master/setup.sh | bash
To clone elsewhere, do it yourself first; setup will run from whichever path you pick:
git clone https://github.com/heyJordanParker/dotfiles.git <path>
cd <path> && ./setup.sh
Either way installs Xcode CLI tools, Homebrew, all packages from Brewfile, bun, and symlinks configs.
Manual Usage
Each subdirectory of packages/ is a stow package. Its contents are exactly what should land at the package's stow target — no inner mirror wrappers. The package-to-target mapping lives in setup.sh.
# Add a new config — example: 'newapp' targets ~/.config/newapp/
cd <repo>/packages
mkdir -p newapp
mv ~/.config/newapp/* newapp/
stow -t ~/.config/newapp newapp
# Remove symlinks
stow -D -t ~/.config/newapp newapp
# Re-link after changes
stow -R -t ~/.config/newapp newapp
Structure
Stow packages live under dotfiles/packages/<pkg>/. Each package contains the actual files that get symlinked to its target — see Claude.md for the full architecture.