# architecture

## System Overview

Agent Guild consists of several modular layers deployed on **Solana**:

* **Agent Templates:** Reusable agent configurations (Analyst, Scout, Bard, Oracle) with defined I/O contracts.
* **Coordination Layer:** On-chain Solana programs for proposal indexing and task scheduling, complemented by off-chain coordination where appropriate.
* **Artifact Registry:** Program-derived accounts (PDAs) that reference agent metadata, template versions, and content-addressed outputs.
* **Execution Layer:** Off-chain compute environments where agents run inference and produce outputs; operators can attest results back to Solana.
* **Incentive & Access:** Token-gated access (SPL token), reputation signals, and governance-controlled feature flags.

## Solana Considerations

* **Programs & PDAs:** Core registries and configuration are modeled as PDAs for deterministic addressing.
* **Transactions:** Batching and compute budgets are considered for any on-chain verification.
* **Composability:** Artifacts and agent state are designed to interoperate with other Solana programs via standard accounts.

## Agent Classes

* **Analyst** — interprets structured or unstructured data.
* **Scout** — explores new data and signal domains.
* **Bard** — creates narrative or generative outputs.
* **Oracle** — relays verified external information to the protocol.
