Architecture

STACC organizes agent behavior, rules, hooks, and install targets into a predictable configuration pipeline for local and global coding environments.

STACC is split between the Rust control plane and the checked-in configuration payload.

#01

Config Surface

STACC ships rules, commands, skills, agents, hooks, stacks, and MCP configuration as source-controlled assets under configs/.

treesource

configs/
  rules/
  commands/
  skills/
  agents/
  hooks/
  stacks/
  mcps/

#02

Install Planner

The Rust CLI builds an install plan before writing files. Planning keeps dry runs, conflict detection, backups, and selective installs aligned across supported editors.

dry runinspect

cargo run -- install \
  --editor codex \
  --scope global \
  --category rules \
  --dry-run \
  --print-plan

#03

Merge Boundaries

MCP files are merged by target format: JSON targets use recursive object merge, Codex targets use TOML tables, and AMP settings are wrapped under amp.mcpServers.