name: manage-principles description: 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. tools: [Read, Write, Edit] location: project
🔔 시스템 메시지: 이 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
# 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
- Generate proposal with rationale
- Present for user approval
- Update Constitution with version bump
- Synchronize dependent templates
- Validate consistency
Usage Examples
// 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 validationimplement- Follows Constitution principlesspec- References Constitution in planning
References
For detailed documentation, see:
- Amendment Process - 5-phase workflow, violation handling
- Principles Guide - Structure, categories, versioning
- Output Format - Report templates, examples, error handling