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.