Files
lcbp3/specs/200-fullstacks/225-ai-tool-layer-architecture/checklists/architecture.md
T
admin ea5499123e
CI / CD Pipeline / build (push) Failing after 3m57s
CI / CD Pipeline / deploy (push) Has been skipped
690519:1631 224 to 226 AI #01
2026-05-19 16:31:50 +07:00

960 B

Architecture Checklist: AI Tool Layer

Created: 2026-05-19 Feature: 225-ai-tool-layer-architecture

System Architecture

  • Does not break any existing core functionality.
  • Fits within the described boundaries of ADR-023A and ADR-025.
  • Maintains isolation: AI Tool Layer does not directly access database, uses Domain Services.
  • Correctly implements Server-side intent routing.

Security (CASL & Audit)

  • Every tool function enforces CASL rules using CaslAbilityFactory.
  • Audit logs are written for every tool execution.
  • ADR-019 check: No id: number exists in ToolCallResult data payloads.
  • No side effects (writes) allowed unless explicitly modeled and protected (Read-only predominantly for V1).

Observability

  • All tool layer failures log the exception details to the server logs.
  • The ToolCallResult returns user-friendly messages for failures without leaking technical details.