Skip to main content

Entity Manifest Templates (v2.4)

WGS ships four [Entity].manifest.toml templates, one per governed-entity tier, all conforming to Aptlantis Entity Manifest schema v2.4 ([manifest] + [entity] + a domain table — see Manifest Conventions).

Development.manifest.toml — drive-root template

[manifest]
schema = "APTlantis Entity Manifest"
schema_version = "2.4"
manifest_type = "workspace"
canonical_name = "Development.manifest.toml"
last_updated = "YYYY-MM-DD"
maintainer = "Herb"

[entity]
id = "development-drive"
title = "Development Workspace"
kind = "workspace"
class = "workspace-root"
status = "active"
description = "Replace with the development workspace mission."
tags = ["development", "workspace"]

[workspace]
root = "D:\\"
primary_governance = "WGS"
city_hall = "D:\\.city_hall"
index = "D:\\INDEX.md"
instructions = "D:\\AGENTS.md"

[policy]
requires_directory_manifests = true
requires_project_manifests = true
requires_project_readmes = true
requires_agent_instructions = true
canonical_directory_manifest = "[DirectoryName].manifest.toml"
canonical_project_manifest = "[ProjectName].manifest.toml"
preserve_legacy_manifests_with_migration_notes = true
manual_review_required_for_moves = true
copy_canonical_standards_into_projects = false

[standards]
wgs = "D:\\.city_hall\\WGS"
sfds = "D:\\.city_hall\\SFDS"
pps = "D:\\.city_hall\\PPS"
drs = "D:\\.city_hall\\DRS"
cts = "D:\\.city_hall\\CTS"
wds = "D:\\.city_hall\\WDS"
dds = "D:\\.city_hall\\DDS"
sis = "D:\\.city_hall\\SIS"

[[roots]]
id = "example-portfolio"
path = "D:\\EXAMPLE"
kind = "portfolio"
role = "Replace with the governed root role."
governing_standard = "WGS"
manifest = "D:\\EXAMPLE\\EXAMPLE.manifest.toml"

[agent]
read_first = ["D:\\AGENTS.md", "D:\\INDEX.md", "D:\\.city_hall\\WGS\\Agent-Startup-Procedure.md"]
authoritative_docs = ["D:\\Development.manifest.toml", "D:\\AGENTS.md"]
known_gaps = ["Replace example root and all placeholder values before adoption."]
notes = "Template only until all placeholders are replaced."

A filled, live version of this template is reproduced in the Workspace Root Snapshot.

DirectoryName.manifest.toml — governed-directory template

[manifest]
schema = "APTlantis Entity Manifest"
schema_version = "2.4"
manifest_type = "directory"
canonical_name = "DirectoryName.manifest.toml"
last_updated = "YYYY-MM-DD"
maintainer = "Herb"

[entity]
id = "directory-name"
title = "Directory Name"
kind = "directory"
class = "container"
status = "planned"
description = "Replace with the governed directory role."
tags = []

[directory]
path = "D:\\DirectoryName"
role = "Replace with the governed directory role."
portfolio_class = "container"
health = "unreviewed"
allows_project_groups = false

[governance]
primary_standard = "WGS"
primary_standard_path = "D:\\.city_hall\\WGS\\README.md"
additional_standards = []
additional_standard_paths = []
inherits_from = "D:\\Development.manifest.toml"
requires_child_manifests = true
allowed_child_types = ["project", "project-group", "container"]

[lifecycle]
state = "planned"
created = "YYYY-MM-DD"
last_reviewed = "YYYY-MM-DD"
maintainer = "Herb"

[structure]
required_files = ["AGENTS.md", "DirectoryName.manifest.toml"]
required_child_project_files = ["AGENTS.md", "[EntityName].manifest.toml", "Project-README.md"]
children = []
reserved_directories = []

[classification]
projects = []
project_groups = []
containers = []
archives = []

[relationships]
parent = "D:\\"
related_directories = []

[policy]
allow_project_creation = false
allow_grouped_projects = false
allow_agent_scaffolding = false
requires_manual_review_for_moves = true

[migration]
archived_manifests = []
known_gaps = ["Replace every placeholder before treating this manifest as authoritative."]

[agent]
read_first = ["AGENTS.md", "DirectoryName.manifest.toml"]
authoritative_docs = ["DirectoryName.manifest.toml", "AGENTS.md"]
safe_to_modify = false
notes = "Template only until all placeholders are replaced."

ProjectName.manifest.toml — project / project-group template

[manifest]
schema = "APTlantis Entity Manifest"
schema_version = "2.4"
manifest_type = "project"
canonical_name = "ProjectName.manifest.toml"
last_updated = "YYYY-MM-DD"
maintainer = "Herb"

[entity]
id = "example-project"
title = "Example Project"
kind = "project"
class = "project"
status = "concept"
description = "Replace with the project mission."
tags = []

[project]
type = "tool"
portfolio_class = "project"
stage = "concept"
version = "0.0.0"

[governance]
primary_standard = "PPS"
primary_standard_path = "D:\\.city_hall\\PPS\\README.md"
release_standard = ""
release_standard_path = ""
additional_standards = ["WGS"]
additional_standard_paths = ["D:\\.city_hall\\WGS\\README.md"]
inherits_from = "..\\ParentName.manifest.toml"
proposal_required = true

[lifecycle]
state = "concept"
created = "YYYY-MM-DD"
last_updated = "YYYY-MM-DD"
maintainer = "Herb"
completion_percent = 0

[paths]
root = "D:\\PORTFOLIO\\ExampleProject"
docs = ""
source = ""
artifacts = ""
data = ""

[documentation]
project_readme = "Project-README.md"
readme = "README.md"
proposal = ""
roadmap = ""
architecture = ""
release_notes = ""

[runtime]
platform = "unknown"
language_primary = "unknown"
languages_used = []
services = []
storage = ["local-filesystem"]

[relationships]
parent = "D:\\PORTFOLIO"
child_projects = []
depends_on_projects = []
used_by_projects = []
related_projects = []
external_dependencies = []

[state]
stability = "experimental"
active_development = false
known_gaps = ["Replace every placeholder before treating this manifest as authoritative."]
technical_debt = "unknown"

[agent]
read_first = ["AGENTS.md", "ProjectName.manifest.toml", "Project-README.md"]
authoritative_docs = ["ProjectName.manifest.toml", "Project-README.md", "AGENTS.md"]
governing_context = "Read inherited instructions and canonical standards before broad changes."
safe_to_modify = false
notes = "Template only until all placeholders are replaced."

StandardName.manifest.toml — standard-suite template

[standard]
id = "example-standard"
title = "Example Standard"
abbreviation = "EXS"
status = "draft"
maturity = "concept"
version = "0.1.0"
description = "Short description of what this standard governs."

[governance]
meta_standard = "SFDS"
workspace_standard = "WGS"
scope = "Describe the boundary of the standard."
non_goals = []

[artifacts]
specification = "[Standard Name].md"
schema = ""
templates = "templates"
examples = "examples"
validators = []
governance_notes = []
reference_examples = []
adoption_guide = "Adoption-Guide.md"
validation_checklist = "Validation-Checklist.md"
changelog = "CHANGELOG.md"

[conformance]
levels = ["minimal", "standard", "reference"]
validation_required = false
reference_implementation = ""

[adoption]
target_project_classes = []
known_adopters = []
blocked_by = []

[lifecycle]
created = "YYYY-MM-DD"
last_updated = "YYYY-MM-DD"
maintainer = "TBD"

[agent]
read_first = ["README.md", "[Standard Name].md", "StandardName.manifest.toml"]
authoritative_docs = ["[Standard Name].md"]
known_gaps = []
notes = "Replace placeholder values before treating this as authoritative. README explains the standard role; the primary specification defines the rules."

Note that this WGS-side StandardName.manifest.toml template includes a [conformance] and [adoption] table not present in the equivalent SFDS manifest template — the two templates describe the same concept from each standard's own vantage point and have drifted slightly. Reconciling them is a known gap, not yet tracked in either standard's backlog.