repo-understanding-repository-architecturelisted

# Repository Architecture - Six-Layer Hierarchy This Skill provides guidance on the six-layer architecture governing the open-sharia-enterprise repository. Each layer builds on the foundation above, creating complete traceability from vision to workflows. ## Purpose Use this Skill when: - Understanding repository governance structure - Tracing rules back to foundational values - Explaining architectural decisions - Navigating layer relationships - Creating new conventions or practices - Understanding where Skills fit in the architecture ## The Six Layers ``` Layer 0: Vision WHY WE EXIST (foundational purpose) Layer 1: Principles WHY - Values (governs L2, L3) Layer 2: Conventions WHAT - Doc Rules (governs L3, L4) Layer 3: Development HOW - Practices (governs L4) Layer 4: AI Agents WHO - Executors (atomic tasks) Layer 5: Workflows WHEN - Orchestrate (multi-step processes) ``` **Key relationships:** - Vision inspires Principles - Principles govern Conventions and Development - Conventions govern Development and Agents - Development governs Agents - Workflows orchestrate Agents ## Quick Layer Reference | Layer | Location | Purpose | Changes? | Answers? | | ----- | ---------------------------- | ----------------------------- | --------------- | ------------------------- | | **0** | repo-governance/vision/ | WHY we exist | Extremely rare | Why does