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.

The five-layer architecture is what enables true autonomy. Most SEO tools stop at Layer 1 — they hand you a report. effectly.ai runs all five layers every night. The Intelligence layer finds issues. Synthesis prioritizes them. The Constitution Agent gates risk. Action executes. Learning improves the next run. No human in the loop for routine fixes. Full control for irreversible changes.

Each agent is specialized. The Technical agent doesn't write content. The Writer agent doesn't touch redirects. This separation ensures quality and safety. When you connect a new site, the system learns your CMS, your vertical, and your approval patterns. Over time, autopilot coverage increases. You spend less time reviewing, more time on strategy.