Skip to main content

WGS Schema Reference

WGS ships one schema at its root, STANDARD.manifest.schema.toml, plus the fully populated WGS.manifest.toml suite manifest. The manifest schema shape mirrors the SFDS-defined STANDARD.manifest.schema.toml contract, with slightly different required-field emphasis.

STANDARD.manifest.schema.toml​

title = "Workspace Governance Standard Manifest Schema"
type = "object"
required = ["standard", "governance", "artifacts", "lifecycle"]

[properties.standard]
required = ["id", "title", "abbreviation", "status", "maturity", "version"]

[properties.governance]
required = ["meta_standard", "workspace_standard", "scope"]

[properties.artifacts]
required = ["specification", "templates", "adoption_guide", "validation_checklist", "changelog"]

Field groups​

  • [properties.standard] — WGS's own identity: id = "wgs", title, abbreviation, status, maturity, and version. Same shape as every other City Hall standard.
  • [properties.governance] — requires both meta_standard (always SFDS, since SFDS governs how WGS itself is shaped) and workspace_standard (always WGS, since WGS is also the workspace standard it describes), plus scope. This dual requirement is unique to WGS's schema — it is both a standard and the workspace standard.
  • [properties.artifacts] — requires templates in addition to the baseline specification, adoption_guide, validation_checklist, and changelog, because WGS's entire adopter surface (AGENTS.*.md, *.manifest.toml templates) is templates-driven.

WGS.manifest.toml (filled suite manifest)​

[standard]
id = "wgs"
title = "Workspace Governance Standard"
abbreviation = "WGS"
status = "active"
maturity = "candidate"
version = "0.2.7"
description = "Governs the Aptlantis workspace structure, manifests, project registration, lifecycle visibility, services, standards hierarchy, responsibility boundaries, agent orientation, and workspace health."

[governance]
meta_standard = "SFDS"
workspace_standard = "WGS"
scope = "Workspace roots, manifests, standards relationships, project classes, lifecycle states, shared services, metadata records, agent startup, and workspace health."
non_goals = ["Application release procedure", "CLI command behavior", "website deployment details", "dataset licensing policy"]

[artifacts]
specification = "Workspace Governance Standard.md"
schema = "STANDARD.manifest.schema.toml"
templates = "templates"
examples = "examples"
adoption_guide = "Adoption-Guide.md"
validation_checklist = "Validation-Checklist.md"
changelog = "CHANGELOG.md"
validators = [
  "tools/city_hall_audit.py",
  "tools/workspace_inventory.py",
  "tools/governance_scaffold.py",
  "tools/normalize_entity_manifests.py",
  "tools/snapshot_root_governance.py"
]
governance_notes = [
  "Manifest-Conventions.md",
  "Agent-Startup-Procedure.md",
  "Documentation-Suite-Roadmap.md",
  "Governance-Responsibility-Matrix.md"
]
reference_examples = [
  "examples/WGS-Suite-Map.md",
  "examples/City-Hall-Health-Record.md",
  "examples/City-Hall-Audit-2026-06-11.md",
  "examples/Workspace-Governance-Audit-2026-07-07.md",
  "examples/Workspace-Governance-Audit-2026-07-08.md"
]

[adopter_artifacts]
schemas = ["STANDARD.manifest.schema.toml"]
manifest_templates = [
  "templates/Development.manifest.toml",
  "templates/DirectoryName.manifest.toml",
  "templates/ProjectName.manifest.toml",
  "templates/StandardName.manifest.toml"
]
document_templates = [
  "templates/AGENTS.root.md",
  "templates/AGENTS.directory.md",
  "templates/AGENTS.project.md",
  "templates/Project-README.md",
  "templates/Workspace-Health-Record.md"
]

[lifecycle]
created = "2026-06-10"
last_updated = "2026-07-08"
maintainer = "Herb"

[agent]
read_first = ["README.md", "Workspace Governance Standard.md", "Manifest-Conventions.md", "Agent-Startup-Procedure.md"]
notes = "WGS is the architectural constitution for the drive. Use SFDS for standard-suite shape and WGS for workspace placement, registration, lifecycle visibility, metadata records, services, and agent orientation."

Field groups​

  • [standard] — WGS's own suite identity: candidate maturity, version 0.2.7, and a one-line description of everything it governs.
  • [governance] — names SFDS as meta-standard and itself as workspace standard, states scope in one sentence, and lists explicit non_goals so readers know release procedure, CLI behavior, website deployment, and dataset licensing are handled elsewhere.
  • [artifacts] — the fullest artifact declaration in City Hall: specification, schema, templates, examples, the three baseline SFDS docs, five validator scripts (all documented on the Tools page), four governance notes (each a standalone WGS page), and five reference examples (all under Examples).
  • [adopter_artifacts] — separates the schema, the four manifest templates, and the five document templates that adopters actually copy — see Templates.
  • [lifecycle] — created 2026-06-10, last updated 2026-07-08, maintained by Herb.
  • [agent] — the WGS-specific read-first order: README, the primary spec, manifest conventions, then the agent startup procedure.