skills.rest
Emrebener
EmrebenerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ss-bs-discovering-constitution

Extract codebase evidence and user intent to write CONSTITUTION.md files.

Updated May 19, 2026
Search Tags:#constitution#codebase analysis#documentation generation#project bootstrapping#interactive refinement#policy principles#CI and security
One-click install
npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-bs-discovering-constitution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ss-bs-discovering-constitution
Source: https://github.com/Emrebener/Sublime-Skills/tree/main/skills/project-bootstrap/ss-bs-discovering-constitution
Command: npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-bs-discovering-constitution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns scattered project signals (lint rules, CI gates, security/config files, and code patterns) plus what humans intend into a crisp constitution document that the team can follow consistently.

Core Features & Use Cases

  • Code-backed principle discovery: Scans repository docs, linters/formatters/type checks, CI workflows, security-relevant files, and representative source patterns to propose candidate principles.
  • Interactive principle confirmation: Asks targeted, structured questions to capture intent the code cannot reveal and to confirm severity (MUST/SHOULD) for each principle.
  • Atomic constitution writing: Produces or updates the constitution file (typically docs/CONSTITUTION.md or a configured path) safely and deterministically, including create, extend, replace, and audit drift-check flows.

Quick Start

Run the ss-bs-bootstrapping-project flow and choose the constitution slot to use ss-bs-discovering-constitution to generate docs/CONSTITUTION.md.

Frequently Asked Questions about ss-bs-discovering-constitution

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

FAQPage Schema
How do I generate a project constitution from an existing codebase?▼

A project constitution document is generated by extracting evidence from CI workflows, lint rules, and code patterns, then confirming severities through interactive questioning to safely write docs/CONSTITUTION.md.

What is a codebase constitution and when do I need one for project bootstrapping?▼

A codebase constitution is a crisp document of policy principles derived from scattered project signals. You need one during project bootstrapping to ensure the team follows consistent MUST and SHOULD rules for CI, security, and code patterns.

How do I check for drift between my codebase patterns and documented policy principles?▼

To check for drift, the Skill performs a silent diagnose mode during the audit flow, comparing extracted codebase evidence against your existing constitution principles and reporting inconsistencies before safely updating the file.

Can I extend an existing constitution file without overwriting established principles?▼

Yes, you can extend an existing constitution safely using the extend mode, which preserves current principles while appending newly discovered policies and interactively confirming their severity before atomically writing updates.

What's the best way to document CI and security policies consistently across a repository?▼

The best way to document CI and security policies is extracting configurations from repository files and code patterns, then transforming them into structured principles with confirmed MUST or SHOULD severities in a central constitution file.

Do I need to run the project bootstrapping workflow to use the constitution discovery flow?▼

Yes, you need to run the ss-bs-bootstrapping-project flow and select the constitution slot, which loads this discovery process inline to handle create, extend, replace, and audit modes for your docs/CONSTITUTION.md file.

Related Skills

Explore More Software Engineering Skills→
HomericIntelligenceHomericIntelligence
6

repo-analyze-strict

Audit repository structure, code quality, testing, security, and CI/CD with evidence-based grading.

Official
Advanced
dr-codedr-code

release-check

Run pre-release verification checks and write a versioned release assessment report.

Community
Advanced
ArvorCoArvorCo
96

constitution

Create or update a project constitution defining coding principles and governance rules.

Community
Advanced
jenticjentic
21

sdd-create-constitution

Generate mission, tech-stack, and roadmap files from repository evidence.

Official
Advanced