skills.rest
catlog22
catlog22COMMUNITY
Explore all skills by this author →
GitHub

maestro-milestone-audit

Audit milestone cross-phase integrations and write verdict reports to .workflow.

511|63|Updated Mar 17, 2026
Search Tags:#automation#workflow#verification#milestone#cross-phase#audit-report#integration-audit
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-milestone-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maestro-milestone-audit
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/maestro-milestone-audit
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-milestone-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits a milestone's cross-phase integration health to identify blocking gaps, inconsistent interfaces, and test-coverage blind spots, then produces a clear PASS/CONDITIONAL/FAIL verdict to inform release decisions.

Core Features & Use Cases

  • Sequential phase collection: Reads .workflow/state.json, roadmap.md, and each phase's index.json, verification.json, and review.json to assemble phase status, tasks, and verification results.
  • Cross-phase analysis: Detects shared interface mismatches, data contract inconsistencies, dependency-chain issues, API surface breakages, and integration test gaps across phase boundaries.
  • Actionable output: Classifies findings by severity, provides prioritized remediation recommendations, optionally spawns an integration-checker agent for complex milestones, and writes a structured markdown audit report to the workflow directory.
  • Use Case: Validate release readiness for a multi-phase milestone before marking it complete.

Quick Start

Run a milestone integration audit for milestone v1.0 and generate the structured verdict report in the .workflow directory.

Frequently Asked Questions about maestro-milestone-audit

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

FAQPage Schema
How do I audit milestone integration readiness across multiple project phases?▼

Milestone integration audit reads state.json, roadmap.md, and phase-level verification files to detect cross-phase gaps, interface mismatches, and test coverage blind spots, producing a clear PASS, CONDITIONAL, or FAIL verdict for release decisions.

What is cross-phase integration analysis for multi-phase project roadmaps?▼

Cross-phase integration analysis examines shared interfaces, data contracts, dependency chains, and API surfaces across phase boundaries to identify inconsistencies and test coverage gaps that could block milestone completion.

How do I generate a milestone audit report with severity levels and remediation steps?▼

The audit classifies cross-phase findings by severity levels, provides prioritized remediation recommendations, and writes a structured markdown report to the .workflow directory at milestone-audit-{milestone}.md for release validation.

Can I automate milestone verification for complex multi-phase releases?▼

Yes, the audit operates on multi-phase project roadmaps by collecting status, dependencies, interfaces, and test coverage from workflow state files, optionally invoking an integration-checker agent for milestones with three or more phases.

Does the milestone audit work with existing workflow state files and verification data?▼

The audit requires .workflow/state.json, roadmap.md, and each phase's index.json, verification.json, and review.json files to assemble phase status, task details, dependencies, and verification results for cross-phase analysis.

What limitations exist when auditing cross-phase dependencies and interface mismatches?▼

The audit depends on structured workflow files being present and accurate; without valid state.json, roadmap.md, and per-phase verification files, it cannot detect interface mismatches, data contract inconsistencies, or integration test gaps.

Related Skills

Explore More Software Engineering Skills→
catlog22catlog22
511

maestro-milestone-complete

Archive completed milestones and update project state in repository workflows.

Community
Advanced
ArtRivArtRiv

gsd-plan-milestone-gaps

Group milestone audit gaps into executable fix phases and update ROADMAP.md.

Community
Intermediate
ev3rlitev3rlit

gsd-audit-milestone

Audit milestone completion against original intent before archiving.

Community
Advanced
Kingly-AgencyKingly-Agency

signal-amplifier

Detects weak signals across information sources to reveal emerging patterns.

Official
Advanced