tidaldb/.sdlc/tools/tools.md

1.7 KiB

SDLC Tools

Project-specific tools installed by sdlc. Use sdlc tool run <name> to invoke.

Run sdlc tool sync to regenerate this file from live tool metadata.


ama — AMA — Ask Me Anything

Answers questions about the codebase by searching a pre-built keyword index.

Run: sdlc tool run ama --question "..." Setup required: Yes — sdlc tool run ama --setup Indexes source files for keyword search (run once, then re-run when files change significantly)


quality-check — Quality Check

Runs checks from .sdlc/tools/quality-check/config.yaml and reports pass/fail.

Run: sdlc tool run quality-check Setup required: No Edit .sdlc/tools/quality-check/config.yaml to add your project's checks


dev-driver — Dev Driver

Finds the next development action and dispatches it — advances the project one step per tick.

Run: sdlc tool run dev-driver Setup required: No Configure via orchestrator: Label=dev-driver, Tool=dev-driver, Input={}, Recurrence=14400. See .sdlc/tools/dev-driver/README.md for full docs.


telegram-recap — Telegram Recap

Fetch and email a Telegram chat digest — pulls messages from the configured window and sends via Resend.

Run: sdlc tool run telegram-recap --input '{}' Setup required: Yes — sdlc tool run telegram-recap --setup Requires 5 secrets: TELEGRAM_BOT_TOKEN, RESEND_API_KEY, RESEND_FROM, RESEND_TO, TELEGRAM_CHAT_IDS (optional). Schedule with orchestrator (--every 86400) for a daily digest.


Adding a Custom Tool

Run sdlc tool scaffold <name> "<description>" to create a new tool skeleton. Then implement the run() function in .sdlc/tools/<name>/tool.ts and run sdlc tool sync.