# 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.

- Skill: `majiayu000/manage-principles` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/manage-principles`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/manage-principles/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/manage-principles

---


> **🔔 시스템 메시지**: 이 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:

- [Amendment Process](references/amendment-process.md) - 5-phase workflow, violation handling
- [Principles Guide](references/principles-guide.md) - Structure, categories, versioning
- [Output Format](references/output-format.md) - Report templates, examples, error handling