---
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]