From b4c700c6c6088a86694dbf27e6711f0705bf65e6 Mon Sep 17 00:00:00 2001
From: YoungJinJung <18644538+YoungJinJung@users.noreply.github.com>
Date: Tue, 29 Sep 2026 11:10:25 +0900
Subject: [PATCH] docs: lead with the install script and drop a triplicated MCP
 paragraph
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Put Install Script before Homebrew under Installation. The Homebrew path
needs three commands and a trust decision since Homebrew 6.0.0 (#369);
the script is one line with no trust step, so it is the lower-friction
entry point for a first-time reader. Both remain documented.

This does not close #376 — that asks for one-command `brew install
unic`, which is gated on homebrew-core notability — but it is the part
available today.

Also collapses the "The server provides the read-only resource
operations listed above ..." paragraph, which appeared three times in a
row with three different example-prompt lists. That was a regression
from merging the #360 fills serially: #364, #367 and #368 each edited
the sentence to name their own tool, and the conflict resolutions for
#367 and #368 kept both sides rather than merging them. The surviving
sentence names no example tool, since doing so is what made the line
conflict on every fill and the command list above already enumerates
them. The six distinct prompts are preserved.

Closes #377
---
 README.md | 28 ++++++++++------------------
 1 file changed, 10 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 0fede4e..9f9ceea 100644
--- a/README.md
+++ b/README.md
@@ -39,27 +39,27 @@ This is the closest structure to a "harness-like" doc hub in this repository: on
 
 ## Installation
 
-### Homebrew
+### Install Script
 
 ```bash
-brew tap DevopsArtFactory/unic
-brew trust --formula DevopsArtFactory/unic/unic
-brew install unic
+curl -sSL https://raw.githubusercontent.com/DevopsArtFactory/unic/main/install.sh | sh
 ```
 
-Homebrew 6.0.0 and later require explicit trust before loading formulae from non-official taps; without the trust step `brew install unic` fails with `Refusing to load formula ... from untrusted tap`. The formula-scoped command trusts only `unic`, rather than every current and future item in the tap, which is what `brew trust DevopsArtFactory/unic` would grant.
+Set `INSTALL_DIR` to override the default install path.
 
-Homebrew and release archives install both the `unic` TUI and the `unic-mcp` stdio server.
+The script checks that the downloaded archive contains both binaries before replacing either installation. If an older release lacks `unic-mcp`, build from source until a release containing both is available.
 
-### Install Script
+### Homebrew
 
 ```bash
-curl -sSL https://raw.githubusercontent.com/DevopsArtFactory/unic/main/install.sh | sh
+brew tap DevopsArtFactory/unic
+brew trust --formula DevopsArtFactory/unic/unic
+brew install unic
 ```
 
-Set `INSTALL_DIR` to override the default install path.
+Homebrew 6.0.0 and later require explicit trust before loading formulae from non-official taps; without the trust step `brew install unic` fails with `Refusing to load formula ... from untrusted tap`. The formula-scoped command trusts only `unic`, rather than every current and future item in the tap, which is what `brew trust DevopsArtFactory/unic` would grant.
 
-The script checks that the downloaded archive contains both binaries before replacing either installation. If an older release lacks `unic-mcp`, build from source until a release containing both is available.
+Homebrew and release archives install both the `unic` TUI and the `unic-mcp` stdio server.
 
 ### Build From Source
 
@@ -261,15 +261,7 @@ The server provides the read-only resource operations listed above plus capabili
 - `Show the AWS capabilities available through unic.`
 - `List my AWS Backup vaults in ap-northeast-2.`
 - `Show my deepest SQS backlogs and their dead-letter queue relationships.`
-The server exposes the read-only resource operations listed above—including `list_cloudformation_stacks`—plus capability discovery, Security Inspector, and context-sync preview tools. Agents should call `get_mcp_capabilities` first because it describes only operations callable through MCP, including permissions and output contracts. Example prompts:
-
-- `Show the AWS capabilities available through unic.`
-- `List my AWS Backup vaults in ap-northeast-2.`
 - `Show failed or rollback CloudFormation stacks and their status reasons.`
-The server exposes the read-only resource operations listed above—including `list_step_function_executions`—plus capability discovery, Security Inspector, and context-sync preview tools. Agents should call `get_mcp_capabilities` first because it describes only operations callable through MCP, including permissions and output contracts. Example prompts:
-
-- `Show the AWS capabilities available through unic.`
-- `List my AWS Backup vaults in ap-northeast-2.`
 - `Show the recent failed executions for this STANDARD Step Functions state machine ARN.`
 - `Preview a unic context sync without changing config.`