Skip to content

Harvest: /iikit-core doctor — health diagnostics for project state #74

Description

@jbaruch

Status: Tier 2

Upstream spec-kit added specify status and specify doctor CLI commands (23bd6450 #1837 status, b9c1a1c7 #1828 doctor — later moved to community extension).

What we'd build

A new sub-command /iikit-core doctor that runs health diagnostics:

  • Broken cross-agent symlinks (.codex/skills/, .gemini/skills/, .opencode/skills/)
  • Stale .specify/context.json schema versions
  • Tessl tile drift (installed version vs registry latest)
  • Missing manifests (tile.json, CONSTITUTION.md)
  • Orphaned specs/NNN-* directories
  • Git hook installation state

Why it matters

/iikit-core already covers status partially. A dedicated doctor would catch the silent failures we've seen with broken symlinks and schema drift — fast triage when "something feels off."

Evidence

  • Upstream commits: 23bd6450 (#1837), b9c1a1c7 (#1828)

Cost

Small-Medium — new script in iikit-core/scripts/bash/; surface via /iikit-core doctor.

Sequencing

Tier 2.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions