What are the Essential Floor requirements?

The Essential Floor consists of four non-negotiable categories every project must address: Security, Testing, Error Handling, and Observability.

What is a brownfield project in this context?

A brownfield project refers to an existing codebase that is already in development or production, as opposed to a 'greenfield' project which starts from scratch.

How does the 'Emergent Ceiling' approach work?

The Emergent Ceiling identifies high-quality patterns already existing in your codebase—such as specific naming conventions or API designs—and formalizes them into project-wide principles.

Does this skill require other plugins to work?

It extends the core 'authoring-constitution' skill and works best when combined with 'analysis-codebase' to first understand the current state of the repository.

Can this skill help with legacy code migration?

Yes, it creates an evolution roadmap and identifies gaps where the current codebase fails to meet the 'Essential Floor' standards, providing a clear path for technical debt reduction.

Brownfield Constitution Author

Name: Brownfield Constitution Author
Author: deepeshBodh

bydeepeshBodh

•

Learning & Documentation

Drafts comprehensive project constitutions for existing codebases by codifying established patterns and enforcing essential engineering standards.

The Brownfield Constitution skill enables Claude Code to systematically document and stabilize existing software projects using the 'Essential Floor + Emergent Ceiling' framework. It establishes a mandatory baseline for security, testing, error handling, and observability while simultaneously identifying and formalizing the project's unique architectural strengths. This skill is particularly valuable for teams inheriting legacy code or those looking to scale existing applications through clear governance, gap analysis, and automated enforcement rules, ensuring that technical debt is managed and future development follows a consistent evolution roadmap.

Key Features

01RFC 2119 Compliance: Utilizes standardized keywords for precise and enforceable requirement definitions.

02Gap Analysis Reporting: Automatically highlights missing capabilities and generates a structured evolution roadmap.

03Emergent Pattern Recognition: Identifies and codifies high-quality architectural patterns present in the codebase.

04Essential Floor Enforcement: Mandatory rules for security, testing, error handling, and observability.

05Sync Impact Integration: Tracks and documents the ripple effects of structural changes across the project.

067 GitHub stars

Use Cases

01Onboarding new developers to a legacy codebase with clear, documented standards.

02Establishing non-negotiable security and testing quality gates for an existing production application.

03Formalizing disparate architectural patterns into a unified governance document for scaling teams.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add deepeshbodh/human-in-loop brownfield-constitution

For use in Claude.ai and ChatGPT

Download Skill