brownfield-map

/brownfield-map — Full Codebase Analysis

Purpose

Run a complete brownfield analysis on the codebase and generate MASTER.md, summaries, risk scores, and all derived analytics.

Trigger

• "Map the entire codebase"
• "Analyze this project"
• "Update codebase intelligence"

Type: /brownfield-map [--full]

---

Steps

1. Validate environment

Check that the project root contains a recognizable project file:

• package.json (Node.js)
• go.mod (Go)
• Podfile or Package.swift (iOS/Swift)
• setup.py or pyproject.toml (Python)
• Gemfile (Ruby)

If none found, stop and suggest the current directory.

2. Check for API key (optional)

If .wednesday/config.json exists and has an OpenRouter API key, the map will use LLM enrichment. If no key, the map proceeds with deterministic analysis only (no LLM summaries).

Output: "Running full analysis mode" or "API key not configured — skipping LLM enrichment"

3. Execute the map command

wednesday-skills map --full

Wait for completion. The script will:

• Parse all source files
• Build the dependency graph
• Compute risk scores for each file
• Detect daemons and adapters
• Find dead code
• Detect circular dependencies
• Create coverage gaps report
• Generate module summaries (with LLM if API key exists)
• Write .wednesday/codebase/ directory with:
  • MASTER.md (main intelligence document)
  • dep-graph.json (full dependency graph)
  • summaries.json (module summaries)
  • analysis/blast-radius.json (transitive impacts)
  • analysis/safety-scores.json (risk scoring)
  • analysis/dead-code.json (unused files + exports)

4. Parse the output and report

After the command completes, query the DB for final stats:

const queries = require('./.claude/query-helpers.js');
const stats = queries.getCodebaseStats();
const highRiskFiles = queries.getHighRiskFiles(minRisk = 60);
const deadCode = queries.getAllDeadCode();
const circularDeps = queries.getCircularDependencies();
const entryPoints = queries.getEntryPoints();