Timmy-time-dashboard/.kimi/README.md

# Kimi Agent Workspace for Timmy Time

This directory contains the Kimi (Moonshot AI) agent workspace for the Timmy Time project.

## About Kimi

Kimi is part of the **Build Tier** in the Timmy Time agent roster:
- **Strengths:** Large-context feature drops, new subsystems, persona agents
- **Model:** Paid API with large context window
- **Best for:** Complex features requiring extensive context

## Quick Commands

```bash
# Check workspace status
bash .kimi/scripts/resume.sh

# Bootstrap (first time)
bash .kimi/scripts/bootstrap.sh

# Development
make dev                 # Start the dashboard
make test                # Run all tests
tox -e unit              # Fast unit tests only
```

## Workspace Files

| File | Purpose |
|------|---------|
| `AGENTS.md` | Workspace guide and conventions |
| `CHECKPOINT.md` | Current session state |
| `TODO.md` | Task list and priorities |
| `scripts/bootstrap.sh` | One-time setup script |
| `scripts/resume.sh` | Quick status check |
| `scripts/dev.sh` | Development helpers |

## Conventions

Per project AGENTS.md:
1. **Tests must stay green** - Run `make test` before committing
2. **No cloud dependencies** - Use Ollama for local AI
3. **Follow existing patterns** - Singletons, graceful degradation
4. **Security first** - Never hard-code secrets
5. **XSS prevention** - Never use `innerHTML` with untrusted content

## Project Links

- **Dashboard:** http://localhost:8000
- **Repository:** http://localhost:3000/rockachopa/Timmy-time-dashboard
- **Docs:** See `CLAUDE.md` and `AGENTS.md` in project root