deciduous: Command for Claude Code

Work Transaction

USE THIS BEFORE STARTING ANY IMPLEMENTATION.

This skill creates the required deciduous nodes BEFORE you write any code. The Edit/Write hooks will BLOCK you if you don't have a recent node.

Step 1: Create the Goal Node

Based on $ARGUMENTS (or the user's most recent request), create a goal node:

# Create goal with the user's request captured verbatim
deciduous add goal "$ARGUMENTS" -c 90 --prompt-stdin << 'EOF'
[INSERT THE EXACT USER REQUEST HERE - VERBATIM, NOT SUMMARIZED]
EOF

IMPORTANT: The prompt must be the user's EXACT words, not your summary.

Step 2: Announce the Goal ID

After creating the goal, tell the user:

• The goal ID that was created
• What you're about to implement
• That you'll create action nodes as you work

Step 3: Before Each Major Edit

Before editing files, create an action node:

deciduous add action "What you're about to implement" -c 85 -f "file1.rs,file2.rs"
deciduous link <goal_id> <action_id> -r "Implementation step"

Other agents working at the same time? Before editing a file another agent may be changing, read deciduous board read --unanswered <your-label>, and post an interface change on the board (deciduous board post --as <your-label> -s "..." -m "@owner ...") before you make it. Never coordinate through a scratch or markdown file.

Step 4: After Completion

When the work is done:

# After committing
deciduous add outcome "What was accomplished" -c 95 --commit HEAD
deciduous link <action_id> <outcome_id> -r "Implementation complete"

# Anything the graph server has not got?
deciduous remote status

Before you report the work finished, check the board once more (deciduous board read --unanswered <your-label>) and answer what is there with --reply-to <id>.

Step 5: Attach Supporting Documents (Optional)

If the work produced or referenced important files (diagrams, specs, screenshots):

deciduous doc attach <goal_id> path/to/diagram.png -d "Architecture diagram"
deciduous doc attach <action_id> path/to/spec.pdf --ai-describe