storage

Persist Unified Process Artifacts to openspec/artifacts/{domain} paths.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/js-rom/Luis --skill storage-js-rom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: storage
Source: https://github.com/js-rom/Luis/tree/main/.agents/skills/storage
Command: npx skills add https://github.com/js-rom/Luis --skill storage-js-rom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Storage Skill ensures Unified Process Artifacts are persisted according to the active Artifact Store Policy, enabling reliable long-term storage, recovery after compaction, and traceability across domains.

Core Features & Use Cases

  • Master-only persistence: artifacts are written directly under openspec/artifacts/{domain}/... following the openspec conventions.
  • Automatic discipline folder creation: empty discipline folders are created (if needed) and versioned with placeholders to keep structure ready for artifacts.
  • State management & recovery: artifacts persistence updates openspec/state.yaml and related metadata to enable DAG state recovery.
  • Policy-driven behavior: detects Artifact Store Policy and defaults to openspec when policy is not detected; supports recovery and archiving flow as defined.

Quick Start

Persist Unified Process Artifacts to the OpenSpec master path for your domain (openspec/artifacts/{domain}) and verify the discipline folders exist.

Frequently Asked Questions about storage

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

FAQPage Schema
How do I persist Unified Process artifacts to the openspec master path?

Persisting Unified Process artifacts requires writing directly under openspec/artifacts/{domain}/... following the openspec conventions. This master-only approach ensures reliable long-term storage, recovery, and traceability across domains.

What does master-only mode mean for artifact storage and archiving?

Master-only mode disables archive and merge operations for artifact storage. Pending artifacts must be persisted directly to master paths with updated file lists to maintain the required master-only structure.

How does openspec artifact state management handle recovery after compaction?

State management handles recovery after compaction by updating openspec/state.yaml and related metadata during persistence. This process enables DAG state recovery and reliable traceability across domains.

What happens when no Artifact Store Policy is detected for artifact persistence?

When no Artifact Store Policy is detected, the system defaults to openspec mode for artifact persistence. If the policy is explicitly set to none, it returns inline results instead of writing to files.

Do I need to manually create discipline folders before persisting openspec artifacts?

No, manual creation is unnecessary. The system automatically creates empty discipline folders if needed and versions them with placeholders to keep the structure ready for artifact persistence.