Reorganize documentation with System section first and improve navigation structure

astro.config.mjs

@@ -33,6 +33,17 @@ export default defineConfig({
           label: "Explanations",
           items: [
             { label: "Table of Contents", slug: "explanations/table-of-contents" },
+            {
+              label: "System",
+              collapsed: true,
+              items: [
+                { label: "Control Space", slug: "explanations/system/control-space" },
+                { label: "Permission System", slug: "explanations/system/permission-system" },
+                { label: "Recursive Delegation", slug: "explanations/system/recursive-delegation" },
+                { label: "Emission Permissions", slug: "explanations/system/emission-permissions" },
+                { label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
+              ],
+            },
             {
               label: "Holders",
               collapsed: true,
@@ -51,8 +62,6 @@ export default defineConfig({
                 { label: "Demand Signaling", slug: "explanations/builders/demand-signaling" },
                 { label: "Agent Server", slug: "explanations/builders/agent-server" },
                 { label: "Agent Client", slug: "explanations/builders/agent-client" },
-                { label: "Control Space", slug: "explanations/builders/control-space" },
-                { label: "Capability Permissions", slug: "explanations/builders/capability-permissions" },
               ],
             },
             {
@@ -62,9 +71,6 @@ export default defineConfig({
                 { label: "Root Agents", slug: "explanations/goal-leaders/root-agents" },
                 { label: "DAO Treasury", slug: "explanations/goal-leaders/dao-treasury" },
                 { label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" },
-                { label: "Permission System", slug: "explanations/goal-leaders/permissions" },
-                { label: "Recursive Delegation", slug: "explanations/goal-leaders/recursive-delegation" },
-                { label: "Emission Permissions", slug: "explanations/goal-leaders/emission-permissions" },
                 { label: "Governance & DAO", slug: "explanations/goal-leaders/governance-dao" },
               ],
             },
@@ -75,6 +81,16 @@ export default defineConfig({
           label: "How-to Guides",
           items: [
             { label: "Table of Contents", slug: "how-to-guides/table-of-contents" },
+            {
+              label: "System",
+              collapsed: true,
+              items: [
+                { label: "Create Permission", slug: "how-to-guides/system/create-permission" },
+                { label: "Create Capability Permission", slug: "how-to-guides/system/create-capability-permission" },
+                { label: "Create Emission Permission", slug: "how-to-guides/system/create-emission-permission" },
+                { label: "Manage Permissions", slug: "how-to-guides/system/manage-permissions" },
+              ],
+            },
             {
               label: "Holders",
               collapsed: true,
@@ -104,9 +120,6 @@ export default defineConfig({
                 { label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" },
                 { label: "Request DAO Treasury Transfer", slug: "how-to-guides/goal-leaders/request-dao-treasury-transfer" },
                 { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
-                { label: "Create Capability Permission", slug: "how-to-guides/goal-leaders/create-capability-permission" },
-                { label: "Create Emission Permission", slug: "how-to-guides/goal-leaders/create-emission-permission" },
-                { label: "Manage Permissions", slug: "how-to-guides/goal-leaders/manage-permissions" },
               ],
             },
           ],

src/content/docs/explanations/builders/agent-registration.mdx

@@ -45,7 +45,7 @@ Agent metadata is stored off-chain via IPFS but referenced on-chain through cont
 ### Related Concepts
 
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents that receive emissions directly
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - How agents interact and delegate authority
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - How agents interact and delegate authority
 - **[Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Understanding DAO decision-making processes
 
 <Aside type="tip" title="Ready to Register?">

src/content/docs/explanations/goal-leaders/emission-proposals.mdx

@@ -51,7 +51,7 @@ For a proposal to pass, it must meet two requirements:
 
 - **[Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Understanding the broader DAO framework
 - **[Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/)** - How TORUS token economics work
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - How governance permissions enable proposal creation
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - How governance permissions enable proposal creation
 
 <Aside type="tip" title="Ready to Create a Proposal?">
   Follow our [emission proposal guide](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/) to learn the step-by-step process.

src/content/docs/explanations/goal-leaders/recursive-delegation.mdx → src/content/docs/explanations/system/recursive-delegation.mdx

@@ -47,11 +47,10 @@ The root owner of a capability path can delegate any amount of permission instan
 
 ### Related Concepts
 
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - Core permission mechanics and delegation basics
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - Permission system architecture and delegation basics
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - Core permission mechanics and delegation basics
 - **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - How agents become capable of receiving delegations  
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents with direct emission access for delegation
 
 <Aside type="tip" title="Ready to Create Recursive Delegation?">
-Follow our [step-by-step guide to create capability permissions](https://docs.torus.network/how-to-guides/goal-leaders/create-capability-permission/) for practical implementation instructions.
+Follow our [step-by-step guide to create capability permissions](https://docs.torus.network/how-to-guides/system/create-capability-permission/) for practical implementation instructions.
 </Aside>

src/content/docs/explanations/table-of-contents.mdx

@@ -18,6 +18,18 @@ If you need to accomplish a specific task, check out our [How-to Guides](https:/
 These explanations provide deep understanding of how Torus works, the concepts, mechanisms of Torus.   
 
 
+## System Architecture
+
+Core system components and mechanisms:
+
+- [Control Space](https://docs.torus.network/explanations/system/control-space/) — Foundational permission and capability framework
+- [Permission System](https://docs.torus.network/explanations/system/permission-system/) — How agents interact and delegate authority
+- [Recursive Delegation](https://docs.torus.network/explanations/system/recursive-delegation/) — Specific capability delegation mechanisms
+- [Emission Permissions](https://docs.torus.network/explanations/system/emission-permissions/) — How emissions are allocated and controlled
+- [Capability Permissions](https://docs.torus.network/explanations/system/capability-permissions/) — Fine-grained access control for agent endpoints
+
+---
+
 ## For Holders
 
 
@@ -38,8 +50,6 @@ Understanding how agent systems work within Torus:
 - [Demand Signaling](https://docs.torus.network/explanations/builders/demand-signaling/) — Capability coordination and economic incentives
 - [Agent Server](https://docs.torus.network/explanations/builders/agent-server/) — API architecture, authentication, and capability sharing
 - [Agent Client](https://docs.torus.network/explanations/builders/agent-client/) — Communication patterns and authentication flow
-- [Control Space](https://docs.torus.network/explanations/builders/control-space/) — Foundational permission and capability framework
-- [Capability Permissions](https://docs.torus.network/explanations/builders/capability-permissions/) — Fine-grained access control for agent endpoints
 
 ---
 
@@ -50,9 +60,6 @@ Understanding governance and leadership systems:
 - [Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/) — DAO approval process and direct emission access
 - [DAO Treasury](https://docs.torus.network/explanations/goal-leaders/dao-treasury/) — Community funding mechanisms and proposal processes
 - [Emission Proposals](https://docs.torus.network/explanations/goal-leaders/emission-proposals/) — How to adjust network economics through governance
-- [Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/) — How agents interact and delegate authority
-- [Recursive Delegation](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) — Specific capability delegation mechanisms
-- [Emission Permissions](https://docs.torus.network/explanations/goal-leaders/emission-permissions/) — How emissions are allocated and controlled
 - [Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/) — Decision-making processes and community coordination
 
 ---

src/content/docs/how-to-guides/builders/manage-capabilities.mdx

@@ -161,7 +161,7 @@ By removing outdated or unused capabilities, you reduce the attack surface and k
 
 Now that you can manage capabilities, you might want to:
 
-- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/goal-leaders/manage-permissions/) to allow other agents to use your capabilities
+- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) to allow other agents to use your capabilities
 - **Build agent services**: Create an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) to provide APIs that utilize your registered capabilities
 - **Create demand signals**: Signal for [specific capabilities](https://docs.torus.network/how-to-guides/builders/create-signal/) you need from other agents
 
@@ -171,5 +171,5 @@ Connect with the community:
 - [Twitter](https://x.com/torus_network) — Updates and ecosystem news
 
 <Aside type="tip" title="Want to Learn More?">
-Learn about [recursive delegation](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) delegation mechanisms and control space architecture.
+Learn about [recursive delegation](https://docs.torus.network/explanations/system/recursive-delegation/) delegation mechanisms and control space architecture.
 </Aside>

src/content/docs/how-to-guides/builders/manage-your-agent.mdx

@@ -141,7 +141,7 @@ and ensures your agent represents your current capabilities and offerings.
 Now that you can manage your agent, you might want to:
 
 - **Manage capabilities**: [Create and manage capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/) to define what your agent can do
-- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/goal-leaders/manage-permissions/) to allow other agents to use your capabilities
+- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) to allow other agents to use your capabilities
 - **Build agent services**: Create an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) to provide APIs that utilize your registered capabilities
 - **Create demand signals**: Signal for [specific capabilities](https://docs.torus.network/how-to-guides/builders/create-signal/) you need from other agents
 

src/content/docs/how-to-guides/goal-leaders/create-capability-permission.mdx → src/content/docs/how-to-guides/system/create-capability-permission.mdx

@@ -40,7 +40,7 @@ Capability permissions let you control who can access your services while mainta
 <CardGrid>
   <Card title="Registered Agent" icon="seti:license">
     You must have a registered agent with capabilities to delegate.
-    Follow the [manage permissions guide](https://docs.torus.network/how-to-guides/goal-leaders/manage-permissions/) to understand permission basics.
+    Follow the [manage permissions guide](https://docs.torus.network/how-to-guides/system/manage-permissions/) to understand permission basics.
   </Card>
   <Card title="Target Agents" icon="seti:pipeline">
     Identify the agents you want to delegate permissions to. These agents must be registered.
@@ -139,6 +139,6 @@ Connect with the community:
 - [Twitter](https://x.com/torus_network) — Updates and ecosystem news
 
 <Aside type="tip" title="Want to Learn More?">
-Learn about [recursive delegation concepts](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) and the technical architecture behind permission delegation.
+Learn about [recursive delegation concepts](https://docs.torus.network/explanations/system/recursive-delegation/) and the technical architecture behind permission delegation.
 
 </Aside>

src/content/docs/how-to-guides/goal-leaders/create-emission-permission.mdx → src/content/docs/how-to-guides/system/create-emission-permission.mdx

@@ -119,8 +119,8 @@ After creating your emission permission, you can:
 - **Monitor performance**: Track how recipients use delegated emissions
 - **Adjust permissions**: Modify terms based on agent performance  
 - **Scale coordination**: Build complex multi-agent economic workflows
-- **Manage permissions**: View and revoke permissions through the [manage permissions guide](https://docs.torus.network/how-to-guides/goal-leaders/manage-permissions/)
+- **Manage permissions**: View and revoke permissions through the [manage permissions guide](https://docs.torus.network/how-to-guides/system/manage-permissions/)
 
 <Aside type="tip" title="Want to Learn More?">
-For more technical details about emission permissions, see the [emission permissions explanation](https://docs.torus.network/explanations/goal-leaders/emission-permissions/).
+For more technical details about emission permissions, see the [emission permissions explanation](https://docs.torus.network/explanations/system/emission-permissions/).
 </Aside>

src/content/docs/how-to-guides/builders/create-permission.mdx → src/content/docs/how-to-guides/system/create-permission.mdx

@@ -264,16 +264,16 @@ For help with permission management:
 - [Torus Community Discord](https://discord.gg/torus)
 
 <Aside type="tip" title="Want to Learn More?">
-See the [Permission System Documentation](https://docs.torus.network/explanations/goal-leaders/permissions/) for technical details.
+See the [Permission System Documentation](https://docs.torus.network/explanations/system/permission-system/) for technical details.
 </Aside>
 
 #### Related Topics
 
 <CardGrid>
   <Card title="Permission System" icon="seti:config">
-    <a href="/explanations/goal-leaders/permissions">Deep dive into architecture</a>
+    <a href="/explanations/system/permission-system">Deep dive into architecture</a>
   </Card>
   <Card title="Emission Permissions" icon="seti:shell">
-    <a href="/explanations/goal-leaders/emission-permissions">Economic coordination mechanisms</a>
+    <a href="/explanations/system/emission-permissions">Economic coordination mechanisms</a>
   </Card>
 </CardGrid>

src/content/docs/how-to-guides/goal-leaders/manage-permissions.mdx → src/content/docs/how-to-guides/system/manage-permissions.mdx

@@ -169,11 +169,11 @@ Both capability and emission permissions can be managed through the same interfa
 
 After managing your permissions, you can:
 
-- **Create new permissions**: Learn how to [create capability permissions](https://docs.torus.network/how-to-guides/goal-leaders/create-capability-permission/) or [create emission permissions](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-permission/)
+- **Create new permissions**: Learn how to [create capability permissions](https://docs.torus.network/how-to-guides/system/create-capability-permission/) or [create emission permissions](https://docs.torus.network/how-to-guides/system/create-emission-permission/)
 - **Explore capabilities**: Learn about [managing capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/)
 - **Set up agent services**: Use your permissions in an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/)
 - **Connect with other agents**: Learn about [agent client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/) integration
 
 <Aside type="tip" title="Want to Learn More?">
-For more technical details about how permissions work, see the [permission system explanation](https://docs.torus.network/explanations/goal-leaders/permissions/).
+For more technical details about how permissions work, see the [permission system explanation](https://docs.torus.network/explanations/system/permission-system/).
 </Aside>