lens-constitution

Resolves and merges 4-level governance constitution hierarchies to validate feature compliance.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/crisweber2600/Lens.Core.Src --skill lens-constitution-crisweber2600
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lens-constitution
Source: https://github.com/crisweber2600/Lens.Core.Src/tree/main/_bmad/lens-work/skills/lens-constitution
Command: npx skills add https://github.com/crisweber2600/Lens.Core.Src --skill lens-constitution-crisweber2600

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Teams with layered governance rules (org, domain, service, repo) struggle to know which rules actually apply to a given feature scope, and whether a feature satisfies them before promotion. This Skill resolves the effective ruleset through additive inheritance and checks feature artifacts against it. ## Core Features & Use Cases - Rule Resolution: Merges constitution files across org → domain → service → repo levels using field-specific strategies (intersection for permitted tracks, union for required artifacts, strongest-wins for gate modes). - Compliance Checking: Validates a feature's track and required artifacts against the resolved constitution, returning PASS/FAIL per check with hard vs informational gate severity. - Progressive Display: Returns only the rules relevant to the current phase and track so feature authors are not overwhelmed by irrelevant governance requirements. - Use Case: Before promoting a feature from planning to dev, run a compliance check to confirm the business-plan and tech-plan artifacts exist and the chosen track is permitted at every governance level. ## Quick Start Ask the assistant to resolve the governance rules for domain platform and service auth using the configured governance repo, then check my feature's compliance for the planning phase.

Frequently Asked Questions about lens-constitution

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

FAQPage Schema
How do I resolve governance rules for a feature scope?

Run the resolve subcommand of constitution-ops.py with the governance repo path plus domain, service, and optionally repo slugs. It merges constitution files from org down to repo level and outputs the effective ruleset as JSON.

How do I check feature compliance against a constitution?

Use the check-compliance subcommand with the feature.yaml path, artifacts directory, and target phase. It verifies the track is permitted and required artifacts exist, returning PASS, INCOMPLETE, or FAIL with per-check gate severity.

How are conflicting constitution rules merged across levels?

Each field merges differently: permitted_tracks uses intersection, required_artifacts and review participants use union, and gate_mode plus enforce flags use strongest-wins. Lower levels can only add constraints, never remove higher-level requirements.

What happens if a constitution file is missing at a level?

Missing domain, service, or repo constitutions are silently skipped and defaults apply. A missing org constitution is a hard error because org-level defaults are required for resolution.

What is the difference between hard and informational gate modes?

Informational gate failures are reported but exit with code 0 and do not block the workflow. Hard gate failures exit with code 2, signaling that workflow promotion should be blocked until requirements are satisfied.