agentic-creator-os / instances

This directory contains project-specific configurations that customize Agentic Creator OS behavior.

What Are Instances?

Instances define how Agentic Creator OS behaves for different projects:

• Brand voice and tone
• Enabled skills and workflows
• Evaluation settings
• Integration preferences

Directory Structure

instances/
├── CLAUDE.md              ← YOU ARE HERE
├── _template/             ← Template for new projects
│   ├── config.json        ← Template configuration
│   └── config.ts          ← Config utilities
├── frankx/                ← FrankX project
│   └── config.json        ← FrankX configuration
└── demo-project/          ← Demo project
    └── config.json        ← Demo configuration

Instance Configuration

Each instance has a config.json with:

{
  "name": "Project Name",
  "slug": "project-slug",
  "version": "1.0.0",
  "brand": {
    "name": "Brand Name",
    "voice": {
      "tone": "professional",
      "personality": ["trait1", "trait2"],
      "keywords": ["word1", "word2"],
      "avoidKeywords": ["word3"]
    },
    "colors": {
      "primary": "#123456",
      "secondary": "#654321",
      "accent": "#abcdef"
    }
  },
  "directories": {
    "workflows": "workflows",
    "templates": "templates",
    "skills": "skills",
    "mcpServers": "mcp-servers"
  },
  "integrations": {
    "opencode": true,
    "claudeCode": true,
    "gemini": false
  },
  "skills": {
    "enabled": ["content", "marketing"],
    "custom": []
  },
  "workflows": {
    "enabled": ["social-media", "content"],
    "custom": []
  },
  "evaluation": {
    "enabled": true,
    "strictMode": false,
    "benchmarkAgainst": "industry-average"
  }
}

Available Instances

frankx

Purpose: FrankX brand content

Settings:

• Tone: Provocative, visionary
• Brand: FrankX
• Skills: All enabled
• Evaluation: Strict mode, benchmark against top performers

Use for: Creating FrankX-branded content

demo-project

Purpose: Demo and testing

Settings:

• Tone: Friendly, educational
• Brand: Demo Brand
• Skills: content, marketing only
• Evaluation: Standard mode

Use for: Testing workflows, learning the system

_template

Purpose: Template for new projects

Use for: Creating new project instances

How to use:

cp -r instances/_template instances/my-new-project
# Edit instances/my-new-project/config.json

Creating a New Instance

1. Copy template:

   cp -r instances/_template instances/my-project

2. Edit config.json:
   • Change name, slug
   • Set brand voice
   • Enable/disable skills
   • Configure workflows
3. Use the instance: The system will automatically detect which instance to use based on your project.

Instance Selection

The system selects an instance based on:

1. Project directory name - Matches instance slug
2. Manual override - Specify in configuration
3. Default instance - Falls back to frankx

Brand Voice Configuration

For AI Agents

When working with instances:

1. Check the instance - Know which project you're working on
2. Respect brand voice - Match the configured tone
3. Use enabled skills - Don't use disabled skills
4. Follow evaluation rules - Strict mode = higher standards
5. Know the keywords - Use approved terminology

Loading Instances

import { getInstanceConfig, listInstances } from './instances/_template/config.ts';

// List all instances
const instances = await listInstances();
// Returns: [{ name, description, path }]

// Load specific instance
const config = await getInstanceConfig('frankx');
// Returns: ProjectConfig object

Related Directories

Instances personalize Agentic Creator OS for each project. Know your instance, respect its rules. </claude-mem-context>