brownfield-guard

Validate file paths against project conventions and forbidden patterns.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/shynlee04/idumb-v2 --skill brownfield-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brownfield-guard
Source: https://github.com/shynlee04/idumb-v2/tree/main/.agent/skills%20copy/brownfield-guard
Command: npx skills add https://github.com/shynlee04/idumb-v2 --skill brownfield-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents file tree anarchy by enforcing project-specific path conventions and preventing the creation of files in disallowed locations.

Core Features & Use Cases

  • Path Validation: Checks if new or modified file paths adhere to defined project conventions.
  • Convention Enforcement: Blocks creation of files in forbidden patterns like src/lib/* or lib/*.
  • Use Case: When an agent attempts to create a new utility file in src/utils/, this skill will block the action and instruct the agent to place it within a relevant domain module instead.

Quick Start

Use the brownfield-guard skill to ensure the new file 'src/components/UserProfile.tsx' follows project path conventions.

Frequently Asked Questions about brownfield-guard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce project path conventions and prevent files from being created in disallowed locations?

Path convention enforcement validates file paths against project architecture rules and blocks creation in forbidden patterns like src/lib/* or lib/*. It ensures files are placed within relevant domain modules instead of generic utility folders, preventing file tree anarchy.

What is canonical path resolution and how does it work in code governance?

Canonical path resolution in code governance validates file locations by referencing architecture decision records and layer definitions. It checks new or modified file paths against these established project conventions to maintain structural integrity and prevent anarchy in the file tree.

How do I check for file size limits and flag files exceeding 300 lines of code for splitting?

File size validation checks file lengths and automatically flags any files exceeding 300 LOC for splitting. This code governance practice ensures individual files remain maintainable and adhere to established project size conventions.

How do I block an agent from creating utility files in src/utils/ and redirect them to domain modules?

Blocking agent file creation in src/utils/ requires convention enforcement that validates paths against forbidden patterns. When an agent attempts to create a utility file there, the validation blocks the action and instructs the agent to place it within a relevant domain module instead.

Can I use path validation to maintain brownfield code governance without external dependencies?

Yes, you can use path validation to maintain brownfield code governance without external dependencies. The validation operates by referencing architecture decision records and layer definitions internally to enforce canonical path resolution and prevent file tree anarchy.

When do I need path validation to prevent file tree anarchy in my software engineering project?

You need path validation when your project risks file tree anarchy from files created in disallowed locations. It enforces project-specific path conventions, blocks forbidden patterns, and references architecture decision records to maintain structural integrity in brownfield environments.