AGENTS.md

1# assets/ - Generated Schemas
2 
3## OVERVIEW
4 
5Checked-in JSON artifacts consumed by editors, CLIs, installers, and published packages. This directory is output, not the source of configuration or help contracts.
6 
7## STRUCTURE
8 
9```
10assets/
11├── oh-my-opencode.schema.json   # OpenCode edition config schema
12├── omo.schema.json              # Harness-neutral omo.json schema
13└── help/                        # Machine-readable CLI help schemas
14    ├── acp.schema.json
15    ├── doctor.schema.json
16    ├── sandbox.schema.json
17    └── status.schema.json
18```
19 
20## SOURCE OF TRUTH
21 
22| Artifact | Generator / source |
23|----------|--------------------|
24| `oh-my-opencode.schema.json` | `script/build-schema.ts` + OpenCode Zod schemas under `packages/omo-opencode/src/config/schema/` |
25| `omo.schema.json` | `script/build-omo-schema.ts` + `packages/omo-config-core/` |
26| `help/*.schema.json` | `script/build-help-schemas.ts` + CLI help definitions |
27 
28## COMMANDS
29 
30```bash
31bun run build:schema
32bun run build:omo-schema
33bun run script/build-help-schemas.ts
34bun test tests/omo-schema-freshness.test.ts
35```
36 
37## CONVENTIONS
38 
39- Regenerate after changing the corresponding source schema or help definition.
40- Commit generated output with the source change that requires it.
41- Review diffs for accidental field removal, default changes, or stale descriptions.
42 
43## ANTI-PATTERNS
44 
45- Never hand-edit generated JSON.
46- Never fix a freshness test by weakening or deleting the assertion.
47- Never update only one schema copy when a shared source feeds multiple artifacts.
48