Agent skill
brownfield-fix
Use before editing any file in a brownfield project. Runs risk check and blast radius before making any change.
Install this agent skill to your Project
npx add-skill https://github.com/wednesday-solutions/ai-agent-skills/tree/main/skills/brownfield-fix
SKILL.md
When to use
- About to edit, refactor, rename, or delete any file
- About to change a function signature or exported value
- Dev asks "is it safe to change X"
- The file you're about to edit has gaps in dep-graph.json (dynamic require, event emitters, global injection)
What to do
- Run: wednesday-skills score
- Score 0–30: proceed
- Score 31–60: tell dev the score, proceed with care
- Score 61–80: tell dev, list direct dependents, ask confirmation
- Score 81–100: stop, tell dev, require explicit approval
- Run: wednesday-skills blast
- Include dependent count in your response
- Cross-language dependents flagged separately
- Check .wednesday/codebase/MASTER.md danger zones section
- If file listed there: read the warning before proceeding
3a. If the file shows gaps in
.wednesday/codebase/dep-graph.json, runwednesday-skills fill-gaps --file <file> --min-risk 50first — ensures blast radius is complete
- If file listed there: read the warning before proceeding
3a. If the file shows gaps in
- Make the change
- Read git-os skill before writing commit message
- After committing: post-commit hook updates graph automatically
Never
- Skip the score check — even for "small" changes
- Modify a file with risk score > 80 without explicit dev confirmation
- Bundle fixes to multiple high-risk files in one commit
- Ignore danger zones section warnings
Tools
Use Bash tool to run:
wednesday-skills score <file>— get risk scorewednesday-skills blast <file>— get blast radius Use Read tool for:.wednesday/codebase/MASTER.md— check danger zones section
Do NOT use
Do not skip score check for any file edit. Do not read raw source to assess risk — use the graph only.
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?