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

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

# 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

# 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