Paths: File paths (
references/,../ln-*) are relative to this skill directory.
ln-830-code-modernization-coordinator
Type: L2 Domain Coordinator Category: 8XX Optimization
Runtime-backed coordinator for code modernization. Delegates OSS replacement and bundle-size work to isolated child runs, records machine-readable worker summaries, and emits a final coordinator summary.
Overview
| Aspect | Details |
|---|---|
| Input | Audit report, target module, or modernization scope |
| Output | Aggregated modernization report with durable worker artifacts |
| Workers | ln-831 (OSS replacer), ln-832 (bundle optimizer) |
| Runtime | .hex-skills/modernization/runtime/runs/{run_id}/ |
Workflow
Phases: Pre-flight -> Analyze Input -> Delegate Workers -> Collect Results -> Verify Summary -> Report
Runtime Contract
MANDATORY READ: Load references/ci_tool_detection.md
MANDATORY READ: Load references/coordinator_runtime_contract.md, references/modernization_runtime_contract.md, references/coordinator_summary_contract.md
Runtime CLI:
node references/scripts/modernization-runtime/cli.mjs start --identifier repo-modernization --manifest-file <file>
node references/scripts/modernization-runtime/cli.mjs status --identifier repo-modernization
node references/scripts/modernization-runtime/cli.mjs checkpoint --phase PHASE_2_DELEGATE_WORKERS --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-worker-result --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-summary --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs advance --to PHASE_3_COLLECT_RESULTS
node references/scripts/modernization-runtime/cli.mjs complete
Required state fields:
worker_planworker_resultschild_runsverification_passedreport_readysummary_recorded
Domain checkpoints:
PHASE_1_ANALYZE_INPUT: target modules, worker selection, stack detectionPHASE_2_DELEGATE_WORKERS: onechild_runper delegated worker with worker name,runId, andsummaryArtifactPathPHASE_3_COLLECT_RESULTS: recorded worker summaries and unresolved failuresPHASE_4_VERIFY_SUMMARY: final report path, verification verdict, summary readiness
Guard rules:
- do not advance from
PHASE_2_DELEGATE_WORKERSuntil every planned worker emitted a validmodernization-workersummary - do not complete until the final report checkpoint exists and the
modernization-coordinatorsummary was recorded - consume worker JSON summaries only; never infer worker status from prose output
Phase 0: Pre-flight
Confirm the modernization request has a valid scope and a deterministic runtime target.
| Check | Required | Action if Missing |
|---|---|---|
| Audit report or target module | Yes | Block modernization |
| Project path | Yes | Block modernization |
| Verification command available | Yes | Block if workers cannot verify changes |
| Existing active run for identifier | No | Pause if conflicting run exists |
Phase 1: Analyze Input
Select workers based on project type and findings.
Worker selection:
| Condition | ln-831 | ln-832 |
|---|---|---|
| Audit findings include OSS candidates | Yes | No |
JS/TS project with package.json | No | Yes |
| Both conditions true | Yes | Yes |
| Explicit target module only | Yes | Optional if bundle impact exists |
Stack detection:
| Indicator | Stack | ln-832 Eligible |
|---|---|---|
package.json + JS/TS files | JS/TS | Yes |
*.csproj | .NET | No |
requirements.txt or pyproject.toml | Python | No |
go.mod | Go | No |
Checkpoint payload must include:
input_sourceworker_planstack_detectionskipped_reasons
Phase 2: Delegate Workers
Delegate one child run per selected worker. Child runs are deterministic and artifact-driven.
Delegate using the concrete worker identities selected by the routing rules below. Do not synthesize family placeholders or guessed skill IDs in prompts.
Delegation context:
| Field | Type | Description |
|---|---|---|
projectPath | string | Absolute path to the target project |
auditReport | string | Path to audit output when applicable |
targetModule | string | Optional focused module path |
identifier | string | Stable worker identifier |
runId | string | Deterministic child run id |
summaryArtifactPath | string | Exact JSON path for the worker summary |
options | object | Verification flags and worker-specific settings |
Delegation rules:
- launch
ln-831beforeln-832when both are selected ln-832consumes the project state produced by accepted modernization changes, not a guessed baseline- checkpoint every child run before waiting on its result
- record every emitted worker summary with
record-worker-result
Phase 3: Collect Results
Aggregate validated worker summaries only.
Worker summary fields consumed by the coordinator:
| Field | Description |
|---|---|
producer_skill | worker identity (ln-831 or ln-832) |
summary_kind | must be modernization-worker |
identifier | stable worker identifier |
payload.status | completed, partial, or failed |
payload.changes_applied | kept changes |
payload.changes_discarded | discarded experiments |
payload.verification | build/test verification result |
payload.artifact_path | worker-owned durable report path |
payload.warnings | non-blocking issues |
Collection output:
worker_resultssuccess_countpartial_countfailed_countwarnings
Phase 4: Verify Summary
Prepare the final modernization report and verify the coordinator can finish deterministically.
Verification checklist:
- every planned worker produced one valid summary envelope
- aggregate counts match recorded worker results
- final report path exists or is ready to be written
report_readyandverification_passedare true before completion
Failure handling:
- Keep successful worker results intact.
- Mark failed workers explicitly in the coordinator report.
- Do not invent rollback actions beyond what workers already verified.
Phase 5: Report
Coordinator report schema:
| Field | Description |
|---|---|
input_source | audit report or target module |
workers_activated | delegated workers |
modules_replaced | OSS replacements applied |
loc_removed | custom code removed |
bundle_reduction | final bundle reduction summary |
verification_passed | aggregate verification verdict |
per_worker[] | machine-readable worker result summaries |
warnings[] | cross-worker warnings |
Completion sequence:
- Write the durable report.
- Checkpoint the report path and verification verdict.
- Record the
modernization-coordinatorsummary envelope withrecord-summary. - Complete runtime only after the report checkpoint and coordinator summary exist.
Configuration
Options:
audit_report: "docs/project/codebase_audit.md"
target_module: ""
enable_oss_replacer: true
enable_bundle_optimizer: true
run_tests: true
run_build: true
Error Handling
Recoverable:
| Error | Recovery |
|---|---|
| ln-831 partial result | Continue with ln-832 if still applicable |
| ln-832 failure | Preserve ln-831 result and report partial modernization |
| Build failure in one worker | Keep failure in coordinator report, continue collection |
Fatal:
| Error | Action |
|---|---|
| No workers activated | Finish with empty-result report |
| Runtime validation failure | Pause run and require intervention |
| Missing worker summary for planned child run | Do not advance from collection |
References
../ln-831-oss-replacer/SKILL.md../ln-832-bundle-optimizer/SKILL.md- `../ln-645-arc