Skip to main content

functional-analysis-group-writer

Author phase-K group AFU (functional-analysis) markdown for ONE group declared in `config/grouping.yaml`. LLM-driven. SCAFFOLD. Two scopes: Per-section — writes one per-language draft into `docs/_shared/_groups/<group_id>/_fa-group-sections/<lang>/<section_id>.md` from a prepared bundle `docs/_shared/_groups/<group_id>/_fa-group-bundles/<section_id>.bundle.{json,md}`. Per-group finalizer — stitches the per-section drafts into `docs/<lang>/_groups/<group_id>/functional-analysis.md` per requested language. Reuses the existing per-file AFU profile family under `config/templates/docs/functional-analysis/`: - `default` - `afu-org-applicazione` (auto-selected when any group member is CICS/BMS) - `afu-org-interfaccia` (auto-selected when any group member is JCL/PRC with batch CBL)

Source facts

Repository
microsoft/cobol-docs-pipeline-sample
Last source activity
October 7, 2026 at 08:16
Detected SKILL.md language
English
Stars
1
Forks
3

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
5 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
functional-analysis-group-writer
description
Author phase-K group AFU (functional-analysis) markdown for ONE group declared in `config/grouping.yaml`. LLM-driven. SCAFFOLD. Two scopes: Per-section — writes one per-language draft into `docs/_shared/_groups/<group_id>/_fa-group-sections/<lang>/<section_id>.md` from a prepared bundle `docs/_shared/_groups/<group_id>/_fa-group-bundles/<section_id>.bundle.{json,md}`. Per-group finalizer — stitches the per-section drafts into `docs/<lang>/_groups/<group_id>/functional-analysis.md` per requested language. Reuses the existing per-file AFU profile family under `config/templates/docs/functional-analysis/`: - `default` - `afu-org-applicazione` (auto-selected when any group member is CICS/BMS) - `afu-org-interfaccia` (auto-selected when any group member is JCL/PRC with batch CBL)
argument-hint
<group_id> <bundle.bundle.md path> [target_languages]
> **Status:** scaffold — Day-1 contracts only. Mirrors per-file > `functional-analysis-writer` at group scope. # Scope Owns phase-K authoring at the group level. One invocation per section (per-section scope) or per group (finalizer scope), each covering exactly `bundle.languages` in declared order at `bundle.output_paths`. Never add an unrequested English edition or intermediate. Structural parity applies only when multiple languages are requested. Sibling skills: - `functional-analysis-writer` — per-file AFU (phase G). - `requirements-group-writer` — group ATE (phase J). - `group-doc-finalizer` — group `index.md` / `complete.md` (phase I). # Inputs Per-section scope: - `docs/_shared/_groups/<group_id>/_fa-group-bundles/<section_id>.bundle.json` (authoritative) - `docs/_shared/_groups/<group_id>/_fa-group-bundles/<section_id>.bundle.md` (LLM-facing) Per-group finalizer scope: - `docs/_shared/_groups/<group_id>/_fa-group-bundles/_finalize.bundle.{json,md}` - Every per-section draft under `docs/_shared/_groups/<group_id>/_fa-group-sections/<lang>/*.md` Bundles aggregate, per group: - Each eligible member's `docs/<lang>/<member>/functional-analysis.md` excerpts (phase G). - PRC members and members with an upstream `_fa-bundles/_skipped.json` decision are excluded from narrative inputs and recorded in `bundle.skipped_members`. Do not invent functional analysis for them. Other missing primary-language member documents are prerequisite errors (exit 4), not implicit skips. - Member narrative inputs and bundle excerpts use `<lang> = bundle.languages[0]`; do not require an English intermediate or member inputs in every output language. - The group's `docs/<lang>/_groups/<group_id>/requirements.md` excerpts (phase J) so AFU sections can cite group ATE requirement ids `GRP-<group_id>-REQ-NNN`. - `config/grouping.yaml` description + member list. - The active AFU profile (auto-detected per group). # Outputs - `docs/_shared/_groups/<group_id>/_fa-group-sections/<lang>/<section_id>.md` - `docs/<lang>/_groups/<group_id>/functional-analysis.md` Write only the languages and paths declared in the bundle. # Determinism rules - Citations point at group `requirements.md` (for `GRP-...-REQ-NNN`) and per-file `functional-analysis.md` of the owning member. - Member order follows `config/grouping.yaml.groups[*].members[*]`.
View on GitHub