Back to list
semicolon-devteam

manage-principles

by semicolon-devteam

SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework Monorepo

1🍴 0📅 Jan 22, 2026

SKILL.md


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

TypeDescriptionAction
ViolationCode conflicts with principleFix code OR amend
GapPattern not coveredDraft new principle
ClarificationPrinciple ambiguousAdd clarifying language
UpdatePrinciple needs refinementShow 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

CategoryPrinciplesAmendment
NON-NEGOTIABLEI, II, III, VII, VIIIRequires strong rationale
FLEXIBLEIV, V, VI, IXExceptions with justification

Dependencies

  • .specify/memory/constitution.md - Primary source
  • .claude/commands/help.md - User-facing guide
  • .claude/commands/speckit.*.md - Template references
  • verify - Uses Constitution for validation
  • implement - Follows Constitution principles
  • spec - References Constitution in planning

References

For detailed documentation, see:

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon