pomodoro-mate/AGENTS.md

Project Expertise (Mulch)

This project uses Mulch for structured expertise management.

At the start of every session, run:

mulch prime

This injects project-specific conventions, patterns, decisions, and other learnings into your context. Use mulch prime --files src/foo.ts to load only records relevant to specific files.

Before completing your task, review your work for insights worth preserving — conventions discovered, patterns applied, failures encountered, or decisions made — and record them:

mulch record <domain> --type <convention|pattern|failure|decision|reference|guide> --description "..."

Link evidence when available: --evidence-commit <sha>, --evidence-bead <id>

Run mulch status to check domain health and entry counts. Run mulch --help for full usage. Mulch write commands use file locking and atomic writes — multiple agents can safely record to the same domain concurrently.

Before You Finish

1. Discover what to record:

   mulch learn
   

2. Store insights from this work session:

   mulch record <domain> --type <convention|pattern|failure|decision|reference|guide> --description "..."
   

3. Validate and commit:

   mulch sync
   

Issue Tracking (Seeds)

This project uses Seeds for git-native issue tracking.

At the start of every session, run:

sd prime

This injects session context: rules, command reference, and workflows.

Quick reference:

• sd ready — Find unblocked work
• sd create --title "..." --type task --priority 2 — Create issue
• sd update <id> --status in_progress — Claim work
• sd close <id> — Complete work
• sd dep add <id> <depends-on> — Add dependency between issues
• sd sync — Sync with git (run before pushing)

Before You Finish

1. Close completed issues: sd close <id>
2. File issues for remaining work: sd create --title "..."
3. Sync and push: sd sync && git push