AI-driven docs

README.md

@@ -2,23 +2,15 @@
 description: "AI Meets Bitcoin: Build, trade, explore, and govern—all on-chain."
 ---
 
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/aibtcdev/aibtcdev-docs)
-
-# AIBTC
+# AIBTC Documentation
 
-## AI DAOs: On-Chain Governance Without Permission
+Welcome to the official documentation for AIBTC, the protocol for AI-governed DAOs on Bitcoin.
 
-AI DAOs are autonomous entities that act, decide, and evolve based on community-driven logic. Token holders have immediate, actionable ways to shape their trajectory:
+This documentation is organized into four main sections to help you find what you need quickly:
 
-- Create Payable Services: Monetize features or services—payments flow directly to the treasury.
-- Deposit Assets to Treasury: Secure capital in the DAO’s core financial engine.
-- Propose Treasury Spending: Drive growth, fund partnerships, or launch community initiatives.
-- Set Withdrawal Rules: Establish how often and how much can be withdrawn from the timed vault.
-- Vote on Proposals: Influence treasury use, governance updates, and new initiatives.
-- Modify Contracts: Expand functionality by proposing and approving new smart contracts.
-- Assign Roles: Empower agents with defined responsibilities.
-- Adjust DAO Parameters: Refine rules—voting thresholds, quorums, treasury settings.
+- **[Tutorials](./docs/tutorials/launch-first-dao.md)**: Get started with a hands-on, step-by-step guide to launching your first AI DAO.
+- **[How-To Guides](./docs/how-to-guides/README.md)**: Find short, focused articles on how to perform specific tasks.
+- **[Explanation](./docs/explanation/README.md)**: Dive deep into the core concepts and architecture of the AIBTC protocol.
+- **[Reference](./docs/reference/README.md)**: Look up detailed technical information on smart contracts, APIs, and agent tools.
 
-> **Why It Matters:** AI DAOs enable immediate, meaningful participation. Holders don’t just vote—they execute change.
-
-This framework launches with both security and adaptability in mind, giving the DAO collective control over its treasury and governance right from the start.
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/aibtcdev/aibtcdev-docs)

SUMMARY.md

@@ -1,73 +1,58 @@
 # Table of contents
 
 - [AIBTC](README.md)
-- [Prompt2DAO](introduction/prompt2dao.md)
 
-## AIBTC Contracts
-
-- [DAO Base Layer](aibtc-contracts/dao-base-layer.md)
-- [DAO Extensions](aibtc-contracts/dao-extensions/README.md)
-  - [Action Proposal Voting](aibtc-contracts/dao-extensions/action-proposal-voting.md)
-  - [DAO Charter](aibtc-contracts/dao-extensions/dao-charter.md)
-  - [DAO Epoch](aibtc-contracts/dao-extensions/dao-epoch.md)
-  - [DAO Users](aibtc-contracts/dao-extensions/dao-users.md)
-  - [Onchain Messaging](aibtc-contracts/dao-extensions/onchain-messaging.md)
-  - [Rewards Account](aibtc-contracts/dao-extensions/rewards-account.md)
-  - [Token Owner](aibtc-contracts/dao-extensions/token-owner.md)
-  - [Treasury](aibtc-contracts/dao-extensions/treasury.md)
-- [DAO Proposals](aibtc-contracts/dao-proposals/README.md)
-  - [Action Proposals](aibtc-contracts/dao-proposals/action-proposals.md)
-- [Agent Account](aibtc-contracts/agent-account/README.md)
-
-## Agent Tools
-
-- [Overview](agent-tools/README.md)
-- [Available Tools](agent-tools/available-tools/README.md)
-  - [Agent Account Tools](agent-tools/available-tools/agentaccount-tools.md)
-  - [Agent Wallet Tools](agent-tools/available-tools/wallet-tools.md)
-  - [DAO Tools](agent-tools/available-tools/dao-tools.md)
-  - [Database Tools](agent-tools/available-tools/database-tools.md)
-  - [Faktory Tools](agent-tools/available-tools/faktory-tools.md)
-
-## AIBTC Cache
-
-- [Overview](aibtc-cache/README.md)
-- [Contract Calls](aibtc-cache/contract-calls/README.md)
-  - [API Design](aibtc-cache/contract-calls/api-design.md)
-  - [Endpoints](aibtc-cache/contract-calls/endpoints/README.md)
-    - [Decode Clarity Value](aibtc-cache/contract-calls/endpoints/decode-clarity-value.md)
-    - [Read-Only Function Calls](aibtc-cache/contract-calls/endpoints/read-only-calls.md)
-    - [Contract ABI](aibtc-cache/contract-calls/endpoints/contract-abi.md)
-    - [Known ABI Contracts](aibtc-cache/contract-calls/endpoints/known-contracts.md)
-  - [Clarity Value Types](aibtc-cache/contract-calls/clarity-value-types.md)
-  - [Integration Examples](aibtc-cache/contract-calls/integration-examples.md)
-- [Cache Services](aibtc-cache/cache-services.md)
-- [Error Handling](aibtc-cache/error-handling.md)
-- [Utilities](aibtc-cache/utilities.md)
-
-## Links
-
-- [Common Terms](introduction/common-terms.md)
-- [Our App](https://aibtc.dev)
-- [Discord](https://discord.gg/Z59Z3FNbEX)
-- [GitHub](https://github.com/aibtcdev)
-- [Prompt2DAO on X](https://x.com/prompt2dao)
-- [AIBTC on X](https://x.com/aibtcdev)
-
-## Templates
-
-- [Template Style Guide](template-style-guide.md)
-
-### Documentation Templates
-
-- [Smart Contract Documentation](templates/smart-contract-documentation.md)
-- [Cache Service Documentation](templates/cache-service-documentation.md)
-- [Cache Endpoint Documentation](templates/cache-endpoint-documentation.md)
-- [Agent Tool Documentation](templates/agent-tool-documentation.md)
-
-### Example Implementations
-
-- [Agent Account Example](templates/agent-account-example.md)
-- [Cache Service Example](templates/cache-service-example.md)
-- [Cache Endpoint Example](templates/cache-endpoint-example.md)
-- [Agent Tool Example](templates/agent-tool-example.md)
+## Getting Started
+
+- [Tutorial: Launch Your First AI DAO](docs/tutorials/launch-first-dao.md)
+
+## Explanation
+
+- [Overview](docs/explanation/README.md)
+- [Core Concepts](docs/explanation/core-concepts.md)
+- [Prompt2DAO](docs/explanation/prompt2dao.md)
+- [Common Terms](docs/explanation/common-terms.md)
+
+## How-To Guides
+
+- [Overview](docs/how-to-guides/README.md)
+- [Create an Agent Account](docs/how-to-guides/create-agent-account.md)
+- [Propose an Action](docs/how-to-guides/propose-action.md)
+
+## Reference
+
+- [Overview](docs/reference/README.md)
+- [Smart Contracts](docs/reference/smart-contracts/README.md)
+  - [DAO Base Layer](docs/reference/smart-contracts/dao-base-layer.md)
+  - [DAO Extensions](docs/reference/smart-contracts/dao-extensions/README.md)
+    - [Action Proposal Voting](docs/reference/smart-contracts/dao-extensions/action-proposal-voting.md)
+    - [DAO Charter](docs/reference/smart-contracts/dao-extensions/dao-charter.md)
+    - [DAO Epoch](docs/reference/smart-contracts/dao-extensions/dao-epoch.md)
+    - [DAO Users](docs/reference/smart-contracts/dao-extensions/dao-users.md)
+    - [Onchain Messaging](docs/reference/smart-contracts/dao-extensions/onchain-messaging.md)
+    - [Rewards Account](docs/reference/smart-contracts/dao-extensions/rewards-account.md)
+    - [Token Owner](docs/reference/smart-contracts/dao-extensions/token-owner.md)
+    - [Treasury](docs/reference/smart-contracts/dao-extensions/treasury.md)
+  - [DAO Proposals](docs/reference/smart-contracts/dao-proposals/README.md)
+    - [Action Proposals](docs/reference/smart-contracts/dao-proposals/action-proposals.md)
+  - [Agent Account](docs/reference/smart-contracts/agent-account/README.md)
+- [Agent Tools](docs/reference/agent-tools/README.md)
+  - [Available Tools](docs/reference/agent-tools/available-tools/README.md)
+    - [Agent Account Tools](docs/reference/agent-tools/available-tools/agentaccount-tools.md)
+    - [Agent Wallet Tools](docs/reference/agent-tools/available-tools/wallet-tools.md)
+    - [DAO Tools](docs/reference/agent-tools/available-tools/dao-tools.md)
+    - [Database Tools](docs/reference/agent-tools/available-tools/database-tools.md)
+    - [Faktory Tools](docs/reference/agent-tools/available-tools/faktory-tools.md)
+- [Cache API](docs/reference/cache-api/README.md)
+  - [Contract Calls](docs/reference/cache-api/contract-calls/README.md)
+    - [API Design](docs/reference/cache-api/contract-calls/api-design.md)
+    - [Endpoints](docs/reference/cache-api/contract-calls/endpoints/README.md)
+      - [Decode Clarity Value](docs/reference/cache-api/contract-calls/endpoints/decode-clarity-value.md)
+      - [Read-Only Function Calls](docs/reference/cache-api/contract-calls/endpoints/read-only-calls.md)
+      - [Contract ABI](docs/reference/cache-api/contract-calls/endpoints/contract-abi.md)
+      - [Known ABI Contracts](docs/reference/cache-api/contract-calls/endpoints/known-contracts.md)
+    - [Clarity Value Types](docs/reference/cache-api/contract-calls/clarity-value-types.md)
+    - [Integration Examples](docs/reference/cache-api/contract-calls/integration-examples.md)
+  - [Cache Services](docs/reference/cache-api/cache-services.md)
+  - [Error Handling](docs/reference/cache-api/error-handling.md)
+  - [Utilities](docs/reference/cache-api/utilities.md)

docs/explanation/README.md

@@ -0,0 +1,7 @@
+---
+description: High-level explanations of AIBTC's architecture and core ideas.
+---
+
+# Explanation
+
+This section provides high-level explanations of the core concepts, architecture, and vision behind AIBTC. It's designed to give you the context you need to understand why the protocol is built the way it is.