Docs: Use Cases category

CONTRIBUTING_DOCS.md

@@ -35,6 +35,17 @@ This section will cover the theoretical aspects and foundational concepts releva
   * **Integrations guides:** These will be part of the "Developers" section, detailing how to integrate the product with other systems.
   * **User guides:** These belong under the "Concept" section as they explain how to use the product rather than integrate with it.
 
+### Quick Starts vs Use Cases (avoid duplicate maintenance)
+
+Some starter kits appear in **Developers → Quick Starts** and also have a **Use Cases** guide (for example Collective DAO). Follow these rules so install instructions do not diverge:
+
+1. **Canonical setup for a public repo:** Keep `git clone`, `.env` / `.env.example`, `npm install`, and `npm run dev` in the **GitHub README** for that repository. Treat it as the single source of truth for environment variables and versions.
+2. **`/developers/quickstart/...` page:** Use a **short** quick start: goal in one or two sentences, prerequisites summary, link to the README for Setup, and a link to the **Use Cases** article for architecture, code maps, and checklists. Do not paste full env tables or multi-step install blocks if the README already has them.
+3. **`/use-cases/...` page:** Focus on the **job to be done**, SDK usage, file mapping, risks, and FAQs. Link to the README (and optionally the quick start page) under **Getting Started** instead of duplicating install steps.
+4. **Before adding content:** Search existing Quick Starts and the kit README. Prefer **one new paragraph plus links** over copying blocks into two portal locations.
+
+If you add a new starter kit to both areas, add a **Quick Starts** hub card and a **Use Cases** guide that references the same README pattern above.
+
 
 ### Node Operators Section
 

docs/01-concepts/fundamentals/stack/index.md

@@ -17,7 +17,7 @@
 * Performance improvement pipeline documented in numerous RSKIPs created by the Rootstock community
     * See the [Rootstock Improvement Proposals](https://github.com/rsksmart/RSKIPs).
 
-![Rootstock Technology Stack - High Level](/img/concepts/rootstock-tech-stack.svg)
+<!-- ![Rootstock Technology Stack - High Level](/img/concepts/rootstock-tech-stack.svg) -->
 
 <section>
 <div class="row">
@@ -41,4 +41,51 @@
         <p>The Smart Bitcoin (rBTC) is the native currency in Rootstock and it is used to pay for the gas required for the execution of transactions. It is pegged 1:1 with Bitcoin, which means in Rootstock there are exactly 21M rBTC. A PowPeg allows the transfer of bitcoins from the Bitcoin blockchain to the Rootstock blockchain and vice-versa.</p>
     </div>
 </div>
-</section>
+</section>
+
+## The Stack
+
+When building BTCFi dApps, you interact with the **Rootstock Virtual Machine (RVM)**.Because the RVM is fully EVM-compatible, you can use industry-standard tools like **Remix, Hardhat, and Foundry** to manage Bitcoin-native assets.
+
+<div className="rootstock-stack-container">
+    {/* Application Layer */}
+    <div className="stack-layer">
+        <div className="layer-label" style={{ backgroundColor: '#FF71E1' }}>APPLICATIONS</div>
+        <div className="layer-content bg-pink">
+            <div className="sub-module">YIELD VAULTS</div>
+            <div className="sub-module">STAKING</div>
+            <div className="sub-module">AI AGENTS</div>
+        </div>
+    </div>
+    {/* Tooling Layer */}
+    <div className="stack-layer">
+        <div className="layer-label" style={{ backgroundColor: '#9E76FF' }}>DEVTOOL</div> 
+        <div className="layer-content bg-purple" style={{ gridTemplateColumns: '1fr', display: 'flex', alignItems: 'center', justifyContent: 'center', fontWeight: '700', letterSpacing: '2px' }}>
+            REMIX • HARDHAT • FOUNDRY • OPENZEPPELIN • DAO SDK
+        </div>
+    </div>
+    {/* Infrastructure Layer */}
+    <div className="stack-layer">
+        <div className="layer-label" style={{ backgroundColor: '#08FFD0' }}>RIF SERVICES</div>
+        <div className="layer-content bg-cyan">
+            <div className="sub-module">RIF RELAY</div>
+            <div className="sub-module">RNS</div>
+            <div className="sub-module">FLYOVER</div>
+            <div className="sub-module">COLLECTIVE DAO</div>
+        </div>
+    </div>
+    {/* Execution Layer */}
+    <div className="stack-layer">
+        <div className="layer-label" style={{ backgroundColor: '#79C600' }}>EXECUTION</div>
+        <div className="layer-content bg-green" style={{ gridTemplateColumns: '1fr' }}>
+            <div className="sub-module">ROOTSTOCK VIRTUAL MACHINE (EVM-COMPATIBLE)</div>
+        </div>
+    </div>
+    {/* Security Layer */}
+    <div className="stack-layer">
+        <div className="layer-label" style={{ backgroundColor: '#FF9100' }}>SECURITY</div>
+        <div className="layer-content bg-orange" style={{ gridTemplateColumns: '1fr' }}>
+            <div className="sub-module">BITCOIN: MERGED MINING</div>
+        </div>
+    </div>
+</div>

docs/01-concepts/rif-suite/rns/index.md

@@ -1,7 +1,7 @@
 ---
 sidebar_label: RNS
 sidebar_position: 400
-title: "RIF RNS: RIF Name Service"
+title: "RIF Name Service (RNS)"
 tags: [rif, rns, rif-name-service, rsk, rootstock]
 description: "Information about the RIF Name Service, specs, how to use and integrate."
 ---
@@ -10,16 +10,16 @@
 
 <RNSDomainSearch />
 
-<div className="row rif_blue_text">
+<!-- <div className="row rif_blue_text">
   <div className="col">
     <div className="rns-index-box">
       <a href="https://testnet.manager.rns.rifos.org/">Try the service</a>
       <br />
       <br />
       <p>Register a domain in the Testnet, for free.</p>
     </div>
   </div>
-  <!-- <div className="col">
+  <div className="col">
     <div className="rns-index-box">
       <a href="./integrate">Integrate with RNS</a>
       <br />
@@ -44,8 +44,8 @@
       <br />
       <p>Use simple libraries to interact with RNS service.</p>
     </div>
-  </div> -->
-</div>
+  </div>
+</div> -->
 
 ## The stack
 

docs/02-developers/04-quickstart/collective.md

@@ -0,0 +1,32 @@
+---
+sidebar_position: 113
+sidebar_label: Collective DAO
+title: Collective DAO Starter Kit
+description: Run the Rootstock Collective sample dApp with Wagmi, RainbowKit, staking, proposals, and voting. Setup steps live in the GitHub README.
+tags: [quickstart, collective-sdk, dao, governance, rootstock, wagmi, rif]
+---
+
+This quick start points to the [Rootstock Collective starter kit](https://github.com/rsksmart/rootstock-collective-starter-kit), a sample dApp that uses [`@rsksmart/collective-sdk`](https://www.npmjs.com/package/@rsksmart/collective-sdk) for staking RIF, listing proposals, and voting on Rootstock Mainnet or Testnet.
+
+## What you do here
+
+Follow the **Setup** section in the repo README: clone, copy `.env` from `.env.example`, set the variables it describes, install, and run `npm run dev`. That README is the **only** canonical place for install commands and environment keys so they stay in sync with the kit.
+
+## Prerequisites
+
+- Node.js 18+
+- A Reown (WalletConnect) project ID for the dApp (see README)
+- Optional Rootstock RPC API key for higher rate limits (see README)
+- A wallet on Rootstock (chain ID 30 or 31) with tRBTC for gas and RIF or stRIF as needed for flows you test
+
+## After the app runs
+
+For how SDK calls map to `src/` files, simulation before writes, governance UX edge cases, and a production checklist, use the use case guide:
+
+- [Build DAO voting and RIF utility with the Collective SDK](/use-cases/integrate-rif-economy/build-dao-voting-collective-sdk/)
+
+## References
+
+- [rootstock-collective-starter-kit on GitHub](https://github.com/rsksmart/rootstock-collective-starter-kit)
+- [Collective SDK source](https://github.com/rsksmart/collective-sdk)
+- [Rootstock Collective app](https://app.rootstockcollective.xyz/)

docs/02-developers/04-quickstart/index.md

@@ -17,7 +17,8 @@ values={[
 {label: 'Reown', value: 'reown'},
 {label: 'On-chain data', value: 'data'},
 {label: 'RPC API', value: 'rpc'},
-{label: 'Port to Rootstock', value: 'port-dapps'}
+{label: 'Port to Rootstock', value: 'port-dapps'},
+{label: 'Governance', value: 'governance'}
 ]}>
 <FilterItem
     value="beginner, Advanced"
@@ -136,6 +137,15 @@ values={[
     linkTitle="Use the Kit"
     description="Account Abstraction Starter Kit using Etherspot."
   />
+<FilterItem
+    value="governance, wagmi, advanced"
+    title="Rootstock Collective DAO Starter Kit"
+    subtitle="quickstart"
+    color="orange"
+    linkHref="/developers/quickstart/collective/"
+    linkTitle="Use the Kit"
+    description="Sample dApp for staking RIF, listing proposals, and voting with the Collective SDK. Full clone and env steps are in the GitHub README; the portal links to the repo and the deep-dive use case guide."
+  />
 <FilterItem
     value="advanced"
     title="dApp Automation with Cucumber"

docs/02-developers/04-quickstart/mcp.md

@@ -12,7 +12,7 @@ In this tutorial, you will learn how to interact with AI clients to automate, bu
 
 :::info[Model Context Protocols on Rootstock]
 
-Not sure about what MCPs are or how they work? Read the [guide to MCPs on Rootstock](/developers/use-cases/ai/mcp-rootstock).
+Not sure what MCPs are or how they work? Read the [guide to MCPs on Rootstock](/use-cases/ai-automation/mcp-rootstock/).
 
 :::
 
@@ -402,4 +402,4 @@ _Error: `rsk-mcp-server disconnected`_
 ## Related Resources
 * [MCP Starter Kit NPM Package](https://www.npmjs.com/package/@rsksmart/rsk-mcp-server)
 * [MCP Server Starter Kit](https://github.com/rsksmart/rsk-mcp-server)
-* [Build Conversational AI Agents on Rootstock](/developers/use-cases/ai/ai-agent-rootstock/)
+* [Conversational app with on-chain actions on Rootstock](/use-cases/ai-automation/ai-agent-rootstock/)

docs/02-developers/06-integrate/01-rif-relay/overview.md

@@ -36,7 +36,4 @@ Each module has instructions for development and usage.
 
 
 ## Contribution Guidelines
-* Please refer to the Rootstock Contribution Guidelines for more information on how to contribute to this project.
-
-## License:
-MIT License - Copyright (c) 2023 Rootstock
+* Please refer to the Rootstock Contribution Guidelines for more information on how to contribute to this project.

docs/02-developers/index.md

@@ -26,6 +26,6 @@ This section enables developers getting started with the Rootstock blockchain. D
 | [Integration Guides](/developers/integrate/) | Deepen your knowledge with detailed guides and informative tutorials that cover various aspects of Rootstock development.|
 | [JSON-RPC](/developers/rpc-api/) | Test your dApps on testnet in minutes before deploying to mainnet using RPC API providers on Rootstock.|
 | [Libraries](/developers/libraries/) | Access essential tools and libraries to streamline your development process. |
-| [Use Cases](/developers/use-cases/) | Explore Rootstock dApp use case guides and tutorials for building DeFi on Bitcoin, AI, and cross-chain solutions. |
+| [Use Cases](/use-cases/) | Use case guides and tutorials for DeFi, onboarding, bridging, and automation on Rootstock. |
 
 

docs/04-resources/04-tutorials/index.md

@@ -71,16 +71,16 @@ value="advanced, defi"
 title="Build an Omnichain Fungible Token (OFT) on Rootstock with Layerzero"
 subtitle="Cross chain"
 color="orange"
-linkHref="/developers/use-cases/defi/rootstock-layerzero/"
+linkHref="/use-cases/interoperability/rootstock-layerzero/"
 description="This guide demonstrates implementing cross-chain token transfers using OFT (Omnichain Fungible Token) between Rootstock Testnet and Ethereum Sepolia Testnet via LayerZero's OFT V2 protocol."
 />
 <FilterItem
 value="ai"
-title="Build a Conversational AI Agent with Blockchain Actions on Rootstock"
+title="Conversational app with on-chain actions on Rootstock"
 subtitle="ai agents"
 color="orange"
-linkHref="/developers/use-cases/ai/ai-agent-rootstock"
-description="This guide demonstrates how to build a lightweight dApp that connects a conversational AI agent to the Rootstock testnet, allowing users to perform DeFi actions like checking token balances and sending tRBTC simply by chatting."
+linkHref="/use-cases/ai-automation/ai-agent-rootstock/"
+description="Build a small dApp that connects a chat UI to Rootstock testnet so users can check balances and send tRBTC from conversation."
 />
 <FilterItem
 value="advanced"

docs/04-resources/06-guides/powpeg-app/advanced-operations/index.md

@@ -15,7 +15,7 @@
 These operations include;
 
 * How to review funds in Bitcoin after a pegout by [viewing a derived address](/resources/guides/powpeg-app/pegout/deriving-electrum), 
-* Convert RBTC - BTC and import a [key in Electrum](/resources/guides/powpeg-app/pegout/deriving-electrum#import-key-in-electrum), import in Electrum if you are using [hardware wallets](/resources/guides/powpeg-app/pegout/deriving-electrum#import-key-in-electrum-using-hardware-wallets)
+* Convert RBTC - BTC and import a [key in Electrum](/resources/guides/powpeg-app/pegout/deriving-electrum#import-key-in-electrum), import in Electrum if you are using [hardware wallets](/resources/guides/powpeg-app/pegout/deriving-electrum)
 * Selecting different accounts
 * Viewing advanced details
 * Adjusting network fees

docs/04-resources/06-guides/powpeg-app/pegout/deriving-electrum.md

@@ -26,9 +26,9 @@
 
 ## How to view a derived address {#how-to-view-advanced-details}
 
-A derived address is the BTC address derived from the RBTC account. When using the PowPeg app, it is important to know which address you will receive your BTCs. See [Viewing advanced details](#how-to-view-advanced-details).
+A derived address is the BTC address derived from the RBTC account. When using the PowPeg app, it is important to know which address you will receive your BTCs
 
-We will learn how to view a derived address using [Metamask](#using-metamask) to get a private key. We will also learn how to [convert RBTC - BTC](#converting-btc-to-rbtc) and [Import a Key in Electrum](#import-key-in-electrum).
+We will learn how to view a derived address using [Metamask](/resources/guides/powpeg-app/pegout/deriving-electrum/#using-metamask) to get a private key. We will also learn how to [convert RBTC - BTC](/resources/guides/powpeg-app/pegout/metamask/) and [Import a Key in Electrum](/resources/guides/powpeg-app/pegout/deriving-electrum/#import-key-in-electrum).
 
 ### Getting a wallet private key
 

docs/04-resources/06-guides/powpeg-app/pegout/ledger.md

@@ -62,7 +62,7 @@ Step 12: Ledger Connected <br/>
 <br/>
 Step 13: Continue filling in the other fields as amount and click on the Send button
 
-Step 14: After finish the pegout transaction creation, click here to see how to see the steps to access to Bitcoin derived address in hardware wallet using [Electrum](/resources/guides/powpeg-app/advanced-operations#electrum-hardware-wallets)
+Step 14: After finish the pegout transaction creation, click here to see how to see the steps to access to Bitcoin derived address in hardware wallet using [Electrum](/resources/guides/powpeg-app/advanced-operations)
 
 ----
 

docs/02-developers/09-use-cases/runes-rootstock/airdrop-giveaway-machine/setup-airdrop.md → docs/04-resources/06-guides/runes-rootstock/airdrop-giveaway-machine/setup-airdrop.md

@@ -53,7 +53,7 @@ This variable specifies the address of the Airdrop Manager smart contract. To en
 
 :::info[Info]
 
-For detailed instructions on obtaining the Airdrop Manager address, please refer to the [Deployment](/developers/use-cases/runes-rootstock/airdrop-giveaway-machine/deploy-airdrop-machine/) section.
+For detailed instructions on obtaining the Airdrop Manager address, please refer to the [Deployment](/resources/guides/runes-rootstock/airdrop-giveaway-machine/deploy-airdrop-machine/) section.
 
 :::
 

docs/05-dev-tools/cross-chain-bridges/index.md

@@ -58,7 +58,7 @@ Imagine different islands, each with its own unique economy and currency. To tra
     subtitle="cross-chain"
     color="green"
     description="LayerZero, a cross-chain messaging protocol enables the seamless movement of Bitcoin-backed assets from Rootstock to other blockchains, allowing developers to build omnichain applications (OApps) that interact across multiple chains as if they were one."
-    linkHref="/developers/use-cases/defi/rootstock-layerzero/"
+    linkHref="/use-cases/interoperability/rootstock-layerzero/"
     linkTitle="Start Bridging"
   />
 </CardsGrid>

docs/05-dev-tools/cross-chain-bridges/layerzero.md

@@ -9,5 +9,5 @@ tags: [Layerzero, bridges, developer tools, rsk, testnet, rootstock, ethereum, d
 Rootstock now integrates with LayerZero, a cross-chain messaging protocol. This integration enables the seamless movement of Bitcoin-backed assets from Rootstock to other blockchains, allowing developers to build omnichain applications (OApps) that interact across multiple chains as if they were one. Users can now move their Bitcoin across different DeFi ecosystems without complicated bridges, high fees, or slow transactions.
 
 ## Resources
-- [How Build Omnichain Fungible Token (OFTs) on Rootstock with Layerzero](/developers/use-cases/defi/rootstock-layerzero/).
+- [How Build Omnichain Fungible Token (OFTs) on Rootstock with Layerzero](/use-cases/interoperability/rootstock-layerzero/).
 - [Deployed Endpoints, Message Libraries, and Executors](https://docs.layerzero.network/v2/deployments/deployed-contracts)