5ceef74f3b
- 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)
37 lines
983 B
Markdown
37 lines
983 B
Markdown
# AMA — Ask Me Anything
|
|
|
|
Answers questions about the codebase by searching a pre-built keyword index.
|
|
|
|
## Setup (run once)
|
|
|
|
```bash
|
|
sdlc tool run ama --setup
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
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.
|