Skip to main content

requirements-group-writer

Author phase-J group ATE (technical-requirements) 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>/_req-group-sections/<lang>/<section_id>.md` from a prepared bundle `docs/_shared/_groups/<group_id>/_req-group-bundles/<section_id>.bundle.{json,md}`. Per-group finalizer — stitches the per-section drafts into `docs/<lang>/_groups/<group_id>/requirements.md` per requested language. Reuses the existing per-file ATE profile family under `config/templates/docs/requirements/`: - `default` - `ate-org-applicazione` (auto-selected when any group member is CICS/BMS) - `ate-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
requirements-group-writer
description
Author phase-J group ATE (technical-requirements) 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>/_req-group-sections/<lang>/<section_id>.md` from a prepared bundle `docs/_shared/_groups/<group_id>/_req-group-bundles/<section_id>.bundle.{json,md}`. Per-group finalizer — stitches the per-section drafts into `docs/<lang>/_groups/<group_id>/requirements.md` per requested language. Reuses the existing per-file ATE profile family under `config/templates/docs/requirements/`: - `default` - `ate-org-applicazione` (auto-selected when any group member is CICS/BMS) - `ate-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 > `requirements-writer` and `requirements-finalizer` at group scope. # Scope Owns phase-J 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: - `requirements-writer` / `requirements-finalizer` — per-file ATE (phase F). - `group-doc-finalizer` — group `index.md` / `complete.md` (phase I). - `functional-analysis-group-writer` — group AFU (phase K). # Inputs Per-section scope: - `docs/_shared/_groups/<group_id>/_req-group-bundles/<section_id>.bundle.json` (authoritative) and `.bundle.md` (LLM-facing projection). Per-group finalizer scope: - `docs/_shared/_groups/<group_id>/_req-group-bundles/_finalize.bundle.{json,md}` - Every per-section draft under `docs/_shared/_groups/<group_id>/_req-group-sections/<lang>/*.md` Bundles aggregate, per group: - Each eligible member's `docs/<lang>/<member>/requirements.md` excerpts (phase F). - PRC members and members with an upstream `_req-bundles/_skipped.json` decision are excluded from narrative inputs and recorded in `bundle.skipped_members`. Do not invent requirements 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>/complete.md` excerpts (phase I). - `config/grouping.yaml` description + member list. - The active ATE profile (auto-detected per group). # Outputs - `docs/_shared/_groups/<group_id>/_req-group-sections/<lang>/<section_id>.md` - `docs/<lang>/_groups/<group_id>/requirements.md` Write only the languages and paths declared in the bundle. # Determinism rules - Requirement ids namespace: `GRP-<group_id>-REQ-NNN` (zero-padded to 3). - Citations must point at per-file `requirements.md` of the member that owns each requirement; never at raw source. - Member order in the finalized doc follows `config/grouping.yaml.groups[*].members[*]` order.
View on GitHub