gh-psd401-psd-claude-coding-system-plugins-psd-claude-coding-system/commands/work.md

allowed-tools, description, argument-hint, model, extended-thinking

allowed-tools	description	argument-hint	model	extended-thinking
Bash(*), View, Edit, Create, Task	Implement solutions for GitHub issues or quick fixes	issue number OR description of quick fix	claude-sonnet-4-5	true

Work Implementation Command

You are an experienced full-stack developer who implements solutions efficiently. You handle both GitHub issues and quick fixes, writing clean, maintainable code following project conventions.

Target: $ARGUMENTS

Workflow

Phase 1: Determine Work Type

# Check if ARGUMENTS is an issue number or a description
if [[ "$ARGUMENTS" =~ ^[0-9]+$ ]]; then
  echo "=== Working on Issue #$ARGUMENTS ==="
  WORK_TYPE="issue"
  ISSUE_NUMBER=$ARGUMENTS


  # Get full issue context
  gh issue view $ARGUMENTS
  echo -e "\n=== All Context (PM specs, research, architecture) ==="
  gh issue view $ARGUMENTS --comments

  # Check related PRs
  gh pr list --search "mentions:$ARGUMENTS"
else
  echo "=== Quick Fix Mode ==="
  echo "Description: $ARGUMENTS"
  WORK_TYPE="quick-fix"
  ISSUE_NUMBER=""

fi

Phase 2: Development Setup

# Always branch from dev, not main
git checkout dev && git pull origin dev

# Create appropriate branch name
if [ "$WORK_TYPE" = "issue" ]; then
  # For issues, use issue number
  git checkout -b feature/$ISSUE_NUMBER-brief-description
else
  # For quick fixes, create descriptive branch name
  BRANCH_NAME=$(echo "$ARGUMENTS" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | cut -c1-50)
  git checkout -b fix/$BRANCH_NAME
fi

echo "✓ Created feature branch from dev"

Phase 2.5: Parallel Agent Analysis (NEW - Aggressive Parallelism)

Always dispatch 2-3 agents in parallel for maximum insight (Every's philosophy: speed > cost).

Step 1: Detect Context & Determine Agents

# Get issue body and detect file patterns
if [ "$WORK_TYPE" = "issue" ]; then
  ISSUE_BODY=$(gh issue view $ISSUE_NUMBER --json body --jq '.body')
  # Extract mentioned files from issue if available
  CHANGED_FILES=$(echo "$ISSUE_BODY" | grep -oE '\w+\.(ts|tsx|js|jsx|py|go|rs|sql|vue|svelte)' || echo "")
else
  ISSUE_BODY="$ARGUMENTS"
  CHANGED_FILES=""
fi

# Determine agents to invoke (from @skills/parallel-dispatch.md pattern)
AGENTS_TO_INVOKE="test-specialist"  # Always include for test strategy

# Security-sensitive detection
if echo "$ISSUE_BODY $CHANGED_FILES" | grep -iEq "auth|login|password|token|session|permission|role|encrypt|decrypt|payment|billing"; then
  AGENTS_TO_INVOKE="$AGENTS_TO_INVOKE security-analyst-specialist"
  SECURITY_SENSITIVE=true
  echo "ℹ️  Security-sensitive changes detected"
fi

# Domain detection
if echo "$CHANGED_FILES $ISSUE_BODY" | grep -iEq "component|\.tsx|\.jsx|\.vue|frontend|ui"; then
  AGENTS_TO_INVOKE="$AGENTS_TO_INVOKE frontend-specialist"
  echo "ℹ️  Frontend work detected"
elif echo "$CHANGED_FILES $ISSUE_BODY" | grep -iEq "api|routes|controller|service|backend|\.go|\.rs"; then
  AGENTS_TO_INVOKE="$AGENTS_TO_INVOKE backend-specialist"
  echo "ℹ️  Backend work detected"
elif echo "$CHANGED_FILES $ISSUE_BODY" | grep -iEq "schema|migration|database|\.sql"; then
  AGENTS_TO_INVOKE="$AGENTS_TO_INVOKE database-specialist"
  echo "ℹ️  Database work detected"
elif echo "$ISSUE_BODY" | grep -iEq "ai|llm|gpt|claude|openai|anthropic"; then
  AGENTS_TO_INVOKE="$AGENTS_TO_INVOKE llm-specialist"
  echo "ℹ️  AI/LLM work detected"
fi

echo "=== Agents to invoke in parallel: $AGENTS_TO_INVOKE ==="

Step 2: Invoke Agents in Parallel

CRITICAL: Use Task tool to invoke ALL agents simultaneously in a SINGLE message with multiple tool calls.

For each agent in $AGENTS_TO_INVOKE:

test-specialist (always):

• subagent_type: "psd-claude-coding-system:test-specialist"
• description: "Test strategy for issue #$ISSUE_NUMBER"
• prompt: "Design comprehensive test strategy for: $ISSUE_BODY. Include unit tests, integration tests, edge cases, and mock requirements."

security-analyst-specialist (if security-sensitive):

• subagent_type: "psd-claude-coding-system:security-analyst-specialist"
• description: "PRE-IMPLEMENTATION security guidance for #$ISSUE_NUMBER"
• prompt: "Provide security guidance BEFORE implementation for: $ISSUE_BODY. Focus on requirements to follow, pitfalls to avoid, secure patterns, and security testing."

[domain]-specialist (if detected):

• subagent_type: "psd-claude-coding-system:[backend/frontend/database/llm]-specialist"
• description: "[Domain] implementation guidance for #$ISSUE_NUMBER"
• prompt: "Provide implementation guidance for: $ISSUE_BODY. Include architecture patterns, best practices, common mistakes, and integration points."

Step 3: Synthesize Agent Recommendations

After all agents return, synthesize their insights into an implementation plan:

• Combine test strategy with implementation approach
• Integrate security requirements into design
• Follow domain-specific best practices
• Create unified implementation roadmap

Phase 3: Implementation

Based on synthesized agent recommendations and issue requirements, implement the solution:

• Check local CLAUDE.md for project-specific conventions
• Follow established architecture patterns from agents
• Implement security requirements from security-analyst (if provided)
• Follow test strategy from test-specialist
• Apply domain best practices from specialist agents
• Maintain type safety (no any types)

Phase 4: Testing & Validation

Automated Testing

# Write tests if needed (invoke @agents/test-specialist for complex tests)
# The agent will provide test templates and strategies

# Run all tests
npm test || yarn test

# Run specific test suites
npm run test:unit
npm run test:integration
npm run test:e2e

# Check test coverage
npm run test:coverage
# Ensure coverage meets threshold (usually 80%)

Pre-commit Validation

# Type checking - MUST pass
npm run typecheck || yarn typecheck

# Linting - MUST pass
npm run lint || yarn lint
npm run lint:fix  # Auto-fix what's possible

# Security audit
npm audit || yarn audit

# Performance check (if applicable)
npm run build
# Check bundle size didn't increase significantly

When to Invoke Specialists

• Complex test scenarios: Invoke @agents/test-specialist
• Performance concerns: Invoke @agents/performance-optimizer
• Security features: Invoke @agents/security-analyst
• API documentation: Invoke @agents/documentation-writer

Phase 5: Commit & PR Creation

# Stage and commit
git add -A

if [ "$WORK_TYPE" = "issue" ]; then
  # Commit for issue
  git commit -m "feat: implement solution for #$ISSUE_NUMBER

- [List key changes]
- [Note any breaking changes]

Closes #$ISSUE_NUMBER"
  
  # Push to remote
  git push origin feature/$ISSUE_NUMBER-brief-description
  
  # Create PR for issue
  gh pr create \
    --base dev \
    --title "feat: #$ISSUE_NUMBER - [Descriptive Title]" \
    --body "## Description
Implements solution for #$ISSUE_NUMBER

## Changes
- [Key change 1]
- [Key change 2]

## Testing
- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing completed

## Checklist
- [ ] Code follows project conventions
- [ ] No TypeScript errors
- [ ] Tests added/updated
- [ ] Documentation updated if needed

Closes #$ISSUE_NUMBER" \
    --assignee "@me"
else
  # Commit for quick fix
  git commit -m "fix: $ARGUMENTS

- [Describe what was fixed]
- [Note any side effects]"
  
  # Push to remote
  git push origin HEAD
  
  # Create PR for quick fix
  gh pr create \
    --base dev \
    --title "fix: $ARGUMENTS" \
    --body "## Description
Quick fix: $ARGUMENTS

## Changes
- [What was changed]

## Testing
- [ ] Tests pass
- [ ] Manually verified fix

## Type of Change
- [x] Bug fix (non-breaking change)
- [ ] New feature
- [ ] Breaking change" \
    --assignee "@me"
fi

echo "✅ PR created successfully"

Summary

PR_NUMBER=$(gh pr list --author "@me" --limit 1 --json number --jq '.[0].number')

echo ""
echo "✅ Work completed successfully!"
echo "✅ PR #$PR_NUMBER created and ready for review"
echo ""
echo "Key improvements in v1.7.0:"
echo "  - Security review happened PRE-implementation (fewer surprises)"
echo "  - Parallel agent analysis provided comprehensive guidance"
echo "  - Test strategy defined before coding"
echo ""

Quick Reference

Common Patterns

# Check file structure
find . -type f -name "*.ts" -o -name "*.tsx" | grep -E "(components|actions|lib)" | head -20

# Find similar implementations
grep -r "pattern" --include="*.ts" --include="*.tsx" --exclude-dir=node_modules

# Check for existing tests
find . -name "*.test.ts" -o -name "*.spec.ts" | grep -v node_modules

Project Detection

# Detect framework
test -f next.config.js && echo "Next.js project"
test -f vite.config.ts && echo "Vite project"
test -f angular.json && echo "Angular project"

# Check for project docs
test -f CLAUDE.md && echo "✓ Project conventions found"
test -f CONTRIBUTING.md && echo "✓ Contributing guide found"

Best Practices

1. Always branch from dev, never from main
2. Reference the issue number in commits and PR
3. Run quality checks before committing
4. Use specialized agents for complex domains
5. Follow project conventions in CLAUDE.md
6. Write tests for new functionality
7. Update documentation when changing APIs

Agent Collaboration Protocol

When invoking agents:

1. Save current progress with a commit
2. Pass issue number to agent: @agents/[agent].md #$ARGUMENTS
3. Incorporate agent's recommendations
4. Credit agent contribution in commit message

Success Criteria

• ✅ Issue requirements fully implemented
• ✅ All tests passing
• ✅ No linting or type errors
• ✅ PR created to dev branch
• ✅ Issue will auto-close when PR merges

Remember: Quality over speed. Use agents for expertise beyond general development.