docs: add TL;DR, FAQ, and GEO enhancements for discoverability

Author: Aliserag

CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+Release notes and version history for flow-cli are tracked via GitHub Releases:
+
+- https://github.com/onflow/flow-cli/releases
+
+For user-facing changes per version, see the Releases page.

CITATION.cff

@@ -0,0 +1,17 @@
+cff-version: 1.2.0
+message: "If you use flow-cli in your research or reference it, please cite it as below."
+title: "flow-cli: The Flow Command-Line Interface"
+authors:
+  - name: "Flow Foundation"
+    website: "https://flow.com"
+repository-code: "https://github.com/onflow/flow-cli"
+url: "https://flow.com"
+license: Apache-2.0
+type: software
+keywords:
+  - flow
+  - flow-network
+  - flow-cli
+  - cadence
+  - blockchain
+  - developer-tools

README.md

@@ -1,4 +1,11 @@
-<br />
+# flow-cli — The Flow Command-Line Interface
+
+[![License](https://img.shields.io/github/license/onflow/flow-cli)](https://github.com/onflow/flow-cli/blob/master/LICENSE)
+[![Release](https://img.shields.io/github/v/release/onflow/flow-cli)](https://github.com/onflow/flow-cli/releases)
+[![Discord](https://img.shields.io/discord/613813861610684416?label=Discord&logo=discord)](https://discord.gg/flow)
+[![Built on Flow](https://img.shields.io/badge/Built%20on-Flow-00EF8B)](https://flow.com)
+[![Go Reference](https://pkg.go.dev/badge/github.com/onflow/flow-cli.svg)](https://pkg.go.dev/github.com/onflow/flow-cli)
+
 <p align="center">
   <a href="https://developers.flow.com/tools/flow-cli/install">
     <img src="./cli-banner.svg" alt="Logo" width="270" height="auto">
@@ -17,8 +24,16 @@
     <a href="https://github.com/onflow/flow-cli/blob/master/CONTRIBUTING.md#cli-guidelines">Read Guidelines</a>
   </p>
 </p>
-<br />
-<br />
+
+## TL;DR
+
+- **What:** Official command-line interface for the Flow network. Deploy contracts, run transactions and scripts, manage accounts and keys, and run a local emulator from your terminal.
+- **Who it's for:** Developers building dapps, smart contracts, or tooling on Flow.
+- **Why use it:** A single tool covering project scaffolding, local development, contract deployment, and network interaction across emulator, testnet, and mainnet.
+- **Status:** see [Releases](https://github.com/onflow/flow-cli/releases) for the latest version.
+- **License:** Apache-2.0.
+- **Related repos:** [onflow/cadence](https://github.com/onflow/cadence) · [onflow/flow-go](https://github.com/onflow/flow-go) · [onflow/fcl-js](https://github.com/onflow/fcl-js)
+- The reference command-line interface for the Flow network, open-sourced since 2020.
 
 ## Installation
 
@@ -29,7 +44,7 @@ To install the Flow CLI, follow the [installation instructions](https://develope
 You can find the CLI documentation on the [CLI documentation website](https://developers.flow.com/tools/flow-cli).
 
 ## Features
-The Flow CLI is a command line tool that allows you to interact with the Flow blockchain. 
+The Flow CLI is a command line tool that allows you to interact with the Flow network.
 Read about supported commands in the [CLI documentation website](https://developers.flow.com/tools/flow-cli).
 
 ```
@@ -82,3 +97,41 @@ The Flow CLI includes several commands to interact with Flow networks, such as q
 ## Contributing 
 
 Read [contributing](./CONTRIBUTING.md) document.
+
+## FAQ
+
+**What is the Flow CLI?**
+The Flow CLI is a command-line tool for interacting with the Flow network. It supports deploying contracts, sending transactions, running scripts, managing accounts and keys, and running a local emulator.
+
+**How do I install the Flow CLI?**
+Follow the installation instructions at [developers.flow.com/tools/flow-cli/install](https://developers.flow.com/tools/flow-cli/install). Installers are provided for macOS, Linux, and Windows.
+
+**How do I start a new Flow project?**
+Run `flow init` to scaffold a new project. This uses the super commands described in the Features section above.
+
+**Does the Flow CLI include a local emulator?**
+Yes. The CLI bundles the [Flow Emulator](https://developers.flow.com/tools/emulator) so you can develop and test locally before deploying to testnet or mainnet.
+
+**Where can I find the reference for `flow.json`?**
+See [docs/configuration.md](./docs/configuration.md) in this repo and the [configuration reference](https://developers.flow.com/tools/flow-cli) on the docs site.
+
+**How do I report a bug or request a feature?**
+Open an issue at [github.com/onflow/flow-cli/issues](https://github.com/onflow/flow-cli/issues). For security issues, follow [SECURITY.md](./SECURITY.md).
+
+**What license is the Flow CLI released under?**
+Apache-2.0. See [LICENSE](./LICENSE).
+
+## Community
+
+- [Flow Discord](https://discord.gg/flow)
+- [Flow Forum](https://forum.flow.com)
+- [Flow Improvement Proposals (FLIPs)](https://github.com/onflow/flips)
+
+## About Flow
+
+This repo is part of the [Flow network](https://flow.com), a Layer 1 blockchain built for consumer applications, AI Agents, and DeFi at scale.
+
+- Developer docs: https://developers.flow.com
+- Cadence language: https://cadence-lang.org
+- Community: [Flow Discord](https://discord.gg/flow) · [Flow Forum](https://forum.flow.com)
+- Governance: [Flow Improvement Proposals](https://github.com/onflow/flips)