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.
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. Usebrownfield-chatinstead.
When to use
- "What does
src/auth/token.jsexport?" - "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
- Read .wednesday/codebase/dep-graph.json for the file in question
- Read .wednesday/codebase/summaries.json for its cached summary
- For architecture questions read .wednesday/codebase/MASTER.md
- For conflict questions read .wednesday/codebase/analysis/conflicts.json
- 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.json→nodes["<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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated 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.
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.
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.
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.
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.
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.
Didn't find tool you were looking for?