Agent Skills: manage-principles Skill

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.

UncategorizedID: semicolon-devteam/semo/manage-principles

Install this agent skill to your local

pnpm dlx add-skill https://github.com/semicolon-devteam/semo/tree/HEAD/semo-system/semo-skills/manage-principles

Skill Files

Browse the full folder contents for manage-principles.

Download Skill

Loading file tree…

semo-system/semo-skills/manage-principles/SKILL.md

Skill Metadata

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.

πŸ”” μ‹œμŠ€ν…œ λ©”μ‹œμ§€: 이 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

  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

// 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: