juliaz-agent-builder

The SOUL.md pattern defines an agent's personality and core conventions before creation. It standardizes agent behavior by generating required files like SOUL.md, IDENTITY.md, and TOOLS.md alongside starter source code, ensuring every agent aligns with the ecosystem's structural and operational conventions.

Standardizing sub-agent creation is best handled by automating the scaffolding of required files like AGENTS.md, HEARTBEAT.md, and MEMORY.md. This enforces consistent agent conventions and correctly wires new sub-agents into the repository structure with agent cards and documentation.

Yes, agents are placed in specific system directories based on their role and environment. The scaffolding process automatically routes new agents into the correct folder structure, such as julia/, meta/agents/, or thesis/agents, ensuring proper ecosystem organization.

You generate agent cards and documentation by triggering the agent scaffolding process. Alongside creating required template files like SOUL.md and IDENTITY.md, the process produces agent-cards and docs to integrate the new agent into the meta/docs catalog and system overview automatically.

No, you do not need to manually create a starter src/index.ts file. The scaffolding process automatically generates the starter source code file alongside required markdown templates, wiring the agent into the repository structure immediately.