rendering-preaction-livrable

Renders a three-layer markdown deliverable from a pre-action analysis facts.json using Jinja2 templates.

6|Updated May 11, 2026
One-click install
npx skills add https://github.com/divalto/divalto-ia-devkit --skill rendering-preaction-livrable-divalto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rendering-preaction-livrable
Source: https://github.com/divalto/divalto-ia-devkit/tree/main/plugins/divalto-devkit/skills/rendering-preaction-livrable
Command: npx skills add https://github.com/divalto/divalto-ia-devkit --skill rendering-preaction-livrable-divalto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jinja2, and includes scripts (resource) and references (resource) components.

What problem does it solve? Pre-action analysis reports often mix raw source references (absolute paths, line numbers, status tags) with readable content, forcing developers to cross-check multiple files. This Skill turns a machine-readable facts.json into a self-contained markdown deliverable that any reader can consume without consulting other documents. ## Core Features & Use Cases - Three-layer rendering: Produces a single markdown file structured into strategic (2 min, project manager), tactical (15 min, implementing developer), and technical (30 min, auditor) reading layers, routed from claim kinds via Jinja2 templates. - Strict content/form separation: The deliverable never exposes absolute paths, line numbers, or [X.12]/[CONFIRME X.13] status tags; all references stay in facts.json for auditability. - Anti-regression validator: Before writing, the renderer rejects output containing stubs (TODO, [a definir]), unsupported HTML tags in Mermaid, relative pronouns after bullet labels, or visible source references, exiting with code 4 and a violation list. - Use Case: After running build_facts.py on a UC-100 pre-action analysis, run render_livrable.py to produce the final markdown deliverable handed to the developer, with an optional internal-audience variant that keeps inline source references. ## Quick Start Render the final markdown deliverable from the facts.json generated by build_facts.py using the render_livrable.py script with the default external audience.

Frequently Asked Questions about rendering-preaction-livrable

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render a markdown report from a facts.json file?

Run render_livrable.py with --facts pointing to your facts.json and --output-dir for the destination folder. The script renders Jinja2 templates into a three-layer markdown file and validates it before writing.

How do I generate a report with different reading levels for managers and developers?

This renderer splits output into three autonomous layers: strategic (2-minute read for project managers), tactical (15 minutes for implementing developers), and technical (30 minutes for auditors). Claims are routed to layers based on their kind and content_type_id.

Why does the render fail with exit code 4?

Exit code 4 means the validator found forbidden patterns in the rendered output, such as absolute Windows paths, [X.12]/[CONFIRME X.13] status tags, TODO stubs, or unsupported HTML tags. Fix the Jinja2 template or the upstream facts.json and rerun.

Can I include source file references in the rendered report?

Yes, by passing --audience interne. The internal audience mode adds inline source references and a consulted-sources appendix for team audits, while the default external mode strips all paths, line numbers, and status tags.

What input format does the pre-action report renderer require?

It requires a facts.json file produced by the upstream build_facts.py script, containing claims with kind, content_type_id, sources, plus verdict, request, coverage, and selection sections. Claims from excluded content types are silently omitted.