Promote

Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement.

Development / Engineeringdevelopmentengineering
by AgentVoltv1.0.0Published 1y ago1 install
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

PromptThis merge-before-deploy pattern works. Make it permanent team rule.
Beforegeneric AI agent
The promote concept lets you capture a working pattern from your session notes and move it into permanent configuration so it becomes a standard practice. This would involve documenting the pattern and adding it to your codebase rules. Over time, this helps ensure consistent behavior across your team without needing to re-explain the same guideline repeatedly. I could help you draft the documentation.
Afterwith Promote
PROMOTION WORKFLOW: Session pattern to permanent rule

CURRENT STATE: Pattern documented in auto-memory at .claude/projects///-/memory/MEMORY.md (this session only, expires next session).

STEP 1 - EXTRACT: Copy the exact pattern from MEMORY.md:
"Before pushing any branch, always run local tests first. Never force-push to main/master. Rebase after merging if release branch has moved."

STEP 2 - PROMOTE TO CLAUDE.md: Add new section
CLAUDE.md (checked into repo, survives all sessions, all team members see it).

STEP 3 - PROMOTE TO .claude/rules/: Create file
.claude/rules/merge-before-deploy.md (enforces on every AI interaction, gated by hook system). Git-committed so it blocks everyone, not just you.

OUTPUT ARTIFACT: Updated CLAUDE.md + new rule file + git commit message ready to push.

NOTE: Once promoted, all future sessions see this rule automatically. Team members who clone the repo get it too. If you need to refine the rule, edit CLAUDE.md and re-commit; rules don't auto-update mid-session (next session picks up changes).

WHY: MEMORY.md is transient (session-scoped). CLAUDE.md is codebase-scoped (all sessions, team visibility). Rules/ are enforcement-scoped (system hooks running on every Claude action). Promotion sequence ensures escalating visibility.

About this skill


name: promote description: Use when Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement.

Promote

Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement. Use when the user runs /si:promote or asks to make a learned behavior permanent.

What you get

  • Public GitHub repo (alirezarezvani/claude-skills)
  • the promote skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.

Customize your output

  • Fork the repo and adapt the skill's instructions and references to your workflow.

Example output

Activates automatically when your request matches Promote; chains with the other skills, agents, and commands in the collection.

Best for

Creators, builders, and teams using Claude Code.

SKILL.md preview

SKILL.md
---
name: promote
description: Use this skill when a proven behavior recorded in auto-memory should be graduated into CLAUDE.md or a project rule file for permanent enforcement.
version: 1.0.0
category: Development / Engineering
author: AgentVolt
license: proprietary
tags:
  - development
  - engineering
---

# Promote

Graduates a proven pattern recorded in auto-memory (MEMORY.md) into CLAUDE.md or a project rule file for permanent enforcement.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill

More development skills

View all Development skills →