Agent skill

brownfield-query

Deterministic lookups from dep-graph.json. Use for direct structural questions about a specific file or module — what it imports, what imports it, its risk score, its exports. For multi-module or natural-language questions use brownfield-chat instead.

Stars 145
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/wednesday-solutions/ai-agent-skills/tree/main/skills/brownfield-query

SKILL.md

Deprecated: This skill has been merged into brownfield-chat, which handles all structural codebase questions including single-file lookups. Use brownfield-chat instead.

When to use

  • "What does src/auth/token.js export?"
  • "What files import userService?"
  • "What is the risk score for db/queries.js?"
  • "Show me the direct dependencies of this specific file"
  • You need a deterministic answer from one or two graph nodes

When NOT to use

  • Multi-module or cross-cutting questions → use brownfield-chat
  • "What breaks if I change X" spanning many files → use brownfield-chat
  • Architecture overview questions → use brownfield-chat or read MASTER.md

What to do

  1. Read .wednesday/codebase/dep-graph.json for the file in question
  2. Read .wednesday/codebase/summaries.json for its cached summary
  3. For architecture questions read .wednesday/codebase/MASTER.md
  4. For conflict questions read .wednesday/codebase/analysis/conflicts.json
  5. Answer from graph data — cite the risk score and blast radius count in your response so the dev understands the weight of the answer

Never

  • Read raw source files to answer structural questions
  • Guess at relationships — only state what the graph shows
  • Load the full dep-graph.json into context — query only the relevant node and its direct edges
  • Answer from memory if dep-graph.json exists — always read fresh

Tools

Use the Read tool to query specific fields from these files:

  • .wednesday/codebase/dep-graph.jsonnodes["<file>"]
  • .wednesday/codebase/summaries.json["<file>"]
  • .wednesday/codebase/MASTER.md → full read
  • .wednesday/codebase/analysis/conflicts.json → full read

Do NOT use

Do not read raw source files (*.ts, *.js, *.go) to answer structural questions. Do not load the entire dep-graph.json — read only the relevant node.

Expand your agent's capabilities with these related and highly-rated skills.

wednesday-solutions/ai-agent-skills

wednesday-design

Design and UX guidelines for Wednesday Solutions projects. Covers visual design tokens, animation patterns, component standards, accessibility, and user experience best practices for React/Next.js applications. ENFORCES use of approved component libraries only.

145 15
Explore
wednesday-solutions/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.

145 15
Explore
wednesday-solutions/ai-agent-skills

onboard-dev-agent

Use when a dev is new to the project, asks for an overview, or wants to get oriented quickly. Fills graph gaps then runs a guided codebase interview.

145 15
Explore
wednesday-solutions/ai-agent-skills

pr-review-agent

Full PR review orchestrator. Use when asked to review a PR or check if it is ready to merge. Runs blast radius + drift check on changed files, then hands off to pr-review for comment triage and fixes. Do NOT use pr-review directly for full reviews — use this.

145 15
Explore
wednesday-solutions/ai-agent-skills

module-audit-agent

Use when asked to audit a module, check its health, or assess whether it should be refactored. Runs structural query, risk check, and test generation automatically.

145 15
Explore
wednesday-solutions/ai-agent-skills

deploy-checklist

Pre-deploy and post-deploy checklist skill. Ensures env vars, migrations, CI, rollback plan, smoke tests, and monitoring are verified before and after every deployment.

145 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results