pacto-doctor

name	pacto-doctor
description	Agent contract for the Pacto doctor workflow.

Pacto Doctor Skill

Use this skill as an agent contract for the doctor workflow in Pacto projects.

Objective

Audit managed integration artifacts for drift and legacy patterns.

When To Use

Use when generated skills might be stale after manual edits or CLI/template upgrades.

Input Contract

Required Inputs

• None when tool auto-detection succeeds.

Optional Inputs

• --root <path> to target a specific project root.
• --tools <all|none|csv> for explicit tool selection.
• --format table|json for human vs automation output.
• --fail-on none|drift|legacy|any for CI enforcement.

Execution Contract

• Tool target: Cursor Agent and Codex (project skills under .agents/skills/)
• Recommended command: pacto doctor [--root ] [--tools <all|none|csv>] [--format table|json] [--fail-on none|drift|legacy|any]

Output Contract

• Reports managed artifact status (ok|missing|unmanaged|legacy_managed|stale|meta_mismatch|legacy_pattern).
• Provides recommended remediation action (typically pacto update --artifacts).
• Emits summary counters for drift and legacy findings.

Validation Checklist

• Confirm analyzed root and tool selection match user intent.
• Review drift/legacy findings before remediation.
• If CI use case, set explicit --fail-on policy.

Failure Modes and Handling

• No tools detected when --tools is omitted.
• Invalid tool list or fail-on/format flag values.
• Filesystem read errors while auditing artifacts.

Implementation Status

• Status: Implemented
• Fallback: If findings are expected but unresolved, run pacto update --artifacts and re-run pacto doctor.