Instances Directory - Project Configurations

Documents a per-project configuration system that controls brand voice, skills, workflows, and evaluation settings for Agentic Creator OS.

frankxai

May 2, 2026

0 downloads

0 views

ai agent rag eval mcp claude gemini workflow

View source

What this file does

Documents a per-project configuration system that controls brand voice, skills, workflows, and evaluation settings for Agentic Creator OS.

When to use it

Setting up a new project with custom brand voice and tone
Adding a project instance to an existing Agentic Creator OS setup
Understanding how the system selects and loads project configurations
Defining evaluation rules and enabled skills per project

Assumes this stack

TypeScriptJSON

<claude-mem-context> # Instances Directory - Project Configurations

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

Copy template:

cp -r instances/_template instances/my-project

Edit config.json:
- Change name, slug
- Set brand voice
- Enable/disable skills
- Configure workflows
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:

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

Brand Voice Configuration

Setting	Description	Options
`tone`	Overall voice	professional, casual, authoritative, friendly, provocative
`personality`	Traits	innovative, helpful, reliable, cutting-edge, etc.
`keywords`	Approved terms	["AI", "automation", "workflow"]
`avoidKeywords`	Terms to avoid	["spammy", "clickbait"]

For AI Agents

When working with instances:

Check the instance - Know which project you're working on
Respect brand voice - Match the configured tone
Use enabled skills - Don't use disabled skills
Follow evaluation rules - Strict mode = higher standards
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

Directory	Purpose
`skills/`	Skills customized by instance
`workflows/`	Workflows customized by instance
`templates/`	Templates customized by instance
`mcp-servers/`	Tools customized by instance

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

What's inside

5 sections, 3 instance examples, 1 JSON schema, 1 directory tree, 1 TypeScript code snippet

Change this for your project

Replace frankx with your own project slug in the directory structure
Replace FrankX with your brand name in the brand name field
Replace #123456, #654321, #abcdef with your brand colors

Where it goes

Save as CLAUDE.md in your repository root. Claude Code reads it automatically at the start of every session.

Worth borrowing

Template-based instance creation with a _template directory and copy command
Explicit brand voice configuration with tone, personality, keywords, and avoidKeywords
Instance selection logic based on directory name, manual override, or fallback