.kimi-code

Imported from justintanner/videobook (.kimi-code/AGENTS.md). Install upstream with npx skills add justintanner/videobook --skill .kimi-code. Copyright stays with the author.

Beads Issue Tracking

This project uses Beads (bd) for issue tracking.

Core Rules

• Track ALL work in bd (never use markdown TODOs or comment-based task lists)
• Use bd ready to find available work
• Use bd create to track new issues/tasks/bugs
• Treat commit, push, and Dolt remote sync as policy-controlled handoff actions
• Run bd prime for complete workflow context (SSOT for operational commands)
• Default to conservative git authority: report status and proposed commands unless the user, orchestrator, or repository profile explicitly authorizes commit/sync/push

Quick Reference

bd prime                              # Load complete workflow context (SSOT)
bd ready                              # Show issues ready to work (no blockers)
bd list --status=open                 # List all open issues
bd create "title" -t task -p 2        # Create new issue
bd update <id> --claim                # Claim work atomically
bd close <id>                         # Mark complete
bd dep add <issue> <depends-on>       # Add dependency
bd dolt push                          # Sync with remote when authorized

Workflow

1. Check for ready work: bd ready
2. Claim an issue atomically: bd update <id> --claim
3. Do the work
4. Mark complete: bd close <id>
5. Handoff: report changed files, validation, issue status, and any proposed commit/sync/push commands

Issue Types

• bug - Something broken
• feature - New functionality
• task - Work item (tests, docs, refactoring)
• epic - Large feature with subtasks
• chore - Maintenance (dependencies, tooling)

Priorities

• 0 - Critical (security, data loss, broken builds)
• 1 - High (major features, important bugs)
• 2 - Medium (default, nice-to-have)
• 3 - Low (polish, optimization)
• 4 - Backlog (future ideas)

Context Loading

Run bd prime to get complete workflow documentation in AI-optimized format. bd prime is the single source of truth for operational commands and session workflow.

For detailed docs: see AGENTS.md, QUICKSTART.md, or run bd --help