OpenSkillIndex← back to search
claude-code

Ai-agent-skills brownfield-gaps

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.

install
source · Clone the upstream repo
git clone https://github.com/wednesday-solutions/ai-agent-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/wednesday-solutions/ai-agent-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/brownfield-gaps" ~/.claude/skills/wednesday-solutions-ai-agent-skills-brownfield-gaps && rm -rf "$T"
manifest: skills/brownfield-gaps/SKILL.md
source content

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 <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 <event> → <file>
  3. If global injection found — ask dev to add: // @wednesday-skills:global <name> → <file>
  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.