Agent skill

brownfield-fix

Use before editing any file in a brownfield project. Runs risk check and blast radius before making any change.

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-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

  1. 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
  2. Run: wednesday-skills blast
    • Include dependent count in your response
    • Cross-language dependents flagged separately
  3. 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, run wednesday-skills fill-gaps --file <file> --min-risk 50 first — ensures blast radius is complete
  4. Make the change
  5. Read git-os skill before writing commit message
  6. 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 score
  • wednesday-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.

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