acn-cobol-modernization — Skills

Four slash commands invoked as /acn-cobol-modernization:<name>. The skills compose: re produces an RE doc that bugfix references, bugfix produces a .patch that deploy-validate applies, re also feeds docgen for publishable onboarding.

re

Reverse-engineer one COBOL program into a structured 9-section markdown document.

• Inputs: repo_path, program_id, optional output_path
• Workflow: refresh lineage.json + copybooks.json caches → pull program neighborhood + copybook content → read program source + BMS mapsets → fill 9-section template (executive summary, architecture mermaid, screen layout, data model, business rules, dependencies, code-quality, migration notes, demo value)
• Output: markdown at <repo>/.lineage/re-<program_id>.md

Source: plugins/acn-cobol-modernization/skills/re/SKILL.md

bugfix

Analyze a COBOL bug and propose a unified-diff fix with cross-reference discipline.

• Inputs: repo_path, program_id, bug_description, optional output_path
• Workflow: ensure caches fresh → read program + copybooks → walk procedure division for candidate defects → grep across codebase to distinguish defects from intentional legacy conventions → categorize findings (B1/B2 bugs, F1/F2 intentional findings) → fill bugfix template → run extract_patches.py to emit .patch
• Output: markdown bugfix doc + git-applicable .patch file

Source: plugins/acn-cobol-modernization/skills/bugfix/SKILL.md

deploy-validate

Apply a .patch to a UniKix EC2 region, validate end-to-end, capture before/after 3270 screens, produce a deploy report.

• Inputs: repo_path, patch_path, plus EC2 connection args (instance_id, region, aws_profile, ec2_host, ssh_key, ssh_user, gh_repo) — defaults match the current ACN UniKix POC stack (see Setup)
• Two-dimensional mode: transport (direct-ssh | actions) × capture (live | code-only)
• Workflow: pre-flight (apply-check, file size) → branch + commit → probe EC2, select transport → capture before-screen (live mode) → rsync + deploy + validate (or via gh workflow run) → capture after-screen → diff screens → fill deploy report template
• Output: deploy report markdown with verdict (✅ PASS / ❌ FAIL / ⚠️ PARTIAL)

Source: plugins/acn-cobol-modernization/skills/deploy-validate/SKILL.md

docgen

Transform an RE doc into a publishable onboarding doc.

• Inputs: re_doc_path, optional output_path, optional audience (developer | tester | analyst)
• Workflow: read RE doc → restructure (TL;DR, first-day checklist, reading order, glossary, simplified architecture, screen walkthrough, data model by purpose, business rules verbatim, call graph, FAQs)
• Drops all migration-analysis sections (different doc, different audience)
• Output: markdown at <re_doc_path> with -onboarding.md suffix

Source: plugins/acn-cobol-modernization/skills/docgen/SKILL.md

Composition pattern

re → either bugfix → deploy-validate (fix path) or docgen (publish path). The .patch extracted by bugfix feeds directly into deploy-validate — they’re already wired to chain.

See Pipeline for the visual flow.