agentcmd: Command for Claude Code

Implement

Follow the Workflow steps in the exact order to implement the spec then Report the completed work.

Variables

• $specIdOrNameOrPath: $1 (required) - Either a timestamp ID (e.g., 2510241201), feature name (e.g., workflow-safety), or full path

Instructions

Parse and resolve $specIdOrNameOrPath:

• If it's a full path (contains /): use as-is
• Otherwise, look up in .agent/specs/index.json:
  • For timestamp ID: Match by id field
  • For feature name: Fuzzy match path (e.g., message-queue matches todo/2510241201-message-queue-implementation/spec.md)
  • Use path from index: .agent/specs/{path}
• If not found in index.json, fallback to directory search:
  • Search in order: todo/, backlog
  • For ID: Pattern {id}-*/spec.md
  • For feature name: Pattern *{feature-name}*/spec.md (fuzzy match)
• If still not found: stop and report error

Task Tracking Requirements

CRITICAL: You MUST track your progress in the spec file as you work. This is NOT optional.

What to Update

1. Individual Tasks - Check off IMMEDIATELY after completing each task:

   • Change - [ ] 1.1 Task description to - [x] 1.1 Task description
   • Do this AFTER finishing each task, NOT in batches
   • Never move to the next task without checking off the current one

2. Completion Notes - Fill in after finishing each task group/phase:

   • Each task group has a #### Completion Notes section
   • Write 2-4 bullet points with:
     • What was implemented
     • Any deviations from the plan
     • Important context for reviewers
     • Known issues or follow-ups

Example of Good Progress Tracking

Before starting task 1.1:

### 1: Project Initialization

- [ ] 1.1 Initialize Bun project
- [ ] 1.2 Configure package.json

After completing task 1.1:

### 1: Project Initialization

- [x] 1.1 Initialize Bun project
- [ ] 1.2 Configure package.json

After completing all tasks in group 1:

### 1: Project Initialization

- [x] 1.1 Initialize Bun project
- [x] 1.2 Configure package.json

#### Completion Notes

- Project initialized with Bun and TypeScript
- Used stricter tsconfig settings than spec suggested for better type safety
- All dependencies installed successfully