Symfony-X Org Governance

This repository contains the default community health files and the canonical governance documents for the Symfony-X organization.

It is the constitutional repository for the organization, not an implementation repository.

Symfony-X is an independent community project built for Symfony applications.

Symfony-X is not affiliated with, endorsed by, sponsored by, or maintained by Symfony SAS or the Symfony project. Symfony is a trademark of Symfony SAS.

---

Purpose

This repository exists to define:

• the public organization profile
• contribution, security, and support defaults
• Symfony-X architectural doctrine
• repository planning and naming rules
• Symfony-X terminology
• the current AI/Mate development strategy
• the package-first composition model

---

Scope

This repository does not contain:

• application code
• bundle code
• Symfony Flex recipes
• runtime implementation details
• example applications

Those belong in the installable repositories they describe.

---

Canonical Documents

• ARCHITECTURE.md — top-level architectural doctrine
• TERMINOLOGY.md — stable vocabulary for Symfony-X
• REPOSITORY_PLAN.md — which repositories exist now, next, later, and not yet
• REPOSITORY_TAXONOMY.md — repo categories and lifecycle rules
• PACKAGE_NAMING.md — naming rules for repos, packages, bundles, and recipes
• AI_STRATEGY.md — Symfony-X AI/Mate development and runtime doctrine
• GOVERNANCE.md — organizational governance and decision model

---

Default Community Health Files

These files are intended to serve as organization-wide defaults where GitHub supports them:

• CODE_OF_CONDUCT.md
• CONTRIBUTING.md
• SECURITY.md
• SUPPORT.md
• PULL_REQUEST_TEMPLATE.md
• .github/ISSUE_TEMPLATE/*

---

Public Org Profile

The public organization profile is defined by:

• profile/README.md

The profile README is the primary public-facing explanation of Symfony-X.

It should preserve three ideas:

1. Symfony-X is built with respect for Symfony.
2. Symfony-X is independent and unofficial.
3. Symfony-X is package-first, Symfony-native, and AI-aware without being AI-led.

---

Current Direction

Symfony-X is being reset around a smaller, clearer foundation:

• one canonical skeleton
• package-first composition
• reusable Symfony bundles
• a separate recipes repository
• a maintainer workbench for validating package and recipe behavior
• a vendor-neutral AI/Mate extension for development-time assistance
• a UI bundle / SXUC baseline for modern Symfony UX
• runtime AI treated as a separate concern from development tooling

The short version:

Start by installing the capability that owns the concern.

The project should avoid copy-paste architecture, speculative package sprawl, and freeform AI-generated structure.

---

Current Roadmap

1. workbench
2. ai-mate-extension baseline
3. ui-bundle / SXUC baseline
4. dashboard-bundle first usable version
5. Hermes Agent sandbox experiment
6. recipe ownership metadata
7. richer Mate tools
8. optional mate-observer later

See REPOSITORY_PLAN.md and AI_STRATEGY.md for the current plan.

---

Related Research Space

• symfony-x — Symfony-focused datasets, model experiments, and research artifacts for improving AI-assisted Symfony development