agentcmd: Command for Claude Code

Move Spec

Move a spec folder between workflow folders (backlog/todo/done), update index.json, and optionally update status field.

Variables

• $specIdOrNameOrPath: $1 (required) - Either a timestamp ID (e.g., 2510241201), feature name (e.g., workflow-safety), or full path (e.g., .agent/specs/todo/2510241201-workflow-safety/)
• $targetFolder: $2 (required) - Target workflow folder: "backlog", "todo", or "done"

Instructions

• Search for the spec folder in all locations (backlog/, todo/, done/)
• Move the entire folder to the target folder
• Update index.json with new location
• Update the Status field in spec.md front matter based on target folder
• Support both old single-file specs and new folder-based specs
• Report the old and new paths

Workflow

1. Find the Spec Folder or File

   • Parse and resolve $specIdOrNameOrPath:
     • If it's a full path (contains /):
       • Use the path 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} (extract folder from file path: dirname({path}))
     • If not found in index.json, fallback to directory search:
       • Search in order: .agent/specs/backlog/, .agent/specs/todo/, .agent/specs/done/
       • For ID: Pattern {id}-*/
       • For feature name: Pattern *{feature-name}*/ (fuzzy match)
   • If still not found, report error and exit

2. Validate Target Folder

   • Ensure $targetFolder is one of: "backlog", "todo", or "done"
   • If invalid, report error and exit

3. Check for Conflicts

   • Check if a folder/file with the same name already exists in target folder
   • If conflict exists, report error and exit

4. Move the Folder

   • Move entire folder from current location to .agent/specs/${targetFolder}/[foldername]
   • Preserve the original folder name