Enforces architecture boundaries defined in PLAN.md. An agent skill from wednesday-solutions/ai-agent-skills.

MITAuto-check passedBackend & APIs

Install Brownfield Drift

skills CLI
$ npx skills add wednesday-solutions/ai-agent-skills --skill brownfield-drift -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wednesday-solutions/ai-agent-skills brownfield-drift --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wednesday-solutions/ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brownfield-drift .claude/skills/brownfield-drift && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brownfield-drift
GitHub stars
170
Token cost
~669 tokens
SKILL.md length
226 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Enforces architecture boundaries defined in PLAN.md. An agent skill from wednesday-solutions/ai-agent-skills.

  • Works in 4 steps: Run wednesday-skills drift via Bash tool → Report violations with → For PR reviews: run wednesday-skills… → …
  • A PR crosses module/service boundaries
  • SKILL.md covers When to use, When NOT to use, What to do and Adding constraints to PLAN.md, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brownfield Drift is an agent skill from wednesday-solutions/ai-agent-skills. Enforces architecture boundaries defined in PLAN.md. Use when a PR crosses module/service boundaries, when the dev asks "are we following the architecture?", or as a scheduled architecture health check. Not for querying what a module does — use brownfield-chat for that.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Microservices. The repository describes itself as: Pre-configured agent skills for Vibe Coded projects. These skills provide AI coding assistants (Claude Code, Cursor, etc.) with specific guidelines for code quality and design… The licence is MIT.

When your agent uses it

  • A PR crosses module/service boundaries
  • The dev asks are we following the architecture?
  • As a scheduled architecture health check

Example prompts

  • “are we following the architecture?”
  • “Use the brownfield-drift skill to enforce architecture boundaries defined in PLAN.md. An agent skill from wednesday-solutions/ai-agent-skills”
  • “/brownfield-drift”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run wednesday-skills drift via Bash tool
  2. Report violations with
  3. For PR reviews: run wednesday-skills drift --since to only report new violations
  4. For a single rule: wednesday-skills drift --rule

What it can do on your machine

Read from SKILL.md and the folder at commit 80fa195. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brownfield Drift loads about 669 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 226 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~669

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wednesday-solutions/ai-agent-skills at commit 80fa195, republished under its MIT licence (© wednesday-solutions). 226 words, ~669 tokens.

Download SKILL.mdSave it as .claude/skills/brownfield-drift/SKILL.md (or your agent's skills folder).
name
brownfield-drift
description
Enforces architecture boundaries defined in PLAN.md. Use when a PR crosses module/service boundaries, when the dev asks "are we following the architecture?", or as a scheduled architecture health check. Not for querying what a module does — use brownfield-chat for that.
permissions.allow
Bash(wednesday-skills drift *), Bash(git log *)

When to use

  • Dev asks "are we following the architecture?" or "is this a valid change?"
  • PR touches files near module boundaries or service interfaces
  • Weekly architecture health check
  • Any cross-service import was just added

When NOT to use

  • "What does module X do?" → use brownfield-chat
  • "What breaks if I change X?" → use brownfield-chat
  • Graph coverage is low on a file → use brownfield-fix (it fills gaps before editing)
  • No PLAN.md exists — drift requires machine-readable boundaries in PLAN.md

What to do

  1. Run wednesday-skills drift via Bash tool
  2. Report violations with:
    • The specific edge that violates the rule
    • The commit that introduced it (when available)
    • The suggested fix per PLAN.md intent
  3. For PR reviews: run wednesday-skills drift --since <base-commit> to only report new violations
  4. For a single rule: wednesday-skills drift --rule <rule-name>

Adding constraints to PLAN.md

If the project has no constraints block, add one to PLAN.md:

json
{
  "boundaries": [
    {
      "rule": "frontend-never-imports-db",
      "description": "Frontend components must never import DB layer directly",
      "from": "src/app/**",
      "to": "src/lib/db/**",
      "type": "forbidden"
    },
    {
      "rule": "no-circular-deps",
      "description": "No circular dependencies anywhere",
      "scope": "**",
      "type": "no-cycle"
    }
  ]
}

Violation types

TypeWhat it catches
forbiddenImport from A → B that should never exist
ownershipLogic pattern appearing outside its designated owner
no-direct-importDirect import between services that should use API
no-cycleCircular dependency between modules

Never

  • Auto-fix boundary violations — always ask the dev first
  • Flag existing violations on a PR that did not introduce them (use --since)
  • Run on projects without machine-readable PLAN.md constraints
  • Report the same violation twice in one review session

CLI reference

bash
wednesday-skills drift                              # full check
wednesday-skills drift --rule frontend-never-imports-db  # single rule
wednesday-skills drift --since abc1234              # new drift only (for PR review)

© wednesday-solutions, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/brownfield-drift of wednesday-solutions/ai-agent-skills.

Open the folder on GitHubat commit 80fa195

Compare with similar skills

Brownfield Drift next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brownfield Drift compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brownfield Drift this skillwednesday-solutions/ai-agent-skills170—~669Automated safety check: PassMIT
Node Backend Development Guidelinesdiet103/claude-code-infrastructure-showcase10k2 repos~2kAutomated safety check: PassMIT
Nodejs Backend Patternsever-works/ever-works16218 repos~4kAutomated safety check: PassAGPL-3.0
AWS Serverless Edazxkane/aws-skills3674 repos~3.2kAutomated safety check: PassMIT
Golang Proantoniopaya22/go-rest-template1723 repos~1.2kAutomated safety check: PassMIT
Dr Jskilljdubois/dr-jskill342—~4.6kAutomated safety check: NotesApache-2.0

Similar skills

  • Node Backend Development Guidelines

    diet103/claude-code-infrastructure-showcase

    Sets layered architecture and coding rules for Node.js, Express and TypeScript microservices, covering routes, controllers, services, repositories, Prisma, Sentry and Zod.

    10k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    162 GitHub starsUsed in 18 repos~4k tokens
    Backend & APIsAuto-check passed
  • AWS Serverless Eda

    zxkane/aws-skills

    AWS serverless and event-driven architecture expert based on Well-Architected Framework.

    367 GitHub starsUsed in 4 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Golang Pro

    antoniopaya22/go-rest-template

    Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with…

    172 GitHub starsUsed in 3 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Dr Jskill

    jdubois/dr-jskill

    Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker.

    342 GitHub stars~4.6k tokensUpdated 11 days ago
    Backend & APIsAuto-check: notes
  • Hybrid Cloud Test Gen

    getsentry/sentry

    Official

    Generate hybrid cloud tests for the Sentry codebase. An agent skill from getsentry/sentry.

    46k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed

More from wednesday-solutions/ai-agent-skills

All 10 skills in this repo
  • Greenfield

    wednesday-solutions/ai-agent-skills

    Parallel persona planning for new projects. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~914 tokensUpdated 4 mo ago
    Auto-check passed
  • PR Review

    wednesday-solutions/ai-agent-skills

    Fix engine for PR review comments. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~661 tokensUpdated 4 mo ago
    Auto-check passed
  • Standards Kit

    wednesday-solutions/ai-agent-skills

    Unified development and design standards. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~436 tokensUpdated 4 mo ago
    Auto-check passed
  • Wednesday Git

    wednesday-solutions/ai-agent-skills

    Unified Git workflow. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~702 tokensUpdated 4 mo ago
    Auto-check passed
  • Module Audit Agent

    wednesday-solutions/ai-agent-skills

    A skill your agent uses when asked to audit a module, check its health, or assess whether it should be refactored.

    170 GitHub stars~438 tokensUpdated 4 mo ago
    Auto-check passed
  • Onboard Dev Agent

    wednesday-solutions/ai-agent-skills

    A skill your agent uses when a dev is new to the project, asks for an overview, or wants to get oriented quickly.

    170 GitHub stars~445 tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Brownfield Drift

What does Brownfield Drift do?

Enforces architecture boundaries defined in PLAN.md. An agent skill from wednesday-solutions/ai-agent-skills. Brownfield Drift is an agent skill from wednesday-solutions/ai-agent-skills.md.

When should I use Brownfield Drift?

Brownfield Drift fits situations like: A PR crosses module/service boundaries; the dev asks are we following the architecture?; as a scheduled architecture health check.

How do I install Brownfield Drift in Claude Code?

Run `npx skills add wednesday-solutions/ai-agent-skills --skill brownfield-drift -a claude-code`. Or copy the skill folder (skills/brownfield-drift in wednesday-solutions/ai-agent-skills) into .claude/skills/brownfield-drift in your project. Claude Code loads it when a task matches its description.

How do I install Brownfield Drift in Codex?

Run `npx skills add wednesday-solutions/ai-agent-skills --skill brownfield-drift -a codex`. Or copy the skill folder (skills/brownfield-drift in wednesday-solutions/ai-agent-skills) into .agents/skills/brownfield-drift in your project. Codex loads it when a task matches its description.

Can I use Brownfield Drift in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wednesday-solutions/ai-agent-skills --skill brownfield-drift -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brownfield-drift, .gemini/skills/brownfield-drift, .github/skills/brownfield-drift and .opencode/skills/brownfield-drift in your project.

What does Brownfield Drift need to run?

SKILL.md names no scripts, command-line tools or credentials: Brownfield Drift is instructions for the agent only.

Does Brownfield Drift access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brownfield Drift safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brownfield Drift use?

Brownfield Drift is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brownfield Drift use?

About 669 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brownfield Drift?

Skills that share tags, products or a category with Brownfield Drift: Node Backend Development Guidelines (diet103/claude-code-infrastructure-showcase, 10k stars), Nodejs Backend Patterns (ever-works/ever-works, 162 stars), AWS Serverless Eda (zxkane/aws-skills, 367 stars) and Golang Pro (antoniopaya22/go-rest-template, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brownfield Drift?

wednesday-solutions (a GitHub organization) maintains it in wednesday-solutions/ai-agent-skills, which has 170 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on May 26, 2026.

Source: wednesday-solutions/ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.