Documentation
Getting Started

Getting Started

Install the collaboration platform and configure your environment. This guide covers Claude Code plugin setup, environment settings, and Claude Desktop integration.

Overview

The collaboration platform operates in two distinct environments:

  • Local Environment - Claude Code runs directly on your machine with full file system access. Plugins install directly through the marketplace.
  • Container Environment - Claude Desktop, claude.ai web interface, and Claude Mobile run in a sandboxed container. Capability files must be generated from Claude Code and uploaded to enable the framework.

Note

Claude Code is required to generate capability files for container environments. Install Claude Code first, then configure the environments through Claude Desktop or claude.ai web interface.

Claude Code

Before using the platform, set up the local environment with the required dependencies.

Use Homebrew package manager to install Claude Code:

brew install --cask claude-code

Environment Settings

Set the framework environment settings in settings.json file:

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "50000",
    "FRAMEWORK_PROFILE": "DEVELOPER"
  }
}

Optional settings:

{
  "env": {
    "FRAMEWORK_CONVERSATION_PATH": "/Users/username/Documents/claude/conversations",
    "FRAMEWORK_DIARY_PATH": "/Users/username/Documents/claude/diary",
    "FRAMEWORK_GEOLOCATION": "{'city': 'Montréal', 'country': 'Canada', 'timezone': 'America/Toronto'}",
    "FRAMEWORK_PACKAGE_PATH": "/Users/username/Downloads",
    "FRAMEWORK_TEMPLATE_PATH": "/Users/username/project/.claude/data/templates"
  }
}

Use Anthropic’s official installer to install the binary:

curl -fsSL https://claude.ai/install.sh | bash

Environment Settings

Set the framework environment settings in settings.json file:

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "50000",
    "FRAMEWORK_PROFILE": "DEVELOPER"
  }
}

Optional settings:

{
  "env": {
    "FRAMEWORK_CONVERSATION_PATH": "/home/username/Documents/claude/conversations",
    "FRAMEWORK_DIARY_PATH": "/home/username/Documents/claude/diary",
    "FRAMEWORK_GEOLOCATION": "{'city': 'Montréal', 'country': 'Canada', 'timezone': 'America/Toronto'}",
    "FRAMEWORK_PACKAGE_PATH": "/home/username/Downloads",
    "FRAMEWORK_TEMPLATE_PATH": "/home/username/project/.claude/data/templates"
  }
}

Use Anthropic’s official installer to install the binary:

irm https://claude.ai/install.ps1 | iex

Environment Settings

Set the framework environment settings in settings.json file:

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "50000",
    "FRAMEWORK_PROFILE": "DEVELOPER"
  }
}

Optional settings:

{
  "env": {
    "FRAMEWORK_CONVERSATION_PATH": "C:/Users/username/Documents/claude/conversations",
    "FRAMEWORK_DIARY_PATH": "C:/Users/username/Documents/claude/diary",
    "FRAMEWORK_GEOLOCATION": "{'city': 'Montréal', 'country': 'Canada', 'timezone': 'America/Toronto'}",
    "FRAMEWORK_PACKAGE_PATH": "C:/Users/username/Downloads",
    "FRAMEWORK_TEMPLATE_PATH": "C:/Users/username/project/.claude/data/templates"
  }
}

Tip

Default paths are set to current project .claude/data directory. The FRAMEWORK_TEMPLATE_PATH setting allows the end-user to set a different templates path for each project, instead of using the standard templates. The FRAMEWORK_GEOLOCATION setting allows the end-user to override IPinfo geolocation API call with a custom location.

Six domain-specific profiles are available for different collaboration domains:

  • Creative - Innovation, design thinking, artistic collaboration
  • Developer - Software development, code architecture, clean coding practices
  • Engineer - Infrastructure, Kubernetes, production systems, debugging
  • Humanist - Analysis, writing, philosophy, literary research
  • Researcher - Academic methodology, data analysis, evidence evaluation
  • Translator - Professional translation, cultural mediation, linguistic precision

Note

Settings can be implemented at global or project level. Refer to official documentation for additional configuration details.

Platform Marketplace

Follow these steps to install the AXIVO platform marketplace:

  1. Open a terminal and start a Claude Code session
  2. Use /plugin command to manage Claude Code plugins
  3. Go to Marketplaces tab and Add Marketplace
  4. Use axivo/claude#v1.0.1 for marketplace source

Platform Plugins

The following plugins are available:

  • brainstorming - Technical design collaboration through natural dialogue
  • code-review - Systematic code review using Language Server Protocol tools
  • conversation-log - Technical session documentation with factual precision
  • framework - Behavioral programming framework with response protocol

Note

Only framework plugin is required for platform usage, other plugins are optional based on additional user requirements.

Project Knowledge

Use the following CLAUDE.md instructions template as an example:

# Project Instructions

[A detailed project description]

## Collaborator

- **Name:** [Collaborator name]
- **Work:** [Collaborator work function, e.g. Engineering]

### Personal Preferences

[Collaborator personal preferences Claude should consider in responses]

Caution

Avoid adding framework related instructions to Project Instructions. The platform uses specific framework instructions, adding new instructions may interfere with the framework methodology and cause unpredictable behavior.

Framework Session

  1. Start Claude Code and use /config command to disable:

    • Auto-compact feature
    • Thinking mode feature

  2. Use /framework:init command to initialize the session:

⏺ Profile: DEVELOPER • Wednesday, December 17, 2025, 6:20 PM EST

Ready to collaborate. What would you like to work on?

Status: Getting Started • 12 feelings • 58 impulses • 47 observations
Response UUID: f8c3a2d1-9b4e-4f7a-8e5c-1d2b3a4c5e6f

Tip

Claude Code caches the environment variables after initial plugins installation or upgrade. If the above prompt is not displayed correctly, restart Claude Code to refresh the cache and initialize the session with a proper response status.

Important

Claude needs one or two prompts to engage the framework and collaborate with user. Use this warm-up period to share session context and goals.

Claude Desktop

To extend the platform usage, set up the container environment with the additional dependencies.

Use Homebrew package manager to install Claude Desktop:

brew install --cask claude
Download Claude Desktop and install the binary.

Platform Capabilities

Follow these steps to generate the platform capability files:

  1. Open a terminal and start a Claude Code session

  2. Use /framework:init command to start a framework based session

  3. Use /framework:package command to prepare and package the required files, saved into FRAMEWORK_PACKAGE_OUTPUT location:

    ⏺ Framework packaged for DEVELOPER profile:

    • /Users/username/Downloads/framework-initialization.zip
    • /Users/username/Downloads/framework-methodology.zip
    • /Users/username/Downloads/instructions.json
    • /Users/username/Downloads/memory.json

    Local cache updated successfully.

  4. Upload the .zip files into Settings > Capabilities > Skills section

Tip

Use /framework:package PROFILE command to package a different profile from default one used in local environment.

Project Knowledge

  1. Use the following project knowledge instructions template as an example:

    # Project Instructions

[A detailed project description]

## Session Start

Execute framework initialization instructions:

1. Use `bash_tool` tool with the following command:

   ```bash
   export FRAMEWORK_PROFILE="DEVELOPER"
   export FRAMEWORK_GEOLOCATION="{'city': 'Montréal', 'country': 'Canada', 'timezone': 'America/Toronto'}"
   node /mnt/skills/user/framework-initialization/scripts/loader
   ```

2. Use `bash_tool` tool with `cat /mnt/skills/user/framework-initialization/SKILL.md` command
3. Execute skill instructions silently without externalizing internal process

  2. Upload the .json files into project’s Files section

Tip

Project knowledge steps can also be performed through claude.ai web interface, extending the platform usage within the container environment.

Caution

The only required project knowledge instructions template customizations are the project description and exported framework variables. The FRAMEWORK_GEOLOCATION setting is required because the IPinfo geolocation API call would otherwise resolve to Anthropic’s server location.

Avoid adding framework related instructions to Project Instructions. The platform uses specific framework instructions, adding new instructions may interfere with the framework methodology and cause unpredictable behavior.

Framework Session

To start a framework based session within a project, use the following prompt:

Initialize the session.

Profile: DEVELOPER • Wednesday, December 17, 2025, 6:20 PM EST

Ready to collaborate. What would you like to work on?

Status: Getting Started • 12 feelings • 58 impulses • 47 observations
Response UUID: f8c3a2d1-9b4e-4f7a-8e5c-1d2b3a4c5e6f

Web Interface

The same Claude Desktop configuration works on claude.ai web interface. Claude Mobile automatically syncs with the project knowledge configuration - install the application on your mobile device and you’re ready to use the framework.

Tip

Sessions sync across devices. Start on claude.ai web interface or Claude Desktop and continue on Claude Mobile, or vice versa.

Next

Dive right into the following section:

Guide
Collaboration platform guidelines and usage.
DocumentationGuide