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-semicolon-devteam-semo
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
- Generate proposal with rationale
- Present for user approval
- Update Constitution with version bump
- Synchronize dependent templates
- 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 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
Didn't find tool you were looking for?