ot-doctor
- Run
./scripts/on-track-doctor.sh <target>from this skill. It is read-only. OnOK:, report that the project is up to date and stop. - Report every
FIND:line in the user's language, one per line: what is wrong and the fix you would apply, from the list in step 4. Foradr-untitled, propose the short title for each ADR, taken from its## Contextand## Decision. Forindex-invalid, propose one concrete fix per error; when the fix needs a fact you cannot settle (a missingsuperseded_by, a citation whose target is unknown), say so and propose no fix for it. - Offer the fixes and wait for the user's confirmation. The user may confirm all of them, some of them, or none. Apply only what was confirmed.
- Apply the confirmed fixes in this order, each one fully before the next:
- legacy-tree: if
on-track/already exists, stop and report the conflict. Otherwise movefast-track-aitoon-track, withgit mvwhen the path is tracked, and replacefast-track-ai/withon-track/in the paths inside the moved files. - legacy-block: delete the
fast-track-aimanaged block inAGENTS.md, from its BEGIN marker line to its END marker line, and nothing else. - block-missing, block-outdated, tree-missing: run
../ot-init/scripts/on-track-init.sh <target>once. It replaces the block in place, keeps the rest ofAGENTS.md, and creates what is missing without overwriting existing files. - adr-superseded: move each listed ADR to
on-track/decisions/archive/, withgit mvwhen tracked, content unchanged. - adr-untitled: replace only the
# ADR: <id>heading line with# ADR: <confirmed title>. - index-invalid: apply each confirmed fix, touching only the file the error names.
- legacy-tree: if
- Regenerate
on-track/INDEX.mdwith../ot-init/scripts/on-track-index.sh <target>, then run./scripts/on-track-doctor.sh <target>again. Report what was fixed, what remains open with itsFIND:line, and any index error.
The doctor edits only on-track/, the managed blocks in AGENTS.md, and the legacy fast-track-ai path. It deletes no artifact, invents no field value, and never commits, pushes, or deploys.
Path resolution: ./ paths and ../ot-* sibling paths resolve from this skill's installed directory, and on-track/ paths resolve from the target repository root.
Bundled scripts are local Bash with no network calls: on-track-doctor.sh reads the target and prints findings without writing anything. It compares the project with the installed package, so it cannot tell whether a newer package was published; updating the package is the installer's job. The owner index script reads frontmatter under on-track/ and writes only on-track/INDEX.md, or exits with validation errors and leaves it unchanged. When it prints a WARN: line, relay it to the user in one sentence at the end of your report; a warning never blocks the stage.