`gtmesh init`

Scaffolds a complete mesh repo — config, reference tables, schemas, templates, foundation files, and the repo-local skills — into the current directory.


gtmesh init                                        # the generic Acme demo scaffold
gtmesh init --from-discovery gtmesh-discovery.yaml  # tailored to your business

What it does

init writes a full, documented mesh repo from the bundled scaffold template. Everything it writes is yours to tune to your domain — the structural-law gtmesh.config.yaml, the reference/ tables, the per-type page schemas, the templates/, the foundation/ voice files, and the .claude/skills/ writer and quality-gate skills.

With --from-discovery, init scaffolds the full library and then overlays the discovery shape onto gtmesh.config.yaml (preserving the educational comments): your project, taxonomy, section routing, the selected page types, and the harvest classes. It writes each cluster’s starter terms to seeds/<class>.csv, templates your project identity into the README, and clears the demo’s worked-example data so a tailored mesh does not inherit Acme’s.

The discovery file is produced by gtmesh discover (the project-discovery skill). The full overlay rules are in the discovery contract.

Arguments & flags

Option	Description	Default
`--force`	Overwrite existing files instead of skipping them	off (skip existing)
`--from-discovery <file>`	Tailor the scaffold from a `gtmesh-discovery.yaml` (the discovery skill’s output)	—

The global --project <dir> chooses where to scaffold (default .).

Reads & writes

Reads: the bundled scaffold template; optionally a gtmesh-discovery.yaml.
Writes: the whole mesh repo — gtmesh.config.yaml, reference/, schemas/, templates/, foundation/, .claude/skills/, and (with discovery) seeds/<class>.csv.
Committed: everything init writes is committed; it is your project.

Examples


mkdir acme-integrations && cd acme-integrations
gtmesh init                                         # generic demo to learn the shape
 
# …or start from a discovered information architecture:
gtmesh init --from-discovery gtmesh-discovery.yaml

Platform: Discovery & harvest, Page types & schemas
Guide: Walkthrough, Discovery contract
CLI: gtmesh discover

gtmesh init