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 Enable markdown file explosion for large documents
Project installation metadata Project type: EXISTING_AIOX, NEW_AIOX, GREENFIELD
ISO 8601 timestamp of installation Example: 2025-01-14T00:00:00Z
AIOX framework version Example: 2.1.0
User experience level: beginner, intermediate, advanced Affects agent verbosity and guidance level.
Documentation Configuration Quality assurance documentation settings Directory for QA reports and artifacts
Product Requirements Document configuration prdFile
string
default: "docs/prd.md"
Primary PRD file path
Enable PRD sharding for large documents
epicFilePattern
string
default: "epic-{n}*.md"
Pattern for epic file naming
Architecture documentation settings architectureFile
string
default: "docs/architecture.md"
Primary architecture document
Architecture document version
Enable architecture sharding
architectureShardedLocation
string
default: "docs/architecture"
Directory for architecture shards
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
Script directories by category 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 integration settings Active IDE integrations selected : - vscode - codex - gemini - cursor - claude-code
Per-IDE feature flags configs : vscode : true codex : true cursor : true claude-code : true zed : false
MCP Configuration Model Context Protocol settings configLocation
string
default: ".claude/mcp.json"
MCP configuration file location
Docker-based MCP gateway configuration Show docker_mcp properties
Enable Docker MCP gateway
Gateway transport settings gateway : transport : http url : http://localhost:8080/mcp port : 8080 watch : true service_file : .docker/mcp/gateway-service.yml
Default server preset: minimal or full
MCP server definitions Each server includes:
name - Server identifierdescription - Purposeconfig - Server-specific settingsrequired - Whether server is mandatoryapi_key_required - Whether API key needed Lazy loading configuration for performance optimization Sections to lazy load heavySections : - pvMindContext - squads - registry
Git integration settings Show git configuration warnings
Git status cache duration (seconds)
Logging & Status Architecture Decision Record (ADR) logging indexFile
string
default: "decision-logs-index.md"
Index file name
Log format: adr, json, yaml
Project status tracking configuration Enable project status tracking
autoLoadOnAgentActivation
Load status automatically when agent activates
Display status in agent greeting
Status components to display components : gitBranch : true gitStatus : true recentWork : true currentEpic : true currentStory : true
Integrations Boundary Protection Framework-Project separation controls (Epic BM) 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.
L1/L2 paths blocked from editing protected : - .aiox-core/core/** - .aiox-core/development/tasks/** - .aiox-core/development/templates/** - .aiox-core/infrastructure/** - bin/aiox.js
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:
Framework defaults → framework-config.yamlProject settings → project-config.yamlPersonal preferences → local-config.yaml
See Configuration Files Overview for migration guidance.
Reference: .aiox-core/core-config.yaml 