dan/skills
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
skills/docs/report-ai-tools-doctor-implementation.md
dan 437265b916 feat: add spec-review skill and ai-tools-doctor docs 
spec-review: Multi-model review of spec-kit artifacts using orch
- SKILL.md with progressive disclosure pattern
- Review processes: spec, plan, tasks, gate-check
- Prompts for critique, review, and go/no-go decisions

ai-tools-doctor: RFC and implementation report for diagnostics skill

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-15 00:43:52 -08:00

2.2 KiB
Raw Permalink Blame History

AI Tools Doctor Implementation Report

Date: 2025-12-01 Status: MVP Complete RFC: docs/rfc-ai-tools-doctor.md

Summary

Implemented ai-tools-doctor CLI with check and sync commands per RFC. MVP scope - no bump command yet.

What Was Built

dotfiles repo

config/ai-tools/tools.json - Updated manifest

  • Added source field (npm/nix) to each tool
  • Pinned versions (was "latest")
  • Added nix tools (opencode, beads)

bin/ai-tools-doctor - New CLI (212 lines bash)

  • check - Compare installed vs declared versions
  • check --json - Machine-readable output
  • check --quiet - Exit code only
  • sync - Install/update npm tools to declared versions

skills repo

skills/ai-tools-doctor/ - Skill for Claude Code / OpenCode

  • SKILL.md - Agent instructions
  • README.md - Human documentation

Deviations from RFC

RFC Implementation Reason
Exit code 1 for "updates available" Exit 0 for success, 1 for errors only Non-zero confuses many tools
expected_version for nix version for all Consistency
opencode version 0.2.1 1.0.119 RFC had wrong version

Current Tool Versions

claude-code  2.0.55   (npm)
openai-codex 0.63.0   (npm)
opencode     1.0.119  (nix)
beads        0.26.0   (nix)

Still TODO

  1. Delete old script - bin/ai-tools-sync.sh still exists, can be removed
  2. Home Manager integration - Symlink manifest to ~/.config/ai-tools/
  3. Session hook - Optional: run check on agent session start
  4. Delete obsolete skill - .claude/skills/update-claude/ per RFC

Testing

# All pass
ai-tools-doctor check           # Human output
ai-tools-doctor check --json    # JSON output
ai-tools-doctor check --quiet   # Exit code only
ai-tools-doctor sync            # Syncs npm tools

Files Changed

dotfiles/
├── config/ai-tools/tools.json  (modified)
└── bin/ai-tools-doctor         (new)

skills/
└── skills/ai-tools-doctor/
    ├── SKILL.md                (new)
    └── README.md               (new)

Next Steps

  1. Review and commit dotfiles changes
  2. Add to Home Manager if needed
  3. Consider bump command for future (fetches latest from npm registry)