feat: scaffold Go-based hf CLI

README.md

@@ -1,6 +1,40 @@
 # HarborForge.Cli
 
-CLI tools for HarborForge.
+`HarborForge.Cli` is the home of the new Go-based `hf` binary for HarborForge.
 
-This repository is intentionally initialized with a minimal scaffold.
-Future commands and packaging can be added here.
+## Current status
+
+This repository now contains the initial Go scaffold required by the cross-project plan:
+
+- Go module initialization
+- binary entrypoint at `cmd/hf/main.go`
+- placeholder internal package layout for future implementation
+- basic build instructions
+
+## Build
+
+```bash
+go build -o ./bin/hf ./cmd/hf
+```
+
+## Run
+
+```bash
+go run ./cmd/hf --help
+go run ./cmd/hf version
+```
+
+## Planned package layout
+
+```text
+cmd/hf/
+internal/
+  client/
+  commands/
+  config/
+  help/
+  mode/
+  passmgr/
+```
+
+The scaffold is intentionally minimal so follow-up work can implement config loading, mode detection, help rendering, auth, and API command groups incrementally.