Chatto Architecture Inventory

SkillDocs & knowledge

Lets your agent keep Chatto's architecture docs in sync with the actual codebase by finding and fixing stale inventory entries.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Chatto Architecture Inventory skill

About this capability

Maintain Chatto runtime documentation in docs/architecture/ when runtime structures change, or audit it when requested.

What this skill tells your AI

The instructions your AI receives, as published by chattocorp/chatto in .agents/skills/chatto/chatto-architecture-inventory/SKILL.md and read by ahel’s review.

Read the inventory index. It defines the categories and documentation boundaries. Read only the categories relevant to the task. Run a complete audit only when requested.

Update affected inventory files by default. For a review, audit, or request for proposals, report findings without edits unless the user also requests fixes. Report code defects separately; inventory work does not authorize implementation changes.

Source Checks

Paths below are relative to the repository root.

CategoryCheck against
Runtime componentsCore construction, runtime units, service and worker constructors; record ownership and lifecycle.
ProjectionsProjector registration, Subjects(), projection_subjects_test.go, and snapshot code; distinguish registered projectors from nested read models.
NATS resourcesStream, KV, and Object Store creation calls; record retention, storage, backup status, and owner.
Subjects and eventsSubject helpers, persisted protobuf variants, and live publishers; check event tokens and aggregate subjects.
Runtime stateKV operations and object-key construction; record encoding, TTL, backup status, and security properties.
Durable effectsWorkers and recovery tests; check durable triggers, retries, restart recovery, duplicate delivery, and multiple replicas.
InterfacesDeclared protobuf services, API.Handlers(), API.OperatorHandlers(), and HTTP mounts; check authentication and listener boundaries.
Realtime deliveryProtocol, handler, event models, and client event bus; check projection waits, authorization, queues, and failure behavior.

Editing And Verification

  • Link to source code and relevant decisions. Do not copy tables from other categories or reproduce the generated per-RPC reference.
  • Replace stale facts in place. Keep compatibility details only while they affect current behavior or stored data.
  • Distinguish unavailable operational data from a healthy zero value.
  • Keep retired resources out of the current resource inventory.
  • Update the index when categories change. Keep docs/ARCHITECTURE.md as a short link to the inventory.
  • Verify changed claims against code and check source and document links.
  • Report the categories checked and any unresolved findings. Do not describe a partial check as a complete audit.

Signals

GitHub stars
3k
Forks
124
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
chatto-architecture-inventory
Source
github.com/chattocorp/chatto
Chatto Architecture Inventory: Skill · ahel