feat: Add Kimi agent workspace with development scaffolding
Create the Kimi (Moonshot AI) agent workspace per AGENTS.md conventions:
Workspace Structure:
- .kimi/AGENTS.md - Workspace guide and conventions
- .kimi/README.md - Quick reference documentation
- .kimi/CHECKPOINT.md - Session state tracking
- .kimi/TODO.md - Task list for upcoming work
- .kimi/notes/ - Working notes directory
- .kimi/plans/ - Plan documents
- .kimi/worktrees/ - Git worktrees (reserved)
Development Scripts:
- scripts/bootstrap.sh - One-time workspace setup (venv, deps, .env)
- scripts/resume.sh - Quick status check + resume prompt
- scripts/dev.sh - Development helpers (status, test, lint, format, clean, nuke)
Features:
- Validates Python 3.11+, venv, deps, .env, git config
- Provides quick status on git, tests, Ollama, dashboard
- Commands for testing, linting, formatting, cleaning
Per AGENTS.md:
- Kimi is Build Tier for large-context feature drops
- Follows existing project patterns
- No changes to source code - workspace only
2026-03-14 14:30:38 -04:00
|
|
|
# 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
|
2026-03-24 01:48:34 +00:00
|
|
|
- **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
|
feat: Add Kimi agent workspace with development scaffolding
Create the Kimi (Moonshot AI) agent workspace per AGENTS.md conventions:
Workspace Structure:
- .kimi/AGENTS.md - Workspace guide and conventions
- .kimi/README.md - Quick reference documentation
- .kimi/CHECKPOINT.md - Session state tracking
- .kimi/TODO.md - Task list for upcoming work
- .kimi/notes/ - Working notes directory
- .kimi/plans/ - Plan documents
- .kimi/worktrees/ - Git worktrees (reserved)
Development Scripts:
- scripts/bootstrap.sh - One-time workspace setup (venv, deps, .env)
- scripts/resume.sh - Quick status check + resume prompt
- scripts/dev.sh - Development helpers (status, test, lint, format, clean, nuke)
Features:
- Validates Python 3.11+, venv, deps, .env, git config
- Provides quick status on git, tests, Ollama, dashboard
- Commands for testing, linting, formatting, cleaning
Per AGENTS.md:
- Kimi is Build Tier for large-context feature drops
- Follows existing project patterns
- No changes to source code - workspace only
2026-03-14 14:30:38 -04:00
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 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
|
