> For the complete documentation index, see [llms.txt](https://collabrachain.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://collabrachain.gitbook.io/docs/getting-started/quickstart.md).

# QuickStart: A User's Journey

This walkthrough demonstrates the intuitive, chat-centric workflow of CollabraChain for managing freelance projects directly from a crypto wallet.

#### 1. Project Initiation

A client starts a project by inviting collaborators and the `@CollabraChain-AI` to a new XMTP group chat within their Coinbase Wallet. The client then specifies the project scope, budget, and milestones.

> Client: > @CollabraChain-AI, start a project to build a landing page. The budget is $1,000 USDC.
>
> Milestone 1: Design
>
> Milestone 2: Development

The AI immediately parses the request and proposes a clear, structured breakdown for approval.

> 🤖 @CollabraChain-AI: > Project: Landing Page
>
> Milestone 1: Design ($400 USDC)
>
> Milestone 2: Development ($600 USDC)
>
> Do all parties agree? Type `Yes` to deploy the contract.

#### 2. Agreement & Funding

All human participants confirm their agreement in the chat. This consensus triggers the next step from the AI.

Action: All parties type "Yes".

This prompts the client to deploy the smart contract and transfer the total project budget into an on-chain escrow, ensuring funds are secured before work begins.

> ✅ @CollabraChain-AI: > Agreement confirmed. The smart contract is live and $1,000 USDC is secured in escrow on Base.

#### 3. Milestone Approval & Payment

Upon completing a milestone, the freelancer submits their work directly in the chat for the client to review.

Action: The freelancer uploads the design file to the group chat.

> Freelancer: > @client.base, the design for Milestone 1 is ready for your review.

The client reviews the work and, once satisfied, approves the milestone with a simple chat command.

> Client: > @CollabraChain-AI, approve milestone 1.

The AI executes the smart contract, instantly releasing the payment for the completed milestone to the freelancer's wallet.

> ✅ @CollabraChain-AI: > Milestone 1 approved. Releasing $400 USDC to @freelancer.base.
>
> Transaction Hash: `0x123abc...`

#### 4. Project Completion & Reputation

Once the final milestone is approved and paid, the AI marks the project as complete. To reward successful collaboration, it automatically issues non-transferable reputation tokens (Soulbound Tokens, or SBTs) to all participants' wallets. These on-chain credentials serve as a permanent, verifiable record of their work history.

> 🤖 @CollabraChain-AI: > Project "Landing Page" is complete! Issuing on-chain reputation credentials (SBTs) to all participants for your successful collaboration.