Document commit-per-task, documentation hygiene, and td lifecycle requirements for all agents working in this repo. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.0 KiB
1.0 KiB
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Agent Workflow Rules
- Commit after every task: When a task is complete, stage all changed files and create a git commit before marking the task done.
- Keep documentation current: Update
CLAUDE.mdwith any new commands, architecture details, or setup steps introduced by your task. UpdatePRD.mdonly if scope/design decisions changed. - Mark tasks in td:
td start <id>when beginning,td close <id>when done.
Task Management
This project uses td (a local CLI) for task tracking. At the start of each session:
td usage --new-session # required at conversation start or after /clear
td usage -q # quick check for subsequent reads
Optional session labeling:
td session "name" # label the current session
td session --new # force a new session in the same terminal context
Task state is stored in .todos/issues.db (SQLite).