block

---

name: block description: Flag a blocker with severity, owner, and due date. Checks for duplicates before creating. Use for "/block project: description --severity high --due friday". allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet user-invocable: true

/block — Flag Blocker

Create or update blocker notes with severity, owner, and due date.

Context

Today's date: !date +%Y-%m-%d Existing blockers: !ls blockers/*/*.md 2>/dev/null | tail -10

Reference template: @_templates/blocker.md Config: @_core/config.yaml Processing logic: @_core/PROCESSING.md

Input

User input: $ARGUMENTS

Processing Steps

1. Parse Input

   • Extract project (before colon)
   • Extract description
   • Parse flags: --severity, --owner, --due
   • Default severity: medium

2. Severity Mapping

   • critical/urgent/p0/p1 → high
   • medium/normal/p2 → medium
   • low/minor/p3 → low

3. Duplicate Check

   • Search blockers/{project}/*.md for similar open blockers
   • If similar found: Prompt user to update existing or create new

4. Create Blocker Note

   • Filename: blockers/{project}/{date}-{slug}.md
   • Apply template with extracted data
   • Add ## Links section

5. Update References

   • Add to project index if exists
   • If critical (high severity + due < 2 days): Flag for escalation

6. Append to Vault Log

   • Append entry to 01-index/_vault-log.md (see .claude/rules/vault-log.md)
   • Action: blocker
   • Details: severity, owner, one-line description

Output

Created: blockers/{project}/{date}-{slug}.md
Severity: {severity} | Owner: {owner} | Due: {due}

Export (Optional)

Supports --xlsx flag. See .claude/rules/export-formats.md for layout specs and workflow. Complete normal processing first, then generate the formatted file.