Agent skill

manage-principles

Manage and update project Constitution. Use when (1) Constitution violation detected during implementation, (2) proposing new architectural principle, (3) templates need sync after Constitution update, (4) reviewing project architecture rules.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/manage-principles

SKILL.md

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: manage-principles 호출 - {작업 유형} 시스템 메시지를 첫 줄에 출력하세요.

manage-principles Skill

Purpose: Project Constitution management with violation detection and template synchronization

When to Use

Agents should invoke this skill when:

  • Constitution violation detected during implementation
  • New development pattern needs to be codified
  • Existing principle requires clarification or update
  • Team standard conflicts with Constitution
  • User explicitly requests Constitution changes

Quick Start

1. Analyze Current State

bash
# Read Constitution
cat .specify/memory/constitution.md

2. Detect Context Type

Type Description Action
Violation Code conflicts with principle Fix code OR amend
Gap Pattern not covered Draft new principle
Clarification Principle ambiguous Add clarifying language
Update Principle needs refinement Show before/after

3. Propose & Apply

  1. Generate proposal with rationale
  2. Present for user approval
  3. Update Constitution with version bump
  4. Synchronize dependent templates
  5. Validate consistency

Usage Examples

javascript
// Violation detected
skill: constitution({ type: "violation", principle: "VII", context: "RPC uses 'as unknown as Type'" });

// New pattern needs codification
skill: constitution({ type: "gap", proposal: "Add error boundary principle" });

// Clarification needed
skill: constitution({ type: "clarification", principle: "II", question: "SSR-First for admin panels?" });

Principle Categories

Category Principles Amendment
NON-NEGOTIABLE I, II, III, VII, VIII Requires strong rationale
FLEXIBLE IV, V, VI, IX Exceptions with justification

Dependencies

  • .specify/memory/constitution.md - Primary source
  • .claude/commands/help.md - User-facing guide
  • .claude/commands/speckit.*.md - Template references

Related Skills

  • verify - Uses Constitution for validation
  • implement - Follows Constitution principles
  • spec - References Constitution in planning

References

For detailed documentation, see:

Didn't find tool you were looking for?

Be as detailed as possible for better results