Ole-Morten Duesund
31ffddfcf4
Aligns with CLAUDE.md (commit 3fef3d8) so both files agree on the
recommended prime invocation.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
6.6 KiB
DOGCAT WORKFLOW GUIDE
Rules
Run dcat prime --opinionated after compaction, clear, or new session
BEFORE writing any code for a new bug, feature, or change:
ask the user if you should create an issue first. No exceptions
for 'small' tasks — the rule exists for traceability, not
because the task is complex.
When creating or updating issues, write them so a fresh agent
with no prior context can pick them up. Include the why,
relevant file paths, error messages, and acceptance criteria —
don't assume shared knowledge.
When creating issues, set appropriate labels using --labels
based on the issue content (e.g. cli, tui, api, docs,
testing, refactor, ux, performance, etc.).
Do NOT batch-mark an entire backlog as in_progress upfront.
Mark each issue in_progress right when you start working on it.
When running multiple dcat commands, make separate parallel
tool calls instead of chaining with && and echo separators.
Before setting in_review: verify your work and cite actual output.
Quick Start
Allowed issue types, priorities, and statuses: Types: bug, chore, epic, feature, question, story, task Priorities: 0 (Critical), 1 (High), 2 (Medium, default), 3 (Low), 4 (Minimal) Statuses: draft, open, in_progress, in_review, blocked, deferred, closed
dcat create and dcat update both support --title, --description,
--priority, --acceptance, --notes, --labels, --parent, --manual,
--design, --external-ref, --depends-on, --blocks, --duplicate-of, --editor
-
Create: $ dcat create "Title" --type bug --priority 1 -d "Description"
-
List issues: $ dcat list - All open issues $ dcat list <parent_id> - Children of a parent $ dcat ready - Ready to work (no blockers) $ dcat blocked - All blocked issues Use --namespace or --all-namespaces to filter.
-
Update: $ dcat update --status in_progress
-
Close: $ dcat close --reason "Fixed"
Essential Commands
dcat create