Known Limitations
We believe transparency earns trust. These are real constraints, cited from official documentation.
Text output is not hookable
Agent text responses bypass enforcement hooks. Rules provide advisory guidance, not deterministic blocking.
Source: code.claude.com/docs/en/hooks
CLAUDE.md is advisory
Instructions shape behavior but are not a hard enforcement layer. Hooks provide deterministic enforcement.
Source: code.claude.com/docs/en/memory
Subagents get frontmatter only
Specialist agents receive only their system prompt, not the full ADLC governance context. The orchestrator holds governance; specialists get role-specific guidance.
Source: code.claude.com/docs/en/sub-agents
Context degrades at ~95% fill
Long sessions lose instruction adherence. Mitigated by /compact and subagent delegation.
Source: code.claude.com/docs/en/best-practices
Subagent max depth = 1
Agents cannot spawn sub-agents. The orchestrator coordinates all specialist work.