[{"data":1,"prerenderedAt":1582},["ShallowReactive",2],{"docs-nav":3,"docs-article-engineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fbuilder-chat":797},[4,17,27,44,55,67,75,82,94,106,114,122,129,135,144,153,161,169,177,189,202,211,218,229,240,248,260,268,276,286,296,305,314,323,331,337,343,350,356,364,371,378,383,393,401,410,415,422,432,439,444,451,458,462,467,475,487,499,509,516,525,533,539,545,551,557,563,567,579,593,603,614,621,626,633,640,646,653,658,665,673,678,686,692,699,704,710,721,730,740,747,753,761,767,776,782,791],{"path":5,"title":6,"description":7,"group":8,"section":6,"order":9,"tags":10,"lastUpdated":16},"\u002Fagents\u002Fagentic-crm","Agentic CRM","Research brief and build plan for an AgencyCore agentic CRM layer, rendered as an interactive page — the core operating loop, the target architecture, the typed-tool risk gateway, the proposed-actions review queue, and the four-slice MVP.","Agents",0,[11,12,13,14,15],"crm","agents","ai","architecture","research","2026-06-12",{"path":18,"title":19,"description":20,"group":8,"section":21,"order":22,"tags":23,"lastUpdated":26},"\u002Fagents\u002Fchat","Chat agent","High-level system design of the AgencyCore chat agent — core components, data flow, and the two abstractions that hold it together.","Reference",1,[12,14,24,25],"chat","system-design","2026-05-13",{"path":28,"title":29,"description":30,"group":8,"section":31,"order":32,"tags":33,"lastUpdated":43},"\u002Fagents\u002Fcompany-enrichment","Company Enrichment","The company enrichment workflow - a cache-first read in front of the company intelligence database that fills firmographic, contact and technographic facts via a fixed-order provider waterfall, and writes every resolved fact back with provenance so the first org pays once and every later search rides free.","Enrichment",2,[12,34,35,36,37,38,39,40,41,42],"workflow","enrichment","companies","waterfall","cache","intelligence-database","firmographics","provenance","sonar","2026-06-10",{"path":45,"title":46,"description":47,"group":8,"section":48,"order":9,"tags":49,"lastUpdated":54},"\u002Fagents\u002Fcompany-sonar","Company Signals","Signal-first company discovery for marketing agencies, on the Claude Agent SDK, with a global intelligence cache and deterministic composite scoring.","Company Sonar",[12,34,42,50,51,52,35,53,14],"company-search","signals","agent-sdk","scoring","2026-06-08",{"path":56,"title":57,"description":58,"group":8,"section":48,"order":22,"tags":59,"lastUpdated":66},"\u002Fagents\u002Fcompany-sonar\u002Fsignal-monitoring","Company Signals Monitoring","Realtime signal capture layer on top of the data graph. Detects hot events, scores them with a Claude managed agent against each agency's ICP, fans out alerts.",[14,51,60,61,62,63,64,65],"intel","icp","alerts","monitoring","sse","managed-agents","2026-06-09",{"path":68,"title":69,"description":70,"group":8,"section":71,"order":22,"tags":72,"lastUpdated":74},"\u002Fagents\u002Fconcepts\u002Fchat-agent-design-principles","Designing chat agents","The 2026 playbook for production chat agents that reach into internal systems via tools — context engineering, memory, tool design, when to add complexity.","Concepts",[12,14,24,73],"context-engineering","2026-05-14",{"path":76,"title":77,"description":78,"group":8,"section":71,"order":32,"tags":79,"lastUpdated":74},"\u002Fagents\u002Fconcepts\u002Fsystem-prompt-architecture","System prompt architecture","How to structure a production chat agent system prompt — eight sections, what each one does, and the rules vendors converge on.",[12,80,81],"prompt-engineering","system-prompt",{"path":83,"title":84,"description":85,"group":8,"section":84,"order":9,"tags":86,"lastUpdated":54},"\u002Fagents\u002Fenvoy","Envoy","High-level system design for the AI outreach engine — the sequence step state machine, the human-in-the-loop draft approval gate, multi-source context enrichment, and the inbox sentiment flow, rendered as an interactive page.",[12,87,88,89,90,91,92,93,14],"envoy","outreach","sales-engagement","sequences","state-machine","human-in-the-loop","nylas",{"path":95,"title":96,"description":97,"group":8,"section":98,"order":9,"tags":99,"lastUpdated":16},"\u002Fagents\u002Fheadhunter","Headhunter","The AI talent-search pipeline on one page - the production six-step design with its current-title relevance gate, and the 2.0 system design with internal-first waterfall sourcing, a pluggable source registry, automatic entity resolution, and a people intelligence graph that compounds every run.","General Search",[12,34,100,101,14,25,102,37,103,104,105],"headhunter","recruiting","multi-source","entity-resolution","people-intelligence","flywheel",{"path":107,"title":108,"description":109,"group":8,"section":21,"order":32,"tags":110,"lastUpdated":113},"\u002Fagents\u002Fpaperclip","Paperclip","Architecture deep dive into the Paperclip orchestration system.",[12,14,111,112],"orchestration","paperclip","2026-04-20",{"path":115,"title":116,"description":117,"group":8,"section":31,"order":22,"tags":118,"lastUpdated":16},"\u002Fagents\u002Fpeople-enrichment","People Enrichment","The people enrichment workflow - a cache-first read in front of the people intelligence database that fills profile, contact and employment facts via a fixed-order provider waterfall, keyed on the LinkedIn URL, and writes every resolved fact back with provenance so the first org pays once and every later search rides free. The fill step Headhunter and People Signals both call.",[12,34,35,119,37,38,39,120,41,100,121],"people","linkedin","people-sonar",{"path":123,"title":124,"description":125,"group":8,"section":126,"order":9,"tags":127,"lastUpdated":54},"\u002Fagents\u002Fpeople-sonar","People Signals","Signal-first people discovery for marketing agencies, built on the headhunter pipeline, with a composite score weighted by signal strength, source reputation, recency, and ICP fit.","People Sonar",[12,34,121,128,51,100,35,53,14],"people-search",{"path":130,"title":131,"description":132,"group":8,"section":126,"order":22,"tags":133,"lastUpdated":54},"\u002Fagents\u002Fpeople-sonar\u002Fpeople-signal-monitoring","People Signals Monitoring","Forward-looking design for the push layer that tracks known people - champions, past contacts, target-company decision-makers - and fires a warm lead the moment they change jobs, get promoted, or their company has an event.",[14,51,60,119,63,134],"warm-leads",{"path":136,"title":137,"description":138,"group":139,"section":140,"order":22,"tags":141,"lastUpdated":143},"\u002Fengineering\u002Fguides\u002Fagent-execution-stack","The Agent Execution Stack","Durable workflows over pluggable agent backends — how AgencyCore runs AI agents on Inngest over a webhook-driven Claude Managed Agents backend.","Engineering","Guides",[12,142,14,25],"inngest","2026-06-25",{"path":145,"title":146,"description":147,"group":139,"section":140,"order":9,"tags":148,"lastUpdated":143},"\u002Fengineering\u002Fguides\u002Fagent-runtime","Agent runtime","How AgencyCore runs AI agents on a provider-neutral runtime — the abstraction layer that lets us swap the agent backend, with Claude managed agents as the current provider.",[12,149,14,150,151,152,25],"runtime","anthropic","claude","providers",{"path":154,"title":155,"description":156,"group":139,"section":21,"order":157,"tags":158,"lastUpdated":160},"\u002Fengineering\u002Freference\u002Fagno-to-agent-sdk-migration","Agno → Claude Agent SDK migration","System-design spec for moving the ac-python-api workflow engine off Agno onto Anthropic's Claude Agent SDK \u002F Managed Agents, tiered by control-flow shape.",10,[12,14,159,52,65],"migration","2026-06-06",{"path":162,"title":163,"description":164,"group":139,"section":21,"order":22,"tags":165,"lastUpdated":54},"\u002Fengineering\u002Freference\u002Fcloudflare-agent-sandbox","Cloudflare agent sandbox","Cloudflare's Workers-based agent platform, evaluated as an alternative sandbox for our Agno workflows.",[12,166,167,168,159],"sandbox","cloudflare","workers",{"path":170,"title":171,"description":172,"group":139,"section":21,"order":32,"tags":173,"lastUpdated":176},"\u002Fengineering\u002Freference\u002Fvirtual-filesystem-rag","Virtual filesystem for AI assistants","How ChromaFs provides AI agents with structured file access.",[12,174,14,175],"rag","chromafs","2026-04-18",{"path":178,"title":179,"description":180,"group":139,"section":181,"order":182,"tags":183,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fcapabilities\u002Fstate-and-knowledge","State and knowledge","What a run may know. One deterministic context builder over application state, knowledge and memory, one owner for every fact, and memory that is written through a tool.","Agentic platform",11,[184,185,186,11,187],"context","memory","knowledge","pgvector","2026-08-31",{"path":190,"title":191,"description":192,"group":139,"section":181,"order":157,"tags":193,"lastUpdated":201},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fcapabilities\u002Ftools-and-integrations","Tools and integrations","A tool is the one way an agent reaches the world. AgencyCore owns the model facing contract, the invoke path, the credentials and the result boundary.",[194,195,196,197,198,199,200],"tools","integrations","mcp","agno","policy","security","idempotency","2026-09-04",{"path":203,"title":204,"description":205,"group":139,"section":181,"order":22,"tags":206,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fcontract","Platform contract","One platform behind chat, interactive channels, triggers, approvals and background runs, with one Agno runtime, one tool layer, one state layer, and three cross-cutting planes.",[12,14,197,142,194,207,149,208,198,209],"skills","channels","observability","2026-09-02",{"path":212,"title":181,"description":213,"group":139,"section":214,"order":22,"tags":215,"lastUpdated":201},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform","The whole agentic platform on one page - who starts a run, the one boundary every run passes, how the work executes, and what comes back.","System design",[12,14,216,197,142,217,198],"overview","runs",{"path":219,"title":220,"description":221,"group":139,"section":181,"order":222,"tags":223,"lastUpdated":228},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Finterfaces\u002Fagent-access","Agent access (CLI and MCP)","How an outside AI agent reaches AgencyCore. The ac CLI works today as a user seat. An MCP server is planned and not designed.",6,[224,196,12,151,225,226,227],"cli","access","auth","todo","2026-08-18",{"path":230,"title":231,"description":232,"group":139,"section":181,"order":233,"tags":234,"lastUpdated":239},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Finterfaces\u002Fchannel-gateway","Channel gateway","The only layer that knows both an interactive channel and the platform. One message shape converges inbound, one intent shape diverges outbound, and no model call happens here.",3,[208,235,236,237,238,199],"slack","web","identity","sessions","2026-08-30",{"path":241,"title":242,"description":243,"group":139,"section":181,"order":244,"tags":245,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Finterfaces\u002Ffront-door","Front door","The conversational control layer. It turns a request into one structured decision, then deterministic application code answers or hands work to RunManager.",4,[246,247,197,184,198,217],"front-door","routing",{"path":249,"title":250,"description":251,"group":139,"section":181,"order":32,"tags":252,"lastUpdated":259},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Finterfaces\u002Fsurfaces","Surfaces","Every product surface and its API contract. Web chat goes through the gateway; every schema-native surface calls the domain API.",[253,254,24,255,256,257,258,217,64],"surfaces","api","approvals","prospects","saved-searches","builder","2026-09-03",{"path":261,"title":262,"description":263,"group":139,"section":181,"order":264,"tags":265,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Finterfaces\u002Ftriggers","Triggers","A Run with no person. Every producer emits one Event, matching is deterministic, and dispatch reuses RunManager, Policy and Inngest.",5,[266,267,142,200],"triggers","events",{"path":269,"title":270,"description":271,"group":139,"section":181,"order":272,"tags":273,"lastUpdated":259},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fplanes\u002Fidempotency","Idempotency","One durable PostgreSQL key service prevents duplicate effects and freezes mutable input before selected Run starts. A Run start is guarded by a unique index on the Run row.",14,[200,217,194,274,275],"webhooks","reliability",{"path":277,"title":278,"description":279,"group":139,"section":181,"order":280,"tags":281,"lastUpdated":285},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fplanes\u002Fobservability-and-operations","Observability and operations","One run row, one span tree and one usage meter. Sentry reports system failure; AgencyCore spans explain what the agent did.",13,[209,217,282,283,64,284],"spans","usage","sentry","2026-08-26",{"path":287,"title":288,"description":289,"group":139,"section":181,"order":290,"tags":291,"lastUpdated":295},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fplanes\u002Fpolicy-and-governance","Policy and governance","One deterministic plane answers may this happen, at three checkpoints, with one grant model, one approval model and one decision log.",12,[198,292,255,293,294],"permissions","limits","governance","2026-08-25",{"path":297,"title":6,"description":298,"group":139,"section":299,"order":22,"tags":300,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fagentic-crm","The AgencyCore CRM loop for turning signals and discovery into qualified organization prospects, CRM relationships and outreach.","Agentic products",[11,301,51,302,256,35,303,304,87],"lead-generation","intelligence","signals-search","email-sequence",{"path":306,"title":307,"description":308,"group":139,"section":299,"order":264,"tags":309,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fbuilder-chat","Front door builder chat","Conversational authoring for organization-specific Agent and Workflow definitions, entered through the normal Front Door and backed by the existing DefinitionService.",[310,311,246,12,312,313,198],"authoring","definitions","workflows","templates",{"path":315,"title":316,"description":317,"group":139,"section":181,"order":318,"tags":319,"lastUpdated":201},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fcapability-contracts","Company, People and Signals contracts","The five Phase 7 product capabilities, their bounded inputs, stable references, permissions and results.",21,[320,321,119,51,322],"capabilities","company","contracts",{"path":324,"title":325,"description":326,"group":139,"section":181,"order":327,"tags":328,"lastUpdated":330},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fcapability-scenarios","Capability design scenarios","Normal, failure and recovery cases for the Phase 7 capability contracts, with implementation owners.",22,[320,329,321,119,51],"validation","2026-09-05",{"path":332,"title":333,"description":334,"group":139,"section":299,"order":233,"tags":335,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Femail-sequence","Email sequence workflow","Envoy durable outreach for one or many people, with fresh context, approvals, reply waits, follow-ups and Nylas transport.",[336,87,34,142,93,255],"email",{"path":338,"title":339,"description":340,"group":139,"section":299,"order":244,"tags":341,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fgeneral-chat","Front door general chat","The default conversational answer path for AgencyCore. It answers from supplied context, cites what it used, asks when context is insufficient, and delegates real work through the normal Front Door.",[24,246,186,184,247,342],"citations",{"path":344,"title":345,"description":346,"group":139,"section":299,"order":222,"tags":347,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fhuman-review","Human review inbox","One product page for every agentic action that is paused because a person must authorize an exact proposal. It is a view over the shared approval primitive, not a second review system.",[348,255,349,198,12],"human-review","inbox",{"path":351,"title":352,"description":353,"group":139,"section":299,"order":32,"tags":354,"lastUpdated":259},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fsignals-search","Signals Search","One bounded discovery workflow that finds companies, verifies signals, finds relevant people, and produces evidence-backed organization prospects without prematurely creating CRM records.",[303,355,36,119,51,302,256,11,35],"discovery",{"path":357,"title":358,"description":359,"group":139,"section":299,"order":360,"tags":361,"lastUpdated":188},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fworkflow-visualizer","Workflow visualizer","One constrained workflow graph, reused to author a draft, read a published definition, and watch a Run. Build mode edits the draft; run mode overlays Run and span state on the frozen snapshot.",7,[312,362,258,311,217,282,363,255],"visualizer","graph",{"path":365,"title":366,"description":367,"group":139,"section":181,"order":368,"tags":369,"lastUpdated":201},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fruntime\u002Fdefinitions","Runtime definitions","Editable drafts, one published configuration per definition, template forks, deterministic validation, and the Run snapshot that keeps in flight work stable.",8,[149,311,329,370],"publishing",{"path":372,"title":373,"description":374,"group":139,"section":181,"order":375,"tags":376,"lastUpdated":259},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fruntime\u002Fexecution","Runtime execution","The Run record, the Inngest step boundaries, agent segments, workflow nodes, approvals, cancellation, failure handling and live events.",9,[149,217,197,142,255,377,64],"cancellation",{"path":379,"title":380,"description":381,"group":139,"section":181,"order":360,"tags":382,"lastUpdated":285},"\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fruntime","Agentic runtime","One Run contract, one Agno agent runtime, one deterministic workflow model, and the component boundaries that keep the framework replaceable.",[149,217,197,312,207,142],{"path":384,"title":385,"description":386,"group":139,"section":387,"order":244,"tags":388,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Fcompany-context","Company context","L3. Company state, knowledge and memory are three different things. One deterministic builder turns them into one brief.","Mission Control",[389,390,186,185,184,391,11],"mission-control","company-state","retrieval","2026-08-12",{"path":394,"title":395,"description":396,"group":139,"section":387,"order":22,"tags":397,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Fexperience","Experience","L6. Where a person observes and controls the company, and the one rule that keeps the UI out of the business.",[389,398,399,255,400],"ui","control-plane","activity",{"path":402,"title":403,"description":404,"group":139,"section":387,"order":222,"tags":405,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Ffoundation","Foundation","L1. Generic infrastructure with no business logic in it. The test is that another product could run on it unchanged.",[389,406,407,408,267,409,226,209],"infrastructure","database","queue","storage",{"path":411,"title":387,"description":412,"group":139,"section":214,"order":233,"tags":413,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control","The internal Company OS. Six layers and one policy plane put a person in control of company state and of autonomous execution.",[389,414,14,12,312,198,399],"company-os",{"path":416,"title":417,"description":418,"group":139,"section":387,"order":32,"tags":419,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Fintelligence","Intelligence","L5. The agent is the primitive. A skill is how it works, a tool is how it reaches the world, and the two are never the same thing.",[389,12,207,420,421],"planning","reasoning",{"path":423,"title":424,"description":425,"group":139,"section":387,"order":368,"tags":426,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Fmetrics-and-connectors","Metrics and connectors","A worked example across every layer. Three vendors, one metric pipeline, three views, and the rule that decides what we store.",[389,427,195,428,429,284,430,431],"metrics","stripe","posthog","ingest","dashboards",{"path":433,"title":434,"description":435,"group":139,"section":387,"order":233,"tags":436,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Forchestration","Orchestration","L4. Workflow, run, step, trigger and event. Five nouns that turn a decision into durable execution.",[389,312,217,266,267,437,438],"durability","retry",{"path":440,"title":288,"description":441,"group":139,"section":387,"order":360,"tags":442,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Fpolicy-and-governance","A plane, not a layer. One place decides what an agent may do, under what conditions, and how much. Human approval is one of its three answers.",[389,198,294,255,292,293,443],"audit",{"path":445,"title":191,"description":446,"group":139,"section":387,"order":264,"tags":447,"lastUpdated":392},"\u002Fengineering\u002Fsystem-design\u002Fmission-control\u002Ftools-and-integrations","L2. One contract for every capability. The tool is the only route to the world, and it is where policy, audit and tenancy meet.",[389,194,195,448,449,450],"adapters","registry","credentials",{"path":452,"title":453,"description":454,"group":139,"section":455,"order":22,"tags":456,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fworkflows\u002Fcompany-search","Company search","Implementation notes for company.search. Search resolves and gates company identities; enrichment is a separate capability.","Workflows",[321,457,142,42],"search",{"path":459,"title":31,"description":460,"group":139,"section":455,"order":233,"tags":461,"lastUpdated":210},"\u002Fengineering\u002Fsystem-design\u002Fworkflows\u002Fenrichment","Reusable company and people enrichment workflows with canonical Intelligence write-back, existing tier freshness and bounded asynchronous email.",[35,321,119,142],{"path":463,"title":464,"description":465,"group":139,"section":455,"order":32,"tags":466,"lastUpdated":259},"\u002Fengineering\u002Fsystem-design\u002Fworkflows\u002Fpeople-search","People search","Implementation notes for people.search. Bounded company scope and persona gates return selectable person identities without enrichment.",[119,457,142,100],{"path":468,"title":469,"description":470,"group":139,"section":455,"order":244,"tags":471,"lastUpdated":474},"\u002Fengineering\u002Fsystem-design\u002Fworkflows\u002Fsignals-search","Signals search","Superseded. The earlier on-demand buying-signal search component, kept as a record of the design that the agentic platform Signals Search workflow replaces.",[51,12,142,472,473],"intelligence-databases","superseded","2026-08-28",{"path":476,"title":477,"description":478,"group":479,"section":480,"order":481,"tags":482,"lastUpdated":66},"\u002Flearnings\u002Fagentic-sdlc","The agentic SDLC","How AI agents move from autocomplete to owning the loop across the software lifecycle, and why that shifts the bottleneck from coding to verification.","Learnings",null,30,[12,483,484,485,486],"sdlc","engineering","verification","review",{"path":488,"title":489,"description":490,"group":479,"section":480,"order":491,"tags":492,"lastUpdated":498},"\u002Flearnings\u002Fagi-to-asi","From AGI to ASI","What lies beyond human-level AI. The four technological pathways from AGI to artificial superintelligence, the formal ceiling that bounds them, and the six bottlenecks that could stall the climb - distilled from the DeepMind report.",50,[493,494,495,496,497],"ai-futures","asi","agi","scaling","recursive-self-improvement","2026-06-19",{"path":500,"title":501,"description":502,"group":479,"section":480,"order":503,"tags":504,"lastUpdated":66},"\u002Flearnings\u002Fai-native-company-playbook","AI native company playbook","Why AI should be the operating system your company runs on, not a tool it uses, and the concrete practices that follow - closed loops, a queryable org, software factories, and token maxing.",40,[505,506,12,507,508],"ai-native","company-building","gtm","founders",{"path":510,"title":511,"description":512,"group":479,"section":480,"order":157,"tags":513,"lastUpdated":54},"\u002Flearnings\u002Fbuying-intent-signals","Buying intent signals","How buyers leak their intent before they ever fill in a form, and how to read those signals before the window closes.",[514,51,507,515],"intent","sales",{"path":517,"title":518,"description":519,"group":479,"section":480,"order":520,"tags":521,"lastUpdated":54},"\u002Flearnings\u002Fcold-outbound-system","Cold outbound system","A high-level study of an open-source 29-skill cold email system, organized into five sequential tracks from ICP to iteration.",20,[522,523,507,524],"outbound","cold-email","systems",{"path":526,"title":527,"description":528,"group":479,"section":480,"order":529,"tags":530,"lastUpdated":532},"\u002Flearnings\u002Fswan-gtm-skills-architecture","Swan GTM skills architecture","A research note on Swan AI's foundations and maps model for GTM agents, with ASCII diagrams and ideas AgencyCore can borrow.",60,[507,12,73,531,14],"swan","2026-07-01",{"path":534,"title":535,"description":536,"group":387,"section":480,"order":272,"tags":537,"lastUpdated":43},"\u002Fmission-control\u002Fciops-agent","CIOps agent","High-level system architecture and design notes for the Mission Control CIOps agent.",[389,12,538,14],"ciops",{"path":540,"title":541,"description":542,"group":387,"section":480,"order":182,"tags":543,"lastUpdated":43},"\u002Fmission-control\u002Fcostops-agent","CostOps agent","High-level system architecture and design notes for the Mission Control CostOps agent.",[389,12,544,14],"finops",{"path":546,"title":547,"description":548,"group":387,"section":480,"order":520,"tags":549,"lastUpdated":54},"\u002Fmission-control\u002Fdashboard","Dashboard","The Mission Control product UI - a dark cockpit with a fleet-nav rail, company-state grid, a working escalation queue, live ledger and a global kill switch.",[389,12,550,398],"dashboard",{"path":552,"title":553,"description":554,"group":387,"section":480,"order":280,"tags":555,"lastUpdated":43},"\u002Fmission-control\u002Fproduct-analytics-agent","ProductAnalytics agent","High-level system architecture and design notes for the Mission Control ProductAnalytics agent.",[389,12,556,14],"product-analytics",{"path":558,"title":559,"description":560,"group":387,"section":480,"order":290,"tags":561,"lastUpdated":43},"\u002Fmission-control\u002Frevenueops-agent","RevenueOps agent","High-level system architecture and design notes for the Mission Control RevenueOps agent.",[389,12,562,14],"revops",{"path":564,"title":214,"description":565,"group":387,"section":480,"order":157,"tags":566,"lastUpdated":54},"\u002Fmission-control\u002Fsystem-design","One screen for the whole company, watched by a guardrailed fleet of ops agents that explain, propose, act and learn overnight.",[389,12,544,14],{"path":568,"title":569,"description":570,"group":571,"section":480,"order":32,"tags":572,"lastUpdated":578},"\u002Fproduct-design\u002Fonboarding-flow","Onboarding flow","Product design for the signup wizard and how TAM building folds into it. Analyzes the flow today (account, profile, company), the gap (no ICP, empty dashboard), and the integration of a new \"who you sell to\" ICP step plus a build-and-reveal screen that lands the user on a populated, ranked list.","Product Design",[573,61,574,575,576,577],"onboarding","tam","activation","ux","user-journey","2026-06-11",{"path":580,"title":581,"description":582,"group":571,"section":480,"order":233,"tags":583,"lastUpdated":592},"\u002Fproduct-design\u002Fpricing-entitlements","Pricing tiers, entitlements and usage credits","Specification for subscription tiers with gated platform access: composable plan entitlements, a unified usage-credit currency, plan-sourced limits, per-module trials and a two-ticket delivery plan built on the Stripe billing foundation. Written for discussion; the Linear document is the canonical copy with ticket links.",[584,585,586,587,588,589,590,591],"pricing","entitlements","billing","credits","subscriptions","plans","seats","trials","2026-07-06",{"path":594,"title":595,"description":596,"group":571,"section":480,"order":233,"tags":597,"lastUpdated":578},"\u002Fproduct-design\u002Fsales-signals-ux","Designing Signals","Product design for the sales-signals experience in ac-frontend: the 14-type taxonomy and its color system, the anatomy of a signal card across four densities, the 0-10 lead score scale, the origin tag (sonar pull vs proactive push), the seven surfaces where signals render (launchpad, sonar app, company detail, timeline, activities, data layer, Envoy), and the interaction rules that keep them consistent.",[51,576,598,11,42,599,600,601,602],"design-system","lead-score","origin","pull","push",{"path":604,"title":605,"description":606,"group":607,"section":608,"order":244,"tags":609,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Factivities","Activities","Deep dive on crm_activities, the interaction + task log of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.","Proprietary data","CRM",[11,610,611,612,613],"activities","tasks","data-model","schema",{"path":615,"title":616,"description":617,"group":607,"section":608,"order":264,"tags":618,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Fcommunications","Communications","Deep dive on crm_communications and crm_communication_events, the unified email\u002Fcall\u002Fmessage log and its per-message engagement tracking — where it is served from, the outbound message lifecycle, and the full schema, relationships and rules.",[11,619,336,620,612],"communications","engagement",{"path":622,"title":623,"description":624,"group":607,"section":608,"order":22,"tags":625,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Fcompanies","Companies","Deep dive on crm_companies, the account record at the centre of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.",[11,36,612,613,14],{"path":627,"title":628,"description":629,"group":607,"section":608,"order":233,"tags":630,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Fdeals","Deals","Deep dive on the deal pipeline — crm_deals, crm_pipeline_stages and crm_pipeline_config. Where it is served from, the life of a deal, and its full schema, relationships and rules.",[11,631,632,612,613],"deals","pipeline",{"path":634,"title":635,"description":636,"group":607,"section":608,"order":222,"tags":637,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Flists","Lists","Deep dive on crm_lists and crm_list_members, the static or dynamic member collections of the CRM — where they are served from, how a list and its members come to be and are read, and their schema, relationships and rules.",[11,638,639,612,613],"lists","segments",{"path":641,"title":642,"description":643,"group":607,"section":608,"order":32,"tags":644,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Fpeople","People","Deep dive on crm_people, the contact record of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.",[11,119,645,612,613],"contacts",{"path":647,"title":648,"description":649,"group":607,"section":608,"order":368,"tags":650,"lastUpdated":43},"\u002Fproprietary-data\u002Fcrm\u002Fsaved-filters","Saved filters","Deep dive on crm_saved_filters, the named reusable filter snapshots over the company, person and signal list views — where it is served from, how a saved view is born and applied, and its full schema, relationships and rules.",[11,651,652,612,613],"saved-filters","views",{"path":654,"title":655,"description":656,"group":607,"section":608,"order":360,"tags":657,"lastUpdated":578},"\u002Fproprietary-data\u002Fcrm\u002Fsignals","Signals","Deep dive on the signals tables - signals, company_signals and person_signals, the CRM's sales-intelligence layer. Where signals are served from, how one is born and attached, and the full schema, relationships and rules.",[11,51,302,612,613],{"path":659,"title":660,"description":661,"group":607,"section":662,"order":22,"tags":663,"lastUpdated":43},"\u002Fproprietary-data\u002Fintelligence-databases\u002Fcompany-intelligence-database","Company Intelligence Database","Decided architecture for ENG-669, the cross-org company intelligence layer that acts as a read-through cache in front of enrichment providers, with public-facts-only privacy and provenance-tracked write-back.","Intelligence databases",[14,60,36,51,38,664],"eng-669",{"path":666,"title":667,"description":668,"group":607,"section":662,"order":244,"tags":669,"lastUpdated":578},"\u002Fproprietary-data\u002Fintelligence-databases\u002Forg-signal-feed","Org Signal Feed","The per-org activation layer on top of the shared signals store. One immutable intel_signals row fans out to many orgs through scoring (signal-type weight times ICP fit times recency decay) and materializes as ranked, tiered rows in intel_org_signal_feed - the only org-scoped, RLS-per-org table of the signal stack, the door the launchpad, inbox and digest all read through. Signals enter by two ingest classes - a user's sonar pull (ungated) or an automated push (gated by threshold plus an optional competitor-ICP check) - logged in intel_signal_ingests, and each feed row records its origin.",[14,60,51,670,53,671,672,575,430,601,602,600],"feed","decay","rls",{"path":674,"title":675,"description":676,"group":607,"section":662,"order":32,"tags":677,"lastUpdated":578},"\u002Fproprietary-data\u002Fintelligence-databases\u002Fpeople-intelligence-database","People Intelligence Database","Decided architecture for the cross-org people intelligence layer - a read-through cache in front of headhunter research and Hunter email lookups, with LinkedIn-URL identity, append-only employment edges, per-tier freshness stamps on the flat profile, shared intel_sources provenance, unified intel_signals, and a GDPR erasure path.",[14,60,119,51,38,100],{"path":679,"title":680,"description":681,"group":607,"section":662,"order":233,"tags":682,"lastUpdated":578},"\u002Fproprietary-data\u002Fintelligence-databases\u002Fsignals-intelligence-database","Signals Intelligence Database","Decided v1 architecture for the unified signal store - one polymorphic append-only intel_signals table that holds both company and person signals, with a shared taxonomy, source-ranked provenance, an intel_signal_ingests log that records which pipeline found each signal, decay at read time, and a person-to-company rollup so a champion job change surfaces on the company feed.",[14,60,51,683,671,684,670,685,41,601,602],"polymorphic","taxonomy","ingests",{"path":687,"title":688,"description":689,"group":607,"section":480,"order":9,"tags":690,"lastUpdated":16},"\u002Fproprietary-data\u002Foverview","Data Layer Overview","The AgencyCore data layer in one map - the org-scoped CRM plane in production today and the global intelligence plane designed to sit in front of it, with interactive diagrams of both, the end-to-end data flow, freshness and precedence rules, the privacy seam, and the rollout path.",[691,14,60,11,51,38,25,216],"data-layer",{"path":693,"title":694,"description":695,"group":696,"section":480,"order":9,"tags":697,"lastUpdated":54},"\u002Froadmap","Roadmap - June 2026","June 2026 product plan across four themes. The spine is moving our agents onto an isolated sandbox runtime and rebuilding the core agents and workflows on it, then standing up a read-through intelligence data store and shipping the Stripe billing system. Knowledge base, assistant, and credit tracking carry into the July roadmap.","Roadmap",[698,420],"roadmap",{"path":700,"title":701,"description":702,"group":696,"section":480,"order":22,"tags":703,"lastUpdated":54},"\u002Froadmap\u002Fjuly-2026","Roadmap - July 2026","July 2026 product plan across three themes, all carried over from June. Building on June's sandbox runtime, July grounds the agents in a knowledge base, launches the AI chat assistant, and meters every action with per-action credit tracking that reconciles into the Stripe billing system shipped in June.",[698,420],{"path":705,"title":706,"description":707,"group":696,"section":480,"order":32,"tags":708,"lastUpdated":532},"\u002Froadmap\u002Fjune-2026-slides","Roadmap slides - June 2026","Board-review slide deck for the June 2026 product roadmap, rendered directly from the original PPTX in the docs site.",[698,420,709],"slides",{"path":711,"title":712,"description":713,"group":714,"section":8,"order":520,"tags":715,"lastUpdated":16},"\u002Fsymphony\u002Fagents\u002Fdevops-agent","DevOps agent","Interactive design for a Slack-first Symphony DevOps agent that wraps production promotion, rollback, audit, and operational jobs behind policy gates, typed runbooks, and an auditable ledger.","Symphony",[716,235,717,718,719,720],"symphony","devops","production","runbooks","operations",{"path":722,"title":723,"description":724,"group":714,"section":8,"order":157,"tags":725,"lastUpdated":16},"\u002Fsymphony\u002Fagents\u002Foncall-agent","Oncall agent","Interactive design for a Symphony oncall agent that turns Sentry incidents into rich Linear tickets, investigates with Codex, opens fix PRs, and resolves Sentry after merge.",[716,284,726,727,728,729],"linear","oncall","incident-response","codex",{"path":731,"title":732,"description":733,"group":714,"section":734,"order":157,"tags":735,"lastUpdated":16},"\u002Fsymphony\u002Fhousekeeping\u002Fcodex-vacuum","Codex vacuum","Interactive design for the Symphony housekeeping timer that checkpoints and vacuums Codex sqlite stores on the VPS.","Housekeeping",[716,736,737,729,738,739],"timed-jobs","housekeeping","sqlite","vps",{"path":741,"title":742,"description":743,"group":714,"section":734,"order":481,"tags":744,"lastUpdated":16},"\u002Fsymphony\u002Fhousekeeping\u002Fhost-cleanup","Host cleanup","Interactive design for the Symphony housekeeping timer that removes stale \u002Ftmp debris, vacuums the journal, and optionally cleans the apt package cache.",[716,736,737,739,745,746],"disk","cleanup",{"path":748,"title":749,"description":750,"group":714,"section":734,"order":520,"tags":751,"lastUpdated":16},"\u002Fsymphony\u002Fhousekeeping\u002Fworkspace-cleanup","Workspace cleanup","Interactive design for the Symphony housekeeping timer that prunes idle per-issue workspaces after their TTL.",[716,736,737,752,746,739],"workspaces",{"path":754,"title":755,"description":756,"group":714,"section":480,"order":9,"tags":757,"lastUpdated":66},"\u002Fsymphony","Symphony orchestration","How AgencyCore runs OpenAI Symphony as a long-running daemon that turns Linear tickets into isolated, autonomous Codex runs, reviewed by Claude and merged by humans. High-level workflow, system architecture, and the engineer playbook.",[716,729,726,758,111,739,759,760],"claude-review","qa","automation",{"path":762,"title":763,"description":764,"group":714,"section":214,"order":22,"tags":765,"lastUpdated":392},"\u002Fsymphony\u002Fsystem-design\u002Fhigh-level-design","High-level design","The Symphony daemon end to end — the standing agent workforce and its label-routed workflows, then the runtime that polls, dispatches, runs and writes back.",[716,14,111,12,729,726,766],"systemd",{"path":768,"title":769,"description":770,"group":714,"section":771,"order":503,"tags":772,"lastUpdated":16},"\u002Fsymphony\u002Ftimed-jobs\u002Fdaily-security-agent","Daily security agent","Interactive design for a report-only Symphony timed job that reviews the last 24h of commits, scans the system for vulnerabilities, and opens focused follow-up tickets.","Timed jobs",[716,199,736,729,773,774,775],"semgrep","threat-model","ownership",{"path":777,"title":778,"description":779,"group":714,"section":771,"order":481,"tags":780,"lastUpdated":16},"\u002Fsymphony\u002Ftimed-jobs\u002Fdaily-sentry-triage","Daily Sentry triage","Interactive design for the Symphony timed job that performs read-only Sentry triage, deduplicates existing tracked clusters, and creates focused ENG bugs for new actionable errors.",[716,736,284,209,781,726],"triage",{"path":783,"title":784,"description":785,"group":714,"section":771,"order":157,"tags":786,"lastUpdated":16},"\u002Fsymphony\u002Ftimed-jobs\u002Fnightly-local-staging-e2e","Nightly local staging E2E","Interactive design for the Symphony timed job that seeds local Supabase, runs ac-frontend Playwright E2E against the local staging stack, uploads evidence, and cleans artifacts.",[716,736,787,788,789,790],"e2e","playwright","staging","frontend",{"path":792,"title":793,"description":794,"group":714,"section":771,"order":520,"tags":795,"lastUpdated":16},"\u002Fsymphony\u002Ftimed-jobs\u002Fnightly-staging-qa","Nightly staging QA","Interactive design for the Symphony timed job that seeds a staging QA Linear issue, runs an agent-browser crawl, validates feature-map coverage, and files focused follow-up work.",[716,736,789,759,796,726],"agent-browser",{"id":798,"title":307,"body":799,"customComponent":480,"description":308,"extension":1575,"group":139,"lastUpdated":188,"meta":1576,"navigation":1577,"order":264,"path":306,"related":480,"section":299,"seo":1578,"stem":1579,"tags":1580,"__hash__":1581},"docs\u002Fengineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fbuilder-chat.md",{"type":800,"value":801,"toc":1559},"minimark",[802,806,810,816,819,824,836,847,850,855,858,886,893,897,905,908,914,917,920,926,929,1029,1032,1056,1059,1103,1121,1124,1128,1135,1141,1144,1150,1165,1168,1174,1181,1184,1188,1194,1197,1203,1206,1210,1217,1223,1226,1240,1246,1256,1260,1263,1269,1279,1282,1286,1289,1296,1299,1305,1308,1319,1323,1329,1333,1339,1342,1346,1349,1356,1359,1385,1389,1459,1463,1503,1507],[803,804,307],"h1",{"id":805},"front-door-builder-chat",[807,808,809],"p",{},"Users should be able to say:",[811,812,813],"blockquote",{},[807,814,815],{},"\"Create an agent that qualifies UK fintech companies for SEO outreach.\"",[807,817,818],{},"or:",[811,820,821],{},[807,822,823],{},"\"Make a custom workflow based on Signals Search, but add a human review before outreach.\"",[807,825,826,827,831,832,835],{},"The experience starts in the normal AgencyCore chat. Architecturally, however, the Front Door ",[828,829,830],"strong",{},"does not become a definition editor",". It delegates authoring intent to one platform-authored ",[828,833,834],{},"Definition Builder Agent",".",[837,838,844],"pre",{"className":839,"code":841,"language":842,"meta":843},[840],"language-text","User\n  │\n  ▼\nChannel Gateway\n  │\n  ▼\nFront Door\n  │ authoring intent\n  ▼\nDefinition Builder Agent\n  │\n  ├── search templates \u002F capabilities\n  ├── create or patch draft\n  ├── validate draft\n  └── publish after explicit user intent + policy\n          │\n          ▼\n     DefinitionService\n          │\n          ▼\n Agent \u002F Workflow definition\n          │\n       publish\n          ▼\n normal Front Door -> RunManager execution path\n","text","",[845,846,841],"code",{"__ignoreMap":843},[807,848,849],{},"From the user's point of view this is one chat experience. From the platform's point of view the boundaries remain unchanged.",[851,852,854],"h2",{"id":853},"what-the-feature-owns","What the feature owns",[807,856,857],{},"The Builder Chat owns the conversational authoring experience:",[859,860,861,865,868,871,874,877,880,883],"ul",{},[862,863,864],"li",{},"understand what the admin wants to build or customize;",[862,866,867],{},"decide whether the target is an Agent or a Workflow;",[862,869,870],{},"find relevant platform templates, Agents, Skills and Tools;",[862,872,873],{},"ask only for missing high-impact requirements;",[862,875,876],{},"create and iteratively update one durable definition draft;",[862,878,879],{},"explain validation failures in product language;",[862,881,882],{},"summarize the effective design before publish;",[862,884,885],{},"publish only after explicit user intent and normal policy checks.",[807,887,888,889,892],{},"It does ",[828,890,891],{},"not"," own runtime execution, policy, tool implementation, trigger scheduling, definition storage or validation rules.",[851,894,896],{"id":895},"why-this-is-not-more-front-door-logic","Why this is not more Front Door logic",[807,898,899,900,904],{},"The platform ",[901,902,903],"a",{"href":241},"Front Door"," stays responsible for intent and capability selection. It must not absorb definition authoring because that would give it another open-ended responsibility and turn it into a second runtime.",[807,906,907],{},"The Definition Builder is therefore a normal platform-authored Agent Definition that the Front Door can select like any other capability.",[837,909,912],{"className":910,"code":911,"language":842,"meta":843},[840],"Front Door\n  answer \u002F clarify \u002F delegate \u002F control_run\n                         │\n                         └── delegate(definition_builder, authoring brief)\n",[845,913,911],{"__ignoreMap":843},[807,915,916],{},"No new Front Door outcome is required.",[851,918,834],{"id":919},"definition-builder-agent",[807,921,922,923,835],{},"The Builder Agent has one responsibility: ",[828,924,925],{},"turn conversational requirements into a valid definition draft",[807,927,928],{},"Its tool set is intentionally narrow.",[930,931,932,945],"table",{},[933,934,935],"thead",{},[936,937,938,942],"tr",{},[939,940,941],"th",{},"Tool",[939,943,944],{},"Purpose",[946,947,948,959,969,979,989,1002,1015],"tbody",{},[936,949,950,956],{},[951,952,953],"td",{},[845,954,955],{},"search_definition_templates",[951,957,958],{},"Find platform Agent\u002FWorkflow templates that are good starting points.",[936,960,961,966],{},[951,962,963],{},[845,964,965],{},"search_capabilities",[951,967,968],{},"Find published Agents, Skills and Tools that may be referenced.",[936,970,971,976],{},[951,972,973],{},[845,974,975],{},"get_definition_draft",[951,977,978],{},"Load one draft by ID when continuing authoring.",[936,980,981,986],{},[951,982,983],{},[845,984,985],{},"create_definition_draft",[951,987,988],{},"Create one organization-owned draft.",[936,990,991,996],{},[951,992,993],{},[845,994,995],{},"update_definition_draft",[951,997,998,999,835],{},"Apply a bounded patch to ",[845,1000,1001],{},"draft_config",[936,1003,1004,1009],{},[951,1005,1006],{},[845,1007,1008],{},"validate_definition_draft",[951,1010,1011,1012,835],{},"Run the shared deterministic ",[845,1013,1014],{},"DefinitionValidator",[936,1016,1017,1022],{},[951,1018,1019],{},[845,1020,1021],{},"publish_definition",[951,1023,1024,1025,1028],{},"Publish through ",[845,1026,1027],{},"DefinitionService"," after explicit user intent and policy.",[807,1030,1031],{},"These are normal internal Tools over the existing Definition APIs\u002Fservices. The Agent never writes definition rows directly.",[807,1033,1034,1037,1038,1040,1041,1044,1045,1048,1049,1052,1053,1055],{},[828,1035,1036],{},"A refused write must never come back as a success."," ",[845,1039,1027],{}," answers a stale ",[845,1042,1043],{},"expected_updated_at"," by returning ",[845,1046,1047],{},"None"," rather than raising, because ",[901,1050,1051],{"href":365},"its caller always reloads",". A tool that maps that ",[845,1054,1047],{}," onto an ordinary result tells the model the patch landed. The model then summarises a design it did not write, and offers to publish it, and the config that publishes is the other admin's. That is worse than the silent overwrite this page already forbids, because nothing anywhere disagrees.",[807,1057,1058],{},"So every write tool returns the refusal as a value the model must read:",[930,1060,1061,1070],{},[933,1062,1063],{},[936,1064,1065,1067],{},[939,1066,941],{},[939,1068,1069],{},"Refusals it must surface",[946,1071,1072,1083],{},[936,1073,1074,1078],{},[951,1075,1076],{},[845,1077,995],{},[951,1079,1080],{},[845,1081,1082],{},"stale_draft",[936,1084,1085,1089],{},[951,1086,1087],{},[845,1088,1021],{},[951,1090,1091,1093,1094,1093,1097,1093,1100],{},[845,1092,1082],{},", ",[845,1095,1096],{},"validation_failed",[845,1098,1099],{},"too_many_referrers",[845,1101,1102],{},"definition_in_use",[807,1104,1105,1110,1111,1113,1114,1117,1118,1120],{},[828,1106,1107,1108,835],{},"The model never carries ",[845,1109,1043],{}," Asking a language model to hold an opaque timestamp across turns and echo it back correctly is asking it to be an optimistic concurrency client, and it will eventually send a stale one or invent one. ",[845,1112,995],{}," instead reads the draft, applies the patch and writes conditionally on the ",[845,1115,1116],{},"updated_at"," it just read. The window shrinks to one round trip and the compare-and-swap still catches the other admin, so the guarantee is unchanged and the model holds no state. On ",[845,1119,1082],{}," the agent reloads and applies the patch again.",[807,1122,1123],{},"Draft writes are product authoring effects, not execution. Publishing is the safety boundary and may be gated by Policy.",[851,1125,1127],{"id":1126},"durable-authoring-state","Durable authoring state",[807,1129,1130,1131,1134],{},"There is ",[828,1132,1133],{},"no authoring-session table"," in V1.",[807,1136,1137,1140],{},[828,1138,1139],{},"The conversation carries the draft ID."," An authoring conversation outlives its Run: the Front Door starts a fresh Run for every turn, so the second turn's Builder Agent has no memory of what the first one created. \"The current draft\" is not a thing the platform can resolve, because an organization may hold many.",[807,1142,1143],{},"So the draft ID lives on the conversation, in the one place that already spans turns.",[837,1145,1148],{"className":1146,"code":1147,"language":842,"meta":843},[840],"create_definition_draft returns the ID\n  -> the Run result carries it as a ResourceRef\n  -> the conversation records it as an entity in scope\n  -> the next turn's ContextBrief carries it\n  -> get_definition_draft(id) loads it\n",[845,1149,1147],{"__ignoreMap":843},[807,1151,1152,1153,1156,1157,1160,1161,1164],{},"Nothing new is built. ",[845,1154,1155],{},"agent.conversation_entities"," already feeds ",[845,1158,1159],{},"ContextRequest.entities",", and a ",[845,1162,1163],{},"ResourceRef"," is already how a Run points at a row it produced. An admin who wants a different draft names it, and the agent searches.",[807,1166,1167],{},"The definition row is the durable state:",[837,1169,1172],{"className":1170,"code":1171,"language":842,"meta":843},[840],"definition\n  id\n  organization_id\n  kind: agent | workflow\n  origin: platform | custom\n  source_definition_id\n  state: draft | active | disabled\n  draft_config\n  published_config\n",[845,1173,1171],{"__ignoreMap":843},[807,1175,1176,1177,1180],{},"The conversation may remember the active ",[845,1178,1179],{},"definition_id"," as lightweight thread\u002Fsession metadata so follow-ups such as \"add CRM read access\" resolve naturally.",[807,1182,1183],{},"If that conversational pointer is lost, the draft is still safe and can be reopened by ID\u002Fname from the Builder or direct Agent Builder UI.",[851,1185,1187],{"id":1186},"agent-authoring-flow","Agent authoring flow",[837,1189,1192],{"className":1190,"code":1191,"language":842,"meta":843},[840],"\"I need an agent that qualifies inbound companies.\"\n        │\n        ▼\nidentify responsibility + expected output\n        │\n        ▼\nsearch available Tools \u002F Skills \u002F templates\n        │\n        ▼\nask only for required missing constraints\n        │\n        ▼\ncreate Agent draft\n        │\n        ▼\nvalidate\n   ┌────┴─────┐\n invalid     valid\n   │           │\nexplain      summarize\n+ patch      effective design\n               │\n         explicit publish\n               │\n               ▼\n      DefinitionService.publish()\n",[845,1193,1191],{"__ignoreMap":843},[807,1195,1196],{},"A custom Agent draft may configure:",[837,1198,1201],{"className":1199,"code":1200,"language":842,"meta":843},[840],"responsibility \u002F instructions\nmodel\ncontext_policy\ntool_ids[]\nskill_ids[]\nbudget_defaults\n",[845,1202,1200],{"__ignoreMap":843},[807,1204,1205],{},"The Builder does not invent permissions. The Agent may reference only Tools\u002FScopes available to the organization and compatible with the authoring principal.",[851,1207,1209],{"id":1208},"workflow-authoring-flow","Workflow authoring flow",[807,1211,1212,1213,1216],{},"The Builder composes the existing V1 ",[901,1214,1215],{"href":365},"Workflow Definition"," language:",[837,1218,1221],{"className":1219,"code":1220,"language":842,"meta":843},[840],"sequence      parallel                     containers\nagent         tool        subworkflow      work\nbranch        wait        approval         control\n",[845,1222,1220],{"__ignoreMap":843},[807,1224,1225],{},"It may reference existing published Agents, Tools and subworkflows. Validation remains deterministic and enforces node IDs, references, types, cycles, nesting depth, wait node shape and declared scopes.",[807,1227,1228,1229,1232,1233,1236,1237,835],{},"The ",[845,1230,1231],{},"approval"," node is how an author says \"stop here for a person\", which is the request in the example below. It is one of the three sources that write an ",[845,1234,1235],{},"agent.approvals"," row. See ",[901,1238,1239],{"href":344},"human review",[837,1241,1244],{"className":1242,"code":1243,"language":842,"meta":843},[840],"\"Create a workflow that researches a prospect,\ngets human review, then starts outreach.\"\n        │\n        ▼\nBuilder finds published capabilities\n        │\n        ▼\nsequence\n  -> agent\u002Fsignals research\n  -> approval node\n  -> subworkflow\u002Femail sequence\n        │\n        ▼\nvalidate -> summarize -> publish\n",[845,1245,1243],{"__ignoreMap":843},[807,1247,1248,1251,1252,1255],{},[828,1249,1250],{},"Schedules and event conditions do not belong inside the Workflow Definition."," If the user asks \"run this every Monday\" or \"run when a CRM signal changes\", that is ",[901,1253,1254],{"href":261},"Trigger"," configuration and remains a separate platform concept.",[851,1257,1259],{"id":1258},"template-customization","Template customization",[807,1261,1262],{},"Platform templates are read-only. Customization forks them.",[837,1264,1267],{"className":1265,"code":1266,"language":842,"meta":843},[840],"platform template\n      │ customize\n      ▼\norganization draft\n  origin = custom\n  source_definition_id = template.id\n      │\n      ▼\nedit -> validate -> publish\n",[845,1268,1266],{"__ignoreMap":843},[807,1270,1271,1272,1274,1275,1278],{},"This allows product capabilities such as ",[901,1273,352],{"href":351}," or the ",[901,1276,1277],{"href":332},"email sequence workflow"," to become starting points for organization-specific workflows without mutating the platform definition.",[807,1280,1281],{},"Later changes to the platform template do not silently change the organization's fork.",[851,1283,1285],{"id":1284},"publish-and-test","Publish and test",[807,1287,1288],{},"V1 keeps the boundary simple:",[811,1290,1291],{},[807,1292,1293],{},[828,1294,1295],{},"Drafts are not executable.",[807,1297,1298],{},"The flow is:",[837,1300,1303],{"className":1301,"code":1302,"language":842,"meta":843},[840],"draft\n  -> deterministic validation\n  -> user sees summary\n  -> explicit publish intent\n  -> Policy \u002F DefinitionService.publish()\n  -> current published_config\n  -> normal Front Door \u002F RunManager Run\n",[845,1304,1302],{"__ignoreMap":843},[807,1306,1307],{},"There is no separate draft runtime or preview execution engine.",[807,1309,1310,1311,1314,1315,1318],{},"After publish, \"test it with Acme\" is simply a normal request to the Front Door. The newly published capability is found through ",[845,1312,1313],{},"CapabilityIndex"," and runs through the standard ",[845,1316,1317],{},"RunManager"," path with a frozen Run snapshot.",[851,1320,1322],{"id":1321},"example-custom-agent","Example: custom Agent",[837,1324,1327],{"className":1325,"code":1326,"language":842,"meta":843},[840],"User:\nCreate an agent that reviews a company and tells me whether it fits\nour UK fintech SEO ICP.\n\nBuilder:\n- finds CRM read + intelligence search Tools\n- proposes an Agent responsibility and output shape\n- asks whether it may write qualification back to CRM\n\nUser:\nRead only for now.\n\nBuilder:\n- creates\u002Fpatches draft with read-only Tools\n- validates successfully\n- summarizes model, context, Tools and budget\n- asks whether to publish\n\nUser:\nPublish it.\n\npublish_definition\n  -> Policy\n  -> DefinitionService.publish()\n  -> capability becomes discoverable by Front Door\n",[845,1328,1326],{"__ignoreMap":843},[851,1330,1332],{"id":1331},"example-customize-a-product-workflow","Example: customize a product workflow",[837,1334,1337],{"className":1335,"code":1336,"language":842,"meta":843},[840],"User:\nMake our Signals Search workflow require a person to review the\nprospect before Email Sequence can start.\n\nFront Door\n  -> Definition Builder Agent\n\nBuilder\n  -> finds Signals Search template\n  -> forks organization draft\n  -> adds the supported wait\u002Fapproval boundary\n  -> validates references and types\n  -> summarizes the changed workflow\n  -> publishes after explicit confirmation\n",[845,1338,1336],{"__ignoreMap":843},[807,1340,1341],{},"The new Workflow uses the same shared Tools, Policy, Context, Runs, spans and Idempotency Service as the platform workflow. Customization creates data, not infrastructure.",[851,1343,1345],{"id":1344},"roles-and-policy","Roles and policy",[807,1347,1348],{},"V1 keeps the existing rule:",[811,1350,1351],{},[807,1352,1353],{},[828,1354,1355],{},"Admins author. Authorized users run.",[807,1357,1358],{},"Rules:",[859,1360,1361,1364,1371,1374,1379,1382],{},[862,1362,1363],{},"Only organization admins may create, patch or publish custom definitions.",[862,1365,1366,1367,1370],{},"The Builder Agent runs with the user's ",[845,1368,1369],{},"Principal","; it cannot widen the user's authority.",[862,1372,1373],{},"A custom Agent cannot grant itself Tool scopes the organization\u002Fprincipal cannot authorize.",[862,1375,1376,1378],{},[845,1377,1021],{}," passes through normal Policy and deterministic validation.",[862,1380,1381],{},"The Builder cannot bypass an approval by editing the definition around it; runtime action policy is evaluated live at execution.",[862,1383,1384],{},"Tenant isolation remains database\u002FRLS enforced through the underlying service path.",[851,1386,1388],{"id":1387},"failure-handling","Failure handling",[930,1390,1391,1401],{},[933,1392,1393],{},[936,1394,1395,1398],{},[939,1396,1397],{},"Failure",[939,1399,1400],{},"Product behavior",[946,1402,1403,1411,1419,1427,1435,1443,1451],{},[936,1404,1405,1408],{},[951,1406,1407],{},"Requirement is genuinely ambiguous",[951,1409,1410],{},"Ask one focused question.",[936,1412,1413,1416],{},[951,1414,1415],{},"No suitable Tool\u002Fcapability exists",[951,1417,1418],{},"Explain the missing capability; do not fabricate one.",[936,1420,1421,1424],{},[951,1422,1423],{},"Draft validation fails",[951,1425,1426],{},"Explain the deterministic validation errors and propose a patch.",[936,1428,1429,1432],{},[951,1430,1431],{},"Concurrent admin edit",[951,1433,1434],{},"Reload after optimistic concurrency failure; never overwrite silently, and never report a refused write as done.",[936,1436,1437,1440],{},[951,1438,1439],{},"Referenced capability is disabled",[951,1441,1442],{},"Validation blocks publish until replaced.",[936,1444,1445,1448],{},[951,1446,1447],{},"Publish policy denies",[951,1449,1450],{},"Keep the draft and explain the policy decision.",[936,1452,1453,1456],{},[951,1454,1455],{},"Conversation loses active draft pointer",[951,1457,1458],{},"Search\u002Freopen the durable draft; no work is lost.",[851,1460,1462],{"id":1461},"v1-rules","V1 rules",[859,1464,1465,1468,1471,1474,1479,1485,1488,1491,1494,1497],{},[862,1466,1467],{},"Front Door routes authoring; it does not author definitions itself.",[862,1469,1470],{},"Definition Builder is one normal platform Agent, not a new runtime.",[862,1472,1473],{},"One durable definition draft is the source of truth; no authoring-session database.",[862,1475,1476,1477,835],{},"All draft lifecycle operations go through ",[845,1478,1027],{},[862,1480,1481,1482,1484],{},"Deterministic ",[845,1483,1014],{}," is authoritative; the model cannot waive an error.",[862,1486,1487],{},"Drafts never execute in V1.",[862,1489,1490],{},"Publishing is explicit and policy-controlled.",[862,1492,1493],{},"Workflow schedules\u002Fevents stay in Triggers, not in workflow config.",[862,1495,1496],{},"Organization customization forks platform templates; it never mutates them.",[862,1498,1499,1500,1502],{},"After publish, the capability uses the exact same Front Door -> ",[845,1501,1317],{}," execution path as every other Agent\u002FWorkflow.",[851,1504,1506],{"id":1505},"minimum-scenarios","Minimum scenarios",[859,1508,1509,1512,1515,1518,1521,1524,1530,1533,1539,1545,1548,1556],{},[862,1510,1511],{},"Non-admin cannot create or patch a custom definition through chat.",[862,1513,1514],{},"Front Door routes authoring intent to Definition Builder without adding a new Front Door outcome.",[862,1516,1517],{},"Builder cannot reference a Tool\u002FSkill outside the visible\u002Fallowed capability set.",[862,1519,1520],{},"Invalid Agent\u002FWorkflow draft cannot publish even if the model says it is valid.",[862,1522,1523],{},"Concurrent draft update produces optimistic-concurrency failure rather than silent overwrite.",[862,1525,1526,1527,1529],{},"A stale draft write reaches the model as ",[845,1528,1082],{},", and the agent reloads instead of reporting success.",[862,1531,1532],{},"A publish refused for referrers or for a definition in use is rendered to the person, never swallowed.",[862,1534,1535,1536,1538],{},"No tool call carries ",[845,1537,1043],{}," from the model.",[862,1540,1541,1542,835],{},"Platform template customization creates a separate organization-owned definition with ",[845,1543,1544],{},"source_definition_id",[862,1546,1547],{},"Draft cannot be started as a Run.",[862,1549,1550,1551,1553,1554,835],{},"Published custom capability is discoverable through ",[845,1552,1313],{}," and starts through ",[845,1555,1317],{},[862,1557,1558],{},"Trigger\u002Fschedule request is not serialized into Workflow config.",{"title":843,"searchDepth":32,"depth":233,"links":1560},[1561,1562,1563,1564,1565,1566,1567,1568,1569,1570,1571,1572,1573,1574],{"id":853,"depth":32,"text":854},{"id":895,"depth":32,"text":896},{"id":919,"depth":32,"text":834},{"id":1126,"depth":32,"text":1127},{"id":1186,"depth":32,"text":1187},{"id":1208,"depth":32,"text":1209},{"id":1258,"depth":32,"text":1259},{"id":1284,"depth":32,"text":1285},{"id":1321,"depth":32,"text":1322},{"id":1331,"depth":32,"text":1332},{"id":1344,"depth":32,"text":1345},{"id":1387,"depth":32,"text":1388},{"id":1461,"depth":32,"text":1462},{"id":1505,"depth":32,"text":1506},"md",{},true,{"title":307,"description":308},"engineering\u002Fsystem-design\u002Fagentic-platform\u002Fproducts\u002Fbuilder-chat",[310,311,246,12,312,313,198],"6d4p0SX-hbFw-BA7wTZR0lpVzkGCNbV7iqoyz2SZWC4",1788650195672]