promote-baseline

Promote a DONE cycle to baseline with validation and history updates.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/leuzeus/aidn --skill promote-baseline
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: promote-baseline
Source: https://github.com/leuzeus/aidn/tree/main/tests/fixtures/repo-installed-core/.codex/skills/promote-baseline
Command: npx skills add https://github.com/leuzeus/aidn --skill promote-baseline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Promotes a DONE cycle to baseline when conditions are met and updates the baseline current/history and snapshot to reflect completed work.

Core Features & Use Cases

  • Validates that the cycle is DONE (or VERIFYING completed) and that there are no unresolved gaps.
  • Updates to docs/audit/baseline/current.md and docs/audit/baseline/history.md, ensuring version bump and coherence across current, history, and snapshot.
  • Integrates pre-write admission and optional runtime hooks to verify traceability, perform repairs, and maintain baseline integrity.

Quick Start

Promote a selected DONE cycle to baseline after verification.

Frequently Asked Questions about promote-baseline

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

FAQPage Schema
How do I promote a completed workflow cycle to a baseline version?▼

To promote a completed workflow cycle to a baseline, the process validates that the cycle is DONE, checks for unresolved gaps, and then updates the baseline current and history files to reflect the completed work with a version bump.

What is a baseline promotion in a versioned audit workflow?▼

Baseline promotion in a versioned audit workflow is the process of advancing a verified cycle to an official snapshot, ensuring coherent updates across current, history, and index files while maintaining traceability and integrity.

Can I promote a cycle to baseline if there are unresolved gaps in the audit history?▼

No, you cannot promote a cycle if unresolved gaps exist. The process applies pre-write admission and validates cycle state to ensure there are no gaps before updating baseline documents and history.

How do baseline updates maintain traceability after promoting a cycle?▼

Baseline updates maintain traceability by applying pre-write admission checks and optional runtime synchronization hooks that verify history coherence, perform repairs, and update current and history markdown files simultaneously.

What happens to the audit history files when a cycle is promoted to baseline?▼

When a cycle is promoted to baseline, the audit history files receive a version bump and coherent updates alongside the current markdown snapshot, ensuring the baseline accurately reflects the newly completed work.

Does baseline promotion support runtime synchronization and repair for audit snapshots?▼

Yes, baseline promotion supports optional runtime synchronization and repair hooks defined in the workflow, allowing you to verify traceability and maintain snapshot integrity during the promotion process.