aios-core
Version:
Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework
389 lines (387 loc) • 11 kB
YAML
markdownExploder: true
project:
type: EXISTING_AIOS
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
epicFilePattern: epic-{n}*.md
architecture:
architectureFile: docs/architecture.md
architectureVersion: v4
architectureSharded: true
architectureShardedLocation: docs/architecture
customTechnicalDocuments: null
devLoadAlwaysFiles:
- docs/framework/coding-standards.md
- docs/framework/tech-stack.md
- docs/framework/source-tree.md
devLoadAlwaysFilesFallback:
- docs/pt/framework/coding-standards.md
- docs/pt/framework/tech-stack.md
- docs/pt/framework/source-tree.md
- docs/es/framework/coding-standards.md
- docs/es/framework/tech-stack.md
- docs/es/framework/source-tree.md
devDebugLog: .ai/debug-log.md
devStoryLocation: docs/stories
slashPrefix: AIOS
toolsLocation: .aios-core/tools
scriptsLocation:
core: .aios-core/core
development: .aios-core/development/scripts
infrastructure: .aios-core/infrastructure/scripts
legacy: .aios-core/scripts
dataLocation: .aios-core/data
elicitationLocation: .aios-core/elicitation
squadsTemplateLocation: templates/squad
mindsLocation: outputs/minds
ide:
selected:
- vscode
- codex
- gemini
- cursor
- claude-code
configs:
vscode: true
codex: true
gemini: true
cursor: true
zed: false
claude-desktop: false
claude-code: true
mcp:
enabled: true
configLocation: .claude/mcp.json
docker_mcp:
enabled: true
gateway:
transport: http
url: http://localhost:8080/mcp
port: 8080
watch: true
service_file: .docker/mcp/gateway-service.yml
presets:
minimal:
servers:
- context7
- desktop-commander
- playwright
description: Core MCPs - no API keys required
api_keys_required: false
estimated_tokens: 10-15k
full:
servers:
- context7
- desktop-commander
- playwright
- exa
description: All MCPs - requires EXA_API_KEY for exa
api_keys_required: true
estimated_tokens: 20-25k
defaultPreset: minimal
defaultServers:
- name: context7
description: Up-to-date library documentation for LLMs
config: {}
required: true
api_key_required: false
- name: desktop-commander
description: File management, terminal commands, and system operations
config:
paths:
- ${USER_HOME}
required: true
api_key_required: false
- name: playwright
description: Browser automation for testing and web interaction
config: {}
required: true
api_key_required: false
- name: exa
description: AI-powered web search and content extraction
config:
apiKeys:
EXA_API_KEY: ${EXA_API_KEY}
required: false
api_key_required: true
commands:
start_gateway: docker compose -f .docker/mcp/gateway-service.yml up -d
stop_gateway: docker compose -f .docker/mcp/gateway-service.yml down
gateway_health: curl http://localhost:8080/health
list_servers: docker mcp server ls
enable_server: docker mcp server enable {name}
disable_server: docker mcp server disable {name}
read_config: docker mcp config read
write_config: docker mcp config write
troubleshooting:
timeout_issue: |
If Claude Code shows "Failed to connect to docker-gateway":
1. Ensure gateway is running: docker compose -f .docker/mcp/gateway-service.yml up -d
2. Check health: curl http://localhost:8080/health
3. Verify ~/.claude.json uses HTTP transport, NOT stdio
gateway_not_starting: |
1. Check Docker Desktop is running
2. Check port 8080 is available: netstat -an | grep 8080
3. Try alternate port in gateway-service.yml
lazyLoading:
enabled: true
heavySections:
- pvMindContext
- squads
- registry
git:
showConfigWarning: true
cacheTimeSeconds: 300
decisionLogging:
enabled: true
async: true
location: .ai/
indexFile: decision-logs-index.md
format: adr
performance:
maxOverhead: 50
projectStatus:
enabled: true
autoLoadOnAgentActivation: true
showInGreeting: true
cacheTimeSeconds: 60
components:
gitBranch: true
gitStatus: true
recentWork: true
currentEpic: true
currentStory: true
statusFile: .aios/project-status.yaml
maxModifiedFiles: 5
maxRecentCommits: 2
synapse:
session:
staleTTLHours: 168 # 7 days — sessions older than this are cleaned up on first prompt
agentIdentity:
greeting:
preference: auto
contextDetection: true
sessionDetection: hybrid
workflowDetection: hardcoded
performance:
gitCheckCache: true
gitCheckTTL: 300
github:
enabled: true
cli_required: false
features:
pr_creation: true
issue_management: true
pr:
title_format: conventional
include_story_id: true
conventional_commits:
enabled: true
branch_type_map:
feature/: feat
feat/: feat
fix/: fix
bugfix/: fix
hotfix/: fix
docs/: docs
chore/: chore
refactor/: refactor
test/: test
perf/: perf
ci/: ci
style/: style
build/: build
default_type: feat
auto_assign_reviewers: false
draft_by_default: false
semantic_release:
enabled: true
coderabbit_integration:
enabled: true
installation_mode: wsl
wsl_config:
distribution: Ubuntu
installation_path: ~/.local/bin/coderabbit
working_directory: ${PROJECT_ROOT}
self_healing:
enabled: true
type: full
max_iterations: 3
timeout_minutes: 30
severity_handling:
CRITICAL: auto_fix
HIGH: auto_fix
MEDIUM: document_as_debt
LOW: ignore
graceful_degradation:
skip_if_not_installed: true
fallback_message: 'CodeRabbit CLI not found. Skipping automated review. Install via: pip install coderabbit-cli'
commands:
qa_pre_review_uncommitted: |
wsl bash -c 'cd ${PROJECT_ROOT} && ~/.local/bin/coderabbit --prompt-only -t uncommitted'
qa_story_review_committed: |
wsl bash -c 'cd ${PROJECT_ROOT} && ~/.local/bin/coderabbit --prompt-only -t committed --base main'
report_location: docs/qa/coderabbit-reports/
squads:
templateLocation: templates/squad
autoLoad: false
pvMindContext:
enabled: true
location: outputs/minds/pedro_valerio
features:
persona_voice: true
technical_depth: advanced
communication_style: structured
storyBacklog:
enabled: true
location: docs/stories/backlog
prioritization: value_risk
utils:
helpers:
- batch-creator
- capability-analyzer
- change-propagation-predictor
- clickup-helpers
- code-quality-improver
- compatibility-checker
- component-metadata
- component-preview
- conflict-manager
- coverage-analyzer
- dependency-analyzer
- diff-generator
- framework-analyzer
- git-wrapper
- manifest-preview
- migration-path-generator
- migration-tester
- modification-history
- modification-risk-assessment
- modification-validator
- performance-analyzer
- redundancy-analyzer
- refactoring-suggester
- sandbox-tester
- template-validator
- test-quality-assessment
- validate-filenames
- version-tracker
- visual-impact-generator
executors:
- approval-workflow
- branch-manager
- commit-message-generator
- component-generator
- component-search
- conflict-resolver
- deprecation-manager
- dependency-impact-analyzer
- documentation-synchronizer
- migration-generator
- migration-rollback
- modification-synchronizer
- performance-optimizer
- rollback-handler
- safe-removal-handler
- test-generator
- test-updater
framework:
- elicitation-engine
- elicitation-session-manager
- improvement-engine
- improvement-validator
- metrics-tracker
- pattern-learner
- template-engine
- test-template-system
- transaction-manager
- usage-analytics
- usage-tracker
ideSync:
enabled: true
source: .aios-core/development/agents
targets:
claude-code:
enabled: true
path: .claude/commands/AIOS/agents
format: full-markdown-yaml
codex:
enabled: true
path: .codex/agents
format: full-markdown-yaml
gemini:
enabled: true
path: .gemini/rules/AIOS/agents
format: full-markdown-yaml
github-copilot:
enabled: true
path: .github/agents
format: github-copilot
cursor:
enabled: true
path: .cursor/rules/agents
format: condensed-rules
antigravity:
enabled: true
path: .antigravity/rules/agents
format: cursor-style
redirects: {}
validation:
strictMode: true
failOnDrift: true
failOnOrphaned: false
autoClaude:
enabled: true
version: '3.0'
migratedAt: '2026-01-29T02:25:00Z'
worktree:
enabled: true
autoCreate: on_story_start
autoCleanup: manual
maxWorktrees: 10
staleDays: 30
branchPrefix: auto-claude/
specPipeline:
enabled: false
execution:
enabled: false
qa:
enabled: false
# Boundary Mapping — Framework-Project Separation (Epic BM)
# Controls deterministic protection of framework core files via Claude Code deny rules.
# When frameworkProtection is true (default), .claude/settings.json includes deny rules
# that block Edit/Write operations on L1/L2 paths listed in 'protected' below.
# Set to false for framework contributors who need to edit core files directly.
# NOTE: This flag is read by the installer during settings.json generation.
# Changing this value alone does NOT add/remove deny rules — re-run the installer.
# SINGLE SOURCE OF TRUTH: Both pre-commit hook (framework-guard.js) and
# the installer read protected/exceptions from here. Do NOT hardcode paths elsewhere.
boundary:
frameworkProtection: false # TEMPORARY: TOK-3 contributor mode — re-enable after story
# L1/L2 paths — blocked from editing in project mode
# Glob syntax: ** matches any depth, * matches single segment
protected:
- .aios-core/core/**
- .aios-core/development/tasks/**
- .aios-core/development/templates/**
- .aios-core/development/checklists/**
- .aios-core/development/workflows/**
- .aios-core/infrastructure/**
- .aios-core/constitution.md
- bin/aios.js
- bin/aios-init.js
# L3 paths — mutable exceptions (allowed even within .aios-core/)
exceptions:
- .aios-core/data/**
- .aios-core/development/agents/*/MEMORY.md
- .aios-core/core/config/schemas/**
- .aios-core/core/config/template-overrides.js
# Memory Intelligence System (Epic MIS) configuration placeholder — MIS-2+