Publish curated DevRunbook source from 968e4df3f2c0f5ce9ba05a32ccf47565920663ab

README.md

@@ -1,5 +1,9 @@
 # DevRunbook
 
+<p align="center"><img src="apps/web/src/app/icon.svg" width="72" alt="DevRunbook icon"></p>
+<p align="center"><strong>From a development request to a reviewable agent task.</strong></p>
+<p align="center"><a href="#how-it-works">Workflow</a> · <a href="#what-users-can-do">Features</a> · <a href="#quick-start-with-docker-compose">Quick start</a> · <a href="#architecture-and-safety">Architecture</a></p>
+
 DevRunbook is a self-hosted platform for turning development intent into
 structured, reusable and verifiable tasks for coding agents such as Codex. It
 combines a reviewed playbook, repository context, risk controls and validation
@@ -9,6 +13,23 @@ The platform helps developers stop rewriting the same instructions while
 keeping scope, provenance and evidence visible. It does **not** execute
 repository commands or write to your Git forge.
 
+![Conceptual illustration of a development request becoming a verified Run Pack](docs/screenshots/workflow-concept.png)
+
+*Conceptual workflow illustration; this is not a screenshot of the application.*
+
+## How it works
+
+```mermaid
+flowchart LR
+    Intent[Development intent] --> Playbook[Reviewed playbook]
+    Profile[Repository profile] --> Composer[Task composer]
+    Playbook --> Composer
+    Composer --> Review[Compatibility and guardrail review]
+    Review --> Output[Immutable task or verified Run Pack]
+```
+
+Choose a playbook, add a repository profile, describe the task, inspect the generated scope and validation requirements, then export the exact prompt or Run Pack for your coding agent. Simple mode guides common tasks; Expert mode exposes the detailed controls. The application keeps the authoring and review boundary visible before anything is handed to an agent.
+
 ## What users can do
 
 - Browse and search 28 built-in, versioned development playbooks.