Elicitation Skill
Purpose
Enable expert agents to self-review and self-correct their code before external validation (sniper). Based on BMAD-METHOD's 75 elicitation techniques.
3 Execution Modes
Mode 1: MANUAL (default)
Expert presents 5 relevant techniques → User chooses → Expert applies
Mode 2: AUTO (--auto)
Expert auto-detects code type → Auto-selects techniques → Applies silently
Mode 3: SKIP (--skip)
Skip elicitation → Go directly to sniper validation
Quick Start
After Execute phase, expert runs:
# Manual mode (default)
> Apply elicitation skill
# Auto mode (no prompts)
> Apply elicitation skill --auto
# Skip self-review
> Apply elicitation skill --skip
Workflow Overview
┌─────────────────────────────────────────────────────────┐
│ ELICITATION WORKFLOW │
│ │
│ Step 0: Init → Load context │
│ Step 1: Analyze Code → Detect code type │
│ Step 2: Select → Choose techniques (or auto) │
│ Step 3: Apply Review → Execute techniques │
│ Step 4: Self-Correct → Fix own issues │
│ Step 5: Report → Summary before sniper │
└─────────────────────────────────────────────────────────┘
Auto-Detection Matrix
| Code Type Detected | Auto-Selected Techniques | |--------------------|--------------------------| | Authentication/Security | Security Audit, OWASP Check, Input Validation | | API Endpoints | Error Handling, Type Coverage, API Contracts | | Database/ORM | N+1 Detection, Migration Safety, Data Integrity | | UI Components | Accessibility, Edge Cases, Loading States | | Business Logic | SOLID Compliance, Unit Test Coverage, Edge Cases | | Refactoring | Breaking Changes, Regression Analysis, Backward Compat | | Performance Critical | Profiling, Memory Analysis, Complexity Check |
Technique Categories (12)
Full catalog: references/techniques-catalog.md
- Code Quality (7): Code review, Pattern detection, Complexity analysis...
- Security (7): OWASP audit, Input validation, Auth check...
- Performance (6): Profiling, N+1 detection, Memory analysis...
- Architecture (6): SOLID check, Dependency analysis, Coupling review...
- Testing (6): Edge cases, Boundary testing, Error paths...
- Documentation (6): API review, Comment check, Type coverage...
- UX (6): Accessibility, Error messages, Loading states...
- Data (6): Schema validation, Migration safety, Data integrity...
- Concurrency (6): Race conditions, Deadlock analysis, State sync...
- Integration (7): API contracts, Backward compat, Breaking changes...
- Observability (6): Logging, Metrics, Error tracking...
- Maintainability (6): Readability, Naming, File organization...
Total: 75 techniques
Integration with APEX
A-nalyze → P-lan → E-xecute → [ELICIT] → X-amine
│ │ │
▼ ▼ ▼
Expert Expert sniper
code self-review (final)
Benefits:
- Expert catches own mistakes before sniper
- Faster validation (less sniper corrections)
- Knowledge retention (expert learns from self-review)
Forbidden
- ❌ Skip init step (must load context)
- ❌ Apply techniques without understanding code type
- ❌ Self-correct without documenting changes
- ❌ Report without listing applied techniques
- ❌ Use techniques outside expertise domain
Steps Reference
| Step | File | Purpose |
|------|------|---------|
| 0 | steps/step-00-init.md | Load context, detect mode |
| 1 | steps/step-01-analyze-code.md | Analyze written code |
| 2 | steps/step-02-select-techniques.md | Select techniques |
| 3 | steps/step-03-apply-review.md | Apply review |
| 4 | steps/step-04-self-correct.md | Self-correct |
| 5 | steps/step-05-report.md | Generate report |