CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-hooks

Four lifecycle hooks every agent runs: on-session-start scans LESSONS-LEARNED.md and resumes checkpoints, on-pre-delegate verifies tracker issues and file partitions, on-post-delegate runs fast-review and CI checks, on-session-end executes the session guard and writes logs. Use when starting a new session, running pre-flight checks before delegation, coordinating between agents, reviewing a completed handoff, or wrapping up a session. Trigger terms: multi-agent setup, delegate tasks, agent coordination, session management, run pre-flight checks, start a new session, coordinate between agents, wrap up session

100

Quality

100%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Agent Lifecycle Hooks

Conventions (not auto-triggers) agents execute at specific lifecycle points. Team Lead includes hook reminders in delegation prompts; specialists follow them in their own workflow.

on-session-start → [work loop] → on-session-end
                        ↓   ↑
               on-pre-delegate → on-post-delegate

on-session-start

#Action
1rg -n "keyword" .opencastle/LESSONS-LEARNED.md
2cat .opencastle/SESSION-CHECKPOINT.md (resume if exists)
3rg -n "ERROR|FAIL" .opencastle/AGENT-FAILURES.md || true
4cat .opencastle/agents/skill-matrix.json | jq '.bindings' — load domain skills

See HOOKS-REFERENCE.md for extended startup checks (approval polling, skill-matrix verification).


on-session-end

⛔ HARD GATE — See logging-mandatory. Load observability-logging for the Pre-Response Quality Gate.

#Action
1opencastle doctor --fix (session guard)
2opencastle log --type session ...
3Write .opencastle/SESSION-CHECKPOINT.md if work is incomplete
4Flag for memory merge if 5+ new lessons

on-pre-delegate — Team Lead only

#Check
1Tracker issue exists (gh issue view TAS-XX)
2File partition clean (comm -12 <(sort agent1-files) <(sort agent2-files) = empty)
3Upstream deps Done (gh issue view TAS-XX --json state -q '.state' = CLOSED)
4Prompt has exact file paths + acceptance criteria
5Prompt includes "Read LESSONS-LEARNED.md first"
65+ files → load context-map skill

All 6 must pass before runSubagent. See HOOKS-REFERENCE.md for example commands per check.

on-post-delegate — Team Lead only

#Action
1 opencastle log --type=delegation --issue=TAS-XX --status=complete
2Run fast-review skill
3pnpm lint && pnpm typecheck && pnpm test
4gh issue view TAS-XX --json body -q '.body' — verify each AC met
5If agent retried → verify lesson added via self-improvement
6Move to Done or re-delegate; 3rd failure → .opencastle/AGENT-FAILURES.md

See HOOKS-REFERENCE.md for detailed verification commands.


Anti-Patterns

Anti-patternImpact
Batch-logging retrospectivelyLoses per-task provenance
Partial post-delegate checksFalse positives — build passes but ACs fail
Repository
monkilabs/opencastle
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.