---

name: f0rge description: local gh-like forge under .forge/

f0rge v1: CONTRACT (not help) id: uuid4 lowercase dashes; never changes number: rank (created,uuid); derived never stored files: one file per entity; command tree mirrors folder tree tree: issue<->issues/ pr<->prs/ task<->tasks/ ci<->ci/ wiki<->wiki/ frontmatter: strict --- fences; unknown field warning; missing required error git: .forge/ committed with repo; PR=git branch from worktree ci: steps are scripts; run in filename order; first nonzero exit code=fail; pass|fail|running|cancelled merge: CI-gates patch in scratch worktree; never touches main/branches; prints conflicts, never resolves; you integrate (ff) + delete branch never delete: close/archive only; archive to .forge/archive/ wiki: files under wiki/; edit in place/stdin spec: spec/schema.md frozen truth; labels.md/milestones.md registries usage: f0rge <cmd> [--json] [args]; init makes .forge/ idempotent; --jq via jq; never parse prose json: compact fixed order; empty []/{} install: f0rge release install [ver|main]