sapho-structured-artifact-bundle-upgrade

Upgrade Sapho article packages to emit structured internal bundle files.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/quiznat/Hermes_Sapho --skill sapho-structured-artifact-bundle-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sapho-structured-artifact-bundle-upgrade
Source: https://github.com/quiznat/Hermes_Sapho/tree/main/.hermes/skills/software-development/sapho-structured-artifact-bundle-upgrade
Command: npx skills add https://github.com/quiznat/Hermes_Sapho --skill sapho-structured-artifact-bundle-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This upgrade enables Sapho article packages to emit structured internal bundle files alongside existing compatibility markdown outputs, improving validation, lineage tracking, and auditability without changing public-facing behavior.

Core Features & Use Cases

  • Preserves existing public outputs (article.md, micro-worthiness.md, micro-findings.md, micro-facts.md) while generating internal artifacts such as curator.json, findings.jsonl, facts.jsonl, and validation.json.
  • Derives structured records from micro outputs and builds lineage.json with explicit claim-evidence mappings.
  • Provides a dedicated module (scripts/structured_artifact_bundle.py) with a canonical entrypoint to materialize bundles.
  • Wires the bundle generation into the article lifecycle so it runs after synthesis and before final writes.
  • Supports both kept and discarded articles with deterministic structured outputs for validators.

Quick Start

Run the structured artifact bundle upgrade flow in the sapho-native workspace to generate the structured artifact bundle alongside existing article outputs.

Frequently Asked Questions about sapho-structured-artifact-bundle-upgrade

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

FAQPage Schema
How do I generate structured JSONL and lineage files from existing article markdown outputs?

You can generate structured internal bundle files by running an upgrade flow that derives curator.json, findings.jsonl, facts.jsonl, and validation artifacts alongside your existing compatibility markdown outputs without altering public-facing behavior.

What are structured artifact bundles and when do I need them for article packages?

Structured artifact bundles are internal files like curator.json and lineage.json that provide explicit claim-evidence mappings. You need them when article packages require improved validation, lineage tracking, and auditability for deterministic validator checks.

Can I add structured internal bundle files without changing my public-facing article outputs?

Yes, you can add structured internal bundle files without changing public-facing article outputs. The upgrade process preserves existing markdowns like article.md while emitting internal artifacts alongside them after synthesis and before final writes.

How do I build lineage tracking and claim-evidence mappings for Sapho article packages?

Build lineage tracking for Sapho article packages by running an upgrade that derives structured records from micro outputs to construct lineage.json with explicit claim-evidence mappings, strengthening article packaging for Sapho-native workflows.

Does the structured artifact bundle generation work for both kept and discarded articles?

Yes, structured artifact bundle generation works for both kept and discarded articles. The process provides deterministic structured outputs for validators across all article lifecycle outcomes without altering Daily Rail behavior.

What are the limitations of upgrading article packages to emit structured internal bundle files?

A key limitation is that upgrading article packages to emit structured internal bundle files is intended exclusively for Sapho-native workflows, meaning it may not suit non-Sapho environments seeking to alter public-facing Daily Rail behavior.