tidaldb/.sdlc/tools/ama/README.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

983 B

AMA — Ask Me Anything

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

Setup (run once)

sdlc tool run ama --setup

Usage

sdlc tool run ama --question "where is JWT validation?"
sdlc tool run ama --question "how does feature transition work?"

How it works

  1. --setup walks source files, chunks them into 40-line windows, extracts keyword tokens, and writes .sdlc/tools/ama/index/chunks.json
  2. --run scores chunks by keyword overlap with your question, returns top file excerpts
  3. Your AI assistant reads the excerpts and synthesizes an answer

Configuration

Edit .sdlc/tools/ama/config.yaml to change which file extensions are indexed or to adjust chunk size, overlap, and result count.

Index location

.sdlc/tools/ama/index/chunks.json — gitignored, regenerate with --setup

Re-index when needed

Re-run --setup after significant file changes. It's fast and safe to run any time.