Engagement Manager
Summary
Orchestrates the full engagement lifecycle from scoping through reporting, managing skill composition, evidence chains, phase transitions, and stakeholder communication. Serves as the command center that coordinates specialized security skills, enforces scope boundaries, tracks progress across kill chain phases, and ensures deliverables meet professional standards.
Domain: management
Description
Engagement Manager is the orchestration skill that manages the full penetration testing lifecycle from initial scoping through final report delivery. It coordinates skill composition across 69 security domains, manages the kill chain phase progression (recon, scan, enum, vuln, exploit, post-exp), maintains evidence chain integrity, and ensures data handoffs between phases are complete and structured. The skill handles scope boundary enforcement, critical finding notification protocols, multi-target coordination, checkpoint-based pause/resume, and standardized report generation. It serves as the command center that activates specialized skills based on target type and manages the overall engagement state.
The engagement lifecycle follows a strict progression: Rules of Engagement (RoE) review and scope definition, target enumeration and attack surface mapping, systematic vulnerability discovery, controlled exploitation with evidence capture, post-exploitation assessment, and comprehensive reporting with remediation guidance. Each phase has entry criteria, exit criteria, and required evidence artifacts. The Engagement Manager ensures no phase is skipped, all data handoffs are validated, and findings are traceable from initial detection through final report inclusion.
Critical finding management is a key responsibility. When a high-severity vulnerability is confirmed (e.g., remote code execution, credential compromise, data exposure), the Engagement Manager triggers the notification protocol within the agreed timeframe (typically 4 hours), documents the finding with full evidence, and coordinates with the client for emergency remediation without disrupting the broader engagement. Multi-target engagements require careful parallel coordination — different skills may be active simultaneously against different targets, and the Engagement Manager must track all active threads, maintain separate evidence chains per target, and prevent scope confusion.
Use Cases
- Manage a complete penetration test engagement from kickoff to report delivery with full phase tracking
- Automatically select and sequence skills based on target type using the skill composition matrix
- Track kill chain phase progress and data handoffs between phases with checkpoint validation
- Maintain evidence chain integrity across multi-skill attack scenarios with checksums and timestamps
- Generate standardized reports from collected evidence with executive summary and technical findings
- Coordinate multi-target engagements with parallel skill activation and separate evidence chains
- Enforce scope boundaries with zero violations; halt and document any scope boundary encounters
- Handle critical finding notification within the agreed-upon timeframe while maintaining engagement continuity
- Support engagement pause/resume with checkpoint-based state management for multi-day assessments
- Conduct post-engagement quality assurance: evidence completeness, finding validation, report accuracy
Core Tools
| Tool |
Category |
Purpose |
Key Command |
| orchestrator.sh |
Engagement Orchestration |
End-to-end penetration test workflow execution |
orchestrator.sh --target web --phase all |
| tool-selector.sh |
Tool Selection |
Target-to-tool mapping by attack phase and type |
tool-selector.sh --target-type web --phase recon |
| report-generator.sh |
Reporting |
Automated report generation from collected evidence |
report-generator.sh --source evidence/ --format html |
| drift-detect.sh |
Quality Assurance |
Configuration drift detection and baseline management |
drift-detect.sh --create-baseline |
Methodology
- Scope & Plan — Define target, scope rules, and skill chain based on target type. Review Rules of Engagement, identify in-scope and out-of-scope assets, establish communication channels and notification thresholds.
- Execute Kill Chain — Progress through recon, scan, enum, vuln, exploit, and post-exp phases with structured data handoff between each phase. Each phase has defined entry/exit criteria and required output artifacts.
- Evidence Collection — Capture structured evidence at each phase with timestamps, checksums, and tool command documentation. All evidence files follow a consistent naming convention and directory structure.
- Cross-Phase Validation — Verify findings from one phase inform the next. Reconnaissance results feed scanning targets, scan results drive enumeration focus, enumeration output identifies vulnerabilities for exploitation.
- Critical Finding Management — When high-severity findings are confirmed, trigger notification protocol within agreed timeframe, document with full evidence chain, and coordinate emergency remediation.
- Report Generation — Compile findings into standardized report with executive summary, technical findings, CVSS scores, remediation priorities, and evidence references.
Skill Composition
| Target Type |
Skills Activated |
| web |
web-xss, web-sqli, web-auth-bypass, web-access-control, web-ssrf |
| cloud |
cloud-security, container-security, api-security, supply-chain-security |
| network |
network-pentest, password-attack, post-exploitation |
| mobile |
mobile-security, binary-reverse |
| api |
api-security, web-auth-bypass, web-access-control |
Key Decisions
- IF target has web services → activate web-xss + web-sqli + web-auth-bypass
- IF target is cloud-hosted → activate cloud-security + container-security
- IF engagement duration < 8 hours → prioritize high-value attack paths
- IF critical finding confirmed → pause, notify client within 4 hours
- IF scope boundary hit → stop, document, request scope expansion
Practical Steps
- Initialize engagement — Create workspace directory structure, load target configuration (targets.json), define scope rules, and verify tool availability
- Determine skill composition — Map target type to appropriate security skills using the Skill Composition table
- Execute kill chain phases — Progress sequentially through recon, scan, enum, vuln, exploit, and post-exp phases, capturing structured evidence at each step
- Manage data handoffs — Ensure output from each phase feeds correctly into the next phase through standardized file formats
- Enforce scope boundaries — Continuously verify all targets and techniques remain within approved scope; halt and document any scope violations
- Handle critical findings — When critical vulnerabilities are discovered, follow the 4-hour notification protocol and document in evidence
- Track engagement state — Update checkpoint.json after each phase completion to enable pause/resume capability
- Generate report — Compile all evidence into a standardized report with executive summary, technical findings, CVSS scores, and remediation priorities
- Perform quality assurance — Validate evidence completeness, verify findings have all required fields, check report for placeholder text
Defense Perspective
Understanding the engagement lifecycle from a defensive perspective helps organizations prepare for and respond to penetration tests effectively:
- Engagement indicators: Defenders should receive advance notice of authorized testing windows and source IP ranges to distinguish legitimate tests from actual attacks. A well-defined notification process prevents unnecessary incident response mobilization during authorized testing.
- Detection during testing: Security teams should monitor for engagement artifacts — nmap scans, brute-force attempts, exploitation payloads — and verify these align with authorized testing schedules. This also tests the blue team's detection capabilities in real time.
- Scope enforcement verification: Blue teams should independently verify that testing stays within approved scope by monitoring network traffic and log entries for activity against out-of-scope systems. Scope violations by testers indicate either a process failure or a genuine attack masquerading as authorized testing.
- Evidence handling: Organizations should retain copies of all penetration test evidence for their own records and ensure the engagement team follows proper data handling procedures. Evidence should be encrypted at rest and securely destroyed after the retention period expires.
- Post-engagement review: After testing concludes, defenders should conduct a lessons-learned session to identify detection gaps, response time improvements, and architectural weaknesses revealed by the test. This review should produce actionable items with owners and deadlines.
- Purple team coordination: Engagement managers can structure purple team exercises where offensive actions are communicated to defenders in near-real-time, enabling calibration of detection rules and response procedures against actual attack techniques.
- Remediation tracking: Post-engagement, the findings report becomes a remediation backlog. Organizations should track remediation progress, re-test critical findings, and update security controls based on lessons learned.
Phase Entry/Exit Criteria
| Phase |
Entry Criteria |
Exit Criteria |
Required Artifacts |
| Recon |
RoE reviewed, targets.json loaded |
All in-scope assets enumerated |
recon-results.json, attack-surface.md |
| Scan |
Recon complete, target list validated |
All ports/services identified |
scan-results.xml, service-map.json |
| Enum |
Scan complete, services catalogued |
All enumerated users/shares/configs |
enum-results.json, credential-stash.json |
| Vuln |
Enum complete, attack surface mapped |
All vulnerabilities classified |
vuln-results.json, risk-matrix.md |
| Exploit |
Vuln confirmed, PoC validated |
Exploitation complete with evidence |
exploit-evidence.json, screenshots/ |
| Post-Exp |
Exploitation successful |
Post-exploitation objectives met |
post-exp-results.json, lateral-map.json |
| Report |
All phases complete |
Report reviewed and delivered |
final-report.pdf, evidence-archive.tar.gz |
Evidence Requirements
Every finding must include these evidence artifacts for the engagement report to meet professional standards:
| Evidence Type |
Required For |
Format |
Naming Convention |
| Screenshot |
All web findings |
PNG with annotations |
F-NNN-description.png |
| HTTP Request/Response |
Web vulnerabilities |
Raw text or HAR |
F-NNN-http-exchange.txt |
| Tool Output |
All automated findings |
Raw with context |
F-NNN-tool-output.txt |
| Console Log |
Terminal-based findings |
Copy of session output |
F-NNN-console.log |
| Packet Capture |
Network-level findings |
PCAP with filter |
F-NNN-capture.pcap |
| Video Recording |
Multi-step exploits |
MP4/GIF |
F-NNN-demo.mp4 |
Engagement Timeline Template
Day 1: Kickoff, RoE review, recon phase (passive + active)
Day 2: Port scanning, service enumeration, vulnerability scanning
Day 3: Manual testing, exploitation of confirmed vulnerabilities
Day 4: Post-exploitation, lateral movement, privilege escalation
Day 5: Evidence consolidation, report drafting, quality assurance
Day 6: Report review, client walkthrough, remediation planning
Adjust timeline based on scope: single-target web app (2-3 days), multi-target enterprise (10-15 days), continuous assessment (ongoing).
Communication Templates
| Trigger |
Template |
Recipient |
Timeframe |
| Engagement kickoff |
kickoff-notification.md |
Client SOC, IT lead |
24h before start |
| Critical finding |
critical-finding-alert.md |
Client security team |
Within 4 hours |
| Scope clarification |
scope-change-request.md |
Client sponsor |
Before proceeding |
| Daily status |
daily-status-update.md |
Client stakeholders |
End of business day |
| Engagement complete |
wrap-up-notification.md |
Client SOC, IT lead |
Within 24h of completion |
| Report delivery |
report-delivery-notice.md |
Client sponsor, security team |
Per contract schedule |
Risk Assessment Matrix
| Risk Level |
CVSS Range |
Response Time |
Client Notification |
| Critical |
9.0-10.0 |
Immediate |
Phone call within 2 hours |
| High |
7.0-8.9 |
Within 24 hours |
Email within 4 hours |
| Medium |
4.0-6.9 |
Within engagement |
Included in daily status |
| Low |
0.1-3.9 |
In report |
Included in final report |
| Informational |
0.0 |
In report |
Included in final report |
Post-Engagement Checklist
Detection Methods
Engagement Process Audit
- Scope violations: Tester accessing systems outside engagement letter.
- Time window violations: Activity outside authorized hours.
- Data handling violations: Exfiltrating data without proper handling.
SIEM Detection Rules
- Splunk SPL: Correlate tester activity with engagement scope document.
- Custom workflow: Jira integration for engagement tracking.
Defense Evasion Techniques
Operational Security
- Stay in scope: Don't access systems outside engagement letter; preserves legal protection.
- Document everything: Maintain detailed audit trail; demonstrates authorization.
- Time-boxed operations: Operate only during authorized hours.
- Notify client: Pre-authorized activity reports; reduces incident response confusion.
Red Team / Blue Team Coordination
- De-confliction channels: Establish communication with blue team; abort if detected.
- Rules of engagement: Define stop conditions in advance.
Quality Criteria
- All phases produce structured evidence files with timestamps
- Data handoffs between phases are documented and verified
- Findings include severity, CVSS score, PoC, impact, and remediation
- Report follows standard penetration test template with all required sections
- Evidence chain is complete, timestamped, and integrity-verified with checksums
- Critical findings are notified within the agreed-upon timeframe
- Scope boundaries are enforced with zero violations
1---2name: engagement-manager3description: End-to-end penetration test project management skill. Orchestrates the full engagement lifecycle from scoping through reporting, managing skill composition, evidence chains, and phase transitions.4---56789# Engagement Manager1011## Summary1213Orchestrates the full engagement lifecycle from scoping through reporting, managing skill composition, evidence chains, phase transitions, and stakeholder communication. Serves as the command center that coordinates specialized security skills, enforces scope boundaries, tracks progress across kill chain phases, and ensures deliverables meet professional standards.1415**Domain**: management1617## Description1819Engagement Manager is the orchestration skill that manages the full penetration testing lifecycle from initial scoping through final report delivery. It coordinates skill composition across 69 security domains, manages the kill chain phase progression (recon, scan, enum, vuln, exploit, post-exp), maintains evidence chain integrity, and ensures data handoffs between phases are complete and structured. The skill handles scope boundary enforcement, critical finding notification protocols, multi-target coordination, checkpoint-based pause/resume, and standardized report generation. It serves as the command center that activates specialized skills based on target type and manages the overall engagement state.2021The engagement lifecycle follows a strict progression: Rules of Engagement (RoE) review and scope definition, target enumeration and attack surface mapping, systematic vulnerability discovery, controlled exploitation with evidence capture, post-exploitation assessment, and comprehensive reporting with remediation guidance. Each phase has entry criteria, exit criteria, and required evidence artifacts. The Engagement Manager ensures no phase is skipped, all data handoffs are validated, and findings are traceable from initial detection through final report inclusion.2223Critical finding management is a key responsibility. When a high-severity vulnerability is confirmed (e.g., remote code execution, credential compromise, data exposure), the Engagement Manager triggers the notification protocol within the agreed timeframe (typically 4 hours), documents the finding with full evidence, and coordinates with the client for emergency remediation without disrupting the broader engagement. Multi-target engagements require careful parallel coordination — different skills may be active simultaneously against different targets, and the Engagement Manager must track all active threads, maintain separate evidence chains per target, and prevent scope confusion.2425## Use Cases2627- Manage a complete penetration test engagement from kickoff to report delivery with full phase tracking28- Automatically select and sequence skills based on target type using the skill composition matrix29- Track kill chain phase progress and data handoffs between phases with checkpoint validation30- Maintain evidence chain integrity across multi-skill attack scenarios with checksums and timestamps31- Generate standardized reports from collected evidence with executive summary and technical findings32- Coordinate multi-target engagements with parallel skill activation and separate evidence chains33- Enforce scope boundaries with zero violations; halt and document any scope boundary encounters34- Handle critical finding notification within the agreed-upon timeframe while maintaining engagement continuity35- Support engagement pause/resume with checkpoint-based state management for multi-day assessments36- Conduct post-engagement quality assurance: evidence completeness, finding validation, report accuracy3738## Core Tools3940| Tool | Category | Purpose | Key Command |41|------|----------|---------|-------------|42| orchestrator.sh | Engagement Orchestration | End-to-end penetration test workflow execution | `orchestrator.sh --target web --phase all` |43| tool-selector.sh | Tool Selection | Target-to-tool mapping by attack phase and type | `tool-selector.sh --target-type web --phase recon` |44| report-generator.sh | Reporting | Automated report generation from collected evidence | `report-generator.sh --source evidence/ --format html` |45| drift-detect.sh | Quality Assurance | Configuration drift detection and baseline management | `drift-detect.sh --create-baseline` |4647## Methodology48491. **Scope & Plan** — Define target, scope rules, and skill chain based on target type. Review Rules of Engagement, identify in-scope and out-of-scope assets, establish communication channels and notification thresholds.502. **Execute Kill Chain** — Progress through recon, scan, enum, vuln, exploit, and post-exp phases with structured data handoff between each phase. Each phase has defined entry/exit criteria and required output artifacts.513. **Evidence Collection** — Capture structured evidence at each phase with timestamps, checksums, and tool command documentation. All evidence files follow a consistent naming convention and directory structure.524. **Cross-Phase Validation** — Verify findings from one phase inform the next. Reconnaissance results feed scanning targets, scan results drive enumeration focus, enumeration output identifies vulnerabilities for exploitation.535. **Critical Finding Management** — When high-severity findings are confirmed, trigger notification protocol within agreed timeframe, document with full evidence chain, and coordinate emergency remediation.546. **Report Generation** — Compile findings into standardized report with executive summary, technical findings, CVSS scores, remediation priorities, and evidence references.5556## Skill Composition5758| Target Type | Skills Activated |59|-------------|-----------------|60| web | web-xss, web-sqli, web-auth-bypass, web-access-control, web-ssrf |61| cloud | cloud-security, container-security, api-security, supply-chain-security |62| network | network-pentest, password-attack, post-exploitation |63| mobile | mobile-security, binary-reverse |64| api | api-security, web-auth-bypass, web-access-control |6566## Key Decisions6768- IF target has web services → activate web-xss + web-sqli + web-auth-bypass69- IF target is cloud-hosted → activate cloud-security + container-security70- IF engagement duration < 8 hours → prioritize high-value attack paths71- IF critical finding confirmed → pause, notify client within 4 hours72- IF scope boundary hit → stop, document, request scope expansion7374## Practical Steps75761. **Initialize engagement** — Create workspace directory structure, load target configuration (targets.json), define scope rules, and verify tool availability772. **Determine skill composition** — Map target type to appropriate security skills using the Skill Composition table783. **Execute kill chain phases** — Progress sequentially through recon, scan, enum, vuln, exploit, and post-exp phases, capturing structured evidence at each step794. **Manage data handoffs** — Ensure output from each phase feeds correctly into the next phase through standardized file formats805. **Enforce scope boundaries** — Continuously verify all targets and techniques remain within approved scope; halt and document any scope violations816. **Handle critical findings** — When critical vulnerabilities are discovered, follow the 4-hour notification protocol and document in evidence827. **Track engagement state** — Update checkpoint.json after each phase completion to enable pause/resume capability838. **Generate report** — Compile all evidence into a standardized report with executive summary, technical findings, CVSS scores, and remediation priorities849. **Perform quality assurance** — Validate evidence completeness, verify findings have all required fields, check report for placeholder text8586### Defense Perspective8788Understanding the engagement lifecycle from a defensive perspective helps organizations prepare for and respond to penetration tests effectively:8990- **Engagement indicators**: Defenders should receive advance notice of authorized testing windows and source IP ranges to distinguish legitimate tests from actual attacks. A well-defined notification process prevents unnecessary incident response mobilization during authorized testing.91- **Detection during testing**: Security teams should monitor for engagement artifacts — nmap scans, brute-force attempts, exploitation payloads — and verify these align with authorized testing schedules. This also tests the blue team's detection capabilities in real time.92- **Scope enforcement verification**: Blue teams should independently verify that testing stays within approved scope by monitoring network traffic and log entries for activity against out-of-scope systems. Scope violations by testers indicate either a process failure or a genuine attack masquerading as authorized testing.93- **Evidence handling**: Organizations should retain copies of all penetration test evidence for their own records and ensure the engagement team follows proper data handling procedures. Evidence should be encrypted at rest and securely destroyed after the retention period expires.94- **Post-engagement review**: After testing concludes, defenders should conduct a lessons-learned session to identify detection gaps, response time improvements, and architectural weaknesses revealed by the test. This review should produce actionable items with owners and deadlines.95- **Purple team coordination**: Engagement managers can structure purple team exercises where offensive actions are communicated to defenders in near-real-time, enabling calibration of detection rules and response procedures against actual attack techniques.96- **Remediation tracking**: Post-engagement, the findings report becomes a remediation backlog. Organizations should track remediation progress, re-test critical findings, and update security controls based on lessons learned.9798## Phase Entry/Exit Criteria99100| Phase | Entry Criteria | Exit Criteria | Required Artifacts |101|-------|---------------|---------------|-------------------|102| Recon | RoE reviewed, targets.json loaded | All in-scope assets enumerated | recon-results.json, attack-surface.md |103| Scan | Recon complete, target list validated | All ports/services identified | scan-results.xml, service-map.json |104| Enum | Scan complete, services catalogued | All enumerated users/shares/configs | enum-results.json, credential-stash.json |105| Vuln | Enum complete, attack surface mapped | All vulnerabilities classified | vuln-results.json, risk-matrix.md |106| Exploit | Vuln confirmed, PoC validated | Exploitation complete with evidence | exploit-evidence.json, screenshots/ |107| Post-Exp | Exploitation successful | Post-exploitation objectives met | post-exp-results.json, lateral-map.json |108| Report | All phases complete | Report reviewed and delivered | final-report.pdf, evidence-archive.tar.gz |109110## Evidence Requirements111112Every finding must include these evidence artifacts for the engagement report to meet professional standards:113114| Evidence Type | Required For | Format | Naming Convention |115|---------------|-------------|--------|-------------------|116| Screenshot | All web findings | PNG with annotations | `F-NNN-description.png` |117| HTTP Request/Response | Web vulnerabilities | Raw text or HAR | `F-NNN-http-exchange.txt` |118| Tool Output | All automated findings | Raw with context | `F-NNN-tool-output.txt` |119| Console Log | Terminal-based findings | Copy of session output | `F-NNN-console.log` |120| Packet Capture | Network-level findings | PCAP with filter | `F-NNN-capture.pcap` |121| Video Recording | Multi-step exploits | MP4/GIF | `F-NNN-demo.mp4` |122123## Engagement Timeline Template124125```126Day 1: Kickoff, RoE review, recon phase (passive + active)127Day 2: Port scanning, service enumeration, vulnerability scanning128Day 3: Manual testing, exploitation of confirmed vulnerabilities129Day 4: Post-exploitation, lateral movement, privilege escalation130Day 5: Evidence consolidation, report drafting, quality assurance131Day 6: Report review, client walkthrough, remediation planning132```133134Adjust timeline based on scope: single-target web app (2-3 days), multi-target enterprise (10-15 days), continuous assessment (ongoing).135136## Communication Templates137138| Trigger | Template | Recipient | Timeframe |139|---------|----------|-----------|-----------|140| Engagement kickoff | kickoff-notification.md | Client SOC, IT lead | 24h before start |141| Critical finding | critical-finding-alert.md | Client security team | Within 4 hours |142| Scope clarification | scope-change-request.md | Client sponsor | Before proceeding |143| Daily status | daily-status-update.md | Client stakeholders | End of business day |144| Engagement complete | wrap-up-notification.md | Client SOC, IT lead | Within 24h of completion |145| Report delivery | report-delivery-notice.md | Client sponsor, security team | Per contract schedule |146147## Risk Assessment Matrix148149| Risk Level | CVSS Range | Response Time | Client Notification |150|------------|-----------|---------------|-------------------|151| Critical | 9.0-10.0 | Immediate | Phone call within 2 hours |152| High | 7.0-8.9 | Within 24 hours | Email within 4 hours |153| Medium | 4.0-6.9 | Within engagement | Included in daily status |154| Low | 0.1-3.9 | In report | Included in final report |155| Informational | 0.0 | In report | Included in final report |156157## Post-Engagement Checklist158159- [ ] All evidence files organized and integrity-verified (SHA256 checksums)160- [ ] All findings have severity, CVSS score, PoC, impact, and remediation161- [ ] Critical findings were notified within agreed timeframe162- [ ] Scope boundaries verified — no unauthorized testing occurred163- [ ] Temporary files, credentials, and test data cleaned up164- [ ] Report follows template with executive summary and technical findings165- [ ] Raw tool outputs archived for re-test reference166- [ ] Client debrief scheduled for report walkthrough167- [ ] Remediation priorities communicated with timeline recommendations168- [ ] Engagement retrospective conducted — lessons learned documented169170## Detection Methods171172### Engagement Process Audit173- **Scope violations**: Tester accessing systems outside engagement letter.174- **Time window violations**: Activity outside authorized hours.175- **Data handling violations**: Exfiltrating data without proper handling.176177### SIEM Detection Rules178- **Splunk SPL**: Correlate tester activity with engagement scope document.179- **Custom workflow**: Jira integration for engagement tracking.180181## Defense Evasion Techniques182183### Operational Security184- **Stay in scope**: Don't access systems outside engagement letter; preserves legal protection.185- **Document everything**: Maintain detailed audit trail; demonstrates authorization.186- **Time-boxed operations**: Operate only during authorized hours.187- **Notify client**: Pre-authorized activity reports; reduces incident response confusion.188189### Red Team / Blue Team Coordination190- **De-confliction channels**: Establish communication with blue team; abort if detected.191- **Rules of engagement**: Define stop conditions in advance.192193## Quality Criteria194195- All phases produce structured evidence files with timestamps196- Data handoffs between phases are documented and verified197- Findings include severity, CVSS score, PoC, impact, and remediation198- Report follows standard penetration test template with all required sections199- Evidence chain is complete, timestamped, and integrity-verified with checksums200- Critical findings are notified within the agreed-upon timeframe201- Scope boundaries are enforced with zero violations