{"id":520775,"date":"2026-01-11T11:54:00","date_gmt":"2026-01-11T18:54:00","guid":{"rendered":"https:\/\/jorgep.com\/blog\/?p=520775"},"modified":"2026-05-20T12:04:45","modified_gmt":"2026-05-20T19:04:45","slug":"getting-to-know-your-agentzero-setup-after-installation","status":"publish","type":"post","link":"https:\/\/jorgep.com\/blog\/getting-to-know-your-agentzero-setup-after-installation\/","title":{"rendered":"Getting to Know Your AgentZero Setup (After Installation)"},"content":{"rendered":"\n<div class=\"wp-block-columns has-theme-palette-7-background-color has-background is-layout-flex wp-container-core-columns-is-layout-5dc627e1 wp-block-columns-is-layout-flex\" style=\"margin-top:0;margin-bottom:0\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:80%\">\n<p class=\"wp-block-paragraph\">Part of: <strong> <a href=\"https:\/\/jorgep.com\/blog\/series-ai-learnings\/\">AI Learning Series Here<\/a><\/strong><\/p>\n\n\n<style>.kadence-column395113_97b87a-23 > .kt-inside-inner-col,.kadence-column395113_97b87a-23 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column395113_97b87a-23 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column395113_97b87a-23 > .kt-inside-inner-col{flex-direction:column;}.kadence-column395113_97b87a-23 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column395113_97b87a-23 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column395113_97b87a-23{position:relative;}@media all and (max-width: 1024px){.kadence-column395113_97b87a-23 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column395113_97b87a-23 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column395113_97b87a-23\"><div class=\"kt-inside-inner-col\"><style>.wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99, .wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99[data-kb-block=\"kb-adv-heading510545_15a085-99\"]{font-size:var(--global-kb-font-size-sm, 0.9rem);font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99[data-kb-block=\"kb-adv-heading510545_15a085-99\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading510545_15a085-99[data-kb-block=\"kb-adv-heading510545_15a085-99\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<p class=\"kt-adv-heading510545_15a085-99 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading510545_15a085-99\">Quick Links:\u00a0<a href=\"https:\/\/jorgep.com\/blog\/resources-for-learning-ai\/\">Resources for Learning AI<\/a> | <a href=\"https:\/\/jorgep.com\/blog\/keeping-up-with-ai\/\">Keep up with AI<\/a> | <a href=\"https:\/\/jorgep.com\/blog\/list-of-ai-tools\/\" data-type=\"post\" data-id=\"402818\">List of AI Tools<\/a> | <a href=\"https:\/\/jorgep.com\/blog\/local-ai-series\/\" data-type=\"page\" data-id=\"519365\">Local AI<\/a><\/p>\n<\/div><\/div>\n\n\n<style>.kb-row-layout-id395113_d73e95-0d > .kt-row-column-wrap{align-content:start;}:where(.kb-row-layout-id395113_d73e95-0d > .kt-row-column-wrap) > .wp-block-kadence-column{justify-content:start;}.kb-row-layout-id395113_d73e95-0d > .kt-row-column-wrap{column-gap:var(--global-kb-gap-md, 2rem);row-gap:var(--global-kb-gap-none, 0rem );padding-top:var(--global-kb-spacing-xxs, 0.5rem);padding-bottom:var(--global-kb-spacing-xxs, 0.5rem);grid-template-columns:repeat(2, minmax(0, 1fr));}.kb-row-layout-id395113_d73e95-0d > .kt-row-layout-overlay{opacity:0.30;}@media all and (max-width: 1024px){.kb-row-layout-id395113_d73e95-0d > .kt-row-column-wrap{grid-template-columns:repeat(2, minmax(0, 1fr));}}@media all and (max-width: 767px){.kb-row-layout-id395113_d73e95-0d > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}<\/style><div class=\"kb-row-layout-wrap kb-row-layout-id395113_d73e95-0d alignnone wp-block-kadence-rowlayout\"><div class=\"kt-row-column-wrap kt-has-2-columns kt-row-layout-equal kt-tab-layout-inherit kt-mobile-layout-row kt-row-valign-top\">\n<style>.kadence-column395113_df36f9-de > .kt-inside-inner-col,.kadence-column395113_df36f9-de > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column395113_df36f9-de > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column395113_df36f9-de > .kt-inside-inner-col{flex-direction:column;}.kadence-column395113_df36f9-de > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column395113_df36f9-de > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column395113_df36f9-de{position:relative;}@media all and (max-width: 1024px){.kadence-column395113_df36f9-de > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column395113_df36f9-de > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column395113_df36f9-de\"><div class=\"kt-inside-inner-col\"><style>.wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9, .wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9[data-kb-block=\"kb-adv-heading395113_b3212c-b9\"]{text-align:center;font-size:var(--global-kb-font-size-sm, 0.9rem);line-height:60px;font-style:normal;background-color:#f5a511;}.wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9[data-kb-block=\"kb-adv-heading395113_b3212c-b9\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading395113_b3212c-b9[data-kb-block=\"kb-adv-heading395113_b3212c-b9\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<p class=\"kt-adv-heading395113_b3212c-b9 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading395113_b3212c-b9\">Subscribe to <a href=\"https:\/\/go.35s.be\/jtb\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>JorgeTechBits  newsletter<\/strong><\/a><\/p>\n<\/div><\/div>\n\n\n<style>.kadence-column395113_4b4b81-29 > .kt-inside-inner-col,.kadence-column395113_4b4b81-29 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column395113_4b4b81-29 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column395113_4b4b81-29 > .kt-inside-inner-col{flex-direction:column;}.kadence-column395113_4b4b81-29 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column395113_4b4b81-29 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column395113_4b4b81-29{position:relative;}@media all and (max-width: 1024px){.kadence-column395113_4b4b81-29 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column395113_4b4b81-29 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column395113_4b4b81-29\"><div class=\"kt-inside-inner-col\"><\/div><\/div>\n\n<\/div><\/div><\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\"><div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large is-resized\"><a href=\"htthttps:\/\/jorgep.com\/blog\/book-dont-just-chat-delegate\/\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"1024\" src=\"https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-640x1024.jpg\" alt=\"\" class=\"wp-image-520234\" style=\"aspect-ratio:0.6250142320391666;width:98px;height:auto\" srcset=\"https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-640x1024.jpg 640w, https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-188x300.jpg 188w, https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-768x1229.jpg 768w, https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-960x1536.jpg 960w, https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01-1280x2048.jpg 1280w, https:\/\/jorgep.com\/blog\/wp-content\/uploads\/CoverBook-01.jpg 1600w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><figcaption class=\"wp-element-caption\"><a href=\"https:\/\/jorgep.com\/blog\/book-series-ai-dont-just-chat\/\" data-type=\"page\" data-id=\"520242\">Check out the Book Series<\/a><\/figcaption><\/figure>\n<\/div><\/div>\n<\/div>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9, .wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9[data-kb-block=\"kb-adv-heading519190_b33a00-c9\"]{font-size:var(--global-kb-font-size-sm, 0.9rem);font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9[data-kb-block=\"kb-adv-heading519190_b33a00-c9\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading519190_b33a00-c9[data-kb-block=\"kb-adv-heading519190_b33a00-c9\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<p class=\"kt-adv-heading519190_b33a00-c9 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading519190_b33a00-c9\"><strong>Disclaimer:<\/strong> <strong>I create this content entirely on my own time, and the views expressed here are mine alone (not my employer&#8217;s)<\/strong>. Because I love leveraging new tech, I use AI tools like Gemini, NotebookLM, Claude, Perplexity and others as a &#8220;digital team&#8221; to help research and polish these articles so I can share the best possible insights with you!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You have AgentZero installed and running. Now what? Before you start delegating tasks and building automated workflows, it helps to understand what you actually installed and where everything lives. This guide walks through the file structure, explains how projects work, and shows you where to find the documentation you will inevitably need.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"what-you-actually-installed\">What You Actually Installed<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">AgentZero is not a single application. It is a framework that lives in <code>\/a0\/<\/code> and splits cleanly into two categories:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Framework code: Everything in <code>\/a0\/<\/code> that powers the agent loop, tools, and Web UI. This updates when the framework updates.<\/li>\n\n\n\n<li>Your data: Everything in <code>\/a0\/usr\/<\/code> that survives updates and belongs to you.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The distinction matters because you can safely update the framework without touching your customizations, plugins, or project files.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"your-directories-explained\">Your Directories Explained<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Here is what lives in <code>\/a0\/usr\/<\/code>, the home for your data:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Directory<\/th><th>Purpose<\/th><\/tr><\/thead><tbody><tr><td><code>workdir\/<\/code><\/td><td>General workspace for scripts, drafts, and working files<\/td><\/tr><tr><td><code>projects\/<\/code><\/td><td>Formal projects with isolated memory, knowledge, and settings<\/td><\/tr><tr><td><code>plugins\/<\/code><\/td><td>Custom plugins you create or install<\/td><\/tr><tr><td><code>skills\/<\/code><\/td><td>Custom skills for specialized tasks<\/td><\/tr><tr><td><code>agents\/<\/code><\/td><td>Subordinate agent profiles you define<\/td><\/tr><tr><td><code>memory\/<\/code><\/td><td>Vector storage for long-term recall<\/td><\/tr><tr><td><code>knowledge\/<\/code><\/td><td>Indexed files for grounded answers<\/td><\/tr><tr><td><code>settings.json<\/code><\/td><td>Framework configuration<\/td><\/tr><tr><td><code>secrets.env<\/code><\/td><td>Sensitive credentials (API keys, passwords) \u2014 never commit this<\/td><\/tr><tr><td><code>.env<\/code><\/td><td>Environment variables for local configuration<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Please note that you can map the <code>\/a0\/usr\/<\/code> folder to your local machine&#8217;s drive. (Specifically in this case: it resides on <code>c:\\AgentZero\\Data\\<\/code>.)<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"workdir\">Workdir<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Workdir is your legacy workspace. It is a flat directory where you can drop scripts, data files, and experimental code. It works, but it lacks isolation. Everything in workdir shares the same memory and knowledge scope.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"projects\">Projects<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Projects are the modern approach. Each project in <code>\/a0\/usr\/projects\/<\/code> gets its own <code>.a0proj\/<\/code> subdirectory containing:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>memory\/<\/code> \u2014 Vector index isolated to this project<\/li>\n\n\n\n<li><code>knowledge\/<\/code> \u2014 Files indexed only for this project<\/li>\n\n\n\n<li><code>project.json<\/code> \u2014 Project metadata and configuration<\/li>\n\n\n\n<li><code>agents.json<\/code> \u2014 Project-specific agent overrides<\/li>\n\n\n\n<li><code>skills\/<\/code> \u2014 Project-specific skills and capabilities<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">When you activate a project, your agent gets scoped memory and knowledge. This prevents cross-contamination between unrelated work. If you are building a marketing automation system, its knowledge should not leak into your personal blog writing project.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"memory-and-knowledge-know-the-difference\">Memory and Knowledge: Know the Difference<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These terms sound similar but function differently:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Memory stores facts about you and your preferences. It persists across conversations and tasks. Use it for durable information like your writing style, family details, or recurring workflows.<\/li>\n\n\n\n<li>Knowledge stores reference documents. The system indexes these files and retrieves relevant chunks when answering questions. Use it for project documentation, research papers, or source material.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Configure your storage locations in <code>settings.json<\/code> or through the Web UI. Long-term, you will want to move active work into projects with dedicated knowledge folders rather than dumping everything into global memory.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"where-is-the-documentation\">Where Is the Documentation?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Documentation lives in <code>\/a0\/docs\/<\/code> with these key guides:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Path<\/th><th>Purpose<\/th><\/tr><\/thead><tbody><tr><td><code>guides\/usage.md<\/code><\/td><td>Comprehensive usage guide<\/td><\/tr><tr><td><code>guides\/projects.md<\/code><\/td><td>Project system explained<\/td><\/tr><tr><td><code>guides\/memory.md<\/code><\/td><td>Memory configuration<\/td><\/tr><tr><td><code>guides\/skills.md<\/code><\/td><td>Creating custom skills<\/td><\/tr><tr><td><code>guides\/browser.md<\/code><\/td><td>Browser automation<\/td><\/tr><tr><td><code>setup\/installation.md<\/code><\/td><td>Installation reference<\/td><\/tr><tr><td><code>developer\/plugins.md<\/code><\/td><td>Plugin development<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">For quick reference, keep <code>guides\/usage.md<\/code> and <code>guides\/projects.md<\/code> bookmarked. These two files cover 80 percent of what you need to know.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"checking-your-installed-plugins\">Checking Your Installed Plugins<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">AgentZero ships with plugins for email, browser automation, memory, and more. Your custom plugins live in <code>\/a0\/usr\/plugins\/<\/code>. To see what is installed, check <code>\/a0\/plugins\/<\/code> for framework plugins and <code>\/a0\/usr\/plugins\/<\/code> for your additions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Each plugin has a <code>README.md<\/code> explaining its tools and configuration. Read these before using a plugin for the first time.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"configuration-files-you-should-know\">Configuration Files You Should Know<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>usr\/settings.json<\/code> \u2014 Main configuration. Edit through the Web UI or directly.<\/li>\n\n\n\n<li><code>usr\/secrets.env<\/code> \u2014 API keys and credentials. Never commit this.<\/li>\n\n\n\n<li><code>usr\/agents\/&lt;profile>\/<\/code> \u2014 Agent profile overrides.<\/li>\n\n\n\n<li><code>.a0proj\/project.json<\/code> \u2014 Per-project settings.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"your-next-steps\">Your Next Steps<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Move existing work from <code>workdir\/<\/code> into proper projects<\/li>\n\n\n\n<li>Create a project for your current focus and add relevant files to its <code>knowledge\/<\/code> folder<\/li>\n\n\n\n<li>Review <code>docs\/guides\/projects.md<\/code> to understand project scoping<\/li>\n\n\n\n<li>Check <code>docs\/guides\/memory.md<\/code> to configure memory recall thresholds<\/li>\n\n\n\n<li>Read <code>docs\/guides\/skills.md<\/code> when you are ready to create reusable capabilities<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">You do not need to master everything today. Start with projects and memory. The rest builds naturally as your workflows grow.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"agentzero-full-structure-example\">AgentZero Full Structure Example<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">This document shows a complete example of the AgentZero directory structure with multiple projects, global and project-scoped skills, memory, and knowledge.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"top-level-structure-a0usr\">Top-Level Structure: <code>\/a0\/usr\/<\/code><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/a0\/usr\/\n\u251c\u2500\u2500 agents\/                    # Your custom subordinate agent profiles\n\u2502   \u251c\u2500\u2500 my-researcher\/\n\u2502   \u2514\u2500\u2500 my-coder\/\n\u2502\n\u251c\u2500\u2500 projects\/                  # All project workspaces\n\u2502   \u251c\u2500\u2500 marketing-automation\/\n\u2502   \u251c\u2500\u2500 personal-blog\/\n\u2502   \u2514\u2500\u2500 data-analysis\/\n\u2502\n\u251c\u2500\u2500 skills\/                    # GLOBAL skills (available to all projects)\n\u2502   \u251c\u2500\u2500 email-assistant\/\n\u2502   \u2502   \u251c\u2500\u2500 SKILL.md\n\u2502   \u2502   \u2514\u2500\u2500 templates\/\n\u2502   \u2514\u2500\u2500 web-scraper\/\n\u2502       \u251c\u2500\u2500 SKILL.md\n\u2502       \u2514\u2500\u2500 utils.py\n\u2502\n\u251c\u2500\u2500 workdir\/                   # Legacy\/general workspace\n\u2502   \u251c\u2500\u2500 old-scripts\/\n\u2502   \u2514\u2500\u2500 experiments\/\n\u2502\n\u251c\u2500\u2500 plugins\/                   # Your custom plugins\n\u2502   \u2514\u2500\u2500 my-custom-plugin\/\n\u2502\n\u251c\u2500\u2500 memory\/                    # GLOBAL memory (vector store)\n\u2502   \u251c\u2500\u2500 index.faiss\n\u2502   \u251c\u2500\u2500 index.pkl\n\u2502   \u2514\u2500\u2500 embedding.json\n\u2502\n\u251c\u2500\u2500 knowledge\/                 # GLOBAL knowledge (indexed files)\n\u2502   \u251c\u2500\u2500 reference-docs\/\n\u2502   \u2514\u2500\u2500 research-papers\/\n\u2502\n\u251c\u2500\u2500 settings.json              # Framework configuration\n\u251c\u2500\u2500 secrets.env                # API keys &amp; credentials\n\u2514\u2500\u2500 .env                       # Environment variables<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"project-1-marketing-automation\">Project 1: <code>marketing-automation<\/code><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/a0\/usr\/projects\/marketing-automation\/\n\u251c\u2500\u2500 .a0proj\/                          # Project metadata &amp; isolation\n\u2502   \u251c\u2500\u2500 project.json                  # Project configuration\n\u2502   \u251c\u2500\u2500 agents.json                   # Per-project agent overrides\n\u2502   \u251c\u2500\u2500 variables.env                 # Project variables\n\u2502   \u251c\u2500\u2500 secrets.env                   # Project secrets\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 memory\/                       # PROJECT-SPECIFIC memory\n\u2502   \u2502   \u251c\u2500\u2500 index.faiss\n\u2502   \u2502   \u251c\u2500\u2500 index.pkl\n\u2502   \u2502   \u2514\u2500\u2500 embedding.json\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 knowledge\/                    # PROJECT-SPECIFIC knowledge\n\u2502   \u2502   \u251c\u2500\u2500 brand-guidelines.pdf\n\u2502   \u2502   \u251c\u2500\u2500 competitor-analysis\/\n\u2502   \u2502   \u2514\u2500\u2500 marketing-playbooks\/\n\u2502   \u2502\n\u2502   \u2514\u2500\u2500 skills\/                       # PROJECT-SPECIFIC skills\n\u2502       \u251c\u2500\u2500 ab-test-setup\/\n\u2502       \u2502   \u251c\u2500\u2500 SKILL.md\n\u2502       \u2502   \u2514\u2500\u2500 sample-code.py\n\u2502       \u251c\u2500\u2500 email-sequence\/\n\u2502       \u2502   \u251c\u2500\u2500 SKILL.md\n\u2502       \u2502   \u2514\u2500\u2500 templates\/\n\u2502       \u2514\u2500\u2500 ad-creative\/\n\u2502           \u251c\u2500\u2500 SKILL.md\n\u2502           \u2514\u2500\u2500 assets\/\n\u2502               \u251c\u2500\u2500 headline-formulas.txt\n\u2502               \u2514\u2500\u2500 image-templates\/\n\u2502\n\u251c\u2500\u2500 campaigns\/                        # Project work files\n\u251c\u2500\u2500 analytics\/\n\u2514\u2500\u2500 content-calendar\/<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"project-2-personal-blog\">Project 2: <code>personal-blog<\/code><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/a0\/usr\/projects\/personal-blog\/\n\u251c\u2500\u2500 .a0proj\/\n\u2502   \u251c\u2500\u2500 project.json\n\u2502   \u251c\u2500\u2500 agents.json\n\u2502   \u251c\u2500\u2500 variables.env\n\u2502   \u251c\u2500\u2500 secrets.env\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 memory\/                       # Isolated blog memory\n\u2502   \u2502   \u251c\u2500\u2500 index.faiss\n\u2502   \u2502   \u251c\u2500\u2500 index.pkl\n\u2502   \u2502   \u2514\u2500\u2500 embedding.json\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 knowledge\/                    # Blog-specific knowledge\n\u2502   \u2502   \u251c\u2500\u2500 previous-posts\/\n\u2502   \u2502   \u251c\u2500\u2500 style-guide.md\n\u2502   \u2502   \u2514\u2500\u2500 topic-ideas\/\n\u2502   \u2502\n\u2502   \u2514\u2500\u2500 skills\/                       # Blog-specific skills\n\u2502       \u2514\u2500\u2500 wordpress-publish\/\n\u2502           \u251c\u2500\u2500 SKILL.md\n\u2502           \u2514\u2500\u2500 wordpress-api.py\n\u2502\n\u251c\u2500\u2500 drafts\/\n\u251c\u2500\u2500 published\/\n\u2514\u2500\u2500 images\/<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"project-3-data-analysis\">Project 3: <code>data-analysis<\/code><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>\/a0\/usr\/projects\/data-analysis\/\n\u251c\u2500\u2500 .a0proj\/\n\u2502   \u251c\u2500\u2500 project.json\n\u2502   \u251c\u2500\u2500 agents.json\n\u2502   \u251c\u2500\u2500 variables.env\n\u2502   \u251c\u2500\u2500 secrets.env\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 memory\/                       # Analysis project memory\n\u2502   \u2502   \u251c\u2500\u2500 index.faiss\n\u2502   \u2502   \u251c\u2500\u2500 index.pkl\n\u2502   \u2502   \u2514\u2500\u2500 embedding.json\n\u2502   \u2502\n\u2502   \u251c\u2500\u2500 knowledge\/                    # Domain knowledge\n\u2502   \u2502   \u251c\u2500\u2500 datasets\/\n\u2502   \u2502   \u251c\u2500\u2500 methodology-docs\/\n\u2502   \u2502   \u2514\u2500\u2500 visualization-examples\/\n\u2502   \u2502\n\u2502   \u2514\u2500\u2500 skills\/                       # Analysis skills\n\u2502       \u251c\u2500\u2500 data-cleaning\/\n\u2502       \u2502   \u251c\u2500\u2500 SKILL.md\n\u2502       \u2502   \u2514\u2500\u2500 cleaning-scripts\/\n\u2502       \u2514\u2500\u2500 reporting\/\n\u2502           \u251c\u2500\u2500 SKILL.md\n\u2502           \u2514\u2500\u2500 report-templates\/\n\u2502\n\u251c\u2500\u2500 raw-data\/\n\u251c\u2500\u2500 processed-data\/\n\u2514\u2500\u2500 outputs\/<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"key-structure-summary\">Key Structure Summary<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Location<\/th><th>Scope<\/th><th>Purpose<\/th><\/tr><\/thead><tbody><tr><td><code>\/a0\/usr\/skills\/&lt;skill&gt;\/<\/code><\/td><td><strong>Global<\/strong><\/td><td>Available to all agents and projects<\/td><\/tr><tr><td><code>\/a0\/usr\/memory\/<\/code><\/td><td><strong>Global<\/strong><\/td><td>Shared long-term memory<\/td><\/tr><tr><td><code>\/a0\/usr\/knowledge\/<\/code><\/td><td><strong>Global<\/strong><\/td><td>Shared reference documents<\/td><\/tr><tr><td><code>\/a0\/usr\/projects\/&lt;project&gt;\/.a0proj\/skills\/&lt;skill&gt;\/<\/code><\/td><td><strong>Project<\/strong><\/td><td>Only available within that project<\/td><\/tr><tr><td><code>\/a0\/usr\/projects\/&lt;project&gt;\/.a0proj\/memory\/<\/code><\/td><td><strong>Project<\/strong><\/td><td>Isolated memory for that project<\/td><\/tr><tr><td><code>\/a0\/usr\/projects\/&lt;project&gt;\/.a0proj\/knowledge\/<\/code><\/td><td><strong>Project<\/strong><\/td><td>Knowledge specific to that project<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"how-it-works\">How It Works<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"global-skills\">Global Skills<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Located in <code>\/a0\/usr\/skills\/<\/code><\/li>\n\n\n\n<li>Available to <strong>all projects<\/strong> and the main agent<\/li>\n\n\n\n<li>Use for reusable capabilities like &#8220;email-assistant&#8221; or &#8220;web-scraper&#8221;<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"project-specific-skills\">Project-Specific Skills<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Located in <code>project\/.a0proj\/skills\/<\/code><\/li>\n\n\n\n<li>Only available when that project is <strong>active<\/strong><\/li>\n\n\n\n<li>Use for domain-specific capabilities that don&#8217;t belong in global scope<\/li>\n\n\n\n<li>Keep assets and scripts in the skill folder<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"memory-isolation\">Memory Isolation<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Global memory<\/strong>: <code>\/a0\/usr\/memory\/<\/code> \u2014 shared across all work<\/li>\n\n\n\n<li><strong>Project memory<\/strong>: <code>project\/.a0proj\/memory\/<\/code> \u2014 isolated to that project<\/li>\n\n\n\n<li>When you activate a project, only that project&#8217;s memory is available<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"knowledge-scoping\">Knowledge Scoping<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Global knowledge<\/strong>: <code>\/a0\/usr\/knowledge\/<\/code> \u2014 reference for all work<\/li>\n\n\n\n<li><strong>Project knowledge<\/strong>: <code>project\/.a0proj\/knowledge\/<\/code> \u2014 reference for specific project<\/li>\n\n\n\n<li>Knowledge files are indexed and retrieved when relevant to the query<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"best-practices\">Best Practices<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Use global skills<\/strong> for truly reusable capabilities<\/li>\n\n\n\n<li><strong>Use project skills<\/strong> when the skill is tightly coupled to project knowledge<\/li>\n\n\n\n<li><strong>Keep work files at project root<\/strong>, metadata in <code>.a0proj\/<\/code><\/li>\n\n\n\n<li><strong>Scope memory carefully<\/strong> \u2014 sensitive or unrelated data should live in project memory<\/li>\n\n\n\n<li><strong>Index knowledge appropriately<\/strong> \u2014 put files where the agent should find them<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"example-workflow\">Example Workflow<\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>1. Create project: \"marketing-automation\"\n2. Add global skills: use email-assistant from \/a0\/usr\/skills\/\n3. Create project skills: ab-test-setup in .a0proj\/skills\/\n4. Add knowledge: upload competitor reports to .a0proj\/knowledge\/\n5. Activate project: agent now has isolated memory + scoped knowledge + project skills\n6. Work: agent recalls project context, uses appropriate skills, references right documents<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Written with the help of Agent Zero <\/em><\/p>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7, .wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7[data-kb-block=\"kb-adv-heading407818_afcbba-c7\"]{font-size:var(--global-kb-font-size-sm, 0.9rem);font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7[data-kb-block=\"kb-adv-heading407818_afcbba-c7\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading407818_afcbba-c7[data-kb-block=\"kb-adv-heading407818_afcbba-c7\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<p class=\"kt-adv-heading407818_afcbba-c7 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading407818_afcbba-c7\">Have questions, ideas to share, or just want to connect? I\u2019d love to hear from you! Check out my <a href=\"https:\/\/jorgep.com\/blog\/about\/\">About Page<\/a> to learn more about me or connect with me.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>You have AgentZero installed and running. Now what? Before you start delegating tasks and building automated workflows, it helps to understand what you actually installed and where everything lives. This guide walks through the file structure, explains how projects work, and shows you where to find the documentation you will inevitably need. What You Actually&#8230;<\/p>\n","protected":false},"author":2,"featured_media":520098,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","ngg_post_thumbnail":0,"episode_type":"","audio_file":"","podmotor_file_id":"","podmotor_episode_id":"","cover_image":"","cover_image_id":"","duration":"","filesize":"","filesize_raw":"","date_recorded":"","explicit":"","block":"","itunes_episode_number":"","itunes_title":"","itunes_season_number":"","itunes_episode_type":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[441,446],"tags":[1026,471,941,930,986],"class_list":["post-520775","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tech-talk","category-tips-tools-resources","tag-agent-zero","tag-ai","tag-ai-agents","tag-ai-series","tag-local-ai"],"taxonomy_info":{"category":[{"value":441,"label":"Tech Talk"},{"value":446,"label":"Tips, Tools &amp; Resources"}],"post_tag":[{"value":1026,"label":"Agent Zero"},{"value":471,"label":"AI"},{"value":941,"label":"AI Agents"},{"value":930,"label":"AI Series"},{"value":986,"label":"Local AI"}]},"featured_image_src_large":["https:\/\/jorgep.com\/blog\/wp-content\/uploads\/FeatureImage-AgentZero-GenerigGemini_Generated-1024x512.png",1024,512,true],"author_info":{"display_name":"Jorge Pereira","author_link":"https:\/\/jorgep.com\/blog\/author\/jorge\/"},"comment_info":0,"category_info":[{"term_id":441,"name":"Tech Talk","slug":"tech-talk","term_group":0,"term_taxonomy_id":451,"taxonomy":"category","description":"","parent":0,"count":711,"filter":"raw","cat_ID":441,"category_count":711,"category_description":"","cat_name":"Tech Talk","category_nicename":"tech-talk","category_parent":0},{"term_id":446,"name":"Tips, Tools &amp; Resources","slug":"tips-tools-resources","term_group":0,"term_taxonomy_id":456,"taxonomy":"category","description":"","parent":0,"count":95,"filter":"raw","cat_ID":446,"category_count":95,"category_description":"","cat_name":"Tips, Tools &amp; Resources","category_nicename":"tips-tools-resources","category_parent":0}],"tag_info":[{"term_id":1026,"name":"Agent Zero","slug":"agent-zero","term_group":0,"term_taxonomy_id":1036,"taxonomy":"post_tag","description":"","parent":0,"count":7,"filter":"raw"},{"term_id":471,"name":"AI","slug":"ai","term_group":0,"term_taxonomy_id":481,"taxonomy":"post_tag","description":"","parent":0,"count":169,"filter":"raw"},{"term_id":941,"name":"AI Agents","slug":"ai-agents","term_group":0,"term_taxonomy_id":951,"taxonomy":"post_tag","description":"","parent":0,"count":132,"filter":"raw"},{"term_id":930,"name":"AI Series","slug":"ai-series","term_group":0,"term_taxonomy_id":940,"taxonomy":"post_tag","description":"","parent":0,"count":177,"filter":"raw"},{"term_id":986,"name":"Local AI","slug":"local-ai","term_group":0,"term_taxonomy_id":996,"taxonomy":"post_tag","description":"","parent":0,"count":43,"filter":"raw"}],"_links":{"self":[{"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/posts\/520775","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/comments?post=520775"}],"version-history":[{"count":2,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/posts\/520775\/revisions"}],"predecessor-version":[{"id":520778,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/posts\/520775\/revisions\/520778"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/media\/520098"}],"wp:attachment":[{"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/media?parent=520775"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/categories?post=520775"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jorgep.com\/blog\/wp-json\/wp\/v2\/tags?post=520775"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}