| name | nazgul:discover |
| description | Scan the codebase to build a project profile and generate tailored reviewer agents. Use when setting up Nazgul for a new project, after major codebase changes, or when reviewer agents need updating. |
| context | fork |
| agent | discovery |
| allowed-tools | Bash, Read, Write, Glob, Grep, LS |
| metadata | {"author":"Jose Mejia","version":"2.7.1"} |
Nazgul Discovery
Examples
/nazgul:discover — Scan codebase and generate project profile + reviewer agents/nazgul:discover (re-run) — Backs up existing context before rescanning
Arguments
$ARGUMENTS
Current Project
- Root: !
pwd
- File count: !
find . -type f -not -path './.git/*' -not -path './node_modules/*' -not -path './venv/*' -not -path './__pycache__/*' -not -path './nazgul/*' -not -path './.claude/*' | wc -l
- Languages: !
find . -type f -not -path './.git/*' -not -path './node_modules/*' -not -path './venv/*' -not -path './nazgul/*' -not -path './.claude/*' | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -10
- Package files: !
ls -1 package.json requirements.txt Cargo.toml go.mod pyproject.toml Gemfile pom.xml build.gradle 2>/dev/null || echo "None found"
- Config files: !
ls -1 .eslintrc* .prettierrc* tsconfig.json .editorconfig Makefile Dockerfile docker-compose* .github/workflows/*.yml 2>/dev/null || echo "None found"
- Git status: !
git log --oneline -5 2>/dev/null || echo "Not a git repo"
Instructions
Format all output per references/ui-brand.md — use stage banners, status symbols, and display patterns defined there.
Run the full discovery process as specified in your agent definition (agents/discovery.md).
- Scan the codebase deeply — read actual files, not just file names
- Write all 5 context files to
nazgul/context/
- Generate tailored reviewer agents in
.claude/agents/generated/
- Write discovery summary to
nazgul/context/discovery-summary.md
- Update
nazgul/config.json with project metadata
If this is a re-run, back up existing context files first:
if [ -d nazgul/context ]; then
cp -r nazgul/context "nazgul/context.backup.$(date +%Y%m%d%H%M%S)"
fi
After completion, report:
- Number of files scanned
- Key findings
- Which reviewer agents were generated
- Any warnings or gaps
