core-config.yaml

Complete schema reference for AIOX core configuration file

Overview

core-config.yaml is the legacy unified configuration file that contains all AIOX settings in a single location. Located at .aiox-core/core-config.yaml, it manages project metadata, documentation paths, integrations, and operational settings.

This file is being gradually migrated to the three-tier configuration system (framework-config.yaml, project-config.yaml, local-config.yaml). New projects should prefer the modular approach.

Schema Reference

Project Metadata

markdownExploder · boolean · default: "true"

Enable markdown file explosion for large documents

project · object · required

Project installation metadata

Show properties

type · string · required

Project type: EXISTING_AIOX, NEW_AIOX, GREENFIELD

installedAt · string · required

ISO 8601 timestamp of installation

Example: 2025-01-14T00:00:00Z

version · string · required

AIOX framework version

Example: 2.1.0

user_profile · string · default: "advanced"

User experience level: beginner, intermediate, advanced

Affects agent verbosity and guidance level.

Documentation Configuration

qa · object

Quality assurance documentation settings

Show properties

qaLocation · string · default: "docs/qa"

Directory for QA reports and artifacts

prd · object

Product Requirements Document configuration

Show properties

prdFile · string · default: "docs/prd.md"

Primary PRD file path

prdVersion · string · default: "v4"

PRD template version

prdSharded · boolean · default: "true"

Enable PRD sharding for large documents

prdShardedLocation · string · default: "docs/prd"

Directory for PRD shards

epicFilePattern · string · default: "epic-{n}*.md"

Pattern for epic file naming

architecture · object

Architecture documentation settings

Show properties

architectureFile · string · default: "docs/architecture.md"

Primary architecture document

architectureVersion · string · default: "v4"

Architecture document version

architectureSharded · boolean · default: "true"

Enable architecture sharding

architectureShardedLocation · string · default: "docs/architecture"

Directory for architecture shards

devLoadAlwaysFiles · array

Files loaded by dev agent on every activation

devLoadAlwaysFiles:
  - docs/framework/coding-standards.md
  - docs/framework/tech-stack.md
  - docs/framework/source-tree.md

devStoryLocation · string · default: "docs/stories"

Directory for user stories

Resource Locations

toolsLocation · string · default: ".aiox-core/tools"

Directory for AIOX utility tools

scriptsLocation · object

Script directories by category

Show properties

core · string · default: ".aiox-core/core"

Core framework scripts

development · string · default: ".aiox-core/development/scripts"

Development scripts

infrastructure · string · default: ".aiox-core/infrastructure/scripts"

Infrastructure scripts

legacy · string · default: ".aiox-core/scripts"

Legacy scripts (deprecated)

dataLocation · string · default: ".aiox-core/data"

Directory for framework data files (registries, patterns, schemas)

elicitationLocation · string · default: ".aiox-core/elicitation"

Directory for elicitation templates and workflows

IDE Configuration

ide · object

IDE integration settings

Show properties

selected · array

Active IDE integrations

selected:
  - vscode
  - codex
  - gemini
  - cursor
  - claude-code

configs · object

Per-IDE feature flags

configs:
  vscode: true
  codex: true
  cursor: true
  claude-code: true
  zed: false

MCP Configuration

mcp · object

Model Context Protocol settings

Show properties

enabled · boolean · default: "true"

Enable MCP integration

configLocation · string · default: ".claude/mcp.json"

MCP configuration file location

docker_mcp · object

Docker-based MCP gateway configuration

Show docker_mcp properties

enabled · boolean · default: "true"

Enable Docker MCP gateway

gateway · object

Gateway transport settings

gateway:
  transport: http
  url: http://localhost:8080/mcp
  port: 8080
  watch: true
  service_file: .docker/mcp/gateway-service.yml

defaultPreset · string · default: "minimal"

Default server preset: minimal or full

defaultServers · array

MCP server definitions

Each server includes:

• name - Server identifier
• description - Purpose
• config - Server-specific settings
• required - Whether server is mandatory
• api_key_required - Whether API key needed

Performance Settings

lazyLoading · object

Lazy loading configuration for performance optimization

Show properties

enabled · boolean · default: "true"

Enable lazy loading

heavySections · array

Sections to lazy load

heavySections:
  - pvMindContext
  - squads
  - registry

git · object

Git integration settings

Show properties

showConfigWarning · boolean · default: "true"

Show git configuration warnings

cacheTimeSeconds · number · default: "300"

Git status cache duration (seconds)

Logging & Status

decisionLogging · object

Architecture Decision Record (ADR) logging

Show properties

enabled · boolean · default: "true"

Enable decision logging

async · boolean · default: "true"

Asynchronous logging

location · string · default: ".ai/"

Decision log directory

indexFile · string · default: "decision-logs-index.md"

Index file name

format · string · default: "adr"

Log format: adr, json, yaml

projectStatus · object

Project status tracking configuration

Show properties

enabled · boolean · default: "true"

Enable project status tracking

autoLoadOnAgentActivation · boolean · default: "true"

Load status automatically when agent activates

showInGreeting · boolean · default: "true"

Display status in agent greeting

cacheTimeSeconds · number · default: "60"

Status cache duration

components · object

Status components to display

components:
  gitBranch: true
  gitStatus: true
  recentWork: true
  currentEpic: true
  currentStory: true

Integrations

github · object

GitHub integration settings

See Project Config - GitHub for complete schema.

coderabbit_integration · object

CodeRabbit AI code review integration

See Project Config - CodeRabbit for complete schema.

Boundary Protection

boundary · object

Framework-Project separation controls (Epic BM)

Show properties

frameworkProtection · boolean · default: "true"

Enable framework file protection via deny rules

When true, Claude Code deny rules block Edit/Write on L1/L2 paths. Set to false for framework contributors.

protected · array

L1/L2 paths blocked from editing

protected:
  - .aiox-core/core/**
  - .aiox-core/development/tasks/**
  - .aiox-core/development/templates/**
  - .aiox-core/infrastructure/**
  - bin/aiox.js

exceptions · array

L3 paths allowed within .aiox-core/

exceptions:
  - .aiox-core/data/**
  - .aiox-core/development/agents/*/MEMORY.md

Example Configuration

markdownExploder: true

project:
  type: EXISTING_AIOX
  installedAt: '2025-01-14T00:00:00Z'
  version: 2.1.0

user_profile: advanced

qa:
  qaLocation: docs/qa

prd:
  prdFile: docs/prd.md
  prdVersion: v4
  prdSharded: true
  prdShardedLocation: docs/prd

architecture:
  architectureFile: docs/architecture.md
  architectureSharded: true
  architectureShardedLocation: docs/architecture

devLoadAlwaysFiles:
  - docs/framework/coding-standards.md
  - docs/framework/tech-stack.md

lazyLoading:
  enabled: true
  heavySections:
    - pvMindContext
    - squads

git:
  showConfigWarning: true
  cacheTimeSeconds: 300

boundary:
  frameworkProtection: true
  protected:
    - .aiox-core/core/**
    - .aiox-core/infrastructure/**

Migration Path

To migrate from core-config.yaml to the three-tier system:

1. Framework defaults → framework-config.yaml
2. Project settings → project-config.yaml
3. Personal preferences → local-config.yaml

See Configuration Files Overview for migration guidance.

Related Documentation

• Configuration Files Overview
• Project Config Schema
• Framework Config Schema

---

Reference: .aiox-core/core-config.yaml