apex-decompose
APEX Decompose
Break down features from a source codebase into detailed, implementation-ready specifications that an agent can use to rebuild them in a new architecture.
When to Use
Use this skill when you need to understand what existing code does before rewriting it. This is the first step in any replatforming or migration workflow. The output is a specification document, not code.
Workflow
Decomposing a feature involves these steps:
- Identify the feature scope (files, modules, entry points)
- Analyze behavior and contracts (inputs, outputs, side effects)
- Extract implicit knowledge (edge cases, error handling, config dependencies)
- Generate the specification document
- Validate the spec against the source
Step 1: Identify Feature Scope
More from othmanadi/apex
apex-learn
Trigger the self-improvement loop after completing a task. Analyzes friction, extracts learnings, and updates AGENTS.md with new rules and preferences. Use after any task that involved struggle, correction, or discovery of a new pattern. Triggers on keywords like learn, self-improve, update rules, what did I learn, retrospective, post-mortem.
2apex-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-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