Menu
Use when coordinating custom Codex subagents for Chaos Redux implementation, asset production, super-event research, audits, active small patches, planning handoffs, or documentation work.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Use when designing, implementing, auditing, or fixing Hearts of Iron IV decisions, missions, timed objectives, decision categories, and mission localisation.
Use when designing, implementing, auditing, or fixing Hearts of Iron IV national focus trees.
Use when implementing or updating Chaos Redux events.
Use when expanding Chaos Redux event ideas into detailed specifications before implementation.
Use when creating, sourcing, processing, converting, organizing, wiring, or documenting visual assets for Chaos Redux.
Use when designing, researching, wiring, or documenting Chaos Redux super-events.
| name | chaos-redux-subagents |
| description | Use when coordinating custom Codex subagents for Chaos Redux implementation, asset production, super-event research, audits, active small patches, planning handoffs, or documentation work. |
Use this skill when a Chaos Redux task should be split across project custom Codex subagents.
The parent Codex agent remains responsible for final integration, validation, and completion claims. Subagents can inspect, patch, create assets, write addenda, or produce reports. The parent must review their outputs, wire final cross-surface behavior, and carry blockers into the final report.
Do not use subagents to hide uncertainty or pass off responsibility. A subagent handoff is evidence for the parent, not a replacement for parent review.
All project custom Codex subagents must be spawned with fork_context=false.
Do not spawn any project subagent with inherited parent-thread context. The parent prompt must include every path, user correction, task constraint, scope boundary, previous handoff status, accepted plan, queued plan, and design rule the subagent needs.
If the needed context only exists in conversation, summarize it into the subagent prompt or write it to the relevant spec, plan, handoff, or repo file before spawning. Then spawn the subagent with fork_context=false.
This rule applies to every subagent type:
The goal is to keep subagents narrow, reproducible, and grounded in explicit inputs instead of inherited conversation state.
Use chaosx_repo_explorer only for read-only repo exploration when touched-file mapping, pattern search, vanilla reference mapping, missing-file recovery, dependency mapping, or edit-order planning is actually unclear. It is not a default preflight agent.
Use chaosx_improvement_loop_planner for event improvement loop planning, detailed expansion specs, historical and regional research notes, and implementation-ready improvement handoffs. This replaces the old mechanic-expander role. It writes plans and addenda. It does not patch gameplay files.
Use chaosx_asset_source_researcher for real or archival image sourcing, real leader portraits, historical flags, historical symbols, user-provided source photos, source-image processing, animated portrait bases, and report, news, or super-event images that must depict real historical material.
Use chaosx_generated_event_art for generated non-icon art, including fictional or alternate-history report images, news images, super-event images, fictional portraits, fictional flags, faction emblems, UI panels, dossier art, progression-state base art, and animated non-icon presentation pieces.
Use chaosx_icon_artist for focus icons, idea icons, national spirit icons, officer corps icons, decision icons, decision category icons, achievement icons, tech icons, formable seals, scripted GUI icons, and small animated icon or button sprites.
Use chaosx_super_event_text_researcher for super-event main quotes, exact wording checks, attribution confidence, source comparison, button text, cultural remarks, slogans, allusions, and short references.
Use chaosx_super_event_audio_researcher for licensed or public domain audio research, source verification, download, .ogg conversion, and audio handoff notes.
Use chaosx_focus_tree_auditor for focus tree audits and active small patches covering branch depth, route coverage, icons, localisation, rewards, prerequisites, mutual exclusions, AI, focus-formable links, and simplification.
Use chaosx_decision_mission_auditor for decision and mission audits and active small patches covering category lifecycle, objective quality, costs, tooltips, scripted GUI decision hooks, AI behavior, cleanup, balance, and exploit risk.
Use chaosx_country_package_auditor for country package audits and active small patches covering tags, history, states, leaders, portraits, flags, parties, focus loading, ideas, advisors, units, technologies, claims, cores, localisation, AI, formables, and playable setup.
Use chaosx_localisation_auditor for localisation and scripted localisation audits and active small patches covering missing keys, duplicate keys, encoding, tooltip quality, broken dynamic text, namespace consistency, dynamic cost text, and cross-surface text mismatch.
Use chaosx_scripted_system_architect for reusable scripted system design and active narrow implementation covering scripted effects, scripted triggers, script constants, event targets, meta effects, variables, tuning values, formable helpers, scripted GUI button helpers, and dynamic helper logic.
Use chaosx_documentation_curator for documentation cleanup and consistency during long implementation. It reconciles specs, plans, docs, handoffs, manifests, prompts, reports, and README files, writes source-of-truth maps and resume packets, marks superseded docs, records plan dispositions, and flags contradictions. It patches documentation surfaces only and does not edit gameplay files, localisation, assets, or spreadsheets.
Use chaosx_event_completion_auditor for read-only spec-versus-implementation audits covering events, mechanics, assets, docs, super-events, focus trees, decisions, validation, and accepted plan addenda.
Use chaosx_spreadsheet_doc_worker only for the event catalog workbook at docs/spreadsheets/chaos_redux_events_catalog.xlsx. It uses the xlsx/spreadsheet skill, keeps the workbook player-facing, and matches event log, event detail, evolution detail, and cluster detail fields to the in-game wording.
Do not route new work to chaosx_mechanic_expander. Its role is merged into chaosx_improvement_loop_planner and the chaos-redux-improvement-loop skill.
chaosx_repo_explorer is an optional scout for uncertain or broad work. It should save time by finding files, patterns, precedents, and edit order before the parent starts a complex implementation.
Use chaosx_repo_explorer when at least one of these is true:
Do not spawn chaosx_repo_explorer for small or already bounded work, including:
chaosx_spreadsheet_doc_workerWhen the task is small, the parent should read the known files directly and proceed. Do not use repo exploration as a ritual step or as a replacement for parent review.
Subagents should act at the level their role requires. Do not make every subagent read-only by default.
These agents do not patch gameplay files:
chaosx_repo_explorerchaosx_event_completion_auditorThey may write reports only when a report path is provided or obvious from the task.
chaosx_improvement_loop_planner writes event expansion specs, improvement addenda, deep research notes, historical connection notes, and implementation handoffs. It does not edit gameplay, localisation, GUI, scripted effects, focus trees, decisions, assets, spreadsheets, or country files.
When an event mechanic needs more depth, new branches, new countries, a new formable suite, a new scripted GUI system, deeper regional logic, historical anchors, or a larger route redesign, the planner writes a plan under docs/plans/<event_id>_<event_slug>_plans/. The main agent decides what to implement.
The parent should use this planner after a meaningful implementation tranche, not after every small patch. Do not spawn it again for the same event until its previous addendum has been implemented, folded into specs, queued with a reason, or rejected with a reason.
chaosx_documentation_curator is patch-capable for documentation surfaces only. It may update Markdown specs, docs, plans, handoffs, manifests, prompt files, README files, route coverage tables, source-of-truth ledgers, resume packets, and documentation indexes inside the current task scope.
Use it after long implementation tranches, after several subagent handoffs, before a major resume, or whenever docs may be stale, contradictory, duplicated, or too numerous. It should reduce confusion for the parent agent by recording what is current, what is superseded, what is queued, what is rejected, and what still needs a decision.
It must not edit gameplay files, localisation, scripted localisation, GUI, GFX, events, focuses, decisions, ideas, scripted effects, scripted triggers, on_actions, country setup, history, AI files, assets, audio, binary files, or the event catalog workbook. It does not replace chaosx_event_completion_auditor, chaosx_localisation_auditor, chaosx_spreadsheet_doc_worker, or chaosx_repo_explorer.
Asset subagents create source files, processed previews, final DDS outputs, contact sheets, manifests, and asset handoffs. They do not wire gameplay, localisation, GFX, GUI, events, focuses, decisions, or spreadsheets unless the parent gives a narrow exception.
These agents are patch-capable by default inside the current task scope:
chaosx_scripted_system_architectchaosx_decision_mission_auditorchaosx_focus_tree_auditorchaosx_country_package_auditorchaosx_localisation_auditorThey do not need a separate permission prompt to fix small, local issues that are clearly connected to the current event, mechanic, country, focus tree, decision category, GUI surface, or localisation surface.
They should inspect first, then patch only when the fix is narrow, reversible, and supported by the relevant skill. They may edit files they own for the current task surface and directly related dependency files. They must not search for unrelated cleanup outside the feature they were spawned for.
Active small patches include:
Active small patches do not include:
When a patch-capable subagent sees a broad design gap, it writes a plan handoff and stops. The main agent decides whether to implement it.
Every subagent that edits files must write a handoff back to the parent. If the event id and slug are known, place it under:
docs/plans/<event_id>_<event_slug>_plans/subagent_handoffs/
The handoff should include:
Do not fill handoffs with passing boilerplate checks that only restate AGENTS.md rules. Basic syntax hygiene can be done internally unless it found a problem or materially changed the patch.
If a patch touches localisation, list the keys changed. If it touches decisions or focuses, list affected ids. If it touches scripted helpers, list helper names and call sites. If it touches country setup, list tags and state ids or state groups.
Full accepted event specs belong under:
docs/specs/<event_id>_<event_slug>_specs/
Subagent plans, expansion addenda, audit follow-up notes, blocked reports, implementation handoffs, and patch handoffs belong under:
docs/plans/<event_id>_<event_slug>_plans/
The plans folder is the working area. The specs folder is the source-of-truth design area. If a plan is accepted as source design, the main agent should fold it into the relevant spec file or clearly report that it remains queued.
Do not create new planning folder names such as docs/planning/ unless the user explicitly asks.
Do not use one broad asset worker for mixed visual packages.
Use:
chaosx_asset_source_researcher for real, archival, historical, documentary, or public-source images when the asset must show real historical materialchaosx_generated_event_art for generated non-icon fictional, alternate-history, symbolic, high-chaos, or unique event artchaosx_icon_artist for generated gameplay icons, formable seals, decision category icons, and small animated icon or button spritesThe parent agent must give each asset subagent a bounded prompt with exact asset names, target sizes, source mode, final folders, sprite names when already registered, reference folders, and constraints.
For chaosx_icon_artist, the parent prompt must require $imagegen source atlas or source PNG evidence, prompt and source-mode notes, transparent-background processing, contact sheets, dimension and alignment QA, no white matte or opaque square backgrounds, and confirmation that final generated icons are not primitive local drawings or resized unrelated icons.
For flags, the parent prompt must state whether each flag is a base flag, ideology variant, route variant, cosmetic-tag flag, historical flag, or fictional flag. Base flags for existing countries must be preserved unless explicitly in scope. Ideology variants must be distinct designs, not recolors or copied emblems. Historical flags and attested symbols belong with chaosx_asset_source_researcher. Fictional or alternate-history variants belong with chaosx_generated_event_art.
Asset subagents may create source files, PNG previews, DDS files, contact sheets, manifests, and gfx_handoff.md. They must not edit .gfx, localisation, GUI, event, focus, idea, decision, script, history, country, or spreadsheet files unless the parent explicitly expands scope.
Use separate research agents when the super-event package has enough work to justify it.
Use chaosx_super_event_text_researcher for quotes, exact wording, attribution confidence, button text, cultural remarks, slogans, allusions, and short references.
Use chaosx_super_event_audio_researcher for audio research, license verification, download, .ogg conversion, and audio handoff notes.
Use chaosx_asset_source_researcher or chaosx_generated_event_art for image work according to the source mode required by chaos-redux-event-assets.
The main agent owns final wiring, localisation, settings-aware playback, docs, and spreadsheet alignment.
Use chaosx_improvement_loop_planner when an event or event-adjacent mechanic needs new design material, not just an audit finding.
The planner should read chaos-redux-improvement-loop, chaos-redux-event-planning, and relevant system skills. It should inspect actual implementation, specs, plans, docs, localisation, and asset notes when available. It should then write concrete design material that expands the event through playable mechanics, historical or regional connections, AI behavior, and visual needs. It should not patch gameplay files.
The main agent should deploy the planner often enough to keep major events from becoming shallow after new mechanics are added, but not so often that plans pile up. For the same event, do not deploy another planner pass until the previous addendum is implemented, promoted to specs, queued with a reason, or rejected.
Audit subagents may include compact improvement handoffs inside their reports. If a gap requires a new route family, new GUI system, new formable suite, new country package, or new event chain, they should recommend a plan-mode pass rather than trying to patch it.
chaosx_spreadsheet_doc_worker is a context-light spreadsheet worker, not a general documentation agent.
Use it when the only required output is an update to:
docs/spreadsheets/chaos_redux_events_catalog.xlsx
The parent prompt should provide event ids, row targets, source localisation keys, or the exact fields to update when possible.
The worker should read only:
It should not read HOI4 wiki pages, vanilla documentation, vanilla files, broad implementation guides, or unrelated repo systems. It should not edit docs, specs, plans, manifests, gameplay files, localisation files, assets, GFX, GUI, events, focuses, decisions, ideas, history, scripted effects, scripted triggers, or other spreadsheets unless the parent explicitly expands scope.
The worker must preserve workbook structure, formatting, formulas, filters, and validation unless the parent explicitly asks for structural changes.
The parent agent must review every subagent output before relying on it.
Before final completion, the parent should check:
A subagent patch can reduce workload. It never owns the final completion claim.