# Gotrino Assistant

A development assistant with skills for inclusion, triage, impact analysis, and more.

## Quick Reference

### Fast Checks (run anytime)
| Command | What it does |
|---------|--------------|
| `/guardian [path]` | Quick inclusion gut-check (lightweight) |
| `/language-check [path]` | Scan for non-inclusive language |
| `/names-check [path]` | Check name diversity in examples |
| `/i18n-check [path]` | Find internationalization issues |

### Deeper Analysis
| Command | What it does |
|---------|--------------|
| `/examples-audit [path]` | Analyze mock data for cultural assumptions |
| `/inclusion-audit [path]` | Comprehensive inclusion review |
| `/test-assumption [path]` | Identify hidden assumptions about users |

### Debt Analysis
| Command | What it does |
|---------|--------------|
| `/code-debt [path]` | TODO markers, dead code, deprecated APIs, oversized units |
| `/doc-debt [path]` | Stale docs, missing API docs, broken links, undocumented env vars |
| `/test-debt [path]` | Skipped tests, untested public APIs, flaky patterns |
| `/dep-debt` | Outdated, unused, or abandoned dependencies |
| `/design-debt [path]` | Inconsistent patterns, architectural drift, duplicated logic |
| `/debt-audit [path]` | Run all debt dimensions, synthesize cross-cutting findings |

### Utilities
| Command | What it does |
|---------|--------------|
| `/inclusive-names` | Generate diverse name suggestions |
| `/explain [path]` | Create decision record in `decisions/` |
| `/impact [path]` | Analyze change impact before making it |
| `/triage` | Triage an incoming request, draft a ready-to-file issue |

### Setup
| Command | What it does |
|---------|--------------|
| `/teach-charter` | Configure plugin for your project |

## Typical Workflow

**Starting a new project:**
1. Run `/teach-charter` to set up your `.assistant-config.md`
2. Define your scope (US-only? Global? etc.)
3. Set priorities for your team

**During development:**
- Run `/guardian` after generating forms, UI, or examples
- Chain it: "create the signup form, then /guardian it"
- Run focused checks (`/language-check`, `/names-check`) as needed

**Before shipping:**
- Run `/inclusion-audit` for comprehensive review
- Run `/test-assumption` on user-facing flows

## Configuration

Your settings are stored in `.assistant-config.md`:

- **Scope decisions**: What's in/out of scope (e.g., i18n for US-only products)
- **Acknowledged findings**: Issues you've reviewed and accepted
- **Priorities**: What matters most for your project
- **Decisions location**: Where `/explain` saves decision records (default: `decisions/`)

Run `/teach-charter` to create or update this file.

## Philosophy

This assistant isn't a linter. It's a **second pair of eyes** that asks:

> "Who might this exclude? What assumptions are baked in?"

It won't catch everything, and not everything it catches needs fixing. Use judgment. The goal is code that welcomes more users, not compliance with rules.