automagik-hive: Command for Claude Code

Advanced Prompting Framework

Task Decomposition Pattern

Break complex tasks into trackable subtasks for clarity and progress monitoring:

<task_breakdown>
1. [Discovery] What to investigate
   - Identify affected components
   - Map dependencies
   - Document current state
   
2. [Implementation] What to change
   - Specific modifications
   - Order of operations
   - Rollback points
   
3. [Verification] What to validate
   - Success criteria
   - Test coverage
   - Performance metrics
</task_breakdown>

This pattern ensures systematic execution and allows agents to track progress through complex multi-step operations.

Auto-Context Loading with @ Pattern

Use @ symbols to automatically trigger file reading, eliminating manual context gathering:

[TASK]
Update authentication system
@src/auth/middleware.ts
@src/auth/config.json
@tests/auth.test.ts

Benefits:

• Agents automatically read files before starting
• No need for "first read X, then Y" instructions
• Ensures complete context from the start
• Reduces tool calls and latency

Example usage:

[CONTEXT]
Files to update:
@src/mastra/index.ts - Main configuration
@src/mastra/agents/*.ts - All agent files
Changes needed: Use consistent DB paths

Success/Failure Boundaries

Use visual markers to clearly define completion criteria and restrictions:

[SUCCESS CRITERIA]
✅ All tests pass
✅ No hardcoded paths
✅ Environment variables used consistently
✅ Memory properly initialized
✅ No console.log statements in production

[NEVER DO]
❌ Skip test coverage
❌ Commit API keys or secrets
❌ Use absolute file paths
❌ Leave TODO comments
❌ Accept partial completion as done

This pattern provides:

• Clear visual scanning of requirements
• Unambiguous completion criteria
• Explicit anti-patterns to avoid
• Reduced ambiguity in task interpretation

Concrete Examples Over Descriptions

Replace vague instructions with actual code snippets and specific patterns:

INSTEAD OF:

"Ensure proper error handling and logging"