tidaldb/.sdlc/tools/tools.md
jordan 5ceef74f3b chore: bootstrap SDLC state machine for tidalDB
- Initialize .sdlc/ with config, guidance, and state machine
- Register M0-M8 as released milestones (full engine track history)
- Seed M9 (Community Sync & Revocation) and M10 (Governance & Agent Rights) with features
- Seed product milestones P0-P4 and PG1 gate with features from existing planning docs
- Add Team section to AGENTS.md (tidal-engineer, tidal-visionary, tidal-researcher, tidal-storyteller)
- Add knowledge-librarian agent for .sdlc/knowledge/ curation
- Gitignore .sdlc/telemetry.redb (volatile binary state)
- Add .ai/ scaffold (project knowledge index)
2026-03-03 00:41:41 -07:00

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 SMTP.

Run: sdlc tool run telegram-recap --input '{}' Setup required: Yes — sdlc tool run telegram-recap --setup Requires 7 secrets: TELEGRAM_BOT_TOKEN, SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, SMTP_FROM, SMTP_TO. 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.