aped-claude

Synchronize APED rules within CLAUDE.md using marker-based merging.

2|Updated Mar 12, 2026

Search Tags:#claude #claude.md #project scaffolding #prompt rules #smart merge #dev pipeline #user-gated changes

Ready to run

npx skills add https://github.com/yabafre/aped-claude --skill aped-claude

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: aped-claude
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-claude
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-claude

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents CLAUDE.md from drifting out of alignment with the APED Method by ensuring the APED-managed rules are injected and refreshed without overwriting user-authored content.

Core Features & Use Cases

Smart merge into CLAUDE.md: Updates only the APED-managed block while preserving any user customizations outside the APED markers.
Marker-based control: Uses  and  to reliably locate and refresh the managed section.
User-safe gating: Halts/requests confirmation when CLAUDE.md is non-trivial, reducing the risk of unintended rule changes; also ensures required enablement checks run first.

Quick Start

Run aped-claude and follow the confirmation prompts to create or refresh the APED block inside your project’s CLAUDE.md.

Frequently Asked Questions about aped-claude

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I update rules in CLAUDE.md without overwriting my custom project instructions?▼

To update CLAUDE.md rules safely, use marker-based smart merging that injects APED-managed sections between start and end markers while preserving your custom content outside those boundaries.

What is the APED marked section in a project's CLAUDE.md file?▼

The APED marked section is a managed block inside CLAUDE.md, bounded by start and end markers, that stores synchronized APED Method working rules separate from your custom instructions.

How do I sync APED working rules into an existing Claude Code repository?▼

To sync APED working rules, run the aped-claude skill in your repository and follow the confirmation prompts to inject or refresh the managed block inside your CLAUDE.md file.

Does updating the CLAUDE.md prompt rules require manual confirmation for complex files?▼

Updating CLAUDE.md prompt rules requires manual confirmation when the file is non-trivial, halting the process to request user approval and reduce the risk of unintended rule changes.

What config file is needed to route language and output for CLAUDE.md rule synchronization?▼

You need an APED config.yaml file to route language and output settings before synchronizing CLAUDE.md rules, which also triggers creation of a lessons.md artefact if missing.