opplan-converter
Convert engagement documents into machine-readable OPPLAN for the ralph loop — objective decomposition, acceptance criteria, MITRE mapping, priority ordering.
Best for Red team operationsWorks with GitHub
⌘source
- author
@PurpleAILAB- language
- Python
★2.1kstars
366forks
Apr 18, 2026
✦overview.md
Key Features
- ·Converts engagement documents into machine-readable OPPLAN
- ·Decomposes objectives for single-agent execution
- ·Maps objectives to MITRE ATT&CK framework
- ·Orders objectives by priority
- ·Generates acceptance criteria
Use Cases
- →Converting CONOPS and RoE documents into executable tasks for the Ralph loop
- →Starting an autonomous red team operation with structured objectives
- →Breaking down complex kill chains into manageable agent tasks
Best for
- ✓Red team operations
- ✓Automated security testing pipelines
- ✓Planning and objective decomposition
Not ideal for
- !One-off manual tasks
- !Non-security-related automation
FAQs
name
opplan-converter
description
Convert engagement documents into machine-readable OPPLAN for the ralph loop — objective decomposition, acceptance criteria, MITRE mapping, priority ordering.
allowed-tools:Read Write Edit
metadata:{"subdomain":"planning","when_to_use":"create OPPLAN, generate objectives, set up the loop, convert plan to tasks, make it runnable","tags":"opplan, objectives, ralph-loop, automation","mitre_attack":null}
OPPLAN Converter — CONOPS to Ralph Loop Format
The OPPLAN is the direct analogue of ralph's prd.json — it's the file the autonomous loop reads each iteration to decide what to do next. Each objective must be completable by one agent in one context window.
When to Use
- After both
roe.jsonandconops.jsonexist - User wants to convert planning docs into executable tasks
- Starting the autonomous red team loop
Prerequisites
Read both roe.json and conops.json first. The RoE constrains what's allowed; the CONOPS defines the kill chain and threat profile.
See ../references/schema-quick-reference.md for the OPPLAN and Objective schema fields, valid status values, and enum types.
Workflow
Step 1: Extract Kill Chain from CONOPS
Read the CONOPS kill chain phases. Only create objectives for authorized phases.
Step 2: Decompose into Objectives
Each objective must follow the one context window rule — if an agent can't complete it in a single session, it's too big. Split it.
See references/objective-templates.md for recon-phase templates and references/objective-rules.md for the complete decomposition rules.
$install
1-click copynpx skills add PurpleAILAB/Decepticon --skill opplan-converterSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
3/ 5
goodMostly clear, but there are still a few confusing or poorly structured parts.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.