Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Pisanie

constitution:amend

/constitution:amend

Zmienia konstytucję projektu z wersjonowaniem semantycznym i dziennikiem zmian, a potem odświeża listę kontrolną.

Repozytorium
agent-foundry ↗
Licencja
MIT
Ostatnia zmiana repozytorium
16.08.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format15 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 16.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zmienia konstytucję projektu z wersjonowaniem semantycznym i dziennikiem zmian, a potem odświeża listę kontrolną.

Wyzwalacze z opisu

amend constitutionupdate constitution versionadd principlemodify governance rules
Oryginalny opis (EN)

Amend project constitution with semantic versioning and changelog management. Use when user asks to "amend constitution", "update constitution version", "add principle", or "modify governance rules". Automatically regenerates checklist.

Jak działa

  1. Goal
  2. Workflow
  3. Edge Cases
  4. Version Decision Tree
  5. Anti-Patterns
Sekcje z nagłówków SKILL.md, w oryginale · 232 linii, 647 słów
Podgląd SKILL.md
---
name: constitution:amend
description: |
  Amend project constitution with semantic versioning and changelog management.
  Use when user asks to "amend constitution", "update constitution version",
  "add principle", or "modify governance rules". Automatically regenerates checklist.
---

# Constitution Amendment Skill

You are amending a project's CONSTITUTION.md with version tracking.

## Goal

Update constitutional principles with semantic versioning, maintain changelog (newest first), and automatically regenerate the implementation checklist.

## Workflow

### 1. Find Constitution & Parse Version

Search for CONSTITUTION.md:
1. Current directory
2. Parent directories
3. Git root

Parse version from footer:
```
*Version: X.Y.Z*
```

If not found: Assume `1.0.0`

### 2. Gather Amendment Details

**Interactive prompts:**

**Prompt 1: Amendment Type**
```
What type of amendment?

1. MAJOR - Breaking change (removes/fundamentally changes core principles)
2. MINOR - Additive change (adds new principles)
3. PATCH - Clarification (typo fixes, wording improvements)

Choice [1-3]:
```

**Prompt 2: Change Description**
```
Describe the changes (2-5 sentences):
```

**Prompt 3: Migration Notes** (skip for PATCH)
```
Migration guidance for existing code (what needs to change?):
```

**Prompt 4: Rationale**
```
Why is this amendment necessary?
```

### 3. Increment Version

**Rules:**
- **MAJOR**: X+1.0.0 (e.g., 2.3.1 → 3.0.0)
  - Removes principles
  - Fundamentally changes core requirements
  - Example: "Remove TDD requirement"

- **MINOR**: X.Y+1.0 (e.g., 2.3.1 → 2.4.0)
  - Adds new principles
  - Expands requirements
  - Example: "Add security audit requirement"

- **PATCH**: X.Y.Z+1 (e.g., 2.3.1 → 2.3.2)
  - Clarifies existing principles
  - Fixes typos
  - Example: "Clarify test coverage metric"

### 4. Render Amendment Entry

Load template from:
```
${CLAUDE_PLUGIN_ROOT}/plugins/constitution/skills/amend/templates/amendment.template.md
```

Replace placeholders:
- `{{new_version}}` → Calculated version (e.g., "2.4.0")
- `{{amendment_date}}` → Today's date (YYYY-MM-DD format)
- `{{amendment_type}}` → MAJOR/MINOR/PATCH
- `{{change_description}}` → User input
- `{{migration_notes}}` → User input (or "N/A" for PATCH)
- `{{rationale}}` → User input

**Rendering:** Simple string replacement (no external dependencies)

### 5. Update Changelog

**Find or create changelog section:**

Look for:
```markdown
## Changelog
```

If not found, insert after preamble (before first `##` principle):
```markdown

## Changelog

### Version {{new_version}} - {{amendment_date}}

**Type**: {{amendment_type}}

**Changes**:
{{change_description}}

**Migration Notes**:
{{migration_notes}}

**Rationale**:
{{rationale}}

---
```

**If found:**
Insert rendered entry **immediately after** `## Changelog` header (newest first):

```markdown
## Changelog

### Version 2.4.0 - 2026-01-25
...

### Version 2.3.0 - 2026-01-20
...
```

### 6. Update Footer

Find footer (last 3 lines typically):
```markdown
---

*Last amended: YYYY-MM-DD*
*Version: X.Y.Z*
```

Update:
- `Last amended:` → Today's date
- `Version:` → New version

If no footer exists, append:
```markdown

---

*Last amended: 2026-01-25*
*Version: 2.4.0*
```

### 7. Regenerate Checklist

**Automatically invoke checklist generator:**

Output instruction:
```
Amendment complete. Now regenerating checklist to reflect updated principles...
```

Then instruct Claude:
```
Please run the constitution:checklist-generator skill to update the implementation checklist based on the amended constitution.
```

(Skills cannot directly invoke other skills, so this is an instruction for Claude to execute next)

### 8. Report Summary

Output:
```
✓ Constitution amended successfully

Version: 1.2.3 → 2.0.0
Type: MAJOR
Date: 2026-01-25

Changelog entry added (3 total entries)
Footer updated
Checklist regeneration requested

⚠️  MAJOR version change detected!
Review existing code for compliance with updated principles.

Migration notes:
[User's migration guidance]
```

## Edge Cases

**No constitution found:** Error with "Run constitution:writer first"

**Invalid version format:** Assume 1.0.0 and add warning

**Changelog placement:** If unclear structure, add section at end (before footer)

**Empty migration notes:** Use "N/A" for PATCH, require for MAJOR/MINOR

## Version Decision Tree

```
Amendment removes principles? → MAJOR
Amendment changes core requirements fundamentally? → MAJOR
Amendment adds new principles? → MINOR
Amendment expands scope? → MINOR
Amendment clarifies existing wording? → PATCH
Amendment fixes typos? → PATCH
```

**When uncertain:** Ask user to confirm type before proceeding

## Anti-Patterns

❌ **Don't:**
- Manually edit checklist (let generator handle it)
- Put oldest changelog entry first (newest on top)
- Skip migration notes for breaking changes
- Use PATCH for additive changes
- Forget to update footer

✅ **Do:**
- Always regenerate checklist after amendment
- Maintain newest-first changelog order
- Provide clear migration guidance
- Use semantic versioning correctly
- Commit constitution and checklist together
Pliki w paczce (2)
  • SKILL.md 5 KB
  • templates/amendment.template.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie constitution:amend.

Migawka bazy z 13.11.2026 · wersja paczki 6caeb5bacefa (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95project-principles
    Tworzy lub zmienia dokument zasad projektu, czyli niepodważalne reguły, bramki jakości i zarządzanie zmianami z numerem wersji.
  • 100constitution
    Zapisuje reguły, których musi przestrzegać każda funkcja projektu, lub je zmienia: zasady, konstytucję, rzeczy niedozwolone w kodzie, przy starcie pracy od specyfikacji w projekcie bez specs/constitution.md.
  • 90constitution:checklist-generator
    Zamienia konstytucję projektu w od 6 do 12 praktycznych punktów listy kontrolnej, bez powtórzeń.
  • 90kickstart-constitution
    Tworzy i zmienia konstytucję projektu, czyli krótki zbiór zasad MUST i SHOULD sprawdzany przy każdej specyfikacji i zmianie.
  • 90constitution:writer
    Pisze konstytucję projektu dopasowaną do skali, ryzyka i zespołu, po pytaniach o architekturę i standardy kodowania.
  • 85sage-constitution
    Przypomina zasady inżynierskie projektu i obowiązkowe reguły procesu, gdy trzeba sprawdzić, co jest dozwolone.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.