# Kimi Agent Workspace

**Agent:** Kimi (Moonshot AI)  
**Role:** Build Tier - Large-context feature drops, new subsystems, persona agents  
**Branch:** `kimi/agent-workspace-init`  
**Created:** 2026-03-14

---

## Quick Start

```bash
# Bootstrap Kimi workspace
bash .kimi/scripts/bootstrap.sh

# Resume work
bash .kimi/scripts/resume.sh
```

---

## Kimi Capabilities

Per AGENTS.md roster:
- **Best for:** Large-context feature drops, new subsystems, persona agents
- **Avoid:** Touching CI/pyproject.toml, adding cloud calls, removing tests
- **Constraint:** All AI computation runs on localhost (Ollama)

---

## Workspace Structure

```
.kimi/
├── AGENTS.md           # This file - workspace guide
├── README.md           # Workspace documentation
├── CHECKPOINT.md       # Current session state
├── TODO.md             # Task list for Kimi
├── scripts/
│   ├── bootstrap.sh    # One-time setup
│   ├── resume.sh       # Quick status + resume
│   └── dev.sh          # Development helpers
├── notes/              # Working notes
└── worktrees/          # Git worktrees (if needed)
```

---

## Development Workflow

1. **Before changes:**
   - Read CLAUDE.md and AGENTS.md
   - Check CHECKPOINT.md for current state
   - Run `make test` to verify green tests

2. **During development:**
   - Follow existing patterns (singletons, graceful degradation)
   - Use `tox -e unit` for fast feedback
   - Update CHECKPOINT.md with progress

3. **Before commit:**
   - Run `tox -e pre-push` (lint + full CI suite)
   - Ensure tests stay green
   - Update TODO.md
   - **CRITICAL: Stage files before committing** — always run `git add .` or `git add <files>` first
   - Verify staged changes are non-empty: `git diff --cached --stat` must show files
   - **NEVER run `git commit` without staging files first** — empty commits waste review cycles

---

## Useful Commands

```bash
# Testing
tox -e unit              # Fast unit tests
tox -e integration       # Integration tests
tox -e pre-push          # Full CI suite (local)
make test                # All tests

# Development
make dev                 # Start dashboard with hot-reload
make lint                # Check code quality
make format              # Auto-format code

# Git
bash .kimi/scripts/resume.sh     # Show status + resume prompt
```

---

## Contact

- **Gitea:** http://localhost:3000/rockachopa/Timmy-time-dashboard
- **PR:** Submit PRs to `main` branch