Architecture Overview
This document is a short map of the architecture. Use it to decide which detailed doc to open next.
When to read
- •You need a quick map of runtime, modular system, skills, and hooks.
- •You want to choose the right deep-dive doc without loading everything.
Core principles (summary)
- •AI systems are the primary code implementers.
- •Humans review, provide constraints, and approve sensitive actions.
- •All side effects run through abilities via the Tool Runner.
- •Module Runner automation is exposed as abilities and invoked through the Tool Runner.
Quick map
- •Runtime model and event timeline: /.system/skills/ssot/repo/architecture-core-mechanisms/runtime-model/SKILL.md
- •Modular system structure and generated registries: /.system/skills/ssot/repo/architecture-core-mechanisms/modular-system/SKILL.md
- •Ability workflow (plan -> create -> run): /.system/skills/ssot/repo/architecture-core-mechanisms/ability-workflow/SKILL.md
- •Skill discovery overview: /.system/skills/ssot/repo/skill-developer/skills-overview/SKILL.md
- •Hook lifecycle and ordering: /.system/skills/ssot/repo/architecture-core-mechanisms/hook-lifecycle/SKILL.md
- •Document roles and conventions: /.system/skills/ssot/repo/documentation-conventions/documentation/conventions/overview.md
- •Module template and registration flow: /.system/skills/ssot/repo/scaffolding/new-module/template/registration_flow.md
- •Glossary and pitfalls: /.system/skills/ssot/repo/architecture-core-mechanisms/architecture-glossary/SKILL.md, /.system/skills/ssot/repo/architecture-core-mechanisms/architecture-pitfalls/SKILL.md
- •DevOps knowledge entrypoints: /.system/skills/ssot/repo/scaffolding/devops-packaging-job/templates/packaging_template.md, /.system/skills/ssot/repo/scaffolding/devops-deploy-job/templates/deploy_template.md
Event timeline (summary)
PromptSubmit -> [AI plans] -> PreAbilityCreate -> PreAbilityCall -> PostAbilityCall -> SessionStop
Related Documents
- •/AGENTS.md
- •/.system/guides/ARCHITECTURE_OVERVIEW.md
- •/.system/skills/ssot/repo/architecture-core-mechanisms/knowledge-metadata/SKILL.md
- •/.system/skills/ssot/repo/architecture-core-mechanisms/runtime-model/SKILL.md
- •/.system/skills/ssot/repo/architecture-core-mechanisms/modular-system/SKILL.md
- •/.system/skills/ssot/repo/architecture-core-mechanisms/hook-lifecycle/SKILL.md
- •/.system/skills/ssot/repo/architecture-core-mechanisms/ability-workflow/SKILL.md