Lifecycle Hooks

This skill defines automated behaviors that trigger at specific points in the agent workflow for the core-tools package.

On before_action

Trigger: Fires before the agent executes any action (file write, shell command, etc.) Applies when: Action matches

Write|Edit|Bash

Auto-approve file operations targeting deep-analysis session and cache directories. This allows the deep-analysis workflow to write session files (checkpoints, findings, cache) without requiring manual approval for each operation.

The implementation logic is in references/auto-approve-da-session.sh. This script:

• Checks if the file operation targets

  .agents/sessions/__da_live__/

  ,

  .agents/sessions/exploration-cache/

  , or

  .agents/sessions/da-*/

  directories
• Auto-approves matching operations to enable autonomous session management
• Passes through all other operations to normal permission flow
• Expected input: Action context as JSON on stdin (with

  tool_name

  and

  tool_input

  fields)
• Expected output: JSON permission decision or empty (no opinion)

Integration Notes

This skill documents lifecycle automation that was originally implemented as platform-specific hooks. When integrating with a specific agent platform:

• Hook registration: Map the

  before_action

  trigger to the platform's pre-execution hook mechanism (e.g.,

  PreToolUse

  in Claude Code, pre-action middleware in other platforms)
• Matcher pattern: The trigger should only fire for file write, file edit, and shell command actions
• Timeout: The approval script should complete within 5 seconds
• Fail-safe behavior: If the script fails or times out, fall through to normal permission flow (never block the agent)
• Path patterns: The script matches against

  .agents/sessions/

  subdirectories specific to the deep-analysis workflow