aped-claude

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

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-claude
Or copy as Structured Prompt for Agent
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 <!-- APED:START --> and <!-- APED:END --> 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.