apex-learn
APEX Learn
Analyze what happened during a task, extract reusable knowledge, and persist it to AGENTS.md so the entire agent team improves over time.
When to Use
Run this skill in any of these situations:
- After completing a Tier 1, 2, or 3 task
- When the human corrected you on the same issue twice (two-strike rule)
- When you discovered a non-obvious pattern or convention
- When a task took significantly longer than expected
- When the human explicitly asks to update the rules
The Two-Strike Rule
This is the core mechanism. If you are corrected on the same type of issue twice:
- First correction — Fix the issue, note it mentally
- Second correction — Fix the issue AND run
apex-learnto add a permanent rule
More from othmanadi/apex
apex-replatform
Implement features in a new architecture using specifications from apex-decompose. Use when replatforming, migrating codebases, rebuilding features in a new framework, or translating specs into working code. Triggers on keywords like replatform, migrate, rebuild, implement spec, new architecture.
2apex-tier1
Execute well-defined tasks autonomously with zero human intervention. Fire-and-forget mode for straightforward work like adding tests, fixing lint errors, writing docs, or implementing simple features. Use when the task is clear, low-risk, and has objective pass/fail criteria. Triggers on keywords like fire and forget, autonomous task, simple fix, add tests, fix lint.
2apex-decompose
Decompose features from an existing codebase into detailed, agent-ready specifications for replatforming or migration. Use when analyzing legacy code, extracting feature behavior, mapping old architecture to new, or preparing migration specs. Triggers on keywords like decompose, analyze features, extract behavior, migration spec, map codebase.
2apex-tier2
Execute complex tasks with periodic human checkpoints. Background work with steering — the agent works autonomously but pauses at defined decision points for human input. Use for medium-complexity tasks like feature implementation, refactoring, or multi-file changes. Triggers on keywords like guided task, checkpoint, background with review, implement feature, refactor module.
2apex-tier3
Real-time pair programming mode for complex architectural work. The agent and human collaborate interactively on design decisions, complex debugging, or exploratory work. Use for high-stakes tasks, new architecture design, critical bug investigation, or when every step needs discussion. Triggers on keywords like pair, collaborate, design together, debug with me, architect, explore.
2