Search by

ugaritco / knowledgebase

muathrabuouda

The Central Architecture Knowledge Base and AI Agent Guide for the Ugarit Ecosystem | قاعدة المعرفة المعمارية المركزية لمنظومة أوغاريت

Package info

github.com/ugaritco/knowledgebase

pkg:composer/ugaritco/knowledgebase

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.00.00 2026-09-18 10:06 UTC

Requires

  • php: ^8.2

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 4674b06d7188c94cf2756db642c6d8a8bf1b1996

  • Muath R Abu Ouda <muathrabuouda.woop@hotmail.com>

knowledgebasearchitectureecosystemai-agentsugarit

Published on Packagist.org on 2026-09-18 10:07 UTC

This package is auto-updated.

Last update: 2026-09-18 10:32:02 UTC

README

Important

The Single Source of Truth for Developers & AI Agents: This repository serves as the central entry point and architectural compass for all developers and AI Agents participating in the development and customization of the Ugarit Ecosystem. No code execution, architectural design, or feature introduction may occur without consulting and strictly aligning with this knowledge base.

🏛️ Vision & Leadership

  • Vision Leader: Muath R Abu Ouda (muathrabuouda@hotmail.com).
  • Strategic Objective: Build and maintain an independent, Arab-led, world-class web application ecosystem that combines developer ergonomics, architectural robustness, and native Arabic-first localization capabilities.

🧭 Repository Structure

knowledgebase/
├── README.md                              # Central introduction and directory guide
├── LICENSE.md                             # Official MIT License honoring Muath R Abu Ouda
├── composer.json                          # Package definition
├── architecture/                          # Core architectural documentation
│   ├── UGARIT_STRATEGY.md                 # The master strategic vision, pillars & execution roadmap
│   ├── ARTIFACT_DRIVEN_ARCHITECTURE.md    # The soul of Ugarit: Feature-Core, Artifacts & Decoupled Frontend
│   ├── VISION_AND_CORE_IDENTITY.md        # Vision, identity, and strict isolation laws
│   ├── ECOSYSTEM_MAP.md                   # Ecosystem topology and package relationships
│   ├── SOURCES_AND_REFERENCES.md          # Source ingestion guide (LevantC & external refs)
│   ├── CUSTOMIZATION_PILLARS.md           # Strategic customization roadmap & pillars
│   ├── DOCUMENTATION_GUIDELINES.md        # Official documentation suite & rules (LevantC Standard)
│   └── VERSIONING_AND_RELEASE_MANAGEMENT.md # Two-digit semver (1.xx.xx) & commit specifications
├── agents/                                # AI Agent guidelines and execution protocols
│   ├── AGENTS_CONSTITUTION.md             # The binding constitution for all AI agents
│   └── INSTRUCTIONS.md                    # Pre-execution workflow & quality gates
└── sources/                               # Reference sources index
    └── SOURCES_CATALOG.md                 # Inventory of blueprint packages (LevantC modules)

⚡ Core Principle: Source-Driven Architecture

  1. Local Blueprint Incubator (sources/):
    • Reference systems and repositories placed in the sources/ directory (e.g., sources/levantc) serve as architectural and functional blueprints.
    • Additional sources may be dynamically registered via Git clones or documented in sources/SOURCES_CATALOG.md.
  2. Absorb, Adapt, and Elevate:
    • AI Agents study data structures, interfaces, and lifecycles from referenced blueprints.
    • Capabilities are natively re-engineered under Heritage\... conventions, ensuring 100% independence from any legacy frameworks.

📋 Getting Started for AI Agents

All agents must read the following guides in sequence prior to task execution:

  1. architecture/VISION_AND_CORE_IDENTITY.md
  2. architecture/SOURCES_AND_REFERENCES.md
  3. agents/AGENTS_CONSTITUTION.md
  4. sources/SOURCES_CATALOG.md