forked from Rockachopa/Timmy-time-dashboard
Hermes Agent
6233a8ccd6
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
92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
# 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
|
|
|
|
---
|
|
|
|
## 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
|