effectly.ai
← Back to Docs

Agent architecture

effectly.ai runs on a 5-layer agent architecture. Ten audit agents crawl your site in parallel. Synthesis agents prioritize findings. The Constitution Agent gates every action. Action agents execute writes. Learning agents make the system smarter every run.

Layer 1 — Intelligence (audit agents)

Six audit agents run in parallel: Technical, Content, Schema, Sitemap, Performance, and Visual. Four intel agents add context: Competitor analysis, SERP intent mapping, AI visibility scoring, and business context from your configured personas.

AgentWhat it reads
Technicalrobots.txt, sitemap, redirects, canonicals, HTTPS, status codes
ContentE-E-A-T signals, thin pages, keyword cannibalization
SchemaJSON-LD presence, schema.org types, rich result eligibility
PerformanceCore Web Vitals (LCP, CLS, INP), TTFB, mobile vs desktop
CompetitorTop 3 ranking competitors, weekly delta
SERP intentQuery clusters mapped to content gaps

Layer 2 — Synthesis

The ICP/Persona agent determines who visits and what they need. The Prioritization agent scores every finding by impact, effort, and risk. Findings collapse into: Autopilot tonight, Your approval, or Deferred. Weights self-adjust per customer over time.

Layer 3 — Decision (Constitution Agent)

Every proposed action passes through the Constitution Agent before any write. It knows 200+ Google ranking signals, every schema.org type, Core Web Vitals thresholds, E-E-A-T criteria, and your brand voice. Outputs: APPROVE, APPROVE WITH CAVEAT, BLOCK, or ESCALATE TO HUMAN.

The irreversibility rule is hardcoded: anything that cannot be undone in under 60 seconds requires human approval. Deleting redirects, changing URL structures, modifying robots.txt — always human-gated.

Layer 4 — Action

The Writer produces ICP-first copy. QA validates against constitution rules. CMS Action executes via REST, SSH, or Git. Rollback snapshots before every write and auto-reverts if ranking drops. Interlinking builds topic clusters. Notify sends Slack and email digests.

Layer 5 — Learning

The Delta Tracker records score before/after per fix type. The Pattern Learner builds a model over time — what works per CMS, per vertical. Customer Memory stores brand voice, red lines, past decisions. The system gets smarter every run. Six months in, our agents know your business better than a human account manager.