Discover

---
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: 1.2.2
---

# Nazgul Discovery

## Examples
- `/nazgul:discover` — Scan codebase and generate project profile + reviewer agents
- `/nazgul:discover` (re-run) — Backs up existing context before rescanning

## 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.

$ARGUMENTS

Run the full discovery process as specified in your agent definition (`agents/discovery.md`).

1. Scan the codebase deeply — read actual files, not just file names
2. Write all 5 context files to `nazgul/context/`
3. Generate tailored reviewer agents in `.claude/agents/generated/`
4. Write discovery summary to `nazgul/context/discovery-summary.md`
5. Update `nazgul/config.json` with project metadata

If this is a re-run, back up existing context files first:
```bash
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