brownfield-constitution

Generate brownfield constitutions codifying Security, Testing, Error Handling, and Observability.

35|2|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/deepeshBodh/human-in-loop --skill brownfield-constitution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brownfield-constitution
Source: https://github.com/deepeshBodh/human-in-loop/tree/main/plugins/humaninloop/skills/brownfield-constitution
Command: npx skills add https://github.com/deepeshBodh/human-in-loop --skill brownfield-constitution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write project constitutions for existing codebases using Essential Floor + Emergent Ceiling to preserve valuable patterns while establishing governance where it is missing.

Core Features & Use Cases

  • Write full governance constitutions capturing four essential floor categories (Security, Testing, Error Handling, Observability) and emergent ceiling patterns from codebase analysis.
  • Provide structure for technology stack, quality gates, and evolution notes to guide ongoing governance.
  • Enable validation via dedicated tools (e.g., humaninloop:validation-constitution) to ensure enforceable principles.

Quick Start

Provide a brownfield constitution for an existing codebase by running this skill after completing codebase analysis.

Frequently Asked Questions about brownfield-constitution

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

FAQPage Schema
How do I establish governance for an existing codebase without losing existing conventions?

Codebase governance for existing projects is established by generating a brownfield constitution that codifies essential floor principles like Security and Testing, while explicitly preserving valuable emergent ceiling patterns already in use.

What is an essential floor and emergent ceiling pattern in codebase governance?

Essential floor principles are mandatory governance categories including Security, Testing, Error Handling, and Observability, while emergent ceiling patterns are valuable conventions discovered by analyzing the existing codebase.

How do I write a constitution for a brownfield project?

Write a brownfield constitution by analyzing the codebase, codifying the four essential floor principles, capturing emergent ceiling patterns, and structuring technology stack, quality gates, governance, and evolution notes.

Can I validate a codebase constitution to ensure principles are enforceable?

Yes, the brownfield constitution ensures enforceable governance through a structured constitution and supports optional validation via dedicated tooling like humaninloop:validation-constitution to verify enforceable principles.

When do I need a constitution for a brownfield project?

You need a brownfield constitution when an existing codebase has governance gaps, requiring codification of essential floor principles and emergent ceiling patterns to establish enforceable quality gates and technology stack standards.