add specx promotion materials

Author: EvanAI0331

README.md

@@ -129,6 +129,7 @@ Demo 3: Multi-agent system
 - `docs/contract-schema-v0.1.md`
 - `docs/execution-result-v0.1.md`
 - `docs/cli.md`
+- `docs/promotion.md`
 
 ## Roadmap
 

docs/promotion.md

@@ -0,0 +1,68 @@
+# Promotion
+
+SpecX is a governance layer for Codex agents.
+
+## Core Positioning
+
+Stop agents from pretending success.
+Make every task contract-bound, gate-bound, evidence-bound, and failure-explicit.
+
+## One-Line Install
+
+```bash
+codex plugin marketplace add https://github.com/BTCNAI/specx-codex-marketplace.git --ref v0.4.0
+```
+
+## Short Copy
+
+SpecX turns vague agent tasks into governed execution contracts. It enforces required agents, tools, evidence, gates, artifacts, execution results, and failure semantics so Codex workflows cannot silently fallback or claim fake success.
+
+## Launch Post
+
+SpecX is a governance layer for Codex agents.
+
+It turns vague tasks into explicit contracts, then verifies execution results against those contracts.
+
+- Required agents and tools
+- Evidence and gate checks
+- Artifact contracts
+- Explicit passed, failed, and blocked states
+- CLI + MCP tools
+- GitHub-backed Codex marketplace distribution
+
+Install:
+
+```bash
+codex plugin marketplace add https://github.com/BTCNAI/specx-codex-marketplace.git --ref v0.4.0
+```
+
+## Demo Hooks
+
+Software engineering:
+
+Before: `Refactor this backend.`
+
+After SpecX: required agents, gates, tests, artifacts, and explicit failure semantics.
+
+Research:
+
+Before: `Research this market.`
+
+After SpecX: source gates, evidence mapping, decision packet, and risk notes.
+
+Multi-agent systems:
+
+Before: agents freestyle.
+
+After SpecX: contract-first runtime, execution result verification, and explicit failure state.
+
+## Distribution Channels
+
+- GitHub README
+- X / Twitter
+- Hacker News Show HN
+- Reddit r/ChatGPTCoding
+- Reddit r/LocalLLaMA
+- Reddit r/ClaudeAI
+- Product Hunt
+- Codex and agent builder communities