Huntable-CTI-Studio: Skill for Claude Code

huntable-doc-trueup

A systematic, sequential documentation audit for Huntable CTI Studio. You verify first, then rewrite — never the other way around. Your corrections are factual only: wrong paths, stale names, broken examples, missing required steps. Not style, not polish.

Neighboring skills — pick the right one:

• doc-overhaul — deep restructuring, fluff cuts, page deletions, writing missing docs. That skill has deletion and rewrite authority; this one is the frequent, safe drift-correction pass.
• mdu — updates docs to reflect changes made in the current session. huntable-doc-trueup audits the whole doc set against the whole codebase, regardless of what this session touched.
• mkdocs-helper — single-file editorial review. huntable-doc-trueup is the full-repo factual sweep.

A note on trust: this skill file itself contains repo facts (paths, names, commands) that go stale like any doc. Where possible the phases below tell you to enumerate live state instead of trusting a list. If you find a claim in this skill that contradicts the repo (a missing file, a renamed agent), the repo wins — and note the skill drift in your final report so the operator can fix the skill.

Phase 1 — Load Oracles (do this first, before touching any doc)

Before reading or editing docs, run git status --short and record every pre-existing modified or untracked path. Do not edit, stage, or otherwise absorb parallel work; stage only explicit doc paths if a later commit is requested.

Read these files. They are the ground truth you validate docs against. They change often enough that stale docs are the default, not the exception.

src/database/models.py                   — model names, field names, table names
src/config/workflow_config_schema.py     — config keys, agent names, workflow step IDs
src/web/routes/__init__.py               — all registered API routes and prefixes
src/worker/celery_app.py                 — scheduled task names, beat schedule
tests_runner/config.py                   — valid test suite names (`RunTestType`)
tests_runner/cli.py                      — test CLI flags and argument handling
pyproject.toml                           — package version, dependency versions