brownfield-gaps

name	brownfield-gaps
description	Improves graph coverage for a specific file with dynamic/unannotated patterns (event emitters, dynamic require, global injection). Use when dep-graph shows gaps on a file or when chat/query returns "not mapped". Not for querying — only for improving coverage.
permissions	{"allow":["Bash(wednesday-skills fill-gaps *)","Bash(wednesday-skills analyze *)"]}

Deprecated: Gap filling is now part of brownfield-fix. When editing a file with coverage gaps, brownfield-fix automatically triggers gap resolution. Use brownfield-fix instead.

When to use

• dep-graph.json shows gaps.eventEmitter, gaps.dynamic, or gaps.conditional on a file
• brownfield-chat or brownfield-query returns "not mapped" for an important file
• Coverage below 80% on a high-risk file (risk > 50)
• Dev says "this file is not mapped well" or "why doesn't the graph show this dependency"

When NOT to use

• Asking what a file does → use brownfield-query or brownfield-chat
• Architecture violations → use brownfield-drift
• First-time codebase mapping → use brownfield-map

What to do

1. Run: wednesday-skills fill-gaps --file --min-risk 50
   • This spawns a targeted subagent for that file only
   • Subagent reads: exports list + nearby filenames + gap type
   • Never sends full file source to LLM
   • Returns edges with confidence score
   • Edges below 0.70 confidence are not added — flagged as unknown
2. If dynamic require found with no annotation — ask dev to add: // @wednesday-skills:connects-to →
3. If global injection found — ask dev to add: // @wednesday-skills:global →
4. After annotation added: run wednesday-skills analyze --incremental
5. Report new coverage % to dev

Never

• Spawn subagent on files with risk score < 50 — not worth cost
• Send full file source to subagent — exports list and filenames only
• Add edges with confidence below 0.70 to the graph
• Run fill-gaps on the whole codebase at once — file by file only

Tools

Use Bash tool to run:

• wednesday-skills fill-gaps --file <file> --min-risk 50
• wednesday-skills analyze --incremental Use Read tool for:
• .wednesday/codebase/dep-graph.json — read nodes["<file>"].gaps

Do NOT use

Do not read the full file source before running fill-gaps. Do not run fill-gaps without --min-risk flag.